Datadog

配置

提交指标

操作

提交指标

API 密钥*

••••••••

Datadog 站点

US1 (datadoghq.com)

指标数据 (JSON)*

json

[ { "metric": "custom.app.response_time", "type": "gauge", "points": [{"timestamp": 1700000000, "value": 0.85}], "tags": ["env:production", "service:api"] } ]

提交指标 (datadog_submit_metrics)

向 Datadog 提交自定义指标。用于跟踪应用性能、业务指标或自定义监控数据。

输入

参数	类型	必填	描述
`series`	string	是	要提交的指标序列 JSON 数组。每个序列应包含指标名称、类型 (gauge/rate/count)、数据点 (时间戳/值对)，以及可选标签。
`apiKey`	string	是	Datadog API 密钥
`site`	string	否	Datadog 站点/区域 (默认：datadoghq.com)

输出

参数	类型	描述
`success`	boolean	指标是否提交成功
`errors`	array	提交过程中出现的任何错误

查询时间序列

操作

查询时间序列

API 密钥*

••••••••

Datadog 站点

US1 (datadoghq.com)

查询*

avg:system.cpu.user{*}

开始时间（Unix 时间戳）*

例如：1701360000

结束时间（Unix 时间戳）*

例如：1701446400

应用密钥*

••••••••

查询时间序列 (datadog_query_timeseries)

查询 Datadog 的指标时间序列数据。用于分析趋势、创建报告或检索指标值。

输入

参数	类型	必需	描述
`query`	字符串	是	Datadog 指标查询 (例如，"avg:system.cpu.user{*}")
`from`	数字	是	开始时间（Unix 时间戳，秒）
`to`	数字	是	结束时间（Unix 时间戳，秒）
`apiKey`	字符串	是	Datadog API 密钥
`applicationKey`	字符串	是	Datadog 应用密钥
`site`	字符串	否	Datadog 站点/区域 (默认：datadoghq.com)

输出

参数	类型	描述
`series`	数组	时间序列数据数组，包含指标名称、标签和数据点
`status`	字符串	查询状态

创建事件

操作

创建事件

API 密钥*

••••••••

Datadog 站点

US1 (datadoghq.com)

事件标题*

部署已完成

事件文本*

描述事件...

警报类型

信息

优先级

正常

标签

env:production, service:api

创建事件 (datadog_create_event)

将事件发布到 Datadog 事件流。用于部署通知、警报或任何重要事件。

输入

参数	类型	必填	描述
`title`	string	是	事件标题
`text`	string	是	事件正文/描述。支持 Markdown。
`alertType`	string	否	警报类型：error、warning、info、success、user_update、recommendation 或 snapshot
`priority`	string	否	事件优先级：normal 或 low
`host`	string	否	关联此事件的主机名
`tags`	string	否	逗号分隔的标签列表 (例如 "env:production,service:api")
`aggregationKey`	string	否	用于聚合事件的键
`sourceTypeName`	string	否	事件的来源类型名称
`dateHappened`	number	否	事件发生时的时间戳（Unix 时间戳）(默认为当前时间)
`apiKey`	string	是	Datadog API 密钥
`site`	string	否	Datadog 站点/区域 (默认：datadoghq.com)

输出

参数	类型	描述
`event`	object	创建的事件详情

创建监控

操作

创建监控

API 密钥*

••••••••

Datadog 站点

US1 (datadoghq.com)

监控名称*

高 CPU 使用率警报

监控类型*

指标警报

监控查询*

avg(last_5m):avg:system.cpu.idle{*} < 20

通知消息

警报！CPU 使用率过高。@slack-alerts

标签

team:backend, priority:high

优先级 (1-5)

选项 (JSON)

json

{"notify_no_data": true, "thresholds": {"critical": 90}}

应用密钥*

••••••••

创建监控 (datadog_create_monitor)

在 Datadog 中创建新的监控/告警。监控可跟踪指标、服务检查、事件等。

输入

