Observability Enhancements
New optional OpenTelemetry support and configurable log levels for self-hosted deployments
New: Observability Enhancements
This release adds optional OpenTelemetry support for improved monitoring and configurable log levels for self-hosted Databrain deployments.
Upgrade Notes
No action required for upgrade - all defaults maintain current behavior. Your existing deployment will work exactly as before without any configuration changes.
New Features
Configurable Log Levels
You can now control the verbosity of application logs via the LOG_LEVEL environment variable:
LOG_LEVEL=info # Default - same as current behavior
LOG_LEVEL=debug # Enable detailed debug logs for troubleshooting
LOG_LEVEL=warn # Only warnings and errors
LOG_LEVEL=error # Only errorsOpenTelemetry Integration (Optional)
Enable comprehensive observability with OpenTelemetry to get:
- API Latency Tracking: Automatic timing for all endpoints
- Error Rate Metrics: Monitor application health
- Distributed Tracing: See exactly where time is spent in each request
- Log Correlation: Link logs to specific request traces
To enable, add these to your .env:
OTEL_ENABLED=true
OTEL_EXPORTER_OTLP_ENDPOINT=http://your-collector:4318OpenTelemetry data can be exported to any OTLP-compatible backend including:
- Grafana (Tempo + Loki + Prometheus)
- SigNoz
- Jaeger
- Datadog
- New Relic
New Environment Variables
| Variable | Default | Description |
|---|---|---|
LOG_LEVEL | info | Log verbosity (debug/info/warn/error) |
OTEL_ENABLED | false | Enable OpenTelemetry |
OTEL_EXPORTER_OTLP_ENDPOINT | - | OTLP collector URL |
OTEL_SERVICE_NAME | databrain-api | Service name in traces |
Documentation
See the Observability Setup Guide for detailed configuration instructions.