Ingest Traces

Send OpenTelemetry traces using OTLP/HTTP protocol

POST /telemetry/ingest_http/traces

cURL

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}
        }]
      }]
    }]
  }'

200

{
  "partialSuccess": {}
}

Ingest OpenTelemetry traces from your MCP servers. This endpoint accepts OTLP (OpenTelemetry Protocol) formatted data in either JSON or protobuf encoding.

We recommend using our TypeScript SDK or Python SDK instead of calling this endpoint directly. The SDKs handle batching, retries, and error handling automatically.

Content-Type · string · required

application/json or application/x-protobuf

resourceSpans · array · required

Array of OpenTelemetry ResourceSpans containing trace data

partialSuccess · object

Indicates partial success if some spans were rejected

MCP Semantic Conventions

Include these attributes for optimal dashboard visualization:

Attribute	Type	Description
service.name	string	Name of your MCP server
service.version	string	Version of your MCP server
mcp.tool.name	string	Name of the executed tool
mcp.tool.duration	int	Execution time in milliseconds
mcp.request.id	string	Unique request identifier

cURL

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}
        }]
      }]
    }]
  }'

200

{
  "partialSuccess": {}
}