granular-observability

Implement MELT observability with Prometheus, OpenTelemetry, and Grafana for ValueOS agents.

Updated Nov 17, 2025
One-click install
npx skills add https://github.com/Valynt/ValueOS --skill granular-observability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: granular-observability
Source: https://github.com/Valynt/ValueOS/tree/main/.windsurf/skills/granular-observability
Command: npx skills add https://github.com/Valynt/ValueOS --skill granular-observability

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standardizes and centralizes observability for ValueOS by implementing a comprehensive MELT stack across all 18 agent types, enabling end-to-end visibility and faster debugging.

Core Features & Use Cases

  • Metrics instrumentation with Prometheus (valueos_* metrics) across agents.
  • Distributed tracing with OpenTelemetry for inter-agent requests.
  • Structured logging with trace correlation for quick debugging.
  • Grafana dashboards for agent health, throughput, and ML performance.
  • Alert rules for health, latency, and communication failures.

Quick Start

Configure your ValueOS deployment to expose Prometheus metrics, OpenTelemetry traces, and structured logs, then import the Grafana dashboards and alert rules to begin monitoring.

Frequently Asked Questions about granular-observability

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

FAQPage Schema
How do I implement distributed tracing across multiple agents using OpenTelemetry?

Distributed tracing with OpenTelemetry provides end-to-end visibility for inter-agent requests by standardizing MELT data. This enables faster debugging across all 18 ValueOS agent types in production deployments.

How do I set up Prometheus metrics instrumentation for agent monitoring?

Prometheus metrics instrumentation uses standardized valueos_* metrics across all agents to monitor health and throughput. You configure your ValueOS deployment to expose these metrics, then import Grafana dashboards for visualization.

What is the MELT stack and how does it standardize observability?

The MELT stack standardizes Metrics, Events, Logs, and Traces across all agent types to centralize observability. It applies Prometheus, OpenTelemetry, and structured logging to achieve end-to-end visibility and performance optimization.

Can I use Grafana dashboards to visualize agent health and ML performance?

Grafana dashboards visualize agent health, throughput, and ML performance by importing pre-configured panels. They work with Prometheus metrics and OpenTelemetry traces to provide centralized visibility across all 18 agents.

How do I configure alert rules for latency and communication failures in ValueOS?

Alert rules for health, latency, and communication failures are configured alongside Grafana dashboards to monitor production deployments. They utilize Prometheus metrics and structured logs to detect and notify on agent anomalies.

Does structured logging with trace correlation help with debugging production agents?

Structured logging with trace correlation enables quick debugging by linking log entries to OpenTelemetry distributed traces. This standardized approach across all 18 agents significantly accelerates root cause analysis in production.