Los tres pilares de la observabilidad

La observabilidad es la capacidad de comprender el estado interno de un sistema a partir de los datos que emite. En un servicio en ejecución, responde a estas preguntas: ¿está en buen estado?, ¿por qué es lento? y ¿qué ha fallado? Se basa en tres pilares: trazas, métricas y logs.

OpenTelemetry, o OTel, es un estándar independiente de proveedores y un conjunto de bibliotecas para generar y exportar telemetría. Con una única instrumentación, puede enviar datos a muchos backends, como Jaeger, Prometheus o Grafana.

Los logs son registros con marca de tiempo de eventos discretos, como «el usuario 42 inició sesión» o «el pago falló». Proporcionan un contexto detallado y legible, pero pueden ser ruidosos y difíciles de agregar por sí solos.

Las métricas son mediciones numéricas agregadas a lo largo del tiempo, como el número de solicitudes, la tasa de errores, los percentiles de latencia y el uso de CPU. Son económicas de almacenar e ideales para paneles y alertas.

Las trazas siguen una única solicitud mientras atraviesa sus servicios y la dividen en spans temporales. Revelan dónde se emplea el tiempo y qué dependencia provocó la ralentización.

Las métricas indican que algo va mal, por ejemplo, que la tasa de errores se disparó. Las trazas indican dónde, por ejemplo, en el servicio de pagos. Los logs indican por qué, por ejemplo, una referencia nula para un pedido concreto. Juntos forman una historia completa de depuración.

La verdadera potencia proviene de la correlación. Un id de traza compartido y añadido a los logs y los spans permite pasar de una alerta de métricas a la traza exacta y sus logs correspondientes a una solicitud que ha fallado.

OTel denomina señales a estos pilares. .NET los asigna a primitivas conocidas: las trazas utilizan Activity/ActivitySource, las métricas utilizan Meter y los logs utilizan ILogger.

Opte por las señales mediante AddOpenTelemetry() y configure las trazas y las métricas. En las lecciones siguientes explicaremos cada una en detalle.

Un recurso describe la entidad que produce la telemetría (nombre del servicio, versión, entorno). Establecerlo de forma coherente permite que los backends agrupen y filtren sus datos correctamente.

OTel ofrece instrumentación automática para ASP.NET Core, HttpClient y otros componentes, además de instrumentación manual cuando necesita añadir sus propios spans y métricas para obtener información específica del negocio.

Compruebe los tres pilares.

La observabilidad se basa en tres pilares: registros (eventos, el porqué), métricas (números agregados, el qué) y trazas (spans por solicitud, el dónde). OpenTelemetry es el estándar independiente del proveedor que emite los tres como señales, representadas en .NET mediante Activity, Meter y ILogger. La correlación mediante los identificadores de traza y un recurso bien configurado los vincula.