SuperAPI AI 工具集

service-remapping

智能体与模型

查看项目

更新于 10-15 20:33

技能介绍

用途:创建和管理 Datadog APM 服务重映射规则,在数据摄入时重写服务名,用于合并推断出的噪声实体、去除名称中的环境或版本后缀、按环境拆分服务,以及组织或产品更名后对齐名称。

主要能力:支持两类实体,SERVICE(rule_type 0,来自 tracer 显式设置 service 标签的插桩服务)与 INFERRED_ENTITY(rule_type 1,由出站调用自动推断,依赖 peer.service)。过滤使用标准事件语法,支持精确匹配、通配符及 AND/OR,不支持 CIDR、数值比较与模糊匹配。新名称可用静态字符串、标签插值 {{service}} 或带正则捕获的标签表达式,正则最多一个捕获组且须用非贪婪量词。内置五种模式:N:1 合并、去前后缀、1:1 重命名、按环境拆分、前缀规范化。

使用方式:先安装并认证 pup-cli(brew tap datadog-labs/pack;brew install pup;pup auth status;pup auth login)。创建、更新、删除需设置 DD_API_KEY、DD_APP_KEY、DD_SITE,读取可用 OAuth。发现现有服务名可用 pup apm services list 与 pup traces search。创建示例:pup apm service-remapping create --name "<RULE_NAME>" --filter "<FILTER>" --rule-type <TYPE> --value "<TARGET_NAME>"。更新、删除需提供版本号,读取用 list 与 get。

限制:重映射推断实体须确保插桩服务设置 DD_TRACE_PEER_SERVICE_DEFAULTS_ENABLED=true,否则规则不生效;集成自动生成的覆盖名称(如 grpc-client、redis)不适用此规则,需在 UI 中处理。重映射后监控、仪表盘、指标生成规则、保留过滤器和 SLO 等不会自动更新,需手动检查。规则生效约需 2 至 5 分钟,推断实体不产生独立 span,需在服务地图中确认。