参数	类型	必填	描述
`name`	string	是	监控名称
`type`	string	是	监控类型：指标告警、服务检查、事件告警、进程告警、日志告警、查询告警、复合告警、合成告警、SLO 告警
`query`	string	是	监控查询 (例如，"avg(last_5m):avg:system.cpu.idle{*} < 20")
`message`	string	否	随通知包含的消息。可以包含 @提及和 Markdown。
`tags`	string	否	逗号分隔的标签列表
`priority`	number	否	监控优先级 (1-5，其中 1 最高)
`options`	string	否	监控选项的 JSON 字符串 (阈值、notify_no_data、renotify_interval 等)
`apiKey`	string	是	Datadog API 密钥
`applicationKey`	string	是	Datadog 应用密钥
`site`	string	否	Datadog 站点/区域 (默认：datadoghq.com)

输出

参数	类型	描述
`monitor`	object	创建的监控详情

获取监控

操作

获取监控

API 密钥*

••••••••

Datadog 站点

US1 (datadoghq.com)

监控 ID*

12345678

应用密钥*

••••••••

获取监控器（datadog_get_monitor）

按 ID 获取指定监控器的详细信息。

输入

参数	类型	必填	说明
`monitorId`	string	是	要获取的监控器 ID
`groupStates`	string	否	以逗号分隔的要包含的组状态：alert、warn、no data、ok
`withDowntimes`	boolean	否	在监控器中包含停机数据
`apiKey`	string	是	Datadog API 密钥
`applicationKey`	string	是	Datadog 应用密钥
`site`	string	否	Datadog 站点/区域（默认：datadoghq.com）

输出

参数	类型	说明
`monitor`	object	监控器详细信息

列出监控器

操作

列出监控器

API 密钥*

••••••••

Datadog 站点

US1 (datadoghq.com)

按名称筛选

CPU

按标签筛选

env:production

应用密钥*

••••••••

列出监控器 (datadog_list_monitors)

列出 Datadog 中的所有监控器，可按名称、标签或状态进行可选筛选。

输入

参数	类型	必填	描述
`groupStates`	字符串	否	逗号分隔的组状态，用于筛选：alert、warn、no data、ok
`name`	字符串	否	按名称筛选监控器 (部分匹配)
`tags`	字符串	否	用于筛选的逗号分隔标签列表
`monitorTags`	字符串	否	用于筛选的逗号分隔监控器标签列表
`withDowntimes`	布尔值	否	在监控器中包含停机数据
`page`	数字	否	用于分页的页码 (从0开始)
`pageSize`	数字	否	每页监控器数量 (最大1000)
`apiKey`	字符串	是	Datadog API 密钥
`applicationKey`	字符串	是	Datadog 应用密钥
`site`	字符串	否	Datadog 站点/区域 (默认：datadoghq.com)

输出

参数	类型	描述
`monitors`	数组	监控器列表

静音监控器

操作

静音监控器

API 密钥*

••••••••

Datadog 站点

US1 (datadoghq.com)

监控器 ID*

12345678

范围

host:myhost（可选）

结束时间（Unix 时间戳）

留空表示无限期

应用密钥*

••••••••

静音监控器（datadog_mute_monitor）

将监控器静音，以暂时抑制通知。

输入

参数	类型	必填	描述
`monitorId`	字符串	是	要静音的监控器 ID
`scope`	字符串	否	要静音的范围(例如："host:myhost")。如果未指定，则静音所有范围。
`end`	数字	否	静音结束时的 Unix 时间戳。如果未指定，则永久静音。
`apiKey`	字符串	是	Datadog API 密钥
`applicationKey`	字符串	是	Datadog 应用密钥
`site`	字符串	否	Datadog 站点/区域(默认：datadoghq.com)

输出

参数	类型	描述
`success`	布尔值	监控器是否已成功静音

查询日志

操作

查询日志

API 密钥*

••••••••

Datadog 站点

US1 (datadoghq.com)

搜索查询*

service:web-app status:error

开始*

now-1h

结束*

now

限制

应用密钥*

••••••••

查询日志（datadog_query_logs）

从 Datadog 搜索并获取日志。用于故障排查、分析或监控。

输入

