observability-standard SKILL.md skillA
observability-standard from martin1847/evolab is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add martin1847/evolab/observability-standard@v1.3.3Pins v1.3.3 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- martin1847/evolab
- Path
skills/observability-standard/SKILL.md- Versions recorded
- 8
- Latest version
- v1.3.3, committed Oct 29, 2026
- First version recorded
- Aug 6, 2026
- Size
- 14,822 bytes
- Repository stars
- 7
- License
- MIT
适用于编写或评审任何后端服务，包括普通服务与 agent/RAG 系统。覆盖日志、tracing、OpenTelemetry、上下文传播、日志级别、trace/log/DB 关联、边界类型及 LLM/工具/检索调用观测。用户说“加点日志”“接一下 trace / instrument this”“set up observability”“这个错误怎么查不到”“这个请求怎么追踪”也触发。.
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
# 可观测性与工程规范 ## 何时应用 写或评审**任何后端服务**的代码时应用 —— 普通微服务(auth / 网关 / 业务服务)与 agent / 多 agent / RAG 知识库项目一视同仁,尤其涉及:日志接入、OpenTelemetry 埋点、跨进程 context 传播、日志级别选择、跨 trace/log/db 排障、边界数据建模;**agent 场景额外**涉及编排与子 agent、LLM/工具/检索调用。Python / Go / Java / Rust 通用。即使用户只说"加点日志""接一下 trace""这个错查不到""这请求怎么追",也按本规范做。 ## 总纲 **用一条关联主线贯穿定位**:`trace_id` 串起 trace + log;业务库这一环靠**业务 id 同时挂成 span 属性(`order.id` / `run.id`)**双向关联,**不在业务行存 `trace_id`**(trace 受采样 / 短保留,持久行存它多半是死指针 —— 见 references §2.1)。定位永远是 `trace 或业务 id → 查 trace 看哪步 → 查 log 看为什么 → 按业务 id 查 db 看数据对不对`,不靠时间戳猜。 ## 五条铁律(所有服务,全部遵守) 1. **一次对外请求 = 一棵 trace**。入站请求 handler 是 root span,所有下游(DB / 缓存 / 跨进程调用 —— agent 场景下还有子 agent / LLM / 工具 / 检索)都是子 span。 2. **宽事件优先**:每步一条富字段结构化事件;事件名是稳定可聚合标识符,变量进字段;不写散文。 3. **三信号可关联**:每条 log 带 `trace_id`+`span_id`(随 trace 同采样 / 保留);**业务 id 挂成 span 属性**以按业务 id 反查 trace,**不往业务行加 `trace_id` 列**;需持久溯源处(AI 决策 / 金额 / 对客输出 / 合规)落自己拥有的 `correlation_id`,优先进专用审计 / outbox 表(见 references §2.1)。 4. **跨进程必传播 W3C `traceparent`**(HTTP / gRPC / 消息队列 / 任何 agent 协议都算)。不传 = trace 断成多棵互不相连的树 = 跨服务定位失效。**优先级高于功能**。 …
Read the whole file at its exact version.
How to install
mdr add martin1847/evolab/observability-standard@sha256:8ab99f9432095c76The line at the top of this page pins the label v1.3.3, 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.
[](https://markdownregistry.com/a/art_ds7vptlhk5ki4hp2)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 8 versions of this file, between Aug 6, 2026 and Oct 29, 2026, about one every 12 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.3.3 latest | 2026-10-29 | 8b44fa3 | 14,822 B | A | view · diff |
| v1.3.2 | 2026-10-29 | 7345c25 | 14,822 B | A | view · diff |
| v1.3.2 | 2026-09-20 | 19ebd08 | 15,209 B | A | view · diff |
| v1.3.1 | 2026-08-26 | 39017b1 | 15,209 B | A | view · diff |
| v1.3.0 | 2026-08-26 | 5ddacd0 | 15,209 B | A | view · diff |
| v1.2.4 | 2026-08-13 | 97b8997 | 14,494 B | A | view · diff |
| v1.2.4 | 2026-08-13 | 7e26b0d | 14,478 B | A | view · diff |
| v1.2.3 | 2026-08-06 | af59db3 | 14,927 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (14822 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
martin1847/evolab · 7 stars · license MIT · pushed 2026-11-07 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ds7vptlhk5ki4hp2 GET https://markdownregistry.com/api/v1/resolve?ref=martin1847/evolab/observability-standard GET https://markdownregistry.com/api/v1/blob/8ab99f9432095c7640216efed383e207ad915a436ed547f1fe899302236d6c15
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.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.