SuperAPI AI 工具集

datadog

部署与运维

查看项目

更新于 10-16 01:36

技能介绍

用途:本技能用于通过 Datadog Logs API 调查 Nexu 平台的生产问题,可查询日志、崩溃日志、告警与指标等。

认证:调用任何 Datadog API 前必须先向用户索取两个密钥:DD_API_KEY(Datadog API Key)与 DD_APP_KEY(Datadog Application Key,需要 logs_read_data 权限)。将其存入当前会话的 shell 变量,切勿硬编码或提交。站点为 datadoghq.com(US)。

主要能力与用法:所有请求发往 https://api.datadoghq.com/api/v2/logs/events/search,请求头包含 DD-API-KEY、DD-APPLICATION-KEY 与 Content-Type: application/json。常见查询包括:OpenClaw 崩溃事件(query: service:nexu-gateway @event:openclaw_crash)、OpenClaw stderr 输出(@stream:stderr,可看到 invalid_auth、EADDRINUSE、配置校验失败等)、网关启动/恢复事件("starting gateway" OR "gateway is ready" OR "spawned openclaw")、Slack Token 健康检查(slack_token_health*)、API HTTP 请求错误(http_request @attributes.status:>=500)。可按 pod_name:<name> 过滤单个 Pod,时间窗口支持 ISO 8601 或相对写法如 now-1h、now-30m、now-24h。结果建议用 python3 内联解析,提取 time、pod_name、message 等字段并汇总。

排查流程(Playbook):先查崩溃事件获取退出码、信号、时间戳与受影响 Pod;再查 stderr 获取实际错误信息;接着查启动事件,用 image_tag 变化与部署时间对齐;若出现 invalid_auth,则查 slack_token_health_check_invalidated;最后结合 API 日志判断是否有关联错误。

服务与事件:服务含 nexu-gateway(网关 sidecar,管理 OpenClaw 进程)与 nexu-api(API 服务器);事件含 openclaw_crash、openclaw_restart_scheduled、openclaw_restart_limit、openclaw_orphan_killed、slack_token_health_check_invalidated。标签含 pod_name、image_tag、kube_stateful_set。

限制与规则:不要硬编码 API 密钥;默认时间窗口从 now-1h 开始,必要时扩展到 now-24h;始终解析并汇总结果,不要向用户输出原始 JSON;需跨服务关联信息;通过 image_tag 判断崩溃是否与特定部署相关。未提供更多收费、平台支持与配额等信息。