Configuración de la observabilidad

Apunta la telemetría de Midaz a tu colector de OpenTelemetry: las variables de entorno que inyecta el chart, el endpoint OTLP fijo y cómo sobrescribirlo.

El chart de Midaz no despliega un stack de observabilidad. Emite trazas y métricas de OpenTelemetry y espera que tú ejecutes el colector y el backend. Lo que el chart controla es una sola cosa: si las variables de entorno de OTEL se inyectan en los deployments ledger y crm.

Versiones anteriores del chart incluían un stack Grafana OTEL LGTM. Esos templates se eliminaron en la versión v5.0.0 del chart; la clave grafana: sigue existiendo en values.yaml, pero el chart no renderiza ningún recurso de Grafana, por lo que definir grafana.enabled: true no tiene efecto.

​

Inyección de las variables de entorno de OTEL

---

La inyección se controla con otel-collector-lerian.enabled, cuyo valor por defecto es true:

otel-collector-lerian:
  enabled: true

El esquema de esta clave es estricto: solo se acepta enabled. Las claves heredadas (external, extraEnvs, exporters, opentelemetry-collector) se rechazan al ejecutar helm install o helm upgrade.

Cuando está habilitada, el chart agrega estas variables a los contenedores ledger y crm:

Variable	Valor
POD_IP	status.podIP (referencia de campo)
HOST_IP	status.hostIP (referencia de campo)
OTEL_EXPORTER_OTLP_ENDPOINT	$(HOST_IP):4317
OTEL_RESOURCE_ATTRIBUTES	k8s.pod.ip=$(POD_IP)

​

Lo que debes proporcionar

---

El endpoint es fijo en $(HOST_IP):4317: el nodo donde se ejecuta el pod. Por lo tanto, mantener enabled: true requiere un colector OTLP accesible en el puerto 4317 de cada nodo, normalmente desplegado como DaemonSet con hostNetwork o un host port. Sin él, las aplicaciones exportan a un endpoint inexistente.

​

Uso de un endpoint diferente

---

Para enviar la telemetría a otro destino —un colector centralizado como Service, un backend gestionado, tu infraestructura de observabilidad existente— deja la inyección deshabilitada y define el endpoint directamente en el ConfigMap de la aplicación:

otel-collector-lerian:
  enabled: false

ledger:
  configmap:
    OTEL_EXPORTER_OTLP_ENDPOINT: "otel-collector.observability.svc.cluster.local:4317"

crm:
  configmap:
    OTEL_EXPORTER_OTLP_ENDPOINT: "otel-collector.observability.svc.cluster.local:4317"

​

Dashboards

---

El chart no incluye dashboards. Créalos en el backend que reciba la telemetría.

Para el chart independiente del colector, consulta Charts de Helm de infraestructura.