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

# Telemetry Overview

> Send and retrieve OpenTelemetry data from your MCP servers.

# Telemetry

Telemetry endpoints let you ingest OpenTelemetry traces and metrics from your MCP servers, and retrieve telemetry data for analysis.

## Endpoints

### Ingestion

| Method | Endpoint                                                          | Description                     |
| ------ | ----------------------------------------------------------------- | ------------------------------- |
| `POST` | [`/telemetry/ingest_http/traces`](/api/telemetry/ingest-traces)   | Ingest OpenTelemetry trace data |
| `POST` | [`/telemetry/ingest_http/metrics`](/api/telemetry/ingest-metrics) | Ingest OpenTelemetry metrics    |

### Retrieval

| Method | Endpoint                                                       | Description                                  |
| ------ | -------------------------------------------------------------- | -------------------------------------------- |
| `GET`  | [`/telemetry/fetch_resources`](/api/telemetry/fetch-resources) | Get all telemetry resources (services)       |
| `GET`  | [`/telemetry/fetch_traces`](/api/telemetry/fetch-traces)       | Get traces with optional filtering           |
| `GET`  | [`/telemetry/fetch_spans`](/api/telemetry/fetch-spans)         | Get individual spans with optional filtering |
| `GET`  | [`/telemetry/fetch_metrics`](/api/telemetry/fetch-metrics)     | Get metrics data with optional filtering     |

## SDKs

While you can use the API directly for telemetry ingestion, we recommend using our official SDKs:

* [TypeScript SDK](/sdk/typescript/installation) — `@shinzolabs/instrumentation-mcp`
* [Python SDK](/sdk/python/installation) — `shinzo`

The SDKs handle authentication, batching, retries, and error handling automatically.