Agent Skills
› grafana/skills
grafana/skills
GitHub提供 grafana-app-sdk 中准入控制（验证与变更）的实现指南，涵盖 Validator 和 Mutator 接口定义、代码示例及 Webhook 注册方式。
Install All Skills
npx skills add grafana/skills --all -g -y
Skills in Collection (53)
Showing top 50 of 53 by quality score. Use the install list command or open individual skills for the rest.
提供 grafana-app-sdk 中准入控制（验证与变更）的实现指南，涵盖 Validator 和 Mutator 接口定义、代码示例及 Webhook 注册方式。
实现资源验证逻辑
编写准入控制器
添加 mutating webhook
在持久化前修改或校验资源
npx skills add grafana/skills --skill admission-control -g -y
Grafana Loki 标签策略专家评估器，用于审计、设计和优化标签方案。通过基数评分、访问模式对齐及一致性检查，解决查询慢和存储成本问题，提供结构化建议。
评估或审计 Loki 标签策略
设计或改进标签架构
诊断 Loki 查询性能缓慢原因
npx skills add grafana/skills --skill loki-label-analyzer -g -y
提供向 Grafana Cloud 发送遥测数据（指标、日志、追踪）的配置指南，涵盖 Alloy 管道、直接 SDK/Agent 集成及凭证管理。
配置 Grafana Cloud 数据接入
设置 Prometheus/Loki/Tempo 远程写入
排查数据发送失败问题
npx skills add grafana/skills --skill send-data -g -y
根据插件名称自动生成 Grafana 数据源的 IaC 配置（YAML/Terraform）。通过 API 解析插件 ID、版本及设置 Schema，将用户输入转换为标准化的数据源配置文件。
生成数据源 YAML 配置
创建 Terraform 资源以配置数据源
基于插件名称进行数据源代码化配置
npx skills add grafana/skills --skill datasources-provisioning -g -y
Grafana Loki日志聚合与LogQL查询技能。涵盖LogQL语法、架构、数据摄入及管道配置，用于编写查询、排障和日志分析。
编写LogQL查询语句
配置Loki或日志采集器
排查日志管道问题
分析结构化或非结构化日志
npx skills add grafana/skills --skill loki -g -y
使用profilecli查询Pyroscope性能数据，结合pprof和源码分析服务性能瓶颈。适用于用户请求调查配置了Pyroscope的服务时，定位CPU、内存等资源热点函数并提供优化建议。
用户请求分析服务性能问题
用户需要定位代码中的热点函数
用户要求查询Pyroscope性能配置文件
npx skills add grafana/skills --skill profilecli-insights -g -y
提供 Prometheus 和 Grafana Cloud 的指标概览，涵盖 PromQL 查询、告警配置、记录规则及集成模式，用于监控与可观测性任务。
编写 PromQL 查询语句
配置 Prometheus 告警规则
分析系统性能指标
排查基础设施监控问题
npx skills add grafana/skills --skill prometheus -g -y
该技能用于通过 pnpm 审计并缩减 JavaScript 依赖体积，保留锁文件和布局。流程包括运行检查门、移除未用依赖、去重版本、分析传递依赖闭环以推荐替换或移除，最终验证并报告影响。
清理 pnpm 依赖
减小 lockfile 大小
缩小 node_modules
npx skills add grafana/skills --skill audit-and-reduce-dependencies -g -y
对JS/TS项目的npm/yarn/pnpm配置进行供应链安全审计，检查工具版本、生命周期脚本禁用状态、不安全依赖协议及包最小发布年龄。
用户调用/check-npm命令
用户询问包管理器安全性、生命周期脚本或git依赖配置
npx skills add grafana/skills --skill check-npm -g -y
提供Grafana相关的专业知识，涵盖关键概念、常用模式及最佳实践。适用于用户询问Grafana配置、PromQL查询或监控指标相关问题时自动加载，聚焦于Grafana特有知识而非通用编程概念。
Grafana配置
PromQL查询
监控仪表盘设置
Grafana告警规则
npx skills add grafana/skills --skill your-skill-name -g -y
用于Grafana App SDK项目的脚手架初始化、部署模式选择及开发工作流指导。涵盖CLI安装、CUE Schema定义、代码生成及Reconciler逻辑实现，支持独立Operator和Grafana内嵌应用构建。
创建新的Grafana应用
Grafana App Platform入门
选择部署模式
SDK项目初始化
npx skills add grafana/skills --skill app-sdk-concepts -g -y
用于创建和管理 Grafana App SDK 中的 CUE Kind 定义，涵盖脚手架生成、版本管理、模式约束及代码生成。
添加新的资源类型
为现有 Kind 添加版本
编写 CUE 模式或字段约束
定义命名类型
模型化资源
npx skills add grafana/skills --skill cue-kind-definition -g -y
提供 Grafana App SDK 中 Reconciler 和 Watcher 的实现指南，涵盖类型安全控制器编写、事件处理、状态更新及注册流程。
实现 Reconciler 或 Watcher
编写控制器逻辑
处理资源创建/更新/删除事件
npx skills add grafana/skills --skill reconciler-logic -g -y
用于优化Grafana Cloud指标成本，通过自适应聚合规则降低活跃序列数。支持自动推荐、自定义标签丢弃、未使用指标检测及高基数治理，帮助用户减少账单支出。
调查高额Grafana Cloud账单
处理高基数标签（如pod_uid, version）
用户提及减少基数或指标支出
npx skills add grafana/skills --skill adaptive-metrics -g -y
管理Grafana Cloud账户，包括组织、Stack、RBAC角色、SSO配置及服务账号。支持通过API或Terraform进行资源供应和权限分配，适用于云基础设施的运维与自动化管理。
创建或管理Grafana Stack
配置SSO/SAML/OAuth认证
管理服务账号和API密钥
设置RBAC角色和团队权限
邀请用户和管理组织成员
npx skills add grafana/skills --skill admin -g -y
提供基于Grafana Cloud的应用、前端及AI可观测性配置指南，涵盖APM接入、Faro RUM集成及OpenLIT监控，支持链路追踪、性能分析及LLM成本监控。
配置APM和Alloy接收器
集成Faro前端监控SDK
监控LLM成本和延迟
排查服务地图缺失问题
npx skills add grafana/skills --skill app-observability -g -y
为AI编码助手配置Grafana MCP服务器，支持stdio和SSE传输。通过安装二进制、生成Token并修改IDE配置文件，实现Agent查询指标、管理告警等功能。
连接Claude Code到Grafana
在Cursor或VS Code中启用Grafana访问
配置MCP服务器以暴露Grafana工具
团队共享Grafana MCP服务
npx skills add grafana/skills --skill assistant-mcp -g -y
指导配置和故障排查 Grafana Cloud 与 AWS、Azure 等云提供商的集成，包括设置托管导出器、AWS Firehose 接收器及 IAM 权限。
连接 AWS CloudWatch
设置 Azure Monitor
配置 Confluent Cloud 可观测性
安装 Grafana 集成
设置托管导出器
使用 AWS Firehose
云指标或日志
npx skills add grafana/skills --skill cloud-integrations -g -y
用于优化Grafana Cloud账单，通过成本分摊、自适应指标/日志/追踪降采样及配额告警降低遥测消耗。
Grafana Cloud账单过高
按团队或服务分摊可观测性成本
减少活跃序列或日志字节数
设置用量或配额告警
npx skills add grafana/skills --skill cost-management -g -y
配置Grafana Cloud数据库可观测性，支持MySQL/PostgreSQL。自动采集查询样本、RED指标及执行计划，关联APM追踪以诊断慢查询，适用于各类托管或自建数据库实例的监控与告警设置。
监控数据库性能
诊断慢查询
设置RDS/Aurora等数据库的可观测性
用户表示数据库变慢或需要监控
npx skills add grafana/skills --skill database-observability -g -y
Grafana官方CLI工具，按每分钟数据点数(DPM)对Prometheus指标排名并分析基数，用于定位高成本指标、优化账单及排查高基数问题。
查询为什么Grafana Cloud账单过高
寻找消耗最大的Prometheus指标
分析高基数或嘈杂的指标
优化Prometheus使用成本
npx skills add grafana/skills --skill dpm-finder -g -y
管理Grafana Alloy采集器集群，通过OpAMP远程分发和热更新Pipeline配置。涵盖配置创建、属性匹配、语法校验及故障排查（如REMOTE_CONFIG_STATUS_FAILED），实现大规模采集器的集中式配置管理。
配置Alloy采集器
远程推送Pipeline配置
排查采集器健康状态
使用OpAMP管理Agent
验证River语法
npx skills add grafana/skills --skill fleet-management -g -y
用于诊断Grafana前端可观测性（RUM）会话的健康状况，分析错误原因并提供修复建议。通过gcx工具获取遥测数据，识别问题、时间戳及证据，支持后续深入分析如会话回放或Trace。
用户要求解释、诊断、分析或审查前端会话
询问会话是否健康
提供应用ID、会话ID和数据源UID等上下文
提及Faro、核心Web指标、异常或ANR
npx skills add grafana/skills --skill frontend-session-rca -g -y
用于将Kubernetes、主机、容器及云提供商的遥测数据接入Grafana Cloud，涵盖Helm部署、Alloy配置及多云指标拉取。
监控我的集群
发送K8s指标到Grafana
抓取EC2指标
安装监控helm chart
npx skills add grafana/skills --skill infrastructure -g -y
用于在Grafana Cloud中启用AI与ML功能，包括动态告警（Prophet/DBSCAN）、自然语言查询、自动根因分析（Sift）及LLM插件集成。适用于异常检测、智能排查和仪表盘生成场景。
需要基于历史数据的智能告警而非静态阈值
通过自然语言描述生成PromQL或仪表盘
自动化调查性能故障或事故的根因
将大语言模型接入Grafana进行辅助分析
npx skills add grafana/skills --skill ml-ai -g -y
用于配置Grafana OnCall/IRM，实现告警路由、值班轮换、升级链及Slack ChatOps。适用于接入Alertmanager、设置通知策略、管理排班表及处理P1-P4事件生命周期的场景。
配置告警路由规则
设置值班轮换排班
集成Alertmanager或PagerDuty
建立事件升级链
处理告警通知与自动恢复
npx skills add grafana/skills --skill oncall-irm -g -y
配置Grafana Cloud私有连接（如AWS PrivateLink），通过VPC端点实现遥测数据内网传输，避免公网暴露与出口费用，满足合规要求。
需要降低云网络出口费用
要求遥测数据不经过公网
需满足PCI-DSS或HIPAA合规
配置私有数据源查询
npx skills add grafana/skills --skill private-connectivity -g -y
针对Prometheus基数爆炸导致的性能、内存或成本问题的诊断指南。提供症状归因、TSDB状态检查及安全修复方案，适用于排查OOM、慢查询和高DPM账单等紧急情况。
Prometheus OOM或内存增长异常
PromQL查询缓慢或超时
Grafana Cloud DPM或Active Series费用激增
上报429 Too Many Samples错误
npx skills add grafana/skills --skill prometheus-cardinality-troubleshooter -g -y
评估、审计及设计 Prometheus 标签策略，预防高基数问题。提供结构化建议，指导在应用代码源头优化标签方案，避免错误丢弃唯一标识符导致数据损坏，确保指标准确性与存储成本可控。
评估或审计 Prometheus 标签架构
询问如何从源头防止高基数
设计或改进 Prometheus 标签规范
npx skills add grafana/skills --skill prometheus-label-strategy -g -y
用于编写Grafana Cloud合成监控检查，涵盖k6脚本和浏览器检查。指导用户正确配置断言、处理秘密、选择检查类型及部署验证，明确区分于负载测试。
编写合成监控检查
将k6脚本转换为检查
验证用户旅程可用性
npx skills add grafana/skills --skill synthetic-monitoring-checks -g -y
用于Grafana Cloud的测试技能，涵盖合成监控、k6分布式负载测试及Faro前端可观测性。支持多区域探针探测、发布门禁负载测试、TLS证书监控、RUM性能追踪及前后端链路关联。
检查网站或API在多地区的可用性
基于负载测试结果进行发布门禁
监控TLS证书过期
在React/Vue应用中集成前端遥测
追踪核心网页指标(Core Web Vitals)
将前端错误与后端链路关联
npx skills add grafana/skills --skill testing -g -y
配置Grafana告警、IRMS及SLO，涵盖通知渠道、路由策略、值班轮转和错误排查。用于设置监控规则、集成IRM系统或定义服务等级目标。
配置告警规则和通知策略
调试告警路由问题
设置值班轮转和升级链
定义和管理SLO指标
npx skills add grafana/skills --skill alerting-irm -g -y
用于构建统一遥测管道的Grafana Alloy技能，涵盖指标、日志、追踪采集及向Grafana Cloud等后端发送。支持配置编写、验证、调试及K8s/OTLP集成。
配置遥测管道
替换Grafana Agent或OTel Collector
调试Alloy发送问题
编写抓取配置
npx skills add grafana/skills --skill alloy -g -y
基于eBPF实现零代码应用可观测性，自动拦截HTTP/gRPC/DB流量并导出OTLP追踪与Prometheus指标。适用于无法修改源码或需集群级部署的场景。
添加不可重新编译服务的可观测性
对闭源二进制进行追踪
无需SDK的APM需求
在Kubernetes中部署DaemonSet以获取全链路监控
npx skills add grafana/skills --skill beyla -g -y
通过 HTTP API 构建、修改和发布 Grafana 仪表盘，支持面板配置、变量管理及数据转换，实现监控可视化的自动化编排。
创建新仪表盘或导出 JSON
添加服务下拉筛选变量
计算错误率等数据列
叠加部署事件注释
npx skills add grafana/skills --skill dashboarding -g -y
用于配置Grafana OSS，包括通过YAML自动部署仪表盘和数据源、管理RBAC角色、创建服务账户令牌、编辑配置文件及安装插件。支持验证配置并解决常见问题。
配置数据源
部署仪表盘
管理服务账户
设置SSO/OAuth
npx skills add grafana/skills --skill grafana-oss -g -y
指导使用 OpenTelemetry SDK、Beyla eBPF 或 JVM Agent 对 Go/Java/Python 等应用进行零代码或自动插桩，配置 OTLP 环境变量与认证，并通过 Alloy 收集器将指标、日志和追踪数据发送至 Grafana Cloud 或自建 Mimir/Loki/Tempo。
auto-instrument my Java app
send traces to Grafana
what env vars do I set
OTLP endpoint
Operator inject
debugging spans aren't showing in Explore
npx skills add grafana/skills --skill opentelemetry -g -y
PromQL查询编写、验证与优化技能。涵盖速率函数、聚合、直方图分位数、SLO计算及性能调优，支持查询修复和录制规则转换。
编写Prometheus查询
优化慢查询
计算错误率或延迟
排查基数膨胀
npx skills add grafana/skills --skill promql -g -y
提供 Grafana Agent SKILL.md 文件的编写、审查与优化指南。涵盖触发描述撰写、结构规范及通过 CI 门禁的评分标准，用于指导技能创建与改进。
用户请求如何编写或优化 Skill 文档
审查 Skill PR 或修复低分 Skill
重构长文档或解决触发问题
npx skills add grafana/skills --skill skill-authoring -g -y
将自然语言描述的用户旅程转化为经过实时浏览器探索验证的k6/browser功能或负载测试脚本，自动发现真实选择器并处理弹窗。
使用自然语言描述网站操作流程
需要编写基于浏览器的UI或负载测试
希望自动生成k6浏览器测试脚本
npx skills add grafana/skills --skill k6-browser-test -g -y
用于调查 Grafana Cloud k6 测试或运行结果。通过结构化流程获取脚本、历史、指标和日志，分析通过率并诊断失败原因。
用户提供 k6 测试或运行的 URL
询问测试是否通过或失败原因
请求展示特定运行的指标或日志
描述为“测试健康状态异常”或“检查失败但运行显示通过”
npx skills add grafana/skills --skill k6-cloud-investigate-test -g -y
用于编写、审查和验证 k6 相关文档，包括用户手册、发布说明及 TypeScript 类型定义。需确保代码示例在 master 分支运行无误，并遵循特定格式与规范。
编写 k6 文档
审查 k6 文档
生成 TypeScript 类型定义
起草发布说明
验证代码示例
npx skills add grafana/skills --skill k6-docs -g -y
提供 Grafana Cloud k6 的交互指南，支持通过 gcx CLI 或 curl 管理负载测试、脚本、项目及获取指标日志。涵盖认证、测试执行与数据查询，用于自动化性能测试运维任务。
用户询问 k6 测试结果失败原因
请求列出、创建、编辑或启动 k6 负载测试
需要获取特定运行实例的日志或指标
调整 k6 项目配额或调度设置
在本地或通过云端运行 k6 脚本
npx skills add grafana/skills --skill k6-manage -g -y
使用 k6 对公开网站进行端到端性能、负载和压力测试，生成混合测试套件、SLO 阈值及监控方案。
性能测试我的网站
压力测试这个 URL
我想对网站进行负载测试
为 [站点] 编写 k6 套件
npx skills add grafana/skills --skill k6-perf-test-website -g -y
维护和改进现有k6测试脚本，涵盖阈值调整、版本迁移、服务变更适配、代码重构及最佳实践审计。核心原则是行为感知变更控制，严格区分语法与行为变更，确保修改安全并通过验证循环。
修复失败的k6测试
收紧阈值
迁移到新版k6
重构测试脚本
服务变更后更新测试
应用最佳实践
npx skills add grafana/skills --skill k6-test-maintenance -g -y
分析 Grafana Cloud k6 测试的历史趋势，检测指标缓慢漂移和性能退化，计算阈值余量并推荐调整。适用于查询性能趋势、检查回归或评估测试健康状态。
用户询问测试性能趋势
检查 P95 延迟等指标是否恶化
请求进行性能回归检查
询问是否应收紧阈值
查看特定测试或多个测试的运行趋势
npx skills add grafana/skills --skill k6-trend-analysis -g -y
用于生成、验证和审查 k6 性能测试脚本，支持 HTTP、WebSocket、gRPC 及浏览器测试等场景。通过匹配示例文件并适配参数，自动执行脚本以校验正确性，适用于负载、压力及功能测试需求。
需要编写或生成 k6 性能/负载测试脚本
需要对现有 k6 测试脚本进行验证或调试
询问如何进行 API 或服务的压力测试
npx skills add grafana/skills --skill k6 -g -y
提供 Grafana Mimir 的部署、配置与运维指南，涵盖本地 Docker 启动、Kubernetes Helm 安装、Prometheus/Alloy 数据接入及多租户配置。支持水平扩展、长期存储、故障排查与性能调优，适用于大规模指标数据存储场景。
需要长期 Prometheus 存储
扩展 Prometheus 单节点限制
搭建多租户指标后端
替换 Cortex 方案
配置 remote_write 目标
Mimir 部署或调试
npx skills add grafana/skills --skill mimir -g -y
提供Grafana Pyroscope连续性能分析技能，涵盖多语言SDK集成、Alloy eBPF无侵入部署及ProfileQL查询。用于生成CPU/内存火焰图、定位热点与回归问题，关联Trace分析。
添加服务性能分析
部署集群级eBPF分析器
通过火焰图排查CPU或内存热点
对比两次分析结果查找回归
将慢速Trace与Profile关联
npx skills add grafana/skills --skill pyroscope -g -y
部署 Grafana Tempo 分布式追踪后端，配置 OTLP/Jaeger/Zipkin 数据摄入与对象存储。编写 TraceQL 查询以定位慢请求或错误链路，分析服务图、RED 指标及跨日志/画像关联，支持本地 Docker 验证与 K8s Helm 生产部署。
部署 Tempo 追踪后端
编写 TraceQL 查询慢请求或错误
排查 Explore 中无追踪数据问题
调整 Querier/Compactor 资源配置
配置 S3/GCS/Azure 块存储
建立追踪-日志-画像关联
npx skills add grafana/skills --skill tempo -g -y
