菜单
Enterprise 开源

Loki 数据源

Grafana 内置支持 Loki,这是一个由 Grafana Labs 开发的开源日志聚合系统。如果您刚开始使用 Loki,以下文档将帮助您入门:

配置 Loki 数据源

要添加 Loki 数据源,请完成以下步骤:

  1. 点击左侧菜单中的Connections
  2. Connections下,点击Add new connection
  3. 在搜索栏中输入Loki
  4. 选择Loki data source
  5. 点击右上角的Create a Loki data source

您将被带到Settings选项卡,在那里您可以设置您的 Loki 配置。

配置选项

以下是 Loki 的配置选项列表。

要配置的第一个选项是您的连接名称

  • 名称 - 数据源名称。这是您在面板和查询中引用数据源的方式。示例:loki-1, loki_logs。

  • 默认 - 切换此选项可在仪表盘面板中将其选为默认名称。当您打开仪表盘面板时,这将是默认选定的数据源。

HTTP 部分

  • URL - 您的 Loki 服务器的 URL。Loki 使用端口 3100。如果您的 Loki 服务器在本地,请使用https://:3100。如果它位于网络中的服务器上,则这是您运行 Loki 的 URL 及端口。示例:http://loki.example.orgname:3100

  • 允许的 Cookie - 按名称指定应转发到数据源的 Cookie。Grafana 代理默认删除所有转发的 Cookie。

  • 超时 - HTTP 请求超时时间。必须以秒为单位。没有默认值,因此此设置取决于您。

认证部分

您可以在“认证”部分选择几种认证方法。

注意

使用 TLS(传输层安全)为与 Loki 的工作提供附加的安全层。有关使用 Loki 设置 TLS 加密的信息,请参阅Grafana Loki 配置参数

  • 基本认证 - 最常见的认证方法。使用您的数据源用户名和数据源密码进行连接。

  • 带凭据 - 切换此选项以启用凭据(例如 Cookie 或认证头)随跨站点请求发送。

  • TLS 客户端认证 - 切换此选项以使用客户端认证。启用后,添加服务器名称客户端证书客户端密钥。客户端提供一个由服务器验证的证书,以建立客户端的信任身份。客户端密钥用于加密客户端和服务器之间的数据。

  • 使用 CA 证书 - 使用 CA 证书进行认证。按照 CA(证书颁发机构)的说明下载证书文件。

  • 跳过 TLS 验证 - 切换此选项以绕过 TLS 证书验证。

  • 转发 OAuth 身份 - 转发查询数据源的用户使用的 OAuth 访问令牌(如果可用,也转发 OIDC ID 令牌)。

自定义 HTTP 头

  • - 添加自定义头。这允许根据您的 Loki 实例需求传递自定义头。

  • - 头的值。

告警

  • 在告警 UI 中管理告警规则 - 切换此选项可在告警 UI 中管理 Loki 数据源的告警规则。要管理其他告警资源,请添加一个Alertmanager数据源。

查询

  • 最大行数 - 设置 Loki 返回的最大日志行数。增加限制可以在即席分析中获得更大的结果集。如果浏览器在显示日志结果时运行缓慢,请减少限制。默认值为1000

派生字段

派生字段用于从您的日志中提取新字段,并从字段的值创建链接。

例如,您可以直接从日志链接到您的追踪后端,或者如果日志行包含相应的userId,则链接到用户个人资料页面。这些链接会出现在日志详情中。

您可以添加多个派生字段。

注意

如果您使用 Grafana Cloud,可以通过点击 Grafana Cloud 门户中的Open a Support Ticket来请求修改此功能。

每个派生字段包含以下内容:

  • 名称 - 设置字段名称。在日志详情中显示为标签。

  • 类型 - 定义派生字段的类型。可以是以下之一:

注意

在任何类型中使用复杂的正则表达式都可能影响浏览器处理大量日志时的性能。请考虑尽可能使用更简单的模式。

  • 正则表达式 (Regex): 用于解析日志消息的一部分并将其捕获作为新字段值的正则表达式。只能包含一个捕获组。

  • 标签 (Label): 选定日志行中的一个标签。可以是任何类型的标签 - 索引标签、解析标签或结构化元数据标签。使用此类型时,输入将作为正则表达式与标签键进行匹配,允许您使用单个正则表达式模式(如 trace[_]?id)匹配 traceidtrace_id 等变体。匹配标签的值将用作派生字段的值。

  • URL/查询 设置链接的完整 URL(如果链接是外部链接),或目标数据源的查询(如果链接是内部链接)。您可以使用${__value.raw}宏插入字段中的值。

  • URL 标签 - 为链接设置自定义显示标签。此设置会覆盖默认链接标签,默认链接标签是完整的外部 URL 或链接的内部数据源名称。

  • 内部链接 - 切换此选项以定义内部链接。对于内部链接,您可以从选择器中选择目标数据源。此功能仅支持追踪数据源。

  • 在新标签页中打开 - 切换此选项可在新标签页或窗口中打开链接。

  • 显示示例日志消息 - 点击此处可粘贴示例日志行以测试您派生字段的正则表达式。

点击保存并测试以测试您的连接。

排除插入故障

您可以使用调试部分查看字段提取的内容以及 URL 如何插入。选择显示示例日志消息以显示一个文本区域,您可以在其中输入日志消息。

Screenshot of the derived fields debugging
派生字段调试截图

日志详情中显示带有链接的新字段

Data link in Explore
Explore 中的数据链接