curl -X POST https://api.app.shinzo.ai/telemetry/ingest_http/traces \
  -H "Authorization: Bearer YOUR_INGEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "resourceSpans": [{
      "resource": {
        "attributes": [
          {"key": "service.name", "value": {"stringValue": "my-mcp-server"}},
          {"key": "service.version", "value": {"stringValue": "1.0.0"}}
        ]
      },
      "scopeSpans": [{
        "scope": {
          "name": "@shinzolabs/instrumentation-mcp",
          "version": "1.0.0"
        },
        "spans": [{
          "traceId": "5b8aa5a2d2c872e8321cf37308d69df2",
          "spanId": "051581bf3cb55c13",
          "name": "mcp.tool.execute",
          "kind": 1,
          "startTimeUnixNano": "1705315200000000000",
          "endTimeUnixNano": "1705315200125000000",
          "attributes": [
            {"key": "mcp.tool.name", "value": {"stringValue": "search_files"}},
            {"key": "mcp.tool.duration", "value": {"intValue": "125"}}
          ],
          "status": {"code": 1}
        }]
      }]
    }]
  }'

# Using the Shinzo Python SDK (recommended)
from shinzo import instrument_server
import os

observability = instrument_server(
    server,
    config={
        "server_name": "my-server",
        "server_version": "1.0.0",
        "exporter_endpoint": "https://api.app.shinzo.ai/telemetry/ingest_http",
        "exporter_auth": {
            "type": "bearer",
            "token": os.getenv("SHINZO_INGEST_TOKEN")
        }
    }
)

// Using the Shinzo TypeScript SDK (recommended)
import { instrumentServer } from "@shinzolabs/instrumentation-mcp"

const telemetry = instrumentServer(server, {
  serverName: "my-server",
  serverVersion: "1.0.0",
  exporterEndpoint: "https://api.app.shinzo.ai/telemetry/ingest_http",
  exporterAuth: {
    type: "bearer",
    token: process.env.SHINZO_INGEST_TOKEN
  }
})

{
  "partialSuccess": {}
}

{
  "success": false,
  "error": {
    "code": "INVALID_TOKEN",
    "message": "The provided ingest token is invalid"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_OTLP",
    "message": "Malformed OTLP payload"
  }
}