> ## 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.

# Lumina Documentation

> Production-grade observability for AI applications

<img className="block dark:hidden" src="https://mintcdn.com/igirievansongmailcom/zeiuTUA-qB9zaWy8/logo/light.svg?fit=max&auto=format&n=zeiuTUA-qB9zaWy8&q=85&s=471801ae4759255e251e6432eaf59933" alt="Lumina Logo" width="200" data-path="logo/light.svg" />

<img className="hidden dark:block" src="https://mintcdn.com/igirievansongmailcom/zeiuTUA-qB9zaWy8/logo/dark.svg?fit=max&auto=format&n=zeiuTUA-qB9zaWy8&q=85&s=21337dc73edb26dd5d5d8aab9cab073a" alt="Lumina Logo" width="200" data-path="logo/dark.svg" />

# Welcome to Lumina

Production-grade observability for AI applications.

Lumina is an OpenTelemetry-native platform for monitoring LLM applications in production. Track costs, latency, and quality across distributed AI systems with full trace visibility and regression testing.

***

## Get Started

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/docs/quickstart/docker">
    Install Lumina and send your first trace in under 10 minutes
  </Card>

  <Card title="SDK Reference" icon="code" href="/docs/sdk/typescript/installation">
    Instrument your application with the TypeScript/JavaScript SDK
  </Card>

  <Card title="Core Concepts" icon="book" href="/docs/introduction/core-concepts">
    Learn fundamental concepts: traces, spans, and attributes
  </Card>

  <Card title="Production Deployment" icon="server" href="/docs/deployment/kubernetes/production-checklist">
    Deploy to production with Kubernetes
  </Card>
</CardGroup>

***

## Features

<CardGroup cols={3}>
  <Card title="Cost Tracking" icon="dollar-sign">
    Automatic cost calculation for OpenAI, Anthropic, and major providers
  </Card>

  <Card title="Distributed Tracing" icon="sitemap">
    Hierarchical tracing for RAG pipelines, agents, and multi-model systems
  </Card>

  <Card title="Quality Monitoring" icon="chart-line">
    Detect semantic degradation with built-in similarity scoring
  </Card>

  <Card title="Replay Testing" icon="rotate">
    Test changes against real production data before deployment
  </Card>

  <Card title="Real-Time Alerts" icon="bell">
    Get notified of cost spikes and quality drops in under 500ms
  </Card>

  <Card title="Self-Hosted" icon="server">
    Deploy on your infrastructure with full data control
  </Card>
</CardGroup>

***

## Popular Pages

<CardGroup cols={2}>
  <Card title="Multi-Span Tracing" icon="sitemap" href="/docs/features/tracing/multi-span">
    Track complex workflows like RAG pipelines with hierarchical spans
  </Card>

  <Card title="OpenAI Integration" icon="plug" href="/docs/integrations/openai">
    Complete guide to integrating OpenAI models
  </Card>

  <Card title="Anthropic Integration" icon="plug" href="/docs/integrations/anthropic">
    Complete guide to integrating Anthropic Claude models
  </Card>

  <Card title="Performance Optimization" icon="gauge-high" href="/docs/best-practices/performance">
    Optimize Lumina for high-throughput workloads
  </Card>
</CardGroup>

***

## Community

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/use-lumina/Lumina">
    Star us on GitHub and contribute to the project
  </Card>

  <Card title="Discussions" icon="comments" href="https://github.com/use-lumina/Lumina/discussions">
    Ask questions and get help from the community
  </Card>

  <Card title="Report Issues" icon="bug" href="https://github.com/use-lumina/Lumina/issues">
    Report bugs and request features
  </Card>

  <Card title="Examples" icon="code" href="https://github.com/use-lumina/Lumina/tree/main/examples">
    Explore example applications
  </Card>
</CardGroup>

***

## Self-Hosted

The open-source version is free forever with:

* **50,000 traces per day** — Resets at midnight UTC
* **7-day retention** — Automatic cleanup
* **All features included** — No paywalled functionality

For unlimited traces and managed hosting, [contact us](mailto:support@uselumina.io).

***

## Need Help?

<Card title="FAQ" icon="circle-question" href="/docs/introduction/faq">
  Frequently asked questions about Lumina
</Card>

<Card title="Troubleshooting" icon="wrench" href="/docs/best-practices/troubleshooting">
  Common issues and solutions
</Card>