日志流 (Beta)
HertzBeat 的日志流功能提供了实时查看和过滤日志数据的能力，包括实时日志监控、多维度过滤、日志详情查看等操作。用户可以实时监控系统日志，并根据不同条件进行精确过滤，快速定位问题和分析系统状态。
注意
日志流功能目前处于 Beta（实验性）阶 段，可能存在潜在缺陷和局限性。该功能正在积极开发和迭代中。
功能概览
在 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 与社区交流。