参数	类型	必填	描述
`query`	string	是	日志搜索查询 (例如，"service:web-app status:error")
`from`	string	是	开始时间，ISO-8601 格式或相对时间 (例如，"now-1h")
`to`	string	是	结束时间，ISO-8601 格式或相对时间 (例如，"now")
`limit`	number	否	返回的最大日志数量 (默认：50，最大：1000)
`sort`	string	否	排序顺序：timestamp (最早优先) 或 -timestamp (最新优先)
`indexes`	string	否	要搜索的日志索引列表，以逗号分隔
`apiKey`	string	是	Datadog API 密钥
`applicationKey`	string	是	Datadog 应用密钥
`site`	string	否	Datadog 站点/区域 (默认：datadoghq.com)

输出

参数	类型	描述
`logs`	array	日志条目列表
`nextLogId`	string	分页游标

发送日志

操作

发送日志

API 密钥*

••••••••

Datadog 站点

US1 (datadoghq.com)

日志（JSON）*

json

[ { "message": "Application started successfully", "service": "my-app", "ddsource": "custom", "ddtags": "env:production" } ]

发送日志 (datadog_send_logs)

将日志条目发送到 Datadog 进行集中式日志记录和分析。

输入

参数	类型	必填	描述
`logs`	string	是	日志条目的 JSON 数组。每个条目应包含 message，并可选择包含 ddsource、ddtags、hostname、service。
`apiKey`	string	是	Datadog API 密钥
`site`	string	否	Datadog 站点/区域 (默认：datadoghq.com)

输出

参数	类型	描述
`success`	boolean	日志是否发送成功

创建停机

操作

创建停机

API 密钥*

••••••••

Datadog 站点

US1 (datadoghq.com)

范围*

host:myhost 或 env:production 或 *

消息

计划维护

开始时间（Unix 时间戳）

留空表示现在

结束时间（Unix 时间戳）

例如：1701450000

监控器 ID（可选）

12345678

应用密钥*

••••••••

创建停机时间 (datadog_create_downtime)

安排停机时间，以在维护窗口期间抑制监控器通知。

输入

参数	类型	必需	描述
`scope`	string	是	应用停机时间的范围 (例如，"host:myhost"、"env:production"，或 "*" 表示全部)
`message`	string	否	停机期间显示的消息
`start`	number	否	停机开始的 Unix 时间戳 (默认为当前时间)
`end`	number	否	停机结束的 Unix 时间戳
`timezone`	string	否	停机的时区 (例如，"America/New_York")
`monitorId`	string	否	要静音的特定监控器 ID
`monitorTags`	string	否	要匹配的逗号分隔的监控器标签 (例如，"team:backend,priority:high")
`muteFirstRecoveryNotification`	boolean	否	静音第一个恢复通知
`apiKey`	string	是	Datadog API 密钥
`applicationKey`	string	是	Datadog 应用程序密钥
`site`	string	否	Datadog 站点/区域 (默认：datadoghq.com)

输出

参数	类型	描述
`downtime`	object	创建的停机时间详细信息

列出停机时间

操作

列出停机时间

API 密钥*

••••••••

Datadog 站点

US1 (datadoghq.com)

仅当前

Disabled

应用程序密钥*

••••••••

列出停机 (datadog_list_downtimes)

列出 Datadog 中所有已计划的停机。

输入

参数	类型	必填	描述
`currentOnly`	boolean	否	仅返回当前活跃的停机
`monitorId`	string	否	按监控器 ID 筛选
`apiKey`	string	是	Datadog API 密钥
`applicationKey`	string	是	Datadog 应用密钥
`site`	string	否	Datadog 站点/区域 (默认：datadoghq.com)

输出

参数	类型	描述
`downtimes`	array	停机列表

取消停机

操作

取消停机

API 密钥*

••••••••

Datadog 站点

US1 (datadoghq.com)

停机 ID*

abc123

应用密钥*

••••••••

取消停机时间(datadog_cancel_downtime)

取消已计划的停机时间。

输入

参数	类型	必填	描述
`downtimeId`	字符串	是	要取消的停机 ID
`apiKey`	字符串	是	Datadog API 密钥
`applicationKey`	字符串	是	Datadog 应用密钥
`site`	字符串	否	Datadog 站点/区域 (默认：datadoghq.com)

输出

参数	类型	描述
`success`	布尔值	停机是否成功取消

使用说明

将 Datadog 监控集成到工作流中。提交指标、管理监控器、查询日志、创建事件、处理停机等。

注意事项

类别: tools
类型: datadog

Datadog

On this page