Skip to main content
POST
/
telemetry
/
ingest_http
/
traces
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}
        }]
      }]
    }]
  }'

{
  "partialSuccess": {}
}

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.

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:
AttributeTypeDescription
service.namestringName of your MCP server
service.versionstringVersion of your MCP server
mcp.tool.namestringName of the executed tool
mcp.tool.durationintExecution time in milliseconds
mcp.request.idstringUnique request identifier
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}
        }]
      }]
    }]
  }'

{
  "partialSuccess": {}
}