Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.uselumina.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Traces Not Appearing

Check endpoint: 
// Correct
endpoint: 'http://localhost:9411/v1/traces'

// Wrong
endpoint: 'http://localhost:8081' // This is query API
Check ingestion logs: 
docker compose logs ingestion | grep ERROR
Test with cURL: 
curl -X POST http://localhost:9411/v1/traces \
  -H "Content-Type: application/json" \
  -d '{"resourceSpans":[...]}'

​
High Memory Usage

Increase PostgreSQL memory: 
ALTER SYSTEM SET shared_buffers = '8GB';
ALTER SYSTEM SET work_mem = '128MB';
Enable sampling: 
const lumina = initLumina({
  endpoint: 'http://lumina:9411/v1/traces',
  service_name: 'service',
  samplingRate: 0.1,
});
Configure retention: 
TRACE_RETENTION_DAYS=7

​
Slow Queries

Add indexes: 
CREATE INDEX CONCURRENTLY idx_traces_service
ON traces (service_name);

CREATE INDEX CONCURRENTLY idx_traces_cost
ON traces (cost_usd) WHERE cost_usd > 0.01;
Enable caching: 
ENABLE_QUERY_CACHE=true

​
Port Conflicts

Change ports: 
# .env
DASHBOARD_PORT=3001
API_PORT=8082
INGESTION_PORT=9412
Find conflicting process: 
lsof -i :3000
kill -9 <PID>

​
Database Connection Failed

Wait for PostgreSQL: 
docker compose logs postgres | grep "ready to accept connections"
Restart services: 
docker compose restart ingestion api
Check connection string: 
DATABASE_URL=postgres://user:password@localhost:5432/lumina

​
Need More Help?