> ## 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.

# Referência de configuração

> Configure a carga de trabalho do Ledger e as conexões de infraestrutura dela no Helm chart do Midaz.

Configure o Ledger na chave `ledger` do seu arquivo de values. O chart renderiza `ledger.configmap` como configuração não sensível e `ledger.secrets` como um Secret do Kubernetes.

## Configurações principais

***

```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
```

## Conexões de serviço padrão

***

Os padrões do chart conectam o Ledger às dependências do mesmo 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
```

Quando você usa serviços externos, sobrescreva juntos os valores de host, porta, usuário e Secret correspondentes. Consulte [Configurar dependências](/pt/platform/deploy/midaz/midaz-dependencies).

## Secrets

***

Use um Secret criado previamente quando você não quiser que o chart crie um:

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

Para dependências gerenciadas externamente, `ledger.secrets` aceita as senhas de banco de dados, MongoDB, Valkey e RabbitMQ que a carga de trabalho usa. Mantenha valores sensíveis fora de `ledger.configmap`.

## Telemetria

***

`otel-collector-lerian.enabled` é `true` por padrão. Ele apenas injeta variáveis de ambiente de telemetria no Ledger, no CRM e no Tracer: `POD_IP`, `HOST_IP`, `OTEL_EXPORTER_OTLP_ENDPOINT=$(HOST_IP):4317` e `OTEL_RESOURCE_ATTRIBUTES=k8s.pod.ip=$(POD_IP)`. Ele não instala um OpenTelemetry Collector.

Para usar um endpoint diferente, defina `otel-collector-lerian.enabled: false` e configure as variáveis do OTEL em `ledger.configmap`, `crm.configmap` ou `tracer.configmap` para cada carga de trabalho habilitada. O chart desabilita a telemetria do Tracer por padrão, então defina também `tracer.configmap.ENABLE_TELEMETRY: "true"` ao habilitá-la.

## Probes e migrations

***

As probes do Ledger usam `/health` para liveness e `/readyz` para readiness por padrão. Sobrescreva qualquer um dos blocos quando seu ambiente precisar de tempos diferentes.

O chart também fornece um Job de migration do Ledger. O valor `enabled` dele é automático quando omitido: fica ligado para tags 4.x do Ledger e desligado para tags 3.x. O Job usa por padrão um prazo de `600` segundos, seis novas tentativas e um período de retenção de três dias.

<Note>
  Leia todas as chaves aceitas e os padrões a partir da versão de que você faz deploy:
  `helm show values oci://registry-1.docker.io/lerianstudio/midaz-helm --version <version>`.
</Note>