本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
连接到 Datadog 数据源
Datadog 数据源使您能够在 Amazon Managed Grafana 中可视化来自 Datadog 监控服务的指标。
注意
此数据源仅适用于 Grafana Enterprise。有关更多信息,请参阅 管理对企业插件的访问权限。
此外,在支持版本 9 或更高版本的工作空间中,此数据源可能需要您安装相应的插件。有关更多信息,请参阅 使用插件扩展您的工作空间。
使用量
缓存
对于需要进行大量查询的大型仪表板,可以受到 Datadog API 的速率限制(达到 Datadog API 允许的最大每小时 API 调用次数)。缓存功能可将唯一查询缓存 60 秒。可以在配置页面上将此间隔更改为更长或更短。
查询编辑器
很简单-选择聚合和指标。如果要筛选结果,请选择一个或多个标签。
Datadog 数据源支持 Datadog 查询编辑器支持的所有高级功能。从下拉列表中选择它,然后通过选择函数名称进行排列。
按字段使用可能性划分的别名:
-
在 “别名依据” 字段中输入别名。
-
使用作用域变量:
-
$__metric
= 替换为指标名称 -
$__display_name
= 替换为指标名称 -
$__expression
= 替换为完整的指标表达式 -
$__aggr
= 替换为指标聚合函数(例如,平均值、最大值、最小值、总和) -
$__scope
= 替换为指标范围(例如,区域、站点、环境、主机)
-
-
使用正则表达式:
-
在
/you regexp here/flags
格式化的 “别名 RegExp” 字段中输入您的正则表达式。 -
如果 “Alias by” 字段为空,则将使用连接 RegExp 结果。指标表达式为 = 的示例
avg:system.load.5{*}
:“Alias by” 字段输入:“" "Alias RegExp" 字段输入:avg:(.+)\.(\d)
结果:system.load, 5
-
在 “别名依据” 字段中使用
$<group_number>
变量。指标表达式为 = 的示例avg:system.load.5{*}
:“别名依据” 字段输入:$1: $2 seconds
“别名 RegExp” 字段输入:avg:(.+)\.(\d)
结果:system.load: 5 seconds
-
用于
$0
获取整个表达式。指标表达式为 = 的示例datadog.dogstatsd.packet.count{*}
:“别名依据” 字段输入:Expression: $0
“别名 RegExp” 字段输入:DOGstatsd\.(.*)\.(.*){\*}/i
结果:Expression: datadog.dogstatsd.packet.count{*}
注意:使用不存在的群组号码时会出现错误。
-
公制算术
要使用公制算术,请将 “查询类型” 设置为 “算术”。使用 s #
ign 链接到你想要的指标。例如,#A * 2
会使查询结果翻倍A
。两个指标之间的算术运算方式相同-添加要用于计算的结果的查询,然后在第三个查询中链接到这些指标,例如#A / #B
。
注释
注释是叠加在图表顶部的事件——例如,部署或中断就是一个事件。使用此数据源,您可以从 Datadog 获取事件并将其叠加在亚马逊托管 Grafana 中的图表上。可以按来源、标签或优先级筛选注释事件。
模板化
有几个选项可以获取模板变量的值,即指标和标签。要获取可用指标列表,请在查询字段*
中指定。
要返回所有标签,请使用值:tag
或scope
。
要返回指定标签组的标签,请使用以下默认类别值之一:
-
host
-
device
-
env
-
region
-
site
-
status
-
version
对于自定义标签组,只需输入标签组名称即可。例如,如果您的自定义标签组名称是subscription_name
,请在 “查询” 字段中输入该名称。
使用 Regex 字段筛选结果。使用标签时支持多值变量——多个选定的标签值将转换为以逗号分隔的标签列表。
临时过滤器
Grafana 中有一种新的特殊类型的模板变量,叫做 Ad-hoc 过滤器。此变量将应用于仪表板中的所有 Datadog 查询。这允许像快速过滤器一样使用它。例如,Datadog 的临时变量从标签中获取所有键值对,并将其用作查询标签。region:east, region:west
要创建此变量,请选择临时筛选器类型并选择您的 Datadog 数据源。你可以为这个变量设置任何名称。