logtracesingestrequest.md

LogTracesIngestRequest

Request model for ingesting traces.

Example Usage

import { LogTracesIngestRequest } from "galileo-generated/models";

let value: LogTracesIngestRequest = {
  logStreamId: "00000000-0000-0000-0000-000000000000",
  sessionId: "00000000-0000-0000-0000-000000000000",
  traces: [
    {
      input: "who is a smart LLM?",
      output: "I am!",
      createdAt: new Date("2026-01-28T00:17:57.438225Z"),
      userMetadata: {},
      tags: [],
      metrics: {},
      datasetMetadata: {},
      spans: [
        {
          type: "llm",
          input: [
            {
              content: "Question: who is a smart LLM?",
              role: "user",
            },
          ],
          output: {
            content: "I am!",
            role: "user",
          },
          name: "",
          createdAt: new Date("2026-01-28T00:17:57.438190Z"),
          userMetadata: {},
          tags: [],
          metrics: {},
          datasetMetadata: {},
        },
      ],
    },
  ],
};

Fields

Field	Type	Required	Description
logStreamId	string	➖	Log stream id associated with the traces.
experimentId	string	➖	Experiment id associated with the traces.
metricsTestingId	string	➖	Metrics testing id associated with the traces.
loggingMethod	models.LoggingMethod	➖	N/A
clientVersion	string	➖	N/A
reliable	boolean	➖	Whether or not to use reliable logging. If set to False, the method will respond immediately before verifying that the traces have been successfully ingested, and no error message will be returned if ingestion fails. If set to True, the method will wait for the traces to be successfully ingested or return an error message if there is an ingestion failure.
sessionId	string	➖	Session id associated with the traces.
sessionExternalId	string	➖	External id of the session (e.g., OTEL session.id from span attributes).
traces	models.Trace[]	✔️	List of traces to log.
isComplete	boolean	➖	Whether or not the records in this request are complete.
includeTraceIds	boolean	➖	If True, include the list of ingested trace IDs in the response.