Variables de entorno

Esta referencia enumera las variables de entorno usadas para configurar Reporter, el servicio que genera reportes regulatorios, de cumplimiento y contables a partir de plantillas configurables. Reporter se entrega como un único binario cuyas superficies activas se seleccionan mediante RUN_MODE: el gestor de API, el worker de reportes, o ambos. Las defines en el momento del despliegue, mediante valores de Helm, Docker Compose o el entorno de tu orquestador. Las variables marcadas como requeridas hacen que el servidor falle al arrancar si no se definen. Para los bloques de configuración que comparte cada producto de Lerian —postura de TLS, OpenTelemetry, autenticación de Access Manager, multi-tenancy, descubrimiento de servicios y streaming de eventos— consulta la referencia de configuración BYOC. Esta página se centra en lo que es distintivo de Reporter.

Modo de ejecución y puertos

RUN_MODE decide qué superficies sirve el proceso. Ejecuta la API y el worker como un solo proceso (all) para despliegues pequeños, o divídelos en desplegables separados (api y worker) para escalar la generación de reportes de forma independiente. Consulta la referencia de salud y readiness para el contrato de las sondas.

Variable	Descripción	Valor por defecto	Requerida
`RUN_MODE`	Superficies a ejecutar: `api`, `worker` o `all`	`all`	No
`APP_CONTEXT`	Prefijo de ruta para la superficie de API	`/manager/v1`	No
`SERVER_PORT` / `SERVER_ADDRESS`	Puerto de la API (`RUN_MODE=api`/`all`). Sirve `/health`, `/readyz`, `/version`.	`4005`	No
`HEALTH_PORT`	Puerto de salud del worker (`RUN_MODE=worker`). Sirve `/health`, `/readyz`.	`4006`	No

Despliegue y TLS

Variable	Descripción	Valor por defecto	Requerida
`DEPLOYMENT_MODE`	Sabor de despliegue: `local`, `byoc` o `saas`. En `saas`, el TLS es obligatorio para cada conexión a una dependencia y el servidor se niega a arrancar sin él. En `byoc`, el TLS se recomienda y se advierte en lugar de imponerse. También etiqueta la respuesta de `/readyz`.	`local`	No
`ALLOW_INSECURE_TLS`	Omite la imposición de TLS por conexión en los DSN de infraestructura. Déjala sin definir o en `false` en producción.	`false`	No

CORS y proxies

Variable	Descripción	Valor por defecto	Requerida
`CORS_ALLOWED_ORIGINS`	Orígenes CORS permitidos (CSV, o `*`). Restringe a orígenes explícitos en producción.	`*`	No
`CORS_ALLOWED_METHODS`	Métodos CORS permitidos	varía	No
`CORS_ALLOWED_HEADERS`	Cabeceras CORS permitidas	varía	No
`TRUSTED_PROXIES`	CIDR de proxy de confianza para el análisis de `X-Forwarded-For`. Defínela al ejecutar detrás de un balanceador de carga.	—	No
`SWAGGER_ENABLED`	Sirve la interfaz de OpenAPI/Swagger	`true`	No

Base de datos (MongoDB)

Almacena metadatos de reportes, plantillas e historial de ejecuciones.

Variable	Descripción	Valor por defecto	Requerida
`MONGO_URI`	Esquema de conexión: `mongodb` o `mongodb+srv`	`mongodb`	No
`MONGO_HOST`	Host de MongoDB	—	Sí
`MONGO_PORT`	Puerto de MongoDB	—	Sí
`MONGO_USER`	Usuario de la base de datos	—	Sí
`MONGO_PASSWORD`	Contraseña de la base de datos. Sensible.	—	Sí
`MONGO_NAME`	Nombre de la base de datos	`reporter-db`	Sí
`MONGO_MAX_POOL_SIZE`	Tamaño máximo del pool de conexiones	varía	No
`MONGO_TLS_CA_CERT`	Certificado CA PEM codificado en base64 para TLS (por ejemplo AWS DocumentDB)	—	No

Broker de mensajes (RabbitMQ)

Transporta la cola de comandos de generación de reportes entre la API y el worker.

Variable	Descripción	Valor por defecto	Requerida
`RABBITMQ_HOST`	Host del broker	—	Sí
`RABBITMQ_PORT_AMQP`	Puerto AMQP	—	Sí
`RABBITMQ_PORT_HOST`	Puerto de gestión/HTTP	—	No
`RABBITMQ_URI`	Esquema de conexión: `amqp` o `amqps`. Usa `amqps` en producción.	`amqp`	No
`RABBITMQ_DEFAULT_USER`	Usuario del broker	—	Sí
`RABBITMQ_DEFAULT_PASS`	Contraseña del broker. Sensible.	—	Sí
`RABBITMQ_NUMBERS_OF_WORKERS`	Concurrencia de consumidores del worker	`5`	No

Almacenamiento de objetos (compatible con S3)

Donde se almacenan los reportes renderizados. Funciona con cualquier endpoint compatible con S3.

