日志流
HertzBeat 的日志流功能提供了实时查看和过滤日志数据的能力,包括实时日志监控、多维度过滤、日志详情查看等操作。用户可以实时监控系统日志,并根据不同条件进行精确过滤,快速定位问题和分析系统状态。
功能概览
在 HertzBeat 界面中,进入"日志" -> "日志流"页面,你将看到一个功能完整的实时日志监控界面。
实时日志查看
日志显示
- 实时更新:新日志会自动显示在列表顶部,带有高亮动画效果
- 日志计数:界面显示当前加载的日志条数(最多保留1000条)
- 级别标识:根据 OpenTelemetry 规范,不同日志级别用不同颜色标识:
- 灰色:TRACE(1-4)
- 蓝色:DEBUG(5-8)
- 绿色:INFO(9-12)
- 橙色:WARN(13-16)
- 红色:ERROR(17-20)
- 火山红:FATAL(21-24)
显示控制
- 暂停/恢复:点击暂停按钮可暂停新日志的显示,再次点击恢复
- 清除日志:清空当前显示的所有日志条目
- 滚动到顶部:快速回到最新日志的位置
- 自动滚动: 系统默认自动滚动到最新日志,当用户手动滚动到其他位置时,自动滚动会暂停,点击"滚动到顶部"按钮或滑动到顶部可重新启用自动滚动
日志过滤
点击"显示过滤器"按钮展开过滤配置区域,支持以下过滤条件:
过滤条件 | 字段名称 | 数据类型 | 用途说明 | 示例值 | 使用场景 |
---|---|---|---|---|---|
严重程度编号 | severityNumber | 数字 | OpenTelemetry 标准级别 | 9 | 按数字级别精确过滤 |
严重程度文本 | severityText | 字符串 | 人类可读的日志级别 | ERROR 、WARN 、INFO | 按级别快速筛选 |
跟踪ID | traceId | 字符串 | 分布式系统请求链路跟踪 | 1234567890abcdef | 链路追踪、请求流程分析 |
跨度ID | spanId | 字符串 | 跟踪中特定操作标识 | abcdef1234567890 | 微服务调用分析 |
日志详情查看功能
点击任意日志条目可打开详情弹窗,提供完整的日志信息展示:
基本信息区域
- 严重程度:显示级别标签和颜色标识
- 时间戳:格式化显示的详细时间
- 跟踪ID:完整的分布式跟踪标识符
- 跨度ID:完整的操作跨度标识符
完整JSON数据
- 原始数据:显示日志条目的完整 JSON 格式
- 复制功能:支持一键复制到剪贴板
- 格式化显示:JSON 数据进行了格式化处理便于阅读
故障排除
连接问题
症状:显示"已断开"状态 解决方案:
- 检查网络连接
- 确认 HertzBeat 服务正常运行
- 检查浏览器是否支持 SSE
无日志显示
症状:连接正常但无日志显示 解决方案:
- 检查是否有日志数据发送到 HertzBeat
- 验证过滤器设置是否过于严格
- 确认日志格式符合预期
如需了解更多日志流功能或遇到技术问题,欢迎通过 GitHub Issues 与社区交流。