observability-guidelines

Provides structured architecture for OpenTelemetry tracing, Prometheus metrics, and structured logging.

Updated Dec 13, 2025
One-click install
npx skills add https://github.com/imehr/vet --skill observability-guidelines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability-guidelines
Source: https://github.com/imehr/vet/tree/main/.claude/skills/observability-guidelines
Command: npx skills add https://github.com/imehr/vet --skill observability-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the lack of consistent observability practices across services by providing a structured set of guidelines for tracing, metrics, and logging.

Core Features & Use Cases

  • Observability governance: Establishes OpenTelemetry-based tracing strategies, Prometheus metrics, and structured logging standards across services.
  • Reference architectures: Provides architecture guidance and decision tables for tracing, metrics, and logging.
  • Use Case: For a microservices app, implement consistent tracing, metrics dashboards, and logging formats across teams.

Quick Start

Review the included guidelines and align your services with the recommended stack and references.

  • Integrate OpenTelemetry tracing with context propagation across service boundaries and set appropriate sampling in dev/prod.
  • Build Prometheus metrics and Grafana dashboards following the golden signals framework.
  • Use the observability references to standardize logging formats and trace correlation IDs.

Frequently Asked Questions about observability-guidelines

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

FAQPage Schema
How do I standardize observability across microservices?

Standardize observability across microservices by adopting a structured architecture for tracing, metrics, and logging that enforces consistent practices across distributed teams. This approach provides reference architectures and decision tables to align your services.

What is the best way to implement OpenTelemetry tracing across service boundaries?

Implement OpenTelemetry tracing by integrating context propagation across service boundaries and configuring appropriate sampling rates for development and production environments. This ensures consistent distributed tracing throughout your system architecture.

How do I build Prometheus dashboards following the golden signals framework?

Build Prometheus dashboards by creating metrics aligned with the golden signals framework and visualizing them in Grafana. This strategy provides reference architectures to monitor latency, traffic, errors, and saturation consistently.

Do I need structured logging standards for distributed systems observability?

Structured logging standards are required for distributed systems observability to ensure logs can be correlated with trace IDs across services. Using standardized formats enables effective troubleshooting and context propagation throughout your microservices.

Why does my observability strategy lack consistency across different services?

Your observability strategy lacks consistency because of the absence of structured governance for tracing, metrics, and logging. Establishing clear standards using OpenTelemetry and Prometheus provides the necessary architectural reference to align your teams.