Variable	Descripción	Valor por defecto	Requerida
`OBJECT_STORAGE_ENDPOINT`	URL del endpoint compatible con S3	—	Sí
`OBJECT_STORAGE_REGION`	Región de almacenamiento	`us-east-1`	No
`OBJECT_STORAGE_BUCKET`	Bucket para los reportes renderizados	—	Sí
`OBJECT_STORAGE_ACCESS_KEY_ID`	ID de clave de acceso. Sensible.	—	Sí
`OBJECT_STORAGE_SECRET_KEY`	Clave de acceso secreta. Sensible.	—	Sí
`OBJECT_STORAGE_USE_PATH_STYLE`	Usa direccionamiento de tipo path (necesario para algunos almacenes compatibles con S3)	`true`	No
`OBJECT_STORAGE_DISABLE_SSL`	Deshabilita TLS hacia el endpoint de almacenamiento. Déjala en `false` en producción.	`true`	No

Caché (Redis / Valkey)

Variable	Descripción	Valor por defecto	Requerida
`REDIS_HOST`	Host y puerto de Redis/Valkey	—	Sí
`REDIS_PASSWORD`	Contraseña de autenticación. Sensible.	—	No
`REDIS_DB`	Índice de la base de datos lógica	`0`	No
`REDIS_PROTOCOL`	Versión del protocolo RESP	varía	No
`REDIS_TLS`	Habilita TLS para la conexión	`false`	No
`REDIS_CA_CERT`	Certificado CA PEM codificado en base64 para TLS	—	No
`REDIS_MASTER_NAME`	Nombre del master de Sentinel (despliegues Sentinel)	—	No
`REDIS_USE_GCP_IAM`	Autentícate en GCP Memorystore con IAM en lugar de una contraseña	`false`	No

Renderizado de PDF (worker)

Variable	Descripción	Valor por defecto	Requerida
`PDF_POOL_WORKERS`	Workers concurrentes de renderizado de PDF	`5`	No
`PDF_TIMEOUT_SECONDS`	Timeout de renderizado de PDF por reporte (segundos)	`30`	No

Fuentes de datos de reportes

Los reportes pueden leer directamente de fuentes de datos single-tenant declaradas con un prefijo dinámico. Sustituye {NAME} por el identificador de tu fuente de datos; declara un bloque por fuente.

Variable	Descripción	Valor por defecto	Requerida
`DATASOURCE_{NAME}_HOST`	Host de la fuente de datos	—	No
`DATASOURCE_{NAME}_PORT`	Puerto de la fuente de datos	—	No
`DATASOURCE_{NAME}_USER`	Usuario de la fuente de datos	—	No
`DATASOURCE_{NAME}_PASSWORD`	Contraseña de la fuente de datos. Sensible.	—	No
`DATASOURCE_{NAME}_DATABASE`	Nombre de la base de datos	—	No
`DATASOURCE_{NAME}_TYPE`	Tipo de motor de la fuente de datos	—	No
`DATASOURCE_{NAME}_SSLMODE`	Modo SSL para la conexión a la fuente de datos	—	No
`DATASOURCE_{NAME}_SSLROOTCERT`	Ruta al certificado raíz SSL de la fuente de datos	—	No
`DATASOURCE_{NAME}_SCHEMAS`	Esquemas a exponer desde la fuente de datos	—	No
`CRYPTO_HASH_SECRET_KEY_CRM`	Clave de hashing para leer la PII de la fuente de datos CRM. Sensible.	—	No
`CRYPTO_ENCRYPT_SECRET_KEY_CRM`	Clave de cifrado para leer la PII de la fuente de datos CRM. Sensible.	—	No

Base de configuración compartida

Los siguientes bloques son idénticos en todos los productos de Lerian y están documentados por completo en la referencia de configuración BYOC. Están desactivados por defecto.

Autenticación de Access Manager — PLUGIN_AUTH_ENABLED, PLUGIN_AUTH_ADDRESS. Habilítala en producción.
Multi-tenancy — MULTI_TENANT_*, más RABBITMQ_MULTI_TENANT_SYNC_INTERVAL y RABBITMQ_MULTI_TENANT_DISCOVERY_TIMEOUT. Desactivado por defecto.
Descubrimiento de servicios — SD_* (Consul; Reporter también acepta los alias heredados SD_ADVERTISE_* / CONSUL_ADDR). Desactivado por defecto.
Streaming de eventos — STREAMING_ENABLED, STREAMING_BROKERS, STREAMING_CLOUDEVENTS_SOURCE, más RABBITMQ_REPORT_EVENTS_EXCHANGE para el exchange de eventos. Desactivado por defecto.
OpenTelemetry — ENABLE_TELEMETRY, OTEL_*, OTEL_INSECURE_EXPORTER. La telemetría es push OTLP.

Resumen

Guías

Console

Operaciones

Variables de entorno

Modo de ejecución y puertos

Despliegue y TLS

CORS y proxies

Base de datos (MongoDB)

Broker de mensajes (RabbitMQ)

Almacenamiento de objetos (compatible con S3)

Caché (Redis / Valkey)

Renderizado de PDF (worker)

Fuentes de datos de reportes

Base de configuración compartida

​Modo de ejecución y puertos

​Despliegue y TLS

​CORS y proxies

​Base de datos (MongoDB)

​Broker de mensajes (RabbitMQ)

​Almacenamiento de objetos (compatible con S3)

​Caché (Redis / Valkey)

​Renderizado de PDF (worker)

​Fuentes de datos de reportes

​Base de configuración compartida

Modo de ejecución y puertos

Despliegue y TLS

CORS y proxies

Base de datos (MongoDB)

Broker de mensajes (RabbitMQ)

Almacenamiento de objetos (compatible con S3)

Caché (Redis / Valkey)

Renderizado de PDF (worker)

Fuentes de datos de reportes

Base de configuración compartida