> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracelit.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Telemetry

> Point the standard OpenTelemetry SDK at Tracelit. Pick your language, framework, and log library — traces and structured logs in one pipeline.

<Tip>
  Prefer a guided setup? In the Tracelit app, add a service and choose **I'm an engineer** (bash recipe) or **I'm a vibe coder** (explicit AI prompt). Both paths use language → framework → log library, then a live connection check for INFO and ERROR logs.
</Tip>

## Why this exists

OpenTelemetry installs easily for **traces**. Application **logs** only show up in Tracelit when your logger is bridged (or when a runtime agent captures it — e.g. the Java agent + Logback).

These pages document the exact recipes we show in onboarding:

1. Set OTLP env vars toward Tracelit ingest
2. Install the language SDK / agent
3. Wire your **framework**
4. Bridge your **log library**
5. Emit an INFO log and an ERROR, then verify

## Shared environment variables

```bash theme={null}
OTEL_SERVICE_NAME=my-service
OTEL_RESOURCE_ATTRIBUTES=deployment.environment=production
OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.tracelit.app
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer <WORKSPACE_INGEST_KEY>
```

<Warning>
  Protocol must be `http/protobuf`. SDKs that default to gRPC will fail silently against Tracelit ingest.
</Warning>

Supported `deployment.environment` values for backend services: `local`, `development`, `production`.

## Languages

| Language                                          | Frameworks & log libraries                                   | Guide                   |
| ------------------------------------------------- | ------------------------------------------------------------ | ----------------------- |
| <Icon icon="golang" iconType="brands" /> Go       | Gin, Echo, Chi, Fiber, net/http — slog, zerolog, zap, logrus | [Install](/otel/go)     |
| <Icon icon="node-js" iconType="brands" /> Node.js | Express, Fastify, NestJS — pino, winston, console            | [Install](/otel/node)   |
| <Icon icon="python" iconType="brands" /> Python   | FastAPI, Flask, Django — logging, structlog, loguru          | [Install](/otel/python) |
| <Icon icon="java" iconType="brands" /> Java       | Spring Boot — Logback, Log4j2 via the official javaagent     | [Install](/otel/java)   |
| <Icon icon="microsoft" iconType="brands" /> .NET  | ASP.NET Core — ILogger, Serilog                              | [Install](/otel/dotnet) |
| <Icon icon="gem" iconType="duotone" /> Ruby       | Rails, Sinatra — Logger, Semantic Logger                     | [Install](/otel/ruby)   |
| <Icon icon="gears" iconType="duotone" /> Rust     | Axum, Actix — tracing, log                                   | [Install](/otel/rust)   |