Agent Skills
返回列表
🔒

Datadog 集成连接器

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/datadog-integration-connector-agent。

技能介绍

要解决的问题

工程团队经常需要把应用数据接到 Datadog:提交自定义业务指标、转发应用日志、消费 Tracing 库产生的 APM trace,或者维护仪表板 JSON 模板。这些操作都基于 Datadog API v2,但手写集成时要自己处理认证凭证、请求体组装、分页与错误处理,重复代码量大且容易出错。

核心能力与工作方式

该技能把这些集成需求整理成清晰的调用路径:

  • 指标提交:打包应用指标,通过 Datadog API v2 上报
  • 日志转发:将应用日志接入 Datadog 日志管道
  • APM trace 消费:基于 dd-trace Node.js APM Tracer 库,捕获应用产生的 trace 数据并发送到 APM 端
  • 仪表板 JSON 模板管理:以 JSON 形式处理仪表板模板配置

关键步骤是:先初始化 API v2 客户端并配置认证凭证,再按场景选择对应数据通路(指标、日志、trace 或仪表板模板),组装 payload 后提交。方法签名、插件列表与使用示例参考上游 dd-trace 官方文档。

适用边界与注意点

  • 仅适用于 Datadog API v2,仍在使用 API v1 的项目需先迁移
  • APM 部分依赖 dd-trace,这是 Node.js 应用的 npm 包,其他语言需使用对应的 tracer 库
  • 文档与技能来源提取自上游 dd-trace-js 仓库,实际使用时建议对照官方文档,注意版本差异
  • 需要在目标环境中提前准备好 API key 与数据提交的写入权限

使用场景

  • 后端服务上线后需要将自定义业务指标通过 Datadog API v2 提交,建立指标监控
  • 应用产生大量本地日志,需要通过 Datadog API v2 转发到日志管道做集中检索分析
  • Node.js 服务接入 dd-trace 后需要把捕获的 APM trace 数据发送给 Datadog APM
  • 需要以 JSON 模板形式新建或修改 Datadog 仪表板,统一团队的监控展示视图

适合人员

  • 负责后端服务可观测性的工程师,需要把自定义业务指标和 APM trace 接入 Datadog 监控
  • 维护日志基础设施的 SRE,要把多个应用的日志统一转发到 Datadog 日志管道
  • 编写 Node.js 应用的研发工程师,打算用 dd-trace 捕获并上报 APM 链路数据
  • 管理监控告警的 DevOps 工程师,需要用 JSON 模板维护 Datadog 仪表板配置