# Telemetry Machine

> OpenTelemetry-native observability. Send traces, logs and metrics over OTLP, then query them as columns.

To connect a coding agent such as Claude Code, Codex or Cursor:

- MCP server: https://telemetrymachine.com/api/mcp (Streamable HTTP). The user signs in with OAuth in their browser. Once connected, call `get_onboarding_guide` and follow it, or `get_instrumentation_guide` if the organization already sends data.
- Claude Code plugin, which adds the MCP server and needs Claude Code 2.1.292 or later: `claude plugin install telemetry-machine --marketplace telemetry-machine/agent-skills`
- Without MCP: read [Send OpenTelemetry Data](https://telemetrymachine.com/docs/send-opentelemetry.md) and your framework's guide under Frameworks, then send OTLP/HTTP to https://api.telemetrymachine.com with the `X-API-Key` and `X-Dataset-Name` headers. The user creates the dataset and its API key at https://telemetrymachine.com/datasets/new.
- tm-cli, the command line: builds for each OS and architecture are in https://telemetrymachine.com/downloads/tm-cli/manifest.json.

The full text of every page is at https://telemetrymachine.com/docs/llms-full.txt.

## Get started

- [Quick Start](https://telemetrymachine.com/docs/quick-start.md): Connect an application with a coding agent or manual setup.

## Send data

- [Send OpenTelemetry Data](https://telemetrymachine.com/docs/send-opentelemetry.md): What Telemetry Machine needs from an OpenTelemetry exporter or Collector, and how it stores what it receives.
- [Canonical Log Lines](https://telemetrymachine.com/docs/canonical-log-lines.md): Emit one wide, structured log record per request, so each request can be queried as a single event.
- [Send JSON Events](https://telemetrymachine.com/docs/json-events.md): Create an events dataset, send JSON events with HTTP, and read the response.
- [Send Render Metrics](https://telemetrymachine.com/docs/render.md): Stream the metrics of your Render services, databases, and Key Value instances to a Telemetry Machine metrics dataset.
- [Annotations](https://telemetrymachine.com/docs/annotations.md): Mark deploys, changes and comments next to your telemetry, from CI, tm-cli or an agent.

## Frameworks

- [Instrument FastAPI with OpenTelemetry](https://telemetrymachine.com/docs/opentelemetry/fastapi.md): Send traces, logs and metrics from a FastAPI app to Telemetry Machine with OpenTelemetry's zero-code Python instrumentation. No code changes.
- [Instrument Django with OpenTelemetry](https://telemetrymachine.com/docs/opentelemetry/django.md): Send traces, logs and metrics from a Django app to Telemetry Machine with OpenTelemetry's zero-code Python instrumentation. No code changes.
- [Instrument Flask with OpenTelemetry](https://telemetrymachine.com/docs/opentelemetry/flask.md): Send traces, logs and metrics from a Flask app to Telemetry Machine with OpenTelemetry's zero-code Python instrumentation. No code changes.
- [Instrument Express with OpenTelemetry](https://telemetrymachine.com/docs/opentelemetry/express.md): Send traces, logs and metrics from an Express app to Telemetry Machine with OpenTelemetry's zero-code Node.js instrumentation. No code changes.
- [Instrument Next.js with OpenTelemetry](https://telemetrymachine.com/docs/opentelemetry/nextjs.md): Send Next.js traces to Telemetry Machine with @vercel/otel and Next.js's built-in OpenTelemetry spans, for routes, rendering and fetch calls.
- [Instrument Spring Boot with OpenTelemetry](https://telemetrymachine.com/docs/opentelemetry/spring-boot.md): Send traces, logs and metrics from a Spring Boot app to Telemetry Machine with the OpenTelemetry Java agent. No code changes.
- [Instrument ASP.NET Core with OpenTelemetry](https://telemetrymachine.com/docs/opentelemetry/aspnet-core.md): Send traces, logs and metrics from an ASP.NET Core app to Telemetry Machine with the OpenTelemetry .NET SDK, in five lines of setup.
- [Instrument Go net/http with OpenTelemetry](https://telemetrymachine.com/docs/opentelemetry/go.md): Send traces, logs and metrics from a Go net/http server to Telemetry Machine with otelhttp, slog and the OpenTelemetry Go SDK.
- [Instrument Rails with OpenTelemetry](https://telemetrymachine.com/docs/opentelemetry/rails.md): Send traces and logs from a Ruby on Rails app to Telemetry Machine with the OpenTelemetry Ruby SDK and its Rails instrumentation.

## Data model

- [Schema Management](https://telemetrymachine.com/docs/schema-management.md): How Telemetry Machine stores fields and evolves schemas for OpenTelemetry data.
- [Writing Effective Queries](https://telemetrymachine.com/docs/writing-effective-queries.md): How to write SQL that finds the right fields and returns the right answer in Telemetry Machine.
- [Effective Investigation](https://telemetrymachine.com/docs/effective-investigation.md): The order in which to look at Telemetry Machine data when something is wrong.

## API reference

- [API reference](https://telemetrymachine.com/docs/api.md): The Telemetry Machine REST API, with its base URL, credentials, responses and errors.
- [Annotations](https://telemetrymachine.com/docs/api/annotations.md): The Annotation object, and the endpoints to create, list, retrieve, update and delete annotations.
- [CI trust rules](https://telemetrymachine.com/docs/api/ci-trust-rules.md): The repositories whose GitHub Actions or GitLab CI jobs may post annotations with their OIDC token, without a stored secret.