---
title: "Add a log entry to a distributed trace"
method: POST
path: "/eclipse-conductor/rest/v1/global/traces"
tags: ["z) Global Functionality"]
---

# Add a log entry to a distributed trace

`POST /eclipse-conductor/rest/v1/global/traces`

Creates a new trace span or enriches an existing one. Omit traceId to start a new trace; the returned traceId can then be passed as the traceparent header in subsequent calls to correlate them. Trace IDs are always in W3C traceparent format, e.g. 00-0427951c0c0a82d422f30fbc1b18d1e1-a39b316aa5d96365-01.

## Request body

- TraceData — Trace data
  - `message` string
  - `serviceName` string
  - `spanName` string
  - `tags` Avp[] — Tags to add to the current span in the trace
    - `att` string, required
    - `val` string, required
  - `traceId` string — The trace to add this trace information to. If not provided, a new trace will be started

## Response `200`

OK

- TraceData — Trace data
  - `message` string
  - `serviceName` string
  - `spanName` string
  - `tags` Avp[] — Tags to add to the current span in the trace
    - `att` string, required
    - `val` string, required
  - `traceId` string — The trace to add this trace information to. If not provided, a new trace will be started

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/eftcorp/apis/eclipse-rest-api.md) · [All operations](https://skmtc.net/eftcorp/apis/eclipse-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eftcorp/eclipse-rest-api/versions/9213d52d49a3/schema)