telemetry-tagging

Tag production logs, metrics, and traces with REQ-* keys.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/foolishimp/ai_sdlc_method --skill telemetry-tagging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telemetry-tagging
Source: https://github.com/foolishimp/ai_sdlc_method/tree/main/gemini-code/plugins/runtime-skills/skills/telemetry-tagging
Command: npx skills add https://github.com/foolishimp/ai_sdlc_method --skill telemetry-tagging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Actuator tags production telemetry (logs, metrics, traces) with REQ-* keys to enable end-to-end traceability from incidents back to requirements and intent.

Core Features & Use Cases

  • Logs: Inject REQ-* identifiers into log events.
  • Metrics: Tag metrics with req:<REQ-ID>.
  • Traces: Attach REQ-* attributes to distributed traces for pinpoint debugging.

Quick Start

Instrument login() to emit logs, metrics, and traces tagged with REQ-USER-LOGIN-001.

Frequently Asked Questions about telemetry-tagging

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

FAQPage Schema
How do I tag production logs, metrics, and traces with requirement identifiers for traceability?

Tagging production telemetry with REQ-* keys enables end-to-end traceability from runtime incidents back to requirements. Inject REQ-* identifiers into logs, attach req:<REQ-ID> labels to metrics, and add REQ-* attributes to distributed traces across your deployed code to link observability signals directly to functional requirements.

Can I use telemetry tagging with Python, TypeScript, Datadog, Prometheus, and OpenTelemetry?

Yes. Telemetry tagging supports Python, TypeScript, Datadog, Prometheus, and OpenTelemetry instrumentations. The Skill applies REQ-* identifiers across these platforms during deployments and observability setup, allowing you to tag logs, metrics, and traces consistently regardless of your stack.

How do I verify that REQ-* tags are present in my deployed telemetry?

Verification steps confirm tags are present in your instrumented logs, metrics, and traces. After instrumenting code with REQ-* identifiers, check observability platforms and logs to confirm tags appear in production telemetry events, validating that end-to-end traceability from requirements to runtime is working.

What's the best way to instrument a login function with requirement traceability?

Instrument login() to emit logs, metrics, and traces tagged with a specific REQ-ID such as REQ-USER-LOGIN-001. This attaches the requirement identifier to all telemetry signals from that function, enabling you to trace login-related incidents directly back to the original requirement.

When should I use requirement tagging during incident investigations?

Use REQ-* tagging in incident investigations to correlate runtime issues with functional requirements. When an incident occurs, REQ-* keys in logs, metrics, and traces create a direct path from the problem back to the requirement it violates, accelerating root-cause analysis and impact assessment.

Does telemetry tagging work for distributed traces across microservices?

Yes. REQ-* attributes attached to distributed traces enable pinpoint debugging across microservices. Tags propagate through trace spans, allowing you to follow a single requirement-tagged request through your entire service topology and identify where issues occur.