observability

Enforces logging, failure tracking, and alerting rules when editing application observability code.

1|Updated Jan 14, 2024
One-click install
npx skills add https://github.com/Eyhenij/rt-tools --skill observability-eyhenij
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability
Source: https://github.com/Eyhenij/rt-tools/tree/main/.claude/skills/observability
Command: npx skills add https://github.com/Eyhenij/rt-tools --skill observability-eyhenij

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When adding log lines, request IDs, failure parsing, or alert logic, developers make inconsistent choices about log levels, secret scrubbing, and error exposure. This Skill loads a constitutional rule that defines exactly how the application must log, record failures, and notify the owner, so every edit follows the same observability law. ## Core Features & Use Cases - Logging rules: Defines request ID propagation, log levels, secret scrubbing by field name, and startup digest requirements. - Failure handling: Specifies single-point error parsing, separation of input/rights failures from breakages, and bounded-queue failure recording that never delays responses. - Alerting semantics: Covers spike detection over closed buckets, schedule-tick analysis, and mail notification fuses. - Use Case: When adding a new log line to the message-bus receiver, load this rule to decide the correct level, ensure fields are scrubbed, and check whether the line belongs in the failure store. ## Quick Start Load the observability rule before editing the logger, request context, or failures domain and follow its articles when adding a new log line.

Frequently Asked Questions about observability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new log line correctly in this codebase?

Follow the observability-record pattern: choose the level deliberately, ensure all fields pass through the scrubbing function before output, and capture the request context at the moment of the logger call rather than at write time.

How should request IDs be handled in distributed logging?

Create the request number once per request and place it in every log line about that request. Accept external IDs only after cleaning and shortening, generate a new one when empty, and return it to the caller as a response header.

Should validation failures be logged the same as system errors?

No. Input or rights failures are checks that fired and must be written apart from breakages without a stack trace. Mixing them floods the alarm channel with guest typos and hides real breakage growth.

Why must log fields always be scrubbed for secrets?

Scrubbing works by key name and must run on every record, not at the writer's discretion. Deciding per call whether fields hold secrets guarantees being wrong eventually, leaking values into logs and the failure store.

What are the limitations of this observability rule in the current tree?

The message-bus receiver has no failure store, alerts domain, or owner screens yet, so most articles are marked not carried out. Failures currently live only in container output with parsed causes in line fields.