Skip to main content
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

OptionTypeRequiredDescription
endpointstringYesOTLP trace endpoint URL
service_namestringYesService identifier
enabledbooleanNoEnable/disable tracing (default: true)
resourceobjectNoAdditional 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