菜单
Grafana Cloud Enterprise 开源

日志

日志是系统或应用程序生成的事件或消息的结构化记录,即一系列包含系统或应用状态更新的文本记录。它们通常包含时间戳、消息以及事件严重性等上下文信息。

日志可视化功能可显示来自支持日志的数据源(如 Elastic、Influx 和 Loki)的这些记录。日志可视化功能具有用于显示日志状态的彩色指示器,以及可折叠的日志事件,有助于您分析生成的信息。

Logs visualization

Give it a try using Grafana Play
使用 Grafana Play 试用

借助 Grafana Play,您可以探索并了解其工作原理,从实际示例中学习,加速您的开发。此功能可在 Logs 面板中看到。

通常,您会将日志与图形可视化结合使用,以显示相关进程的日志输出。如果您的应用或系统发生事件(例如网站中断或代码故障),您可以使用日志可视化功能帮助您找出问题所在、发生时间甚至原因。

配置日志可视化

以下视频将引导您创建日志可视化。您还将学习如何自定义一些设置以及日志可视化的注意事项

支持的数据格式

日志可视化最适用于日志类型数据集,例如来自 Loki、Elastic 和 InfluxDB 等数据源的查询。

只要第一个字段是时间类型,后面跟着字符串、数字和时间字段,您也可以从其他数据源构建日志格式的数据。开头的时间字段用于对日志进行排序和添加时间戳,如果数据包含其他时间类型字段,则会将其作为日志记录的元素包含在内。

无论第二个字段是时间、数字还是字符串字段,都将用作日志记录标题。通常,第二个字段是包含多个字符串元素的文本字段,但如果存在消息级别(或 lvl),可视化功能将使用其中的值来为记录添加颜色,如日志级别集成中所述。

后续字段在每个日志记录内部折叠起来,您可以通过点击展开 (>) 图标来打开它们。

要限制可视化中渲染的日志行数,您可以使用面板查询选项中的最大数据点设置。如果未设置此选项,则数据源通常会强制执行其自己的默认限制。

示例

时间标题消息元素 1元素 2元素 3
2023-02-01 12:00:00title=Log1 lvl=info1server22023-02-01 11:00:00
2023-02-01 11:30:00title=Log1 lvl=error1server22023-02-01 11:00:00
2023-02-01 11:00:00title=Log1 lvl=trace1server22023-02-01 11:00:00

Logs Example

日志级别

对于指定了级别标签的日志,我们使用标签的值来确定日志级别并相应地更新颜色。如果日志没有指定级别标签,我们会尝试查找其内容是否匹配任何受支持的表达式(更多信息请参见下文)。日志级别始终由第一个匹配项确定。如果 Grafana 无法确定日志级别,则会以未知日志级别进行可视化。请参阅支持的日志级别以及日志级别缩写和表达式的映射

配置选项

以下部分介绍此可视化在面板编辑器窗格中可用的配置选项。这些选项尽可能按照它们在 Grafana 中的显示顺序排列。

面板选项

在面板编辑器窗格的面板选项部分,可以设置基本选项,例如面板标题和描述以及面板链接。要了解更多信息,请参阅配置面板选项

日志选项

使用这些设置来细化您的可视化

选项描述
时间显示或隐藏时间列。这是与数据源报告的日志行关联的时间戳。
唯一标签显示或隐藏唯一标签列,该列仅显示非公共标签。
公共标签显示或隐藏公共标签。
换行开启或关闭换行。
美化 JSON打开开关以美化所有 JSON 日志打印。此设置不影响除 JSON 以外任何格式的日志。
启用日志详情打开开关以查看一个可扩展区域,其中包含日志详情,包括标签和检测到的字段。每个字段或标签都有一个统计图标,用于显示与所有显示日志相关的即席统计信息。默认设置为开启。
去重根据您选择的条件,隐藏显示的其他日志消息的重复项。选择以下选项:
  • 精确 - 忽略 ISO 日期时间。
  • 数值 - 仅忽略数字不同的项,例如 IP 或延迟。
  • 签名 - 删除标点和空白符相同的连续行。
顺序设置是否按最新优先最早优先显示结果。