Datadog 集成连接器
将以下提示词粘贴到你的 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-traceNode.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 仪表板配置