跳转到内容
learn-pstack

Datadog 遥测

更新于 2026-10-01

Datadog 遥测

Section titled “Datadog 遥测”

这个来源里有什么

Section titled “这个来源里有什么”

Datadog 记录运行时——生产实际发生什么，而非计划或讨论。

  • 指标。 团队埋点的计数器、仪表、直方图。指标存在本身就是证据：有人觉得该数字值得看。
  • 监控与告警。 团队认为值得叫醒人的条件。对 rate_limit_hit > 10/min 告警的 monitor 是直接证据：团队担心该阈值。
  • 仪表盘。 人工整理的视图。图表说明团队认为子系统什么重要。
  • APM 追踪与 span。 请求级运行时数据。适用于「为何慢/为何超时」类问题。
  • 日志。 高流量 事件记录。常含驱动防御性代码的错误条件。
  • 事故。 正式事故记录，含时间线与链接事后复盘。
  • Notebook。 探索性调查。常含假设与分析。

Datadog 回答「写这段代码前后生产现实如何」，常解释代码形态。

怎么搜

Section titled “怎么搜”

使用 Datadog MCP。先广后窄。

  1. 识别负责服务。

    search_datadog_services (filter by name or team)
    search_datadog_service_dependencies (see upstream/downstream)

  2. 先看仪表盘与 monitor。它们说明团队在意什么。

    search_datadog_dashboards (query: feature name, service name, symbol)
    search_datadog_monitors   (same queries)

    当仪表盘或 monitor 覆盖目标时，记下其查询与监控阈值。阈值常是「为何限制为 N」的答案。

  3. 目标相关指标。

    search_datadog_metrics (by name pattern, e.g., the feature or symbol)
    get_datadog_metric_context (metadata: description, units, tags)
    get_datadog_metric (timeseries; "was there a spike around the PR date?")

    将指标轨迹与目标变更日期关联是强旁证：「payment_timeout 指标在 2023-11-03 尖峰，重试逻辑 2023-11-06 合并。」

  4. 日志。收窄，不要倾倒。

    search_datadog_logs (raw log patterns near the target, set use_log_patterns=true)
    analyze_datadog_logs (SQL-style aggregations, only when you need counts)

    用符号、错误字符串或功能名搜索。强烈建议限定时间（如变更前后 30 天）。日志量巨大。无约束搜索费时间且可能超时。

  5. APM span 与 trace。

    aggregate_spans    (stats: "how often does this endpoint fail?")
    search_datadog_spans (inspect individual spans)
    get_datadog_trace  (a specific trace ID)

    适用于超时、重试、慢路径、跨服务行为。

  6. 事故。

    search_datadog_incidents (by title, team, date range)
    get_datadog_incident     (full detail for a specific incident)

    若目标看起来防御性，搜添加前后的事故。时间线含「为 X 加防御检查」的事故接近直接证据。

这里怎样算好证据

Section titled “这里怎样算好证据”
  • monitor 查询与阈值匹配代码所强制约束（代码限制到 100，monitor 在请求超 100/min 告警）
  • 目标作者创建的仪表盘，组件对应代码测量或防护的内容
  • 合并前生产尖峰、合并后稳定的指标
  • 引用目标代码、同符号或同错误串的事故记录
  • 防御代码会阻止的错误模式日志，时间戳在变更前窗口

常见陷阱

Section titled “常见陷阱”
  • 相关不等于因果。 尖峰在前、PR 后稳定有提示性，非定论。同窗口可能有其他变更。查邻近 PR。
  • 过度贴合找到的图。 Datadog 可视化由人做，反映该人的表述角度 。「retry success rate」图证明团队在意重试成功，非证明某行代码因此存在。
  • 遥测消失。 指标可改名、删除或保留期短。相关窗口无数据是缺口，非空结果。
  • 规模噪声。 搜常见字符串返回大量匹配。 积极 按 service、tag、时间收窄。用 analyze_datadog_logs 聚合而非倾倒原始日志。
  • 有埋点不等于因此添加。 指标存在说明有人在意测量，非说明代码因它而加。与 commit/PR 日期交叉引用。

要返回什么

Section titled “要返回什么”

每项相关条目：

  • 类型（仪表盘 / 监控 / 指标 / 日志模式 / 追踪 / 事故 / 笔记本）
  • 标题或名称
  • 链接或标识（dashboard ID、monitor ID、指标名、incident ID）
  • 所有者/作者与创建/修改日期
  • 与问题相关的具体条件、查询或引用（尽可能逐字）
  • 相关性：对目标代码暗示什么，连接强度如何

本站是非官方的 pstack 中文学习站，和 poteto 没有隶属关系。译文对照的是 cursor/plugins 仓库里的 pstack/ 目录。本站不发行中文版插件。 github.com/cursor/plugins