Grafana的Datadog数据源
Grafana的Datadog数据源允许您从Grafana内部查询和可视化Datadog指标。使用我们托管的Datadog指标服务,您还可以直接从Datadog代理转发指标。
需求
这个插件有以下要求:
- Datadog帐户
- 以下帐户类型之一:
- 启用企业插件插件
安装数据源插件
要安装数据源,请参见安装.
兼容性的需求
对于这个插件,没有兼容性要求。
检查插件是否已安装
- 在Grafana企业从左侧菜单,导航到配置>数据源.
- 从右上角单击添加数据源按钮。
- 搜索
Datadog
,将鼠标悬停在Datadog搜索结果上。 - 单击选择按钮。
- 如果你可以点击选择按钮,然后安装。
- 如果该按钮缺失或禁用,则该插件未安装。检查您的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密钥和应用程序密钥
- 去https://datadoghq.com.
- 设置一个API密钥并复制您的应用程序密钥。
- 为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的监视器状态7254197
或240232
.
注意:为监控列表选项,由于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数据源。你可以给这个变量取任何名字。
了解更多
相关的Grafana Datadog数据源资源
使用Grafana插件统一您的数据:Datadog, Splunk, MongoDB等
在本次网络研讨会中,学习如何利用Grafana的插件生态系统访问80多个数据源,包括Datadog、Splunk、MongoDB等的插件。
Grafana插件演示:Github, Gitlab, JIRA, ServiceNow等
在本次网络研讨会中,我们将向您展示如何使用Grafana来解锁这些见解,并更好地了解您的软件开发团队的性能。
关于Grafana插件:在一个地方可视化不同的数据源
Grafana企业插件是与其他商业监控工具(如Datadog、Splunk、New Relic、ServiceNow、Oracle和Dynatrace)的集成,这些工具是由Grafana实验室团队创建、维护和支持的。bob电竞频道