Sobre Observabilidad

Midaz exporta telemetría mediante OpenTelemetry. Despliega un collector en tu clúster de Kubernetes y luego configura las cargas de trabajo de Midaz para enviarle la telemetría.

Despliega un collector

El chart OpenTelemetry Collector de Lerian se ejecuta como DaemonSet y recibe telemetría OTLP en el puerto gRPC 4317 y en el puerto HTTP 4318. Recopila trazas, logs y métricas de las cargas de trabajo de Kubernetes, y las exporta al backend central de telemetría de Lerian. Crea otel-values.yaml para hacer que el collector sea local al nodo y conectar el Secret de la clave de API a su exporter:

opentelemetry-collector:
  hostNetwork: true
  dnsPolicy: ClusterFirstWithHostNet
  extraEnvs:
    - name: OTEL_API_KEY
      valueFrom:
        secretKeyRef:
          name: otel-api-key
          key: api-key
  config:
    exporters:
      otlphttp/server:
        headers:
          x-api-key: ${env:OTEL_API_KEY}

Crea el namespace y el Secret con la clave de API antes de instalar el chart:

kubectl create namespace midaz --dry-run=client -o yaml | kubectl apply -f -
kubectl create secret generic otel-api-key \
  --from-literal=api-key=<your-api-key> \
  -n midaz \
  --dry-run=client -o yaml | kubectl apply -f -

Instala el collector como un release independiente:

helm install otel-collector-lerian \
  oci://registry-1.docker.io/lerianstudio/otel-collector-lerian \
  --version <version> \
  -n midaz \
  -f otel-values.yaml

Conecta las cargas de trabajo de Midaz

En las versiones 8.4.0 y posteriores del chart de Midaz, otel-collector-lerian no es un subchart de Midaz. El siguiente ajuste no instala un collector. Inyecta HOST_IP, POD_IP, OTEL_EXPORTER_OTLP_ENDPOINT=$(HOST_IP):4317 y OTEL_RESOURCE_ATTRIBUTES=k8s.pod.ip=$(POD_IP) en los despliegues de Ledger y CRM.

otel-collector-lerian:
  enabled: true

El valor predeterminado es true. Espera un collector local al nodo que escuche en el puerto 4317 mediante hostNetwork o hostPort. Para usar otro endpoint, desactiva esta conexión y configura el endpoint directamente para cada carga de trabajo:

otel-collector-lerian:
  enabled: false

ledger:
  configmap:
    OTEL_EXPORTER_OTLP_ENDPOINT: "https://your-collector.example.com:4317"
crm:
  configmap:
    OTEL_EXPORTER_OTLP_ENDPOINT: "https://your-collector.example.com:4317"

El chart de Midaz acepta solo enabled dentro de otel-collector-lerian. Las claves heredadas como external, extraEnvs, exporters y opentelemetry-collector se rechazan durante la instalación o actualización de Helm.

Qué procesa el collector

El collector de Lerian enriquece la telemetría con metadatos de Kubernetes y un atributo client.id. Aplica limitación de memoria y batching, genera métricas RED a partir de spans, enmascara datos de payload sensibles y filtra la telemetría a los namespaces midaz y midaz-plugins antes de exportarla. Revisa los metadatos y los valores del chart OpenTelemetry Collector antes de desplegarlo para conocer los parámetros y las configuraciones de producción.

​Despliega un collector

​Conecta las cargas de trabajo de Midaz

​Qué procesa el collector

Despliega un collector

Conecta las cargas de trabajo de Midaz

Qué procesa el collector