Variáveis de ambiente

Esta referência lista as variáveis de ambiente usadas para configurar o Tracer, o serviço de controle de gastos em tempo real e de análise de risco de transações. Você as define no momento da implantação, por valores Helm, Docker Compose ou pelo ambiente do seu orquestrador. Variáveis marcadas como obrigatórias fazem o servidor falhar na inicialização se não forem definidas. Para os blocos de configuração que todo produto Lerian compartilha — postura de TLS, OpenTelemetry, autenticação do Access Manager, multi-tenancy e streaming de eventos — veja a referência de configuração BYOC. Esta página foca no que é distintivo do Tracer.

O Tracer roda como um serviço autônomo e também é empacotado no monorepo do Midaz (components/tracer) como parte do rollout da consolidação. As variáveis abaixo refletem o formato atual, mais completo, incluindo o seam gRPC de reserva que o ledger chama.

Portas e endpoints de saúde

Veja a referência de saúde e prontidão para o contrato de sondas.

Superfície	Variável de porta	Padrão	Endpoints
REST + saúde	`SERVER_PORT` / `SERVER_ADDRESS`	`4020`	`/health`, `/readyz`, `/version`, `/metrics`
Seam gRPC de reserva (opt-in)	`TRACER_GRPC_PORT`	sem definir (desligado)	gRPC reserve / confirm / release

Implantação e TLS

Variável	Descrição	Padrão	Obrigatória
`DEPLOYMENT_MODE`	Sabor de implantação: `local`, `byoc` ou `saas`. Em `saas`, o TLS é obrigatório para toda conexão de dependência e o servidor se recusa a iniciar sem ele. Em `byoc`, o TLS é recomendado e alertado em vez de imposto. Também marca a resposta de `/readyz`.	`local`	Não
`ALLOW_INSECURE_TLS`	Ignora a imposição de TLS por conexão nas DSNs de infraestrutura. Deixe sem definir ou `false` em produção.	`false`	Não

Aplicação

Variável	Descrição	Padrão	Obrigatória
`VERSION`	Tag de versão do serviço	varia	Não
`LOG_LEVEL`	Verbosidade dos logs: `debug`, `info`, `warn` ou `error`	`debug`	Não
`CEL_COST_LIMIT`	Custo máximo de avaliação para uma única expressão de regra CEL	`10000`	Não

Autenticação e tratamento de requisições

Variável	Descrição	Padrão	Obrigatória
`API_KEY_ENABLED`	Impõe a autenticação por chave de API	`false`	Não
`API_KEY`	Chave de API para autenticação de requisições. Sensível — use pelo menos 32 caracteres em produção.	—	Sim (se `API_KEY_ENABLED=true`)
`API_KEY_ENABLED_ONLY_VALIDATION`	Modo somente validação: verifica as chaves sem impô-las rigidamente	`false`	Não
`API_KEY_LABEL`	Identificador de ator de auditoria registrado para o principal da chave de API	`tracer-default`	Não
`CORS_ALLOWED_ORIGINS`	Origens CORS permitidas (CSV, ou `*`). Restrinja a origens explícitas em produção.	— (restritivo)	Não
`TRUSTED_PROXY_CIDRS`	CIDRs de proxy confiáveis para a análise de `X-Forwarded-For`. Defina ao rodar atrás de um load balancer.	— (usa o IP do peer)	Não

Banco de dados (PostgreSQL)

O Tracer armazena regras e contadores de uso em seu próprio banco de dados tracer no primário PostgreSQL compartilhado do Midaz.

Variável	Descrição	Padrão	Obrigatória
`DB_HOST`	Host do PostgreSQL	—	Sim
`DB_PORT`	Porta do PostgreSQL	—	Sim
`DB_USER`	Usuário do banco de dados	—	Sim
`DB_PASSWORD`	Senha do banco de dados. Sensível.	—	Sim
`DB_NAME`	Nome do banco de dados	`tracer`	Sim
`DB_SSL_MODE`	Modo SSL do libpq: `disable`, `require`, `verify-ca` ou `verify-full`. Use `require` ou mais forte em produção.	`disable`	Não
`MIGRATIONS_PATH`	Caminho para os arquivos de migração do banco de dados	`./migrations`	Não

Workers em background

