Grafana 的 Looker 数据源插件

文档

插件

Grafana 的 Looker 数据源插件允许你在 Grafana 中可视化来自 Looker 的数据。

项目状态

注意：此插件目前处于公开预览阶段。有关更多详情，请参阅 Grafana Labs 发布生命周期文档。如果你发现任何问题或有功能需求，请通过你的 Grafana Enterprise 支持渠道创建支持工单。

前提条件

有效的 Grafana Enterprise 许可。访问 Grafana 定价了解更多详情
有效的 Looker 帐户和 API 凭据。访问 Looker 文档了解更多详情

获取 Looker API 凭据

为了将 Grafana Looker 数据源实例连接到 Looker，你需要了解你的 Looker 环境详情和凭据。你可以按照 Looker 文档中指定的指南生成 Looker API 凭据 (client_id 和 client_secret)。

典型的流程是：Looker -> 管理员 -> 用户 -> 选择用户 -> 编辑密钥 (API 密钥) -> 新建 API 密钥

在 Grafana 中配置数据源

填写以下信息添加 Looker 数据源。

字段	描述	示例值
Looker URL	Looker 实例基础 URL	`https://00001234-1234-1ab2-1234-a1b2c3d4.looker.app`
Looker 客户端 ID	Looker 客户端 ID	`1234abcdXyZ567`
Looker 客户端密钥	Looker 客户端密钥	`EAiHBw4ngGLQidMtWeH4U8cE1`

数据源配置的更多详情可在此处找到此处。

使用 Provisioning 配置 Looker 数据源

可以使用 Grafana 的 Provisioning 系统通过配置文件配置数据源。要了解更多信息，请阅读 Provisioning Grafana 中关于其工作原理以及所有数据源设置的内容。

apiVersion: 1
datasources:
  - name: Looker Prod
    type: grafana-looker-datasource
    jsonData:
      base_url: https://00001234-1234-1ab2-1234-a1b2c3d4.looker.app
      client_id: 1234abcdXyZ567
    secureJsonData:
      client_secret: EAiHBw4ngGLQidMtWeH4U8cE1

Provisioning 数据源的更多详情可在此处找到此处

查询 Looker

使用 Grafana 的 Looker 数据源，你可以通过以下方式查询 Looker。在 Looker 数据源查询编辑器中，这些方式被称为查询类型。

LookML

你可以通过 LookML 查询类型执行 LookML 查询。你可以选择通过生成器构建基本的 LookML 查询 JSON，或者输入高级原始 LookML JSON。在底层，该数据源使用 Looker RunInlineQuery API。

字段	描述
模型	LookML 模型名称
Explore 名称	LookML 视图名称
维度和度量	LookML 字段。支持维度和度量
枢轴	LookML 枢轴字段。
自定义度量	字段上的自定义度量
过滤表达式	自定义过滤表达式

运行 Look

你可以选择 运行 Look 来运行已保存的 Look，而不是构建新的 LookML 查询。

字段	描述
Look ID	Look 的 ID

查询中的宏

你可以在查询中使用以下宏来过滤数据。在 LookML JSON 模式下使用时，你可以在 JSON 中的任何位置使用宏。在 LookML Builder 模式下使用时，你只能在过滤表达式中使用宏。

宏语法	描述	示例	展开为
`$__timeFilter(<Field Name>)`	当你想要基于时间字段和仪表盘时间范围限制结果时，此宏非常有用	`$__timeFilter(basic_users.created_at_time)`	`${basic_users.created_at_time} >= date_time(2022,12,31,13,59,59) AND ${basic_users.created_at_time} <= date_time(2023,12,31,13,59,59)`
`$__timeFrom()`	替换为仪表盘的起始时间	`$__timeFrom()`	`date_time(2022,12,31,13,59,59)`
`$__timeTo()`	替换为仪表盘的结束时间	`$__timeTo()`	`date_time(023,12,31,13,59,59)`