技能注册表
开发工作流公共技能

Observability & Monitoring

面向 AI 代理的全栈可观测性 — 通过 Datadog、Grafana 或 New Relic 调试日志错误,追踪服务间延迟,管理告警,使用运行手册响应事件,并保护 SLO 错误预算。

此技能教授的内容

针对特定工作类型的可复用操作手册。

MCP 服务器告诉代理可用的操作。技能为这些操作添加判断:如何识别任务,遵循哪个顺序,避免什么,以及如何判断结果已完成。

协调全栈可观测性 — 查询日志、搜索追踪、监控指标、管理告警、处理事件、跟踪 SLO、执行运行手册。适用于调试错误、调查延迟、检查服务健康、管理告警、响应事件、审查 SLO 消耗率或查找运行手册时使用。

架构

Observability & Monitoring 如何指导 ADK-Rust 代理。

技能保持可读和可移植,因为它包含说明而非服务凭证或业务数据。ADK-Rust 将其提供给代理,代理从审核过的工具边界中选择,连接的 MCP 服务器执行经过身份验证的操作。

01

用户请求

代理接收以普通语言表达的目标。

02

Observability & Monitoring 技能

匹配意图,提供决策指南,并缩小工具边界。

03

ADK-Rust 代理

规划工作流,并通过运行时流式传输每个关键步骤。

04

mcp-observability

对拥有该能力的系统执行经过身份验证的操作。

05

已验证结果

技能的完成规则决定返回给用户的证据。

可移植的说明: SKILL.md · 能力边界: mcp-observability · 允许的工具: 28

决策指南

代理如何将请求转化为正确操作。

这些路由直接来自技能说明。它们帮助模型识别意图并选择专注的工具或工作流,而不是在整个能力范围内即兴发挥。

01

“错误”,“异常”,“500”,“失败”?

工作流 1:调试错误

02

“慢”,“延迟”,“超时”,“p99”?

工作流 2:追踪延迟

03

“健康”,“CPU”,“内存”,“磁盘”?

工作流 3:系统健康

04

“告警”,“触发”,“呼叫”?

工作流 4:告警管理

05

“事件”,“故障”,“宕机”?

工作流 5:事件响应

06

“SLO”,“错误预算”,“可靠性”?

工作流 6:SLO 跟踪

07

“仪表盘”,“概览”?

工作流 7:仪表盘

08

不确定?

先获取系统健康以了解整体情况

经过验证的工作流

可重复的序列以实现有用结果。

工作流将多个工具调用组合成用户实际识别的任务。技能解释顺序和预期结果,而 ADK-Rust 通过共享运行时实时传输代理的进度。

013-4 次调用

调试错误

日志 → 跟踪 → 根因

023-4 次调用

追踪延迟

定位慢的跨度

031-2 次调用

系统健康

CPU/内存/磁盘概览

042-3 次调用

告警管理

分诊 + 运行手册 + 确认

053-4 次调用

事件响应

声明 + 调查 + 解决

062-3 次调用

SLO 跟踪

剩余预算 + 预测

工具边界

技能可能使用 28 个已记录工具。

此允许列表由技能声明。它使代理专注于完成此任务所需的操作,而 mcp-observability 保留身份验证、验证和连接系统的责任。

query_logs
get_log_stats
get_errors
tail_logs
query_metric
list_metrics
get_system_health
compare_metrics
search_traces
get_trace
get_service_map
get_latency_breakdown
list_alerts
get_alert
create_alert
acknowledge_alert
list_incidents
get_incident
create_incident
update_incident
list_slos
get_slo
forecast_slo
list_dashboards
get_dashboard
get_runbook
list_services
get_service

工作规则

代理应做什么。

  • 遵循决策指南,使用声明的工具边界,并在响应前验证结果。

操作边界

代理应避免什么。

  • 启用此技能进行生产工作前,请完整阅读 SKILL.md。

安装并连接

将技能添加到其预期能力旁边。

安装仓库,使您的 ADK-Rust 技能加载器能发现它,连接 mcp-observability,并确认声明的工具可用后,再让代理使用工作流。

安装技能
git clone https://github.com/zavora-ai/skill-observability-monitoring.git \
  ~/.skills/skills/observability-monitoring
ADK-Rust 加载形态
let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("observability-monitoring").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

仓库的兼容性声明:需要连接 mcp-observability 服务器(Datadog、Grafana Cloud、New Relic 或自定义 API)。

源记录

此技能条目的仓库元数据。

查看公共仓库 ↗
许可证
Apache-2.0
允许的工具
28
参考文献
3
修订
c7be5def736b
已更新
2026年5月31日