Rend le comportement des automatisations VISIBLE et diagnosticable — logs structurés JSON, compteurs de fin de run, heartbeats, alertes sur seuil — pour les timers systemd, tâches planifiées, pipelines de veille et scripts maison. À utiliser quand on ajoute du logging ou de l'alerting, quand on déploie une automatisation et qu'il faut prouver qu'elle tourne, ou quand un incident survient sans trace exploitable. Déclencheurs : "ajoute des logs", "comment savoir si ça tourne", "instrumente…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Observabilité & instrumentation
Objectif : répondre à « ça a tourné, et qu'a-t-il fait ? » SANS relancer. Règles citées (R34 : tout
artefact opérationnel est inscrit au vault ; R48 : logging de session ; R71 : exit 0 seulement si
l'effet annoncé a eu lieu) — définitions dans `${CLAUDE_PLUGIN_ROOT}/references/regles.md`.
## Les 3 questions de toute automatisation
1. **A-t-elle tourné ?** — dernière exécution, succès/échec, durée.
2. **Qu'a-t-elle produit ?** — compteurs : N traités, N ignorés, N erreurs.
3. **Qu'est-ce qui a cloché ?** — erreurs avec contexte (fichier, entrée, exception), pas juste un code.
## Pratiques
- **Log structuré** : une ligne JSON par événement, horodatage ISO 8601 UTC, append-only, flush
immédiat. Squelette prêt à copier : `scripts/structlog_snippet.py` (stdlib, ~60 lignes ;
`python3 structlog_snippet.py --demo` pour voir la sortie).
- **Événements minimaux** : `run_start` (paramètres), `run_end` (compteurs + durée), `error`
(contexte + exception), `skip` (raison). Nommer les événements en snake_case stable — c'est ce
qu'on grep.
- **Heartbeat** pour les services longs : un événement `heartbeat` toutes les N minutes, ou un fichier
…
The line at the top of this page pins the label v1.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_chf7mtor3favudez
GET https://markdownregistry.com/api/v1/resolve?ref=geekfamilycorp/tricorderkit/observability-and-instrumentation
GET https://markdownregistry.com/api/v1/blob/80f8becff923a2cdd098562a4faf4828bbf293d3b80a0ad40134cca2e08fb52a
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
geekfamilycorp/tricorderkit · .claude/skills/vault-token-optimizer/SKILL.md · Optimize any Markdown or Obsidian vault for Claude Code by analyzing structure first, generating manifests, routing…
geekfamilycorp/tricorderkit · cowork-plugins/tk-agent-security/skills/agent-config-audit/SKILL.md · Audit de sécurité en lecture seule de la CONFIGURATION DE L'AGENT lui-même (pas de l'application) — serveurs MCP et…
geekfamilycorp/tricorderkit · cowork-plugins/tk-data-ops/skills/graphrag-hybrid/SKILL.md · Répond à une question par recherche hybride locale : similarité vectorielle dans Qdrant, puis expansion du voisinage…
geekfamilycorp/tricorderkit · cowork-plugins/tk-data-ops/skills/neo4j-graph-ops/SKILL.md · Interroge et fait évoluer le graphe de connaissances Neo4j d'une stack locale (APOC/GDS) via le serveur MCP officiel…
geekfamilycorp/tricorderkit · cowork-plugins/tk-data-ops/skills/scrape-adaptive/SKILL.md · Collecte des pages web de façon robuste et respectueuse avec Scrapling (BSD-3 : parseur adaptatif qui retrouve un…
geekfamilycorp/tricorderkit · cowork-plugins/tk-data-ops/skills/watch-changes/SKILL.md · Met en place et exploite une veille de changements de pages et de flux, en local : changedetection.io (Apache-2.0…
geekfamilycorp/tricorderkit · cowork-plugins/tk-dev-discipline/skills/code-corrector/SKILL.md · Corrige et durcit le code d'une application web de façon disciplinée et mesurée. À utiliser quand l'utilisateur veut…
geekfamilycorp/tricorderkit · cowork-plugins/tk-dev-discipline/skills/debugging-and-error-recovery/SKILL.md · Débogage discipliné par cause racine pour scripts Python, VPS (systemd/Docker/SFTP), pipelines de veille et…
addyosmani/agent-skills · skills/observability-and-instrumentation/SKILL.md · Instruments code so production behavior is visible and diagnosable. Use when adding logging, metrics, tracing, or…
sandbaseai/sandbase-skills · marketing/observability-and-instrumentation/SKILL.md · Plan, implement, or review observability and instrumentation work in an existing codebase with compatibility, security…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/codex/.agents/skills/observability-and-instrumentation/SKILL.md · Instruments code so production behavior is visible and diagnosable. Use when adding logging, metrics, tracing, or…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/skills/observability-and-instrumentation/SKILL.md · Instruments code so production behavior is visible and diagnosable. Use when adding logging, metrics, tracing, or…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-cursor/.cursor/skills/observability-and-instrumentation/SKILL.md · Instruments code so production behavior is visible and diagnosable. Use when adding logging, metrics, tracing, or…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-codex/.agents/skills/observability-and-instrumentation/SKILL.md · Instruments code so production behavior is visible and diagnosable. Use when adding logging, metrics, tracing, or…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/cursor/.cursor/skills/observability-and-instrumentation/SKILL.md · Instruments code so production behavior is visible and diagnosable. Use when adding logging, metrics, tracing, or…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-claude/.claude/skills/observability-and-instrumentation/SKILL.md · Instruments code so production behavior is visible and diagnosable.