跳到主要内容
版本:v1.7.x

日志流

HertzBeat 的日志流功能提供了实时查看和过滤日志数据的能力,包括实时日志监控、多维度过滤、日志详情查看等操作。用户可以实时监控系统日志,并根据不同条件进行精确过滤,快速定位问题和分析系统状态。

功能概览

在 HertzBeat 界面中,进入"日志" -> "日志流"页面,你将看到一个功能完整的实时日志监控界面。

log_stream

实时日志查看

日志显示

  • 实时更新:新日志会自动显示在列表顶部,带有高亮动画效果
  • 日志计数:界面显示当前加载的日志条数(最多保留1000条)
  • 级别标识:根据 OpenTelemetry 规范,不同日志级别用不同颜色标识:
    • 灰色:TRACE(1-4)
    • 蓝色:DEBUG(5-8)
    • 绿色:INFO(9-12)
    • 橙色:WARN(13-16)
    • 红色:ERROR(17-20)
    • 火山红:FATAL(21-24)

显示控制

  • 暂停/恢复:点击暂停按钮可暂停新日志的显示,再次点击恢复
  • 清除日志:清空当前显示的所有日志条目
  • 滚动到顶部:快速回到最新日志的位置
  • 自动滚动: 系统默认自动滚动到最新日志,当用户手动滚动到其他位置时,自动滚动会暂停,点击"滚动到顶部"按钮或滑动到顶部可重新启用自动滚动

日志过滤

点击"显示过滤器"按钮展开过滤配置区域,支持以下过滤条件:

过滤条件字段名称数据类型用途说明示例值使用场景
严重程度编号severityNumber数字OpenTelemetry 标准级别9按数字级别精确过滤
严重程度文本severityText字符串人类可读的日志级别ERRORWARNINFO按级别快速筛选
跟踪IDtraceId字符串分布式系统请求链路跟踪1234567890abcdef链路追踪、请求流程分析
跨度IDspanId字符串跟踪中特定操作标识abcdef1234567890微服务调用分析

日志详情查看功能

点击任意日志条目可打开详情弹窗,提供完整的日志信息展示:

log_entry_details

基本信息区域

  • 严重程度:显示级别标签和颜色标识
  • 时间戳:格式化显示的详细时间
  • 跟踪ID:完整的分布式跟踪标识符
  • 跨度ID:完整的操作跨度标识符

完整JSON数据

  • 原始数据:显示日志条目的完整 JSON 格式
  • 复制功能:支持一键复制到剪贴板
  • 格式化显示:JSON 数据进行了格式化处理便于阅读

故障排除

连接问题

症状:显示"已断开"状态 解决方案

  • 检查网络连接
  • 确认 HertzBeat 服务正常运行
  • 检查浏览器是否支持 SSE

无日志显示

症状:连接正常但无日志显示 解决方案

  • 检查是否有日志数据发送到 HertzBeat
  • 验证过滤器设置是否过于严格
  • 确认日志格式符合预期

如需了解更多日志流功能或遇到技术问题,欢迎通过 GitHub Issues 与社区交流。