Grafana的Datadog数据源

Grafana的Datadog数据源允许您从Grafana内部查询和可视化Datadog指标。使用我们托管的Datadog指标服务,您还可以直接从Datadog代理转发指标。

需求

这个插件有以下要求:

  • Datadog帐户
  • 以下帐户类型之一:
    • Grafana Cloud:专业客户、高级客户或启用企业插件的专业试用用户
    • Grafana企业:客户有一个激活许可证以及具有Grafana服务器或组织管理的用户权限
  • 启用企业插件插件

安装数据源插件

要安装数据源,请参见安装

兼容性的需求

对于这个插件,没有兼容性要求。

检查插件是否已安装

  1. 在Grafana企业从左侧菜单,导航到配置>数据源
  2. 从右上角单击添加数据源按钮。
  3. 搜索Datadog,将鼠标悬停在Datadog搜索结果上。
  4. 单击选择按钮。
    • 如果你可以点击选择按钮,然后安装。
    • 如果该按钮缺失或禁用,则该插件未安装。检查您的Grafana Enterprise许可证是否有效,并重新安装插件。如果你还需要帮助联系Grafanbob电竞频道a实验室

注意:在Grafana Cloud上,最多需要15分钟才能看到Grafana中的数据源插件。

如果您想在Grafana Cloud中托管Datadog指标,请选择

Datadog数据源插件可以通过连接到Datadog(使用API键)或从Datadog代理发送度量来工作。通过使用API密钥连接到Datadog,您只在Datadog中托管指标,但可能面临API速率限制。使用我们托管的Datadog Metrics服务通过将数据存储在Grafana Cloud中解决了这个问题。

下面一节描述如何将Datadog连接到Grafana。专用于托管Datadog Metrics的页面描述了如何将数据从Datadog代理发送到Grafana。

从Datadog获取API密钥和应用程序密钥

  1. https://datadoghq.com
  2. 设置一个API密钥并复制您的应用程序密钥。
  3. 为Datadog插件添加API键:

通过导航到获取应用程序密钥配置文件->组织设置->应用密钥复制想要的键ID

配置数据源

若要添加新的Datadog数据源,请参见添加数据源,并填写以下字段:

Datadog设置

描述
的名字 此特定Datadog数据源的名称。
API的URL 指向Datadog API的URL。例如,https://api.datadoghq.com
API密匙 来自Datadog的API密钥
应用的关键 来自Datadog的应用程序密钥
显示API速率限制 显示每个查询端点的Datadog API限制。如果需要查看API速率限制,请执行查询检查员>JSONTab和set选择源DataFrame结构
禁用数据链路 选中此选项可禁用数据链路。数据链接是当用户与面板交互时将用户带到datadog应用程序的链接
启用基本认证 调用API URL时使用基本身份验证。这在使用代理时非常有用。

使用供应配置数据源

使用配置文件和Grafana的供应系统配置Datadog数据源。要了解有关供应系统如何工作的更多信息,包括所有数据源设置,请参阅供应Grafana

下面是这个数据源的配置示例:

apiVersion: 1 datasources:—name: DATADOG type: grafana-datadog-datasource access: proxy basicAuth: false jsonData: url: https://api.datadoghq.com api_key: API Key app_key: Application Key logApiRateLimits: false disableDataLinks: false

查询数据源

查询编辑器允许您查询Datadog、获取监视器状态、获取服务级别目标(SLOs)、执行算术和别名图形图例。

查询

通过设置获取度量查询QueryType查询

  • 选择指标或单击查询编辑按钮输入指标
  • 选择聚合类型(默认为平均)
  • 可选地选择一个或多个标签,如果您想过滤结果而且集团
  • 可选地选择函数下拉菜单以选择Datadog函数。可以通过单击它们并单击箭头或x来重新排序和删除它们

服务级目标(SLOs)

通过设置获取SLOs查询类型SLO.从列表中选择一个目标。slo是从Datadog帐户填充的。

算术

通过设置使用度量算法查询类型算术

  • 要执行算术操作,查询编辑器中必须至少有一个其他查询。
  • 支持的算术操作为+-/,()
  • 要引用度量,请使用后面是查询的名称。例如,#一个
表达式的例子

# a * 2使查询结果加倍一个

# a / # b对查询结果进行除法一个通过查询B

对图例进行混叠

你可以使用的别名而且别名RegExp更改图形图例中的文本。为的别名,使用纯文本,以下列出的作用域变量,或两者都使用。

