后端与接口
在 Grafana Cloud 中启用…
当你在 Grafana Cloud 上需要无静态阈值异常告警、自然语言查询与面板生成、自动化事故根因调查,或为插件接入托管 LLM 时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
在 Grafana Cloud 中启用 特定
解决思路
- 创建 Dynamic Alerting 预测任务:用 curl 向 https://<stack>.grafana.net/api/plugins/grafana-ml-app/resources/ml/v1/forecast 发 POST,带 Authorization: Bearer <token> 和 Content-Type: application/json;body 中设置 name(如 cpu-forecast)、metric(如 avg(rate(node_cpu_seconds_total{mode="user"}[5m])))、datasourceId、interval、trainingWindow、forecastWindow、algorithm.name 为 prophet。
- 等待任务产生预测值指标后验证:查询 https://<stack>.grafana.net/api/datasources/proxy/<datasourceId>/api/v1/query?query=ml_forecast_upper{job="cpu-forecast"},用 jq '.data.result | length',期望 > 0;<datasourceId> 必须与创建任务时一致,可通过 GET /api/datasources 查找,或直接在 Explore 中运行查询。
- 添加预测告警:设置 expr 为 avg(rate(node_cpu_seconds_total{mode="user"}[5m])) > ml_forecast_upper{job="cpu-forecast"} * 1.1,使实际值超过预测上界时触发。
- 创建 outlier 任务:用 curl 向 https://<stack>.grafana.net/api/plugins/grafana-ml-app/resources/ml/v1/outlier 发 POST,带 Authorization 和 Content-Type;body 中设置 name(如 service-error-outliers)、metric(如 sum(rate(http_requests_total{status=~"5.."}[5m])) by (service))、datasourceId、interval、algorithm.name 为 dbscan、sensitivity 为 0.5、config.epsilon 为 0.5。
- 验证 outlier 评分指标存在:查询 https://<stack>.grafana.net/api/datasources/proxy/<datasourceId>/api/v1/query?query=ml_outlier_score{job="service-error-outliers"},用 jq '.data.result | length';<datasourceId> 必须与创建任务时一致,或从 Explore 运行查询。
- 添加 outlier 告警:当 ml_outlier_score{job="service-error-outliers"} > 0.8 持续 5m 时触发。
- 触发 Sift 调查:用 curl 向 https://<stack>.grafana.net/api/plugins/grafana-sift-app/resources/sift/v1/investigations 发 POST,带 Authorization 和 Content-Type;body 设置 name(如 checkout-spike)、start、end、filters(如 service: checkout、namespace: production);也可从 Explore / Incident / OnCall 触发。
- 打开 Sift 调查结果:从响应中获取 investigation ID,打开 https://<stack>.grafana.net/a/grafana-sift-app/investigations/<id>。
- 验证 Sift 分析已运行:确认 8 项检查每项显示 ✔ 或 ✖,并带 linked evidence;完整 8-analysis 表见 references/sift.md。
- 配置 LLM Plugin:在 provisioning/plugins/llm.yaml 中写入 apiVersion: 1,apps 下 type: grafana-llm-app,jsonData 设置 openAIUrl: https://api.openai.com、openAIModel: gpt-4o,secureJsonData 设置 openAIKey: sk-...;具体见 references/llm-and-graph.md;按所选 provider(OpenAI / Anthropic / Azure / Ollama / vLLM / LiteLLM)配置对应 provider 字段。
- 重启 Grafana 后验证 LLM Plugin:curl -s -H "Authorization: Bearer <token>" https://<stack>.grafana.net/api/plugins/grafana-llm-app/health | jq,期望返回 {"status":"ok", ...},并报告已配置的 provider。
- 在面板中验证 Assistant:打开任意 panel,点击 Assistant 图标,问 "what does this query do?"。
- 参阅 references/llm-and-graph.md 获取 Assistant 能力、Knowledge Graph 搜索语法和 Adaptive Metrics 建议。
适用边界 · 注意事项
- 没有 Grafana Cloud Pro/Advanced 栈时不适用;大多数功能需要该付费栈,部分功能仍为 preview。
- 缺少带 plugins:write 权限的 API token 时不适用;ML / Sift / LLM-plugin endpoints 需要该权限。
- Dynamic Alerting 目标指标没有至少 14 天(理想 90 天)历史时不适用或预测不可靠。