oma-observability

Routes observability setup, migration, tuning, and incident forensics across OpenTelemetry signals and vendor categories.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/javiruu/viru-air --skill oma-observability-javiruu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oma-observability
Source: https://github.com/javiruu/viru-air/tree/main/.agents/skills/oma-observability
Command: npx skills add https://github.com/javiruu/viru-air --skill oma-observability-javiruu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Designing and operating observability pipelines across metrics, logs, traces, and profiles involves dozens of decisions—vendor selection, collector topology, sampling strategy, cardinality control, and compliance—that are easy to get wrong and hard to debug. This Skill classifies your intent and routes you to the correct guidance, vendor category, or forensics playbook instead of generic advice. ## Core Features & Use Cases - Intent-based routing: Classifies requests into setup, migrate, investigate, alert, trace, tune, or route, then dispatches to the right resource guide across a 4-layer × 4-boundary × 7-signal coverage matrix. - Transport and pipeline tuning: Provides in-depth guidance on UDP/MTU thresholds, OTLP gRPC vs HTTP, Collector DaemonSet vs gateway topology, and tail-sampling recipes. - Incident forensics: Runs a 6-dimension localization flow (code, service, layer, host, region, infra) with cross-signal validation and vendor query syntax for Tempo, Honeycomb, Datadog, Jaeger, and more. - Use Case: When a 5xx spike hits your payment service in ap-northeast-2, invoke the investigate intent to acquire a trace_id from a metric exemplar, narrow the root cause to a Redis connection pool exhaustion in a specific service version, and trigger an automated canary rollback. ## Quick Start Ask the agent to set up an OpenTelemetry stack on Kubernetes or to investigate a latency spike in a specific service and region.

Frequently Asked Questions about oma-observability

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

FAQPage Schema
How do I set up an OpenTelemetry collector on Kubernetes?▼

Use a two-tier topology: a DaemonSet agent per node for hostmetrics, filelog, and kubeletstats collection, forwarding to a Deployment gateway for batching and export. Always place the memory_limiter processor first in every pipeline and run at least two gateway replicas.

How do I migrate from Fluentd to Fluent Bit?▼

Run a dual-send phase where Fluent Bit ships logs alongside Fluentd, verify record-count parity per service over 24 hours, then scale the Fluentd DaemonSet to zero. Fluentd is deprecated per the CNCF 2025-10 guide; Fluent Bit offers native OTLP output with far lower memory usage.

What is the difference between head-based and tail-based sampling?▼

Head-based sampling decides at the trace root, which breaks multi-service traces when downstream services sample independently. Tail-based sampling buffers complete traces at a gateway collector and decides afterward, requiring a loadbalancing exporter with consistent hash by trace_id.

Why does my metrics backend have cardinality explosion?▼

Unbounded labels like user.id, raw http.url, or per-tenant metric names create one time series per unique value. Replace them with bounded labels such as user.tier or normalized http.route, and enforce an attribute allow-list in the OTel SDK View.

When should I not use this observability router?▼

Use dedicated tools for LLM ops (Langfuse, Arize Phoenix), data pipeline lineage (OpenLineage, Marquez), chaos engineering (Chaos Mesh, Litmus), GPU infrastructure metrics (NVIDIA DCGM), and incident paging workflows (PagerDuty, OpsGenie).

How do I configure SLO burn-rate alerts in Prometheus?▼

Define the SLO as OpenSLO YAML in git, generate PrometheusRule CRDs with Sloth, and implement multi-window alerts: fast burn at 2% budget in 1 hour for paging, slow burn at 5% budget in 6 hours for tickets. Validate rules with promtool before merging.