参数的作用域变量 取而代之的是
__metric美元 指标名称
__display_name美元 指标名称
__expression美元 全度量表达式
__aggr美元 度量聚合函数(如avg, max, min, sum)
__scope美元 度量范围(例如区域、站点、环境、主机)
__tag_name美元 相应的tagName。仅适用于按查询分组。(例如:在使用group by时宿主使用__tag_host美元别名)
__scope_name美元 当有多个范围项可用时,使用此别名提取特定的范围名。(例如:提取宿主范围、使用__scope_host美元别名)
(SLOs)的作用域变量 取而代之的是
__name美元 名称(与中选择的名称相同客观的下拉)
__aggr美元 聚合函数(例如:avg马克斯最小值总和
__metric美元 指标名称
__scope美元 范围名称
__numerator美元 在SLO计算中用作分子的度量
__denominator美元 在SLO计算中用作分母的度量

要使用正则表达式混叠,请填写别名RegExp使用正则表达式查找用逗号分隔的匹配项。

监控

通过设置显示监控器列表和状态信息查询类型监控.Grafana中的警报在Datadog中被称为监视器。有关更多信息,请参阅监控

有以下选项:

  • 按状态、类型、标签或静音状态计数
  • 监控列表

数量:按状态、类型、标签或静音状态显示监视器的计数。

监控列表:列出所有监视器及其对应的状态和其他相关细节。

查询:数的而且监控列表选项,您可以选择指定筛选器查询。如果指定筛选器查询,计数或列表将只返回与查询匹配的监视器。

有关监控器查询的更多信息,请参见查询

示例查询:

  • 状态:(警报或正常或“无数据”或警告)列出至少有一个状态的监视器警报好吧没有数据,或警告
  • 状态:(警报或警告)类型:度量“cassandra”列出使用的度量监控器警报警告地位也与“卡桑德拉”有关。
  • id:(7254197或240232)只显示ID的监视器状态7254197240232

注意:监控列表选项,由于API的限制,只有顶部n指定的监视器。每页的条目检索并显示设置。

所有监视器查询都有到数据狗应用程序的数据链接。若要禁用数据链路,请勾选禁用数据链路选项。

与监视器搜索类似,您还可以搜索和筛选监视器组详细信息。底层API细节可以找到在这里.这个端点需要monitors_read授权范围。

事件

事件查询提供对数据狗事件流的查询功能。

  • 这个查询最多返回1000个最近的结果
  • 结果将自动筛选到仪表板的时间范围
  • 您还可以根据来源、标签和优先级筛选结果

真实用户监控/ RUM

RUM查询允许您查询数据狗RUM事件

  • 该查询最多返回100个最近事件
  • 结果将自动筛选到仪表板的时间范围

在使用RUM查询类型时,还可以使用以下别名

参数的作用域变量 取而代之的是
__metric美元 __metric美元将被指标名称取代
__label_xyz美元 替换为标签xyz,其中xyz可以是dd返回的任何有效标签。__label_host美元
__no_labels美元 当你的别名__no_labels美元, grafana将不会为字段附加额外的标签

日志

日志查询提供对数据狗日志的查询功能

  • 该查询最多返回100条最近的日志
  • 结果将自动筛选到仪表板的时间范围

模板和变量

若要添加新的Datadog查询变量,请参见添加查询变量.使用Datadog数据源作为数据源。以下查询是可用的:

查询 描述
获取可用指标的列表
标签 返回所有标签使用值标记标记
范围 返回所有范围使用值范围的标记
宿主 返回所有宿主标签
设备 返回所有设备标签
env 返回所有env标签
地区 返回所有地区标签
网站 返回所有网站标签
状态 返回所有状态标签
版本 返回所有版本标签

对于自定义标签组,请输入标签组名称。例如,如果您的自定义标记组名称为subscription_name,然后在查询字段。

创建变量后,可以在Datadog查询中使用它。有关更多信息,请参阅变量的语法

有关变量的更多信息,请参阅模板和变量

为Datadog导入一个仪表板

要导入仪表板,请参见导入仪表板

若要查找导入的仪表板,请转到配置>数据源

要查看可用的预制仪表板,请选择Datadog数据源,并选择指示板选项卡。

临时过滤器

Grafana企业类型的模板变量称为临时过滤器,它适用于仪表板中的所有Datadog查询。这个过滤器作为一个快速过滤器。Datadog的一个特别变量从标记中获取所有的键-值对,例如东部地区:西部地区:,并将它们用作查询标记。要创建此变量,请选择临时过滤器键入并选择Datadog数据源。你可以给这个变量取任何名字。

了解更多