Receive traces

curl --request POST \
  --url https://gateway-api.unomiq.com/v1/traces \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "resourceSpans": [
    {
      "resource": {
        "attributes": [
          {
            "key": "service.name",
            "value": {
              "stringValue": "my-service"
            }
          },
          {
            "key": "service.version",
            "value": {
              "stringValue": "1.0.0"
            }
          }
        ]
      },
      "scopeSpans": [
        {
          "scope": {
            "name": "my-instrumentation-library",
            "version": "1.0.0"
          },
          "spans": [
            {
              "traceId": "5B8EFFF798038103D269B633813FC60C",
              "spanId": "EEE19B7EC3C1B174",
              "parentSpanId": "EEE19B7EC3C1B173",
              "name": "GET /api/users",
              "kind": 2,
              "startTimeUnixNano": "1544712660000000000",
              "endTimeUnixNano": "1544712661000000000",
              "attributes": [
                {
                  "key": "http.method",
                  "value": {
                    "stringValue": "GET"
                  }
                },
                {
                  "key": "http.url",
                  "value": {
                    "stringValue": "https://api.example.com/users"
                  }
                },
                {
                  "key": "http.status_code",
                  "value": {
                    "intValue": 200
                  }
                }
              ],
              "status": {
                "code": 0
              }
            }
          ]
        }
      ]
    }
  ]
}
'

{
  "partialSuccess": {
    "rejectedSpans": 0,
    "errorMessage": ""
  }
}

OpenTelemetry Traces

Receive Traces

Submit trace data to the OpenTelemetry Collector using OTLP/HTTP protocol.

The request must include a valid OAuth2 bearer token in the Authorization header, obtained from the Unomiq OAuth API.

The collector processes traces through the following pipeline:

Extract API key ID from JWT sub claim
Extract app ID from JWT custom claim
Filter out spans without app ID (silently dropped, no error returned)

Note: The endpoint always returns 200 OK if the request is valid, even if spans are filtered out due to missing app ID. Check partialSuccess in the response for details.

POST

traces

Receive traces

curl --request POST \
  --url https://gateway-api.unomiq.com/v1/traces \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "resourceSpans": [
    {
      "resource": {
        "attributes": [
          {
            "key": "service.name",
            "value": {
              "stringValue": "my-service"
            }
          },
          {
            "key": "service.version",
            "value": {
              "stringValue": "1.0.0"
            }
          }
        ]
      },
      "scopeSpans": [
        {
          "scope": {
            "name": "my-instrumentation-library",
            "version": "1.0.0"
          },
          "spans": [
            {
              "traceId": "5B8EFFF798038103D269B633813FC60C",
              "spanId": "EEE19B7EC3C1B174",
              "parentSpanId": "EEE19B7EC3C1B173",
              "name": "GET /api/users",
              "kind": 2,
              "startTimeUnixNano": "1544712660000000000",
              "endTimeUnixNano": "1544712661000000000",
              "attributes": [
                {
                  "key": "http.method",
                  "value": {
                    "stringValue": "GET"
                  }
                },
                {
                  "key": "http.url",
                  "value": {
                    "stringValue": "https://api.example.com/users"
                  }
                },
                {
                  "key": "http.status_code",
                  "value": {
                    "intValue": 200
                  }
                }
              ],
              "status": {
                "code": 0
              }
            }
          ]
        }
      ]
    }
  ]
}
'

{
  "partialSuccess": {
    "rejectedSpans": 0,
    "errorMessage": ""
  }
}

Authorizations

Authorization

string

header

required

OAuth2/OIDC JWT token with required app ID and API key ID claims.

Headers

Content-Type

enum<string>

required

Content type of the request body

Available options:

application/json

Body

application/json

OTLP ExportTraceServiceRequest. The request body follows the standard OTLP/HTTP JSON format. See https://opentelemetry.io/docs/specs/otlp/#otlphttp-request for the full schema.

resourceSpans

object[]

Array of ResourceSpans as defined by the OTLP specification

Response

Traces accepted successfully

OTLP ExportTraceServiceResponse. See https://opentelemetry.io/docs/specs/otlp/#otlphttp-response for the full schema.

partialSuccess

object

Show child attributes

Introduction Introduction