# Service Mesh Observability

> Implement comprehensive observability for service meshes including distributed tracing, metrics, and visualization. Use when setting up mesh monitoring, debugging latency issues, or implementing SLOs for service communication.

Source: https://skillsagentes.com/skills/wshobson/agents/service-mesh-observability
Repository: https://github.com/wshobson/agents
Author: wshobson
License: MIT
Updated: hace 2 meses
Context cost: 57 tok installed, 708 tok once triggered, 2.6k tok with every bundled file
Bundle: 2 files, 10 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add wshobson/agents --skill service-mesh-observability --agent claude-code
```

## What it does

- Proporciona patrones y plantillas para observabilidad de service mesh en Istio y Linkerd
- Explica los tres pilares de observabilidad: métricas, trazas y logs
- Define señales doradas (latencia, tráfico, errores, saturación) con umbrales de alerta
- Da buenas y malas prácticas de muestreo, cardinalidad y retención

## Use it when

- Configurar tracing distribuido entre servicios
- Implementar métricas y dashboards de service mesh
- Depurar problemas de latencia y errores
- Definir SLOs para comunicación entre servicios

## What triggers it

- "Ayúdame a configurar tracing distribuido en mi service mesh de Istio"
- "Necesito definir SLOs para la comunicación entre mis microservicios"
- "¿Cómo depuro problemas de latencia en Linkerd?"

## Before you install

- Requiere consultar references/details.md para plantillas y ejemplos detallados concretos.

## Files

- SKILL.md — 3 KB
- references/details.md — 8 KB

## SKILL.md

Reproduced verbatim from wshobson/agents under MIT. This section is the upstream document and is in English.

# Service Mesh Observability

Complete guide to observability patterns for Istio, Linkerd, and service mesh deployments.

## When to Use This Skill

- Setting up distributed tracing across services
- Implementing service mesh metrics and dashboards
- Debugging latency and error issues
- Defining SLOs for service communication
- Visualizing service dependencies
- Troubleshooting mesh connectivity

## Core Concepts

### 1. Three Pillars of Observability

```
┌─────────────────────────────────────────────────────┐
│                  Observability                       │
├─────────────────┬─────────────────┬─────────────────┤
│     Metrics     │     Traces      │      Logs       │
│                 │                 │                 │
│ • Request rate  │ • Span context  │ • Access logs   │
│ • Error rate    │ • Latency       │ • Error details │
│ • Latency P50   │ • Dependencies  │ • Debug info    │
│ • Saturation    │ • Bottlenecks   │ • Audit trail   │
└─────────────────┴─────────────────┴─────────────────┘
```

### 2. Golden Signals for Mesh

| Signal         | Description               | Alert Threshold   |
| -------------- | ------------------------- | ----------------- |
| **Latency**    | Request duration P50, P99 | P99 > 500ms       |
| **Traffic**    | Requests per second       | Anomaly detection |
| **Errors**     | 5xx error rate            | > 1%              |
| **Saturation** | Resource utilization      | > 80%             |

## Templates and detailed worked examples

Full template library and detailed worked examples live in `references/details.md`. Read that file when you need the concrete templates.

## Best Practices

### Do's

- **Sample appropriately** - 100% in dev, 1-10% in prod
- **Use trace context** - Propagate headers consistently
- **Set up alerts** - For golden signals
- **Correlate metrics/traces** - Use exemplars
- **Retain strategically** - Hot/cold storage tiers

### Don'ts

- **Don't over-sample** - Storage costs add up
- **Don't ignore cardinality** - Limit label values
- **Don't skip dashboards** - Visualize dependencies
- **Don't forget costs** - Monitor observability costs

---

Skills Agentes — https://skillsagentes.com/skills/wshobson/agents/service-mesh-observability