Práctica: recopilar trazas con el Collector de OpenTelemetry con corrección

Lo que vas a aprender en este TP

• Configurar el exportador otlphttp
• Generar trazas
• Consultarlas

Introducción #

Lo que vas a aprender en esta sección

• Configurar el exportador otlphttp
• Generar trazas
• Consultarlas

Contexto. Tus aplicaciones están instrumentadas con OpenTelemetry. Las haces pasar por un Collector, sin atarlas directamente a la plataforma.

Requisitos: la práctica anterior  ·  Duración estimada: 35 min

Un flujo de trazas de extremo a extremo.

Puesta en marcha #

Pasos guiados, con su corrección.

1. 1. Configurar el Collector

   ¿Por qué? El exportador añade /v1/traces por sí mismo: indica solo la base.

   Escribe collector.yaml con el exportador otlphttp y la cabecera de autenticación.
   Ver la corrección

   receivers:
     otlp:
       protocols:
         grpc:
           endpoint: 0.0.0.0:4317
         http:
           endpoint: 0.0.0.0:4318
   
   processors:
     batch:
   
   exporters:
     otlphttp/openobserve:
       endpoint: http://openobserve:5080/api/default
       headers:
         Authorization: "Basic ${env:O2_AUTH}"
         stream-name: applis
   
   service:
     pipelines:
       logs:
         receivers: [otlp]
         processors: [batch]
         exporters: [otlphttp/openobserve]
       metrics:
         receivers: [otlp]
         processors: [batch]
         exporters: [otlphttp/openobserve]
       traces:
         receivers: [otlp]
         processors: [batch]
         exporters: [otlphttp/openobserve]

2. 2. Añadir el Collector a la pila

   ¿Por qué? La contraseña no debe escribirse en la configuración del Collector.

   Añade el servicio collector al Compose.
   Ver la corrección

   services:
     openobserve:
       image: o2cr.ai/openobserve/openobserve:v1.1.2
       ports:
         - "5080:5080"
       environment:
         ZO_DATA_DIR: /data
         ZO_ROOT_USER_EMAIL: root@example.com
         ZO_ROOT_USER_PASSWORD: Complexpass#123
       volumes:
         - o2-data:/data
   
     collector:
       image: otel/opentelemetry-collector-contrib:latest
       command: ["--config=/etc/otelcol/config.yaml"]
       environment:
         O2_AUTH: ${O2_AUTH}
       volumes:
         - ./collector.yaml:/etc/otelcol/config.yaml:ro
       depends_on: [openobserve]
   
   volumes:
     o2-data:

3. 3. Generar trazas

   ¿Por qué? telemetrygen sustituye aquí a una aplicación instrumentada.

   Inicia la pila y envía 20 trazas al Collector.
   Ver la corrección

   export O2_AUTH=$(printf 'root@example.com:Complexpass#123' | base64)
   docker compose up -d
   docker run --rm --network "$(basename "$PWD")_default" \
     ghcr.io/open-telemetry/opentelemetry-collector-contrib/telemetrygen:latest \
     traces --otlp-insecure --otlp-endpoint=collector:4317 --traces 20 --service=paiement

4. 4. Comprobar

   ¿Por qué? La cabecera stream-name ha elegido el flujo applis.

   Consulta el flujo de tipo traces y abre el menú Traces de la interfaz.
   Ver la corrección

   NOW=$(date +%s)
   curl -s -u 'root@example.com:Complexpass#123' -H 'Content-Type: application/json' \
     'http://localhost:5080/api/default/_search?type=traces' \
     -d "{\"query\":{\"sql\":\"SELECT service_name, operation_name, duration FROM applis\",
           \"start_time\":$(( (NOW-3600)*1000000 )),\"end_time\":$(( (NOW+60)*1000000 )),\"from\":0,\"size\":3}}" | jq .hits

Nivel de dificultad : ●●○○○ (2/5)