[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78CYSC6NGD2VWQPRWMV0PM7":3,"skill-same:01M78CYSC6NGD2VWQPRWMV0PM7":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":35,"ownerHtmlUrl":36,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":37,"install":38,"resources":51},"01M78CYSC6NGD2VWQPRWMV0PM7","monitoring",null,"Prometheus metrics, Grafana dashboards, alert rules, ServiceMonitor wiring, and endpoint instrumentation. NOT for logs\u002Ftraces (belong to observability) and NOT for Helm health probes.","atretyak1985\u002Fswarmery","atretyak1985","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1436737?v=4","01M78CTSX57YH0EYY9YGH0TWKX","Andrii Tretiak","01M78CTSXRPJPYQ7GNPMP45TYX",8,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fatretyak1985\u002Fswarmery\u002Fblob\u002Fmain\u002Fplugins\u002Fcore\u002Fskills\u002Fmonitoring\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: monitoring\ndescription: \"Prometheus metrics, Grafana dashboards, alert rules, ServiceMonitor wiring, and endpoint instrumentation. NOT for logs\u002Ftraces (belong to observability) and NOT for Helm health probes.\"\nversion: \"1.0.0\"\nowner: \"swarmery-core\"\ndocs:\n  status: reviewed\n  source_sha: 8d2277869557\n  updated: 2026-08-06\n---\n\n# Purpose\n\nDefine, instrument, and verify Prometheus metrics, Grafana dashboards, and alert rules across the project's platform. Produce metric definitions, dashboard JSON, alert rule YAML, and ServiceMonitor resources that connect instrumentation to Prometheus scraping. Placeholders `\u003CmainApp>`, `\u003Cdevice>`, and `\u003Cproject>` (metric prefix) resolve from `project.json`.\n\n# Rules\n\n- Metric names follow `\u003Cproject>_{subsystem}_{unit}_{suffix}` (e.g. `myproject_telemetry_latency_seconds`).\n- Never hardcode label values like `device_id` — labels use runtime variables only.\n- Every alert rule MUST carry a `for:` duration, or it fires on single-sample spikes.\n- Label cardinality stays bounded — never request paths, user IDs, or trace IDs as labels.\n- Metrics without ServiceMonitor\u002Fscrape wiring are never collected — always wire the scrape path and run `helm lint` on chart changes.\n- Metrics, dashboards, and alerts only: \"add logging\u002Ftracing\" belongs to `observability`; Helm health probes belong to the project's infra pack skills.\n\n# Resources\n\n- Read `resources\u002Finstrumentation-procedure.md` when instrumenting a service — environment, inputs\u002Foutputs, and the six-step procedure with TypeScript\u002FPython code, ServiceMonitor YAML, alert rules, and verification checkpoints.\n- Read `resources\u002Fpromql-and-alerts-reference.md` when writing panels or alerts, or when something misbehaves — golden-signals PromQL, self-check, common mistakes, escalation, examples, failure modes.\n\n# How to use\n\n## What it does\n\nCovers Prometheus metrics work end to end: picking metric type and name, instrumenting service code in TypeScript or Python, wiring the scrape path so Prometheus actually collects the series, writing alert rules that survive transient spikes, building Grafana panels, and verifying the metric exists before calling the work done.\n\n## When to use it\n\n- Adding a counter, histogram, or gauge and wanting naming and label rules right the first time.\n- A metric is defined in code but never shows up in Prometheus — suspect scrape wiring.\n- New alert rules with consistent thresholds, `for:` durations, and severities; or golden-signal PromQL for a dashboard.\n- Investigation starting from a Prometheus alert (log\u002Ftrace-first investigations start with `observability`).\n\n## How to invoke\n\n```\nSkill(skill: \"core:monitoring\")\n```\n\nInvoke before writing the first metric line; follow the six steps in order, clearing each checkpoint. Required inputs: target service and metric intent. Optional: alert thresholds (SLOs) and an existing dashboard path to extend.\n\n## Worked example\n\n```\nSkill(skill: \"core:monitoring\")\n\n\"Add a histogram for order line-item processing latency in orders\u002Fline-items,\nalert when p95 goes above 500 ms.\"\n```\n\nYou get a `Histogram` with explicit buckets and bounded labels, a ServiceMonitor pointing at the metrics path, an alert with `expr: histogram_quantile(0.95, ...) > 0.5` and a `for: 5m` guard, one Grafana latency panel, plus verification evidence: a `helm lint` pass and curl output showing the new `_bucket` series.\n","# Purpose\n\nDefine, instrument, and verify Prometheus metrics, Grafana dashboards, and alert rules across the project's platform. Produce metric definitions, dashboard JSON, alert rule YAML, and ServiceMonitor resources that connect instrumentation to Prometheus scraping. Placeholders `\u003CmainApp>`, `\u003Cdevice>`, and `\u003Cproject>` (metric prefix) resolve from `project.json`.\n\n# Rules\n\n- Metric names follow `\u003Cproject>_{subsystem}_{unit}_{suffix}` (e.g. `myproject_telemetry_latency_seconds`).\n- Never hardcode label values like `device_id` — labels use runtime variables only.\n- Every alert rule MUST carry a `for:` duration, or it fires on single-sample spikes.\n- Label cardinality stays bounded — never request paths, user IDs, or trace IDs as labels.\n- Metrics without ServiceMonitor\u002Fscrape wiring are never collected — always wire the scrape path and run `helm lint` on chart changes.\n- Metrics, dashboards, and alerts only: \"add logging\u002Ftracing\" belongs to `observability`; Helm health probes belong to the project's infra pack skills.\n\n# Resources\n\n- Read `resources\u002Finstrumentation-procedure.md` when instrumenting a service — environment, inputs\u002Foutputs, and the six-step procedure with TypeScript\u002FPython code, ServiceMonitor YAML, alert rules, and verification checkpoints.\n- Read `resources\u002Fpromql-and-alerts-reference.md` when writing panels or alerts, or when something misbehaves — golden-signals PromQL, self-check, common mistakes, escalation, examples, failure modes.\n\n# How to use\n\n## What it does\n\nCovers Prometheus metrics work end to end: picking metric type and name, instrumenting service code in TypeScript or Python, wiring the scrape path so Prometheus actually collects the series, writing alert rules that survive transient spikes, building Grafana panels, and verifying the metric exists before calling the work done.\n\n## When to use it\n\n- Adding a counter, histogram, or gauge and wanting naming and label rules right the first time.\n- A metric is defined in code but never shows up in Prometheus — suspect scrape wiring.\n- New alert rules with consistent thresholds, `for:` durations, and severities; or golden-signal PromQL for a dashboard.\n- Investigation starting from a Prometheus alert (log\u002Ftrace-first investigations start with `observability`).\n\n## How to invoke\n\n```\nSkill(skill: \"core:monitoring\")\n```\n\nInvoke before writing the first metric line; follow the six steps in order, clearing each checkpoint. Required inputs: target service and metric intent. Optional: alert thresholds (SLOs) and an existing dashboard path to extend.\n\n## Worked example\n\n```\nSkill(skill: \"core:monitoring\")\n\n\"Add a histogram for order line-item processing latency in orders\u002Fline-items,\nalert when p95 goes above 500 ms.\"\n```\n\nYou get a `Histogram` with explicit buckets and bounded labels, a ServiceMonitor pointing at the metrics path, an alert with `expr: histogram_quantile(0.95, ...) > 0.5` and a `for: 5m` guard, one Grafana latency panel, plus verification evidence: a `helm lint` pass and curl output showing the new `_bucket` series.\n",{"docs":24,"name":5,"owner":28,"version":29,"description":7},{"status":25,"updated":26,"source_sha":27},"reviewed",1785974400000,"8d2277869557","swarmery-core","1.0.0","main","2d9e918cc79c9b17b59356780ff0a3da38a3e98a","plugins\u002Fcore\u002Fskills\u002Fmonitoring",5,"https:\u002F\u002Fgithub.com\u002Fatretyak1985\u002Fswarmery","https:\u002F\u002Fatretyak1985.github.io\u002Fswarmery\u002F","https:\u002F\u002Fgithub.com\u002Fatretyak1985","2026-11-11 04:29:12",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add atretyak1985\u002Fswarmery --skill monitoring",{"tool":44,"command":45},"bunx","bunx skills add atretyak1985\u002Fswarmery --skill monitoring",{"tool":47,"command":48},"pnpm","pnpm dlx skills add atretyak1985\u002Fswarmery --skill monitoring","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fatretyak1985\u002Fswarmery\u002Fblob\u002Fmain\u002Fplugins\u002Fcore\u002Fskills\u002Fmonitoring\u002FSKILL.md",true,[52,58],{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"resources\u002Finstrumentation-procedure.md","REFERENCE","参考文档",5955,"https:\u002F\u002Fgithub.com\u002Fatretyak1985\u002Fswarmery\u002Fblob\u002Fmain\u002Fplugins\u002Fcore\u002Fskills\u002Fmonitoring\u002Fresources\u002Finstrumentation-procedure.md",{"path":59,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":60,"sourceHtmlUrl":61},"resources\u002Fpromql-and-alerts-reference.md",4871,"https:\u002F\u002Fgithub.com\u002Fatretyak1985\u002Fswarmery\u002Fblob\u002Fmain\u002Fplugins\u002Fcore\u002Fskills\u002Fmonitoring\u002Fresources\u002Fpromql-and-alerts-reference.md",[63,70,76,83,90,97],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M78D4T1FFWFW19Z44AHH5BSY","short-desc","Too short.","https:\u002F\u002Fgithub.com\u002Fatretyak1985\u002Fswarmery\u002Fblob\u002Fmain\u002Ftools\u002Fswarmery\u002Ftestdata\u002Fsysconfig\u002Fclaude\u002Fskills\u002Fshort-desc\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M78D4S0TWT42WXFJHC1DBN0R","no-frontmatter","https:\u002F\u002Fgithub.com\u002Fatretyak1985\u002Fswarmery\u002Fblob\u002Fmain\u002Ftools\u002Fswarmery\u002Ftestdata\u002Fsysconfig\u002Fclaude\u002Fskills\u002Fno-frontmatter\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M78D4Q14P8DJ4W78N62F3EG2","global-skill","Fixture global skill (minimal user-scope shape, format doc §2.3).","https:\u002F\u002Fgithub.com\u002Fatretyak1985\u002Fswarmery\u002Fblob\u002Fmain\u002Ftools\u002Fswarmery\u002Ftestdata\u002Fsysconfig\u002Fclaude\u002Fskills\u002Fglobal-skill\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M78D4N1JHGQJQ7EZ43KY5SV3","documented-skill","Fixture skill whose usage guide deliberately omits the Worked example subsection.","https:\u002F\u002Fgithub.com\u002Fatretyak1985\u002Fswarmery\u002Fblob\u002Fmain\u002Ftools\u002Fswarmery\u002Ftestdata\u002Fsysconfig\u002Fclaude\u002Fskills\u002Fdocumented-skill\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M78D4KVNZ03GBKGDFJZWW5FJ","z","NOT auto-discovered — only skills\u002F is scanned for plugins (§2.2).","https:\u002F\u002Fgithub.com\u002Fatretyak1985\u002Fswarmery\u002Fblob\u002Fmain\u002Ftools\u002Fswarmery\u002Ftestdata\u002Fsysconfig\u002Fclaude\u002Fplugins\u002Fcache\u002Fmkt\u002Ftoolpack\u002F1.0.0\u002Fworkflow-skills\u002Fz\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M78D4JMBRZWK51HFE5RZJGHC","y","Plugin skill y from toolpack — stored as \"toolpack:y\".","https:\u002F\u002Fgithub.com\u002Fatretyak1985\u002Fswarmery\u002Fblob\u002Fmain\u002Ftools\u002Fswarmery\u002Ftestdata\u002Fsysconfig\u002Fclaude\u002Fplugins\u002Fcache\u002Fmkt\u002Ftoolpack\u002F1.0.0\u002Fskills\u002Fy\u002FSKILL.md",[],[]]