关于本页

本页介绍更夫所基于的开源内核 Keep 的通用能力。更夫在其上提供国内化增强：钉钉/企业微信/飞书通知、国产大模型接入、LDAP 认证与值班管理。部署与上手请看快速上手。

概述

Grafana Loki 是一个日志聚合系统，设计用于存储和查询来自所有应用程序和基础设施的日志。入门的最简单方法是使用 Grafana Cloud，这是一个完全可组合的可观测性堆栈。

认证

此提供商需要身份验证。

• host_url: Grafana Loki 主机 URL（必需：True，敏感：False）
• verify: 启用 SSL 验证（必需：False，敏感：False）
• authentication_type: 身份验证类型（必需：True，敏感：False）
• username: HTTP 基本身份验证 - 用户名（必需：False，敏感：False）
• password: HTTP 基本身份验证 - 密码（必需：False，敏感：True）
• x_scope_orgid: X-Scope-OrgID 头身份验证（必需：False，敏感：False）

某些范围可能需要才能通过提供商执行特定操作或查询。以下是相关范围及其用例的摘要：

• authenticated: 实例有效且用户已身份验证

在工作流中

此提供商可用于工作流。

作为"步骤"来查询数据，示例：

steps:
    - name: Query grafana_loki
      provider: grafana_loki
      config: "{{ provider.my_provider_name }}"
      with:
        query: {value}
        limit: {value}
        time: {value}
        direction: {value}
        start: {value}
        end: {value}
        since: {value}
        step: {value}
        interval: {value}
        queryType: {value}

请查看以下工作流示例：

• query_grafana_loki.yaml

连接 Grafana Loki provider

1. 获取所需的身份验证参数。
2. 将 Grafana Loki provider 添加到您的 keep 账户并使用上述身份验证参数进行配置。

查询 Grafana Loki

Grafana Loki provider 允许您通过 query 和 query_range 类型查询 Grafana Loki 中的日志。以下是可用于查询的参数：

1. query 类型：

   • query：要执行的 LogQL 查询。不使用有效 LogQL 语法的请求将返回错误。
   • limit：返回的最大条目数。默认为 100。仅适用于产生流（日志行）响应的查询类型。
   • time：查询的执行时间，作为纳秒 Unix 时间戳或其他 支持的格式。默认为 now。
   • direction：确定日志的排序顺序。支持的值为 forward 或 backward。默认为 backward。

2. query_range 类型：

   • query：要执行的 LogQL 查询。
   • limit：返回的最大条目数。默认为 100。仅适用于产生流（日志行）响应的查询类型。
   • start：查询的开始时间，作为纳秒 Unix 时间戳或其他 支持的格式。默认为一小时前。Loki 返回时间戳大于或等于此值的结果。
   • end：查询的结束时间，作为纳秒 Unix 时间戳或其他 支持的格式。默认为 now。Loki 返回时间戳小于此值的结果。
   • since：用于相对于 end 计算 start 的 duration。如果 end 在未来，start 计算为现在之前到此持续时间。为 start 指定的任何值都会覆盖此参数。
   • step：以 duration 格式或秒为单位的浮点数表示的查询分辨率步长宽度。duration 是形式为 [0-9]+[smhdwy] 的 Prometheus 持续时间字符串。例如，5m 表示 5 分钟的持续时间。默认为基于 start 和 end 的动态值。仅适用于产生矩阵响应的查询类型。
   • interval：仅返回在指定间隔或更大间隔的条目，可以是 duration 格式或秒为单位的浮点数。仅适用于产生流响应的查询。不要与 step 混淆，请参阅 Step versus interval 中的解释。
   • direction：确定日志的排序顺序。支持的值为 forward 或 backward。默认为 backward。

相关链接

• Grafana Loki
• Grafana Loki 身份验证