Variável	Descrição	Padrão	Obrigatória
`CLEANUP_WORKER_ENABLED`	Executa o worker de limpeza de contadores de uso expirados	`false`	Não
`CLEANUP_WORKER_INTERVAL_HOURS`	Intervalo de limpeza (horas)	`24`	Não
`CLEANUP_WORKER_RETENTION_DAYS`	Janela de retenção dos contadores de uso (dias)	`90`	Não
`RESERVATION_REAPER_ENABLED`	Executa o reaper de reservas expiradas	`false`	Não
`RESERVATION_REAPER_INTERVAL_SECONDS`	Intervalo do reaper (segundos)	`30`	Não
`RESERVATION_LONG_LIVED_TTL_HOURS`	TTL após o qual uma reserva de longa duração é reaped (horas)	`720`	Não
`RULE_SYNC_POLL_INTERVAL_SECONDS`	Intervalo de poll de sincronização do cache de regras (segundos)	`10`	Não
`RULE_SYNC_STALENESS_THRESHOLD_SECONDS`	Limiar de obsolescência do cache de regras (segundos)	`50`	Não
`RULE_SYNC_OVERLAP_BUFFER_SECONDS`	Buffer de sobreposição da sincronização do cache de regras (segundos)	`2`	Não

Prontidão e drenagem

Variável	Descrição	Padrão	Obrigatória
`READYZ_DRAIN_GRACE_SECONDS`	Janela durante a qual `/readyz` retorna 503 após o SIGTERM, para que o Kubernetes desregistre o pod antes do desligamento	`12`	Não
`READYZ_CACHE_STALENESS_THRESHOLD_SECONDS`	Idade do cache de regras na qual `/readyz` reporta `degraded`	`300`	Não

Seam gRPC de reserva

Lado servidor do seam que o ledger do Midaz chama para reservar limites de gasto. Desligado a menos que TRACER_GRPC_PORT esteja definido.

Variável	Descrição	Padrão	Obrigatória
`TRACER_GRPC_PORT`	Porta de escuta gRPC do servidor de reserva	sem definir (desligado)	Não
`TRACER_TLS_MODE`	Segurança do seam: `mesh` (TLS terminado pelo service mesh) ou `mtls`	`mesh`	Não
`TRACER_TLS_CERT_FILE`	Caminho do PEM do certificado de servidor (quando `mtls`)	—	Não
`TRACER_TLS_KEY_FILE`	Caminho do PEM da chave privada de servidor (quando `mtls`). Sensível.	—	Não
`TRACER_TLS_CLIENT_CA_FILE`	Caminho do PEM do certificado CA de cliente para verificação mútua (quando `mtls`)	—	Não

Base de configuração compartilhada

Os blocos a seguir são idênticos entre os produtos Lerian e estão documentados por completo na referência de configuração BYOC. Eles vêm desativados.

Autenticação do Access Manager — PLUGIN_AUTH_ENABLED, PLUGIN_AUTH_ADDRESS. Ative em produção.
Multi-tenancy — MULTI_TENANT_*, mais os botões de pool por tenant do Tracer (MULTI_TENANT_MAX_TENANT_POOLS, MULTI_TENANT_MAX_OPEN_CONNS_PER_TENANT, MULTI_TENANT_TENANT_CAP_RETRY_AFTER_SECONDS). Desativado por padrão. APPLICATION_NAME identifica o módulo para o Tenant Manager.
Streaming de eventos — STREAMING_* (produtor lib-streaming). Desativado por padrão.
OpenTelemetry — ENABLE_TELEMETRY, OTEL_*. O Tracer também expõe um endpoint /metrics do Prometheus.

Visão geral

Guias

Console

Operações

Variáveis de ambiente

Portas e endpoints de saúde

Implantação e TLS

Aplicação

Autenticação e tratamento de requisições

Banco de dados (PostgreSQL)

Workers em background

Prontidão e drenagem

Seam gRPC de reserva

Base de configuração compartilhada

​Portas e endpoints de saúde

​Implantação e TLS

​Aplicação

​Autenticação e tratamento de requisições

​Banco de dados (PostgreSQL)

​Workers em background

​Prontidão e drenagem

​Seam gRPC de reserva

​Base de configuração compartilhada

Portas e endpoints de saúde

Implantação e TLS

Aplicação

Autenticação e tratamento de requisições

Banco de dados (PostgreSQL)

Workers em background

Prontidão e drenagem

Seam gRPC de reserva

Base de configuração compartilhada