文档 插件 Grafana 的 Netlify 数据源

Netlify Grafana 数据源

Netlify 数据源插件允许您在 Grafana 中查询和可视化来自 Netlify 的数据。

要求

此插件有以下要求

• 一个 Netlify 个人访问令牌
• 任何免费或付费的 Grafana Cloud 计划，或已激活的本地部署 Grafana Enterprise 许可证。签约的 Cloud 客户应参考其协议。

安装插件

要安装数据源，请参阅 安装。

在 Grafana 中配置数据源

通过填写以下字段 添加数据源

基本字段

身份验证字段

此插件支持基于 Bearer 令牌的身份验证。登录 Netlify portal，然后前往 User Settings > OAuth，在 Personal Access Tokens 部分找到您的令牌。

通过 Provisioning 配置数据源

可以使用 Grafana 的 Provisioning 系统通过配置文件配置数据源。要了解其工作原理，包括可以为此数据源设置的所有设置，请参阅 Provisioning Grafana 数据源

以下是使用访问密钥身份验证为此数据源配置的一些 Provisioning 示例

yaml 复制

apiVersion: 1
datasources:
  - name: Netlify
    type: grafana-netlify-datasource
    secureJsonData:
      Netlify.token: <token>

查询

查询编辑器允许您查询 - Sites、Builds、Deploys、SSL Certificates、Forms、Form Submissions 和 Account Build Status。选择操作类型并输入所需的参数，并在适用时输入可选参数。

Sites

Sites 操作允许您管理 Netlify 帐户中的所有站点。它返回有关每个站点的信息，包括其唯一标识符、名称、域名、构建设置和其他配置详情。

Builds

Builds 操作提供对您站点的构建过程的访问。它返回有关每个构建的详细信息，例如构建 ID、状态（例如，building、ready、failed）、提交信息以及构建开始和完成的时间戳。

Deploys

Deploys 操作允许您与站点的部署历史交互。它返回每个部署的信息，包括部署 ID、部署上下文（例如，production、staging）、部署状态（例如，ready、error）以及已部署站点的 URL。

SLL 证书

SSL Certificates 操作允许您管理您站点的 SSL 证书。它返回有关每个证书的详细信息，包括证书 ID、域名、过期日期和状态，有助于确保您站点的安全连接。

列出站点表单

Forms 操作使您能够管理 Netlify 站点上创建的表单。它返回有关每个表单的信息，例如表单 ID、名称、提交计数和设置，方便轻松访问和管理表单配置。

表单提交

Form Submissions 操作提供对通过 Netlify 表单收集的提交的访问。它返回有关每个提交的详细信息，包括提交 ID、表单 ID、提交数据和时间戳，允许您查看和处理表单条目。

帐户构建状态

Account Build Status 操作提供了您的整个 Netlify 帐户的构建状态概述。它返回有关构建配额的信息，包括已使用的构建数量和当前计费周期剩余的构建数量，帮助您监控帐户的构建使用情况。

已知限制

由于目前 Netlify API 的限制，无法按时间过滤。选择 dimension 时，将返回所有 dimension 值的数据。

目前暂不支持警报功能。

Explore 视图

Explore 视图允许您运行查询并将结果可视化为日志或指标图表。有关 Explore 的更多信息，请参阅 Explore。

模板和变量

要添加新的 Netlify 查询变量，请参阅 添加查询变量。使用您的 Netlify 数据源作为数据源，并在 query 字段中填写您的查询。

创建变量后，您可以使用 变量语法 在您的 Netlify 查询中使用它。有关变量的更多信息，请参阅 模板和变量。

了解更多

• 添加 注解 (Annotations)。
• 配置和使用 模板和变量。
• 添加 转换 (Transformations)。