Back to Skills

app-observability

Get RED metrics + service maps + frontend RUM + AI/LLM monitoring out of Grafana Cloud — Application Observability (`traces_spanmetrics_*` from OTel traces, p50/p95/p99 latency, exemplar-to-trace, traces-to-logs / profiles), Frontend Observability with the Faro Web SDK (Core Web Vitals, session replay, `pushError`, React + router integration, `TracingInstrumentation` for browser → backend trace correlation), and AI Observability via OpenLIT (token / cost / latency, GPU, hallucination + toxicity

198stars17forksUpdated 7/24/2026

Security Assessment

Safe(93/100)
Security Score93/100

About app-observability

The app-observability skill helps users stand up Grafana Cloud's application, frontend, and AI observability products on top of a shared OpenTelemetry (OTLP) plus Mimir/Loki/Tempo/Pyroscope pipeline. It solves the problem of wiring instrumentation and verifying that telemetry actually flows end-to-end: Application Observability provides RED metrics and service maps from OTel spanmetrics, Frontend Observability adds real-user monitoring via the Faro Web SDK, and AI Observability adds LLM/vector-DB monitoring through OpenLIT.

The skill walks through concrete workflows: configuring a Grafana Alloy OTLP receiver and forwarding to Grafana Cloud, then verifying receipt with health checks and metrics queries; instrumenting apps in Node.js, Python, Java, and Go with required resource attributes (service.name, service.namespace, deployment.environment); instrumenting a React frontend with Faro plus TracingInstrumentation for browser-to-backend trace correlation, Core Web Vitals, and session replay; and adding LLM cost/token/latency and hallucination/toxicity monitoring by initializing OpenLIT. It includes verification steps using TraceQL, PromQL, and LogQL, plus troubleshooting for missing service-map edges and collect-endpoint errors. Credentials such as the Grafana Cloud API key and instance ID are handled through environment variables and standard publisher scopes.

Target users are backend and frontend engineers, SREs, and platform teams setting up APM, debugging telemetry gaps, monitoring LLM cost drift, or correlating frontend errors to backend traces. The shell commands it runs are setup, health-check, and read-only verification operations against official Grafana tooling.

FAQ

What are the prerequisites?

A Grafana Cloud stack with an OTLP endpoint, numeric instance ID, and an API key with MetricsPublisher, LogsPublisher, and TracesPublisher scopes. APM needs an OTel-instrumented app, Frontend needs a web app and Faro app key, and AI needs Python 3.10 or newer. Grafana Alloy is recommended as the local OTLP receiver.

Which languages and frameworks are supported for instrumentation?

The APM reference includes examples for Node.js, Python, Java, and Go using OpenTelemetry SDKs/agents, and the frontend workflow targets React apps via the Faro Web SDK.

How are Grafana Cloud credentials handled?

Through environment variables such as the OTLP endpoint, instance ID, and API key, using standard publisher-scoped keys. There is no exfiltration to third parties; data is sent to the user's own Grafana Cloud stack.

Why are my service-map edges missing?

Service-map edges require span.kind to be set on outbound calls; the skill includes troubleshooting steps and verification queries (TraceQL/PromQL) to confirm spans and spanmetrics are being generated.

How do I monitor LLM cost and quality?

Install OpenLIT and call openlit.init at app startup; existing OpenAI/Anthropic/Cohere calls then emit OTel spans and metrics for token, cost, latency, GPU, and hallucination/toxicity evaluation.

All Files

6 files
references/apm-setup.md23.1 KB
View
references/frontend-observability.md14.7 KB
View
references/ai-observability.md2.4 KB
View
references/faro.md3.2 KB
View
references/apm.md3.2 KB
View
SKILL.md7.2 KB
View

Install app-observability

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill

Repository

grafana/skills