Configuration - Lumina Documentation

Configure the Lumina TypeScript/JavaScript SDK.

Basic Configuration

import { initLumina } from '@uselumina/sdk';

const lumina = initLumina({
  endpoint: 'http://localhost:9411/v1/traces',
  service_name: 'my-service',
});

Configuration Options

Option	Type	Required	Description
`endpoint`	string	Yes	OTLP trace endpoint URL
`service_name`	string	Yes	Service identifier
`enabled`	boolean	No	Enable/disable tracing (default: true)
`resource`	object	No	Additional resource attributes

Environment-Based Configuration

const lumina = initLumina({
  endpoint: process.env.LUMINA_ENDPOINT,
  service_name: process.env.SERVICE_NAME,
  enabled: process.env.NODE_ENV === 'production',
});

Resource Attributes

const lumina = initLumina({
  endpoint: 'http://localhost:9411/v1/traces',
  service_name: 'my-service',
  resource: {
    environment: 'production',
    version: '1.2.0',
    region: 'us-east-1',
  },
});

Next Steps

Basic Usage

Learn basic tracing patterns

API Reference

Complete API documentation