> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Referencia de configuración

> Configura el workload de Ledger y sus conexiones de infraestructura en el Helm chart de Midaz.

Configura Ledger bajo la clave `ledger` en tu archivo de values. El chart renderiza `ledger.configmap` como configuración no sensible y `ledger.secrets` como un Secret de Kubernetes.

## Ajustes principales

***

```yaml theme={null}
ledger:
  enabled: true
  replicaCount: 2
  image:
    repository: lerianstudio/midaz-ledger
  service:
    type: ClusterIP
    port: 3002
  ingress:
    enabled: false
  autoscaling:
    enabled: true
    minReplicas: 2
    maxReplicas: 9
```

## Conexiones de servicio predeterminadas

***

Los valores predeterminados del chart conectan Ledger con las dependencias del mismo release:

```yaml theme={null}
ledger:
  configmap:
    DB_ONBOARDING_HOST: midaz-postgresql-primary
    DB_ONBOARDING_NAME: onboarding
    DB_TRANSACTION_HOST: midaz-postgresql-primary
    DB_TRANSACTION_NAME: transaction
    MONGO_ONBOARDING_HOST: midaz-mongodb
    MONGO_ONBOARDING_NAME: onboarding
    MONGO_TRANSACTION_HOST: midaz-mongodb
    MONGO_TRANSACTION_NAME: transaction
    REDIS_HOST: midaz-valkey-primary:6379
    RABBITMQ_URI: amqp
    RABBITMQ_HOST: midaz-rabbitmq
    RABBITMQ_PORT_HOST: "5672"
    RABBITMQ_PORT_AMQP: "15672"
    RABBITMQ_DEFAULT_USER: transaction
    RABBITMQ_CONSUMER_USER: consumer
```

Cuando usas servicios externos, sobrescribe en conjunto los valores de host, puerto, usuario y Secret correspondientes. Consulta [Configurar dependencias](/es/platform/deploy/midaz/midaz-dependencies).

## Secrets

***

Usa un Secret creado previamente cuando no quieres que el chart cree uno:

```yaml theme={null}
ledger:
  useExistingSecret: true
  existingSecretName: midaz-ledger
```

Para dependencias gestionadas externamente, `ledger.secrets` admite las contraseñas de base de datos, MongoDB, Valkey y RabbitMQ que usa el workload. Mantén los valores sensibles fuera de `ledger.configmap`.

## Telemetría

***

`otel-collector-lerian.enabled` es `true` de forma predeterminada. Solo inyecta variables de entorno de telemetría en Ledger, CRM y Tracer: `POD_IP`, `HOST_IP`, `OTEL_EXPORTER_OTLP_ENDPOINT=$(HOST_IP):4317` y `OTEL_RESOURCE_ATTRIBUTES=k8s.pod.ip=$(POD_IP)`. No instala un OpenTelemetry Collector.

Para usar un endpoint distinto, configura `otel-collector-lerian.enabled: false` y luego define las variables OTEL en `ledger.configmap`, `crm.configmap` o `tracer.configmap` para cada workload habilitado. El chart deshabilita la telemetría de Tracer de forma predeterminada, así que también configura `tracer.configmap.ENABLE_TELEMETRY: "true"` cuando la habilites.

## Probes y migraciones

***

Los probes de Ledger usan `/health` para liveness y `/readyz` para readiness de forma predeterminada. Sobrescribe cualquiera de los dos bloques cuando tu entorno necesita tiempos distintos.

El chart también provee un Job de migración de Ledger. Su valor `enabled` es automático cuando se omite: está activo para tags de Ledger 4.x y desactivado para tags 3.x. El Job usa de forma predeterminada un deadline de `600` segundos, seis reintentos y un período de retención de tres días.

<Note>
  Lee todas las claves admitidas y sus valores predeterminados desde la versión que despliegas:
  `helm show values oci://registry-1.docker.io/lerianstudio/midaz-helm --version <version>`.
</Note>