Create spans

Submit spans to be inserted into a project. If any spans are invalid or duplicates, no spans will be inserted.

POST /v1/projects/{project_identifier}/spans

Try it

Create spans

cURL

curl --request POST \
  --url https://api.example.com/v1/projects/{project_identifier}/spans \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": [
    {
      "name": "<string>",
      "context": {
        "trace_id": "<string>",
        "span_id": "<string>"
      },
      "span_kind": "<string>",
      "start_time": "2023-11-07T05:31:56Z",
      "end_time": "2023-11-07T05:31:56Z",
      "status_code": "<string>",
      "id": "",
      "parent_id": "<string>",
      "status_message": "",
      "attributes": {},
      "events": [
        {
          "name": "<string>",
          "timestamp": "2023-11-07T05:31:56Z",
          "attributes": {}
        }
      ]
    }
  ]
}
'

202

{
  "total_received": 123,
  "total_queued": 123
}

Path Parameters

project_identifier · string · required

The project identifier: either project ID or project name. If using a project name, it cannot contain slash (/), question mark (?), or pound sign (#) characters.

Body

application/json

data · Span · object[] · required

Show child attributes

data. name · string · required

Name of the span operation

data. context · SpanContext · object · required

Span context containing trace_id and span_id

Show child attributes

data.context. trace_id · string · required

OpenTelemetry trace ID

data.context. span_id · string · required

OpenTelemetry span ID

data. span_kind · string · required

Type of work that the span encapsulates

data. start_time · string<date-time> · required

Start time of the span

data. end_time · string<date-time> · required

End time of the span

data. status_code · string · required

Status code of the span

data. id · string · default: ""

Span Global ID, distinct from the OpenTelemetry span ID

data. parent_id · string | null

OpenTelemetry span ID of the parent span

data. status_message · string · default: ""

Status message

data. attributes · Attributes · object

Span attributes

data. events · SpanEvent · object[]

Span events

Show child attributes

data.events. name · string · required

Name of the event

data.events. timestamp · string<date-time> · required

When the event occurred

data.events. attributes · Attributes · object

Event attributes

Response

202

application/json

Successful Response

total_received · integer · required

Total number of spans received

total_queued · integer · required

Number of spans successfully queued for insertion