OpenObserve
Overview
Section titled “Overview”OpenObserve is an observability platform for logs, metrics, and traces.
Key features:
- Log aggregation and search
- Metrics visualization
- Distributed tracing
- Low resource usage
Installation
Section titled “Installation”shc install openobserve --stack observabilityCommon variables:
admin_user- Admin username (default: admin)admin_password- Admin password (auto-generated)public_host- Public hostnames3_bucket- S3 bucket for storage (optional)
Configuration
Section titled “Configuration”Configure SHC to send telemetry to OpenObserve:
collector: enabled: true endpoint: "http://openobserve:5080" logs: enabled: true metrics: enabled: true traces: enabled: trueCollector Setup
Section titled “Collector Setup”OpenObserve receives:
- Logs: JSON format via
/shc_logs/_json - Metrics: Custom format via
/ingest/metrics/_json - Traces: OTLP format via
/v1/traces
Access Dashboard
Section titled “Access Dashboard”- URL: https://{public_host}
- Username: {admin_user}
- Password: (from vault)
shc vault get observability/admin_password
Querying Data
Section titled “Querying Data”Example log query:
SELECT * FROM shc_logsWHERE tenant = 'production' AND timestamp > now() - interval '1 hour'ORDER BY timestamp DESCLIMIT 100Backup
Section titled “Backup”OpenObserve backup includes:
- Configuration
- User accounts
- Dashboards and alerts
- Indexed data (if using local storage)
Note: S3-backed data is not included in backups (managed externally).
Troubleshooting
Section titled “Troubleshooting”Common issues:
Problem: No logs appearing Solution: Verify collector endpoint in config.yaml
Problem: High memory usage Solution: Reduce retention period or use S3 storage
See Also
Section titled “See Also”shc@docs:~$