New Relic NRQL 查询代理

解决什么问题

运维工程师在 New Relic 中排查性能问题时，常需要从仪表盘复制查询语句、手动调整时间窗口、计算分位数，再打开表格逐段统计。当团队开始关注 SLA 时，这类临时操作会变得重复且容易出错：不同工程师对 P95 的统计口径可能不一致，错误预算的消耗进度也难以及时同步。

技能如何工作

该技能面向 New Relic 的 GraphQL NerdGraph API，核心流程分为三步：

• 查询构建：根据用户提供的应用名称、时间窗口和指标目标，组装对应的 NRQL 查询语句，例如 SELECT percentile(duration, 95) FROM PageView FACET transactionName。
• 数据提取：通过 NerdGraph API 提交查询，获取原始的事件行数据或聚合结果。
• 报告生成：对返回的延迟数据按分位数拆解，结合目标可用性阈值计算剩余错误预算，最终输出结构化的 SLA 报告。

适用边界与注意点

• 技能直接调用 New Relic 官方 API，需要有效的 NEW_RELIC_API_KEY 和正确的 account ID；凭证缺失或权限不足时，查询会在 NerdGraph 层返回错误。
• NRQL 语法有固定的关键词和子句顺序，复杂查询建议先在 New Relic 的 Query your data 抽屉中调试通过，再交给代理执行。
• 分位数计算依赖数据点的分布，当时间窗口内事件稀疏时，P99 等高阈值结果可能波动较大，需要结合 SAMPLES 子句判断统计可靠性。
• 该技能不修改 New Relic 账户内的任何配置，只执行只读查询；如需写入元数据或创建仪表盘，仍需通过其他 API 完成。