Ai Attributes

38 attributes in this category.38 deprecated

Scrubbing Visibility OTel

38 attributes

Deprecated Attributes

These attributes are deprecated and should not be used in new code. See each attribute for migration guidance.

`ai.citations`Deprecated

string[]Scrub: AutoVisibility: PublicOTel: False

References or sources cited by the AI model in its response.

Example["Citation 1","Citation 2"]

No replacement available at this time.

Changelog

v0.5.0#264

v0.1.0#55

Raw JSON

{
  "key": "ai.citations",
  "brief": "References or sources cited by the AI model in its response.",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "Citation 1",
    "Citation 2"
  ],
  "deprecation": {
    "_status": null
  },
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55
      ]
    }
  ]
}

`ai.completion_tokens.used`Deprecated

integerScrub: ManualVisibility: PublicOTel: False

The number of tokens used to respond to the message.

Example10

Aliasesgen_ai.usage.output_tokensgen_ai.usage.completion_tokens

Use gen_ai.usage.output_tokens instead.

Status: backfill

Changelog

v0.4.0#228

v0.1.0#57 #61

v0.0.0

Raw JSON

{
  "key": "ai.completion_tokens.used",
  "brief": "The number of tokens used to respond to the message.",
  "type": "integer",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 10,
  "deprecation": {
    "replacement": "gen_ai.usage.output_tokens",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.usage.output_tokens",
    "gen_ai.usage.completion_tokens"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        57,
        61
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

`ai.documents`Deprecated

string[]Scrub: AutoVisibility: PublicOTel: False

Documents or content chunks used as context for the AI model.

Example["document1.txt","document2.pdf"]

No replacement available at this time.

Changelog

v0.5.0#264

v0.1.0#55

Raw JSON

{
  "key": "ai.documents",
  "brief": "Documents or content chunks used as context for the AI model.",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "document1.txt",
    "document2.pdf"
  ],
  "deprecation": {
    "_status": null
  },
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55
      ]
    }
  ]
}

`ai.finish_reason`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The reason why the model stopped generating.

ExampleCOMPLETE

Aliasesgen_ai.response.finish_reasons

Use gen_ai.response.finish_reasons instead.

Status: backfill

Changelog

v0.1.0#55 #57 #61 #108 #127

Raw JSON

{
  "key": "ai.finish_reason",
  "brief": "The reason why the model stopped generating.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "COMPLETE",
  "deprecation": {
    "replacement": "gen_ai.response.finish_reasons",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.response.finish_reasons"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        55,
        57,
        61,
        108,
        127
      ]
    }
  ]
}

`ai.frequency_penalty`Deprecated

doubleScrub: ManualVisibility: PublicOTel: False

Used to reduce repetitiveness of generated tokens. The higher the value, the stronger a penalty is applied to previously present tokens, proportional to how many times they have already appeared in the prompt or prior generation.

Example0.5

Aliasesgen_ai.request.frequency_penalty

Use gen_ai.request.frequency_penalty instead.

Status: backfill

Changelog

v0.4.0#228

v0.1.0#55 #57 #61 #108

Raw JSON

{
  "key": "ai.frequency_penalty",
  "brief": "Used to reduce repetitiveness of generated tokens. The higher the value, the stronger a penalty is applied to previously present tokens, proportional to how many times they have already appeared in the prompt or prior generation.",
  "type": "double",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 0.5,
  "deprecation": {
    "replacement": "gen_ai.request.frequency_penalty",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.request.frequency_penalty"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55,
        57,
        61,
        108
      ]
    }
  ]
}

`ai.function_call`Deprecated

stringScrub: AutoVisibility: PublicOTel: False

For an AI model call, the function that was called. This is deprecated for OpenAI, and replaced by tool_calls

Examplefunction_name

Aliasesgen_ai.tool.namemcp.tool.name

Use gen_ai.tool.name instead.

Status: backfill

Changelog

v0.1.0#55 #57 #61 #108

Raw JSON

{
  "key": "ai.function_call",
  "brief": "For an AI model call, the function that was called. This is deprecated for OpenAI, and replaced by tool_calls",
  "type": "string",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "function_name",
  "deprecation": {
    "replacement": "gen_ai.tool.name",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.tool.name",
    "mcp.tool.name"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        55,
        57,
        61,
        108
      ]
    }
  ]
}

`ai.generation_id`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

Unique identifier for the completion.

Examplegen_123abc

Aliasesgen_ai.response.id

Use gen_ai.response.id instead.

Status: backfill

Changelog

v0.1.0#55 #57 #61 #108 #127

Raw JSON

{
  "key": "ai.generation_id",
  "brief": "Unique identifier for the completion.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "gen_123abc",
  "deprecation": {
    "replacement": "gen_ai.response.id",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.response.id"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        55,
        57,
        61,
        108,
        127
      ]
    }
  ]
}

`ai.input_messages`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The input messages sent to the model

Example[{"role": "user", "message": "hello"}]

Aliasesgen_ai.request.messages

Use gen_ai.input.messages instead.

Status: backfill

Changelog

v0.1.0#65 #119

v0.0.0

Raw JSON

{
  "key": "ai.input_messages",
  "brief": "The input messages sent to the model",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "[{\"role\": \"user\", \"message\": \"hello\"}]",
  "deprecation": {
    "replacement": "gen_ai.input.messages",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.request.messages"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        65,
        119
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

`ai.is_search_required`Deprecated

booleanScrub: ManualVisibility: PublicOTel: False

Boolean indicating if the model needs to perform a search.

Examplefalse

No replacement available at this time.

Changelog

v0.5.0#264

v0.1.0#55

Raw JSON

{
  "key": "ai.is_search_required",
  "brief": "Boolean indicating if the model needs to perform a search.",
  "type": "boolean",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": false,
  "deprecation": {
    "_status": null
  },
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55
      ]
    }
  ]
}

`ai.metadata`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

Extra metadata passed to an AI pipeline step.

Example{"user_id": 123, "session_id": "abc123"}

No replacement available at this time.

Changelog

v0.5.0#264

v0.1.0#55 #127

Raw JSON

{
  "key": "ai.metadata",
  "brief": "Extra metadata passed to an AI pipeline step.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "{\"user_id\": 123, \"session_id\": \"abc123\"}",
  "deprecation": {
    "_status": null
  },
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55,
        127
      ]
    }
  ]
}

`ai.model_id`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The vendor-specific ID of the model used.

Examplegpt-4

Aliasesgen_ai.request.model

Use gen_ai.request.model instead.

Status: backfill

Changelog

v0.1.0#57 #61 #127

v0.0.0

Raw JSON

{
  "key": "ai.model_id",
  "brief": "The vendor-specific ID of the model used.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "gpt-4",
  "deprecation": {
    "replacement": "gen_ai.request.model",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.request.model"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        57,
        61,
        127
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

`ai.model.provider`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The provider of the model.

Exampleopenai

Aliasesgen_ai.provider.namegen_ai.system

Use gen_ai.provider.name instead.

Status: backfill

Changelog

v0.4.0#253

v0.1.0#57 #61 #108 #127

Raw JSON

{
  "key": "ai.model.provider",
  "brief": "The provider of the model.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "openai",
  "deprecation": {
    "replacement": "gen_ai.provider.name",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.provider.name",
    "gen_ai.system"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        253
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        57,
        61,
        108,
        127
      ]
    }
  ]
}

`ai.pipeline.name`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The name of the AI pipeline.

ExampleAutofix Pipeline

Aliasesgen_ai.pipeline.name

Use gen_ai.pipeline.name instead.

Status: backfill

Changelog

v0.1.0#53 #76 #108 #127

Raw JSON

{
  "key": "ai.pipeline.name",
  "brief": "The name of the AI pipeline.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "Autofix Pipeline",
  "deprecation": {
    "replacement": "gen_ai.pipeline.name",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.pipeline.name"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        53,
        76,
        108,
        127
      ]
    }
  ]
}

`ai.preamble`Deprecated

stringScrub: AutoVisibility: PublicOTel: False

For an AI model call, the preamble parameter. Preambles are a part of the prompt used to adjust the model's overall behavior and conversation style.

ExampleYou are now a clown.

Aliasesgen_ai.system_instructions

Use gen_ai.system_instructions instead.

Status: backfill

Changelog

v0.5.0#264

v0.1.0#55

Raw JSON

{
  "key": "ai.preamble",
  "brief": "For an AI model call, the preamble parameter. Preambles are a part of the prompt used to adjust the model's overall behavior and conversation style.",
  "type": "string",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "You are now a clown.",
  "deprecation": {
    "replacement": "gen_ai.system_instructions",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.system_instructions"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55
      ]
    }
  ]
}

`ai.presence_penalty`Deprecated

doubleScrub: ManualVisibility: PublicOTel: False

Used to reduce repetitiveness of generated tokens. Similar to frequency_penalty, except that this penalty is applied equally to all tokens that have already appeared, regardless of their exact frequencies.

Example0.5

Aliasesgen_ai.request.presence_penalty

Use gen_ai.request.presence_penalty instead.

Status: backfill

Changelog

v0.4.0#228

v0.1.0#55 #57 #61 #108

Raw JSON

{
  "key": "ai.presence_penalty",
  "brief": "Used to reduce repetitiveness of generated tokens. Similar to frequency_penalty, except that this penalty is applied equally to all tokens that have already appeared, regardless of their exact frequencies.",
  "type": "double",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 0.5,
  "deprecation": {
    "replacement": "gen_ai.request.presence_penalty",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.request.presence_penalty"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55,
        57,
        61,
        108
      ]
    }
  ]
}

`ai.prompt_tokens.used`Deprecated

integerScrub: ManualVisibility: PublicOTel: False

The number of tokens used to process just the prompt.

Example20

Aliasesgen_ai.usage.prompt_tokensgen_ai.usage.input_tokens

Use gen_ai.usage.input_tokens instead.

Status: backfill

Changelog

v0.4.0#228

v0.1.0#57 #61

v0.0.0

Raw JSON

{
  "key": "ai.prompt_tokens.used",
  "brief": "The number of tokens used to process just the prompt.",
  "type": "integer",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 20,
  "deprecation": {
    "replacement": "gen_ai.usage.input_tokens",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.usage.prompt_tokens",
    "gen_ai.usage.input_tokens"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        57,
        61
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

`ai.prompt.messages`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The input messages sent to the AI model.

Example[{"role": "user", "message": "hello"}]

Aliasesgen_ai.input.messagesai.textsgen_ai.prompt

Use gen_ai.input.messages instead.

Status: backfill

Changelog

v0.19.0#498Added ai.prompt.messages attribute

Raw JSON

{
  "key": "ai.prompt.messages",
  "brief": "The input messages sent to the AI model.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "[{\"role\": \"user\", \"message\": \"hello\"}]",
  "deprecation": {
    "replacement": "gen_ai.input.messages",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.input.messages",
    "ai.texts",
    "gen_ai.prompt"
  ],
  "changelog": [
    {
      "version": "0.19.0",
      "prs": [
        498
      ],
      "description": "Added ai.prompt.messages attribute"
    }
  ]
}

`ai.raw_prompting`Deprecated

booleanScrub: ManualVisibility: PublicOTel: False

When enabled, the user’s prompt will be sent to the model without any pre-processing.

Exampletrue

No replacement available at this time.

Changelog

v0.5.0#264

v0.1.0#55

Raw JSON

{
  "key": "ai.raw_prompting",
  "brief": "When enabled, the user’s prompt will be sent to the model without any pre-processing.",
  "type": "boolean",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": true,
  "deprecation": {
    "_status": null
  },
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55
      ]
    }
  ]
}

`ai.response_format`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

For an AI model call, the format of the response

Examplejson_object

No replacement available at this time.

Changelog

v0.5.0#264

v0.1.0#55 #127

Raw JSON

{
  "key": "ai.response_format",
  "brief": "For an AI model call, the format of the response",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "json_object",
  "deprecation": {
    "_status": null
  },
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55,
        127
      ]
    }
  ]
}

`ai.response.text`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The text response from the AI model.

ExampleThe weather in Paris is currently rainy.

Aliasesgen_ai.output.messagesai.response.toolCalls

Use gen_ai.output.messages instead.

Status: backfill

Changelog

v0.19.0#498Added ai.response.text attribute

Raw JSON

{
  "key": "ai.response.text",
  "brief": "The text response from the AI model.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "The weather in Paris is currently rainy.",
  "deprecation": {
    "replacement": "gen_ai.output.messages",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.output.messages",
    "ai.response.toolCalls"
  ],
  "changelog": [
    {
      "version": "0.19.0",
      "prs": [
        498
      ],
      "description": "Added ai.response.text attribute"
    }
  ]
}

`ai.response.toolCalls`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The tool calls in the AI model response.

Example[{"name": "get_weather", "arguments": {"location": "Paris"}}]

Aliasesgen_ai.output.messagesai.response.text

Use gen_ai.output.messages instead.

Status: backfill

Changelog

v0.19.0#498Added ai.response.toolCalls attribute

Raw JSON

{
  "key": "ai.response.toolCalls",
  "brief": "The tool calls in the AI model response.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "[{\"name\": \"get_weather\", \"arguments\": {\"location\": \"Paris\"}}]",
  "deprecation": {
    "replacement": "gen_ai.output.messages",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.output.messages",
    "ai.response.text"
  ],
  "changelog": [
    {
      "version": "0.19.0",
      "prs": [
        498
      ],
      "description": "Added ai.response.toolCalls attribute"
    }
  ]
}

`ai.responses`Deprecated

string[]Scrub: ManualVisibility: PublicOTel: False

The response messages sent back by the AI model.

Example["hello","world"]

Use gen_ai.output.messages instead.

Status: backfill

Changelog

v0.1.0#65 #127

v0.0.0

Raw JSON

{
  "key": "ai.responses",
  "brief": "The response messages sent back by the AI model.",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "hello",
    "world"
  ],
  "deprecation": {
    "replacement": "gen_ai.output.messages",
    "_status": "backfill"
  },
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        65,
        127
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

`ai.search_queries`Deprecated

string[]Scrub: AutoVisibility: PublicOTel: False

Queries used to search for relevant context or documents.

Example["climate change effects","renewable energy"]

No replacement available at this time.

Changelog

v0.5.0#264

v0.1.0#55

Raw JSON

{
  "key": "ai.search_queries",
  "brief": "Queries used to search for relevant context or documents.",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "climate change effects",
    "renewable energy"
  ],
  "deprecation": {
    "_status": null
  },
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55
      ]
    }
  ]
}

`ai.search_results`Deprecated

string[]Scrub: AutoVisibility: PublicOTel: False

Results returned from search queries for context.

Example["search_result_1, search_result_2"]

No replacement available at this time.

Changelog

v0.5.0#264

v0.1.0#55

Raw JSON

{
  "key": "ai.search_results",
  "brief": "Results returned from search queries for context.",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "search_result_1, search_result_2"
  ],
  "deprecation": {
    "_status": null
  },
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55
      ]
    }
  ]
}

`ai.seed`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The seed, ideally models given the same seed and same other parameters will produce the exact same output.

Example1234567890

Aliasesgen_ai.request.seed

Use gen_ai.request.seed instead.

Status: backfill

Changelog

v0.1.0#55 #57 #61 #108 #127

Raw JSON

{
  "key": "ai.seed",
  "brief": "The seed, ideally models given the same seed and same other parameters will produce the exact same output.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "1234567890",
  "deprecation": {
    "replacement": "gen_ai.request.seed",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.request.seed"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        55,
        57,
        61,
        108,
        127
      ]
    }
  ]
}

`ai.streaming`Deprecated

booleanScrub: ManualVisibility: PublicOTel: False

Whether the request was streamed back.

Exampletrue

Aliasesgen_ai.response.streaming

Use gen_ai.response.streaming instead.

Status: backfill

Changelog

v0.1.0#76 #108

v0.0.0

Raw JSON

{
  "key": "ai.streaming",
  "brief": "Whether the request was streamed back.",
  "type": "boolean",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": true,
  "deprecation": {
    "replacement": "gen_ai.response.streaming",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.response.streaming"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        76,
        108
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

`ai.tags`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

Tags that describe an AI pipeline step.

Example{"executed_function": "add_integers"}

No replacement available at this time.

Changelog

v0.5.0#264

v0.1.0#55 #127

Raw JSON

{
  "key": "ai.tags",
  "brief": "Tags that describe an AI pipeline step.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "{\"executed_function\": \"add_integers\"}",
  "deprecation": {
    "_status": null
  },
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55,
        127
      ]
    }
  ]
}

`ai.temperature`Deprecated

doubleScrub: ManualVisibility: PublicOTel: False

For an AI model call, the temperature parameter. Temperature essentially means how random the output will be.

Example0.1

Aliasesgen_ai.request.temperature

Use gen_ai.request.temperature instead.

Status: backfill

Changelog

v0.4.0#228

v0.1.0#55 #57 #61 #108

Raw JSON

{
  "key": "ai.temperature",
  "brief": "For an AI model call, the temperature parameter. Temperature essentially means how random the output will be.",
  "type": "double",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 0.1,
  "deprecation": {
    "replacement": "gen_ai.request.temperature",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.request.temperature"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55,
        57,
        61,
        108
      ]
    }
  ]
}

`ai.texts`Deprecated

string[]Scrub: AutoVisibility: PublicOTel: False

Raw text inputs provided to the model.

Example["Hello, how are you?","What is the capital of France?"]

Aliasesgen_ai.input.messagesai.prompt.messagesgen_ai.prompt

Use gen_ai.input.messages instead.

Status: backfill

Changelog

v0.5.0#264

v0.1.0#55

Raw JSON

{
  "key": "ai.texts",
  "brief": "Raw text inputs provided to the model.",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "Hello, how are you?",
    "What is the capital of France?"
  ],
  "deprecation": {
    "replacement": "gen_ai.input.messages",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.input.messages",
    "ai.prompt.messages",
    "gen_ai.prompt"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55
      ]
    }
  ]
}

`ai.tool_calls`Deprecated

string[]Scrub: AutoVisibility: PublicOTel: False

For an AI model call, the tool calls that were made.

Example["tool_call_1","tool_call_2"]

Use gen_ai.output.messages instead.

Status: backfill

Changelog

v0.1.0#55 #65

Raw JSON

{
  "key": "ai.tool_calls",
  "brief": "For an AI model call, the tool calls that were made.",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "tool_call_1",
    "tool_call_2"
  ],
  "deprecation": {
    "replacement": "gen_ai.output.messages",
    "_status": "backfill"
  },
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        55,
        65
      ]
    }
  ]
}

`ai.toolCall.args`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The arguments of the tool call.

Example{"location": "Paris"}

Aliasesgen_ai.tool.call.argumentsgen_ai.tool.input

Use gen_ai.tool.call.arguments instead.

Status: backfill

Changelog

v0.19.0#498Added ai.toolCall.args attribute

Raw JSON

{
  "key": "ai.toolCall.args",
  "brief": "The arguments of the tool call.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "{\"location\": \"Paris\"}",
  "deprecation": {
    "replacement": "gen_ai.tool.call.arguments",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.tool.call.arguments",
    "gen_ai.tool.input"
  ],
  "changelog": [
    {
      "version": "0.19.0",
      "prs": [
        498
      ],
      "description": "Added ai.toolCall.args attribute"
    }
  ]
}

`ai.toolCall.result`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The result of the tool call.

Examplerainy, 57°F

Aliasesgen_ai.tool.call.resultgen_ai.tool.outputgen_ai.tool.messagemcp.tool.result.content

Use gen_ai.tool.call.result instead.

Status: backfill

Changelog

v0.19.0#498Added ai.toolCall.result attribute

Raw JSON

{
  "key": "ai.toolCall.result",
  "brief": "The result of the tool call.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "rainy, 57°F",
  "deprecation": {
    "replacement": "gen_ai.tool.call.result",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.tool.call.result",
    "gen_ai.tool.output",
    "gen_ai.tool.message",
    "mcp.tool.result.content"
  ],
  "changelog": [
    {
      "version": "0.19.0",
      "prs": [
        498
      ],
      "description": "Added ai.toolCall.result attribute"
    }
  ]
}

`ai.tools`Deprecated

string[]Scrub: ManualVisibility: PublicOTel: False

For an AI model call, the functions that are available

Example["function_1","function_2"]

Use gen_ai.tool.definitions instead.

Status: backfill

Changelog

v0.1.0#55 #65 #127

Raw JSON

{
  "key": "ai.tools",
  "brief": "For an AI model call, the functions that are available",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "function_1",
    "function_2"
  ],
  "deprecation": {
    "replacement": "gen_ai.tool.definitions",
    "_status": "backfill"
  },
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        55,
        65,
        127
      ]
    }
  ]
}

`ai.top_k`Deprecated

integerScrub: ManualVisibility: PublicOTel: False

Limits the model to only consider the K most likely next tokens, where K is an integer (e.g., top_k=20 means only the 20 highest probability tokens are considered).

Example35

Aliasesgen_ai.request.top_k

Use gen_ai.request.top_k instead.

Status: backfill

Changelog

v0.4.0#228

v0.1.0#55 #57 #61 #108

Raw JSON

{
  "key": "ai.top_k",
  "brief": "Limits the model to only consider the K most likely next tokens, where K is an integer (e.g., top_k=20 means only the 20 highest probability tokens are considered).",
  "type": "integer",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 35,
  "deprecation": {
    "replacement": "gen_ai.request.top_k",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.request.top_k"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55,
        57,
        61,
        108
      ]
    }
  ]
}

`ai.top_p`Deprecated

doubleScrub: ManualVisibility: PublicOTel: False

Limits the model to only consider tokens whose cumulative probability mass adds up to p, where p is a float between 0 and 1 (e.g., top_p=0.7 means only tokens that sum up to 70% of the probability mass are considered).

Example0.7

Aliasesgen_ai.request.top_p

Use gen_ai.request.top_p instead.

Status: backfill

Changelog

v0.4.0#228

v0.1.0#55 #57 #61 #108

Raw JSON

{
  "key": "ai.top_p",
  "brief": "Limits the model to only consider tokens whose cumulative probability mass adds up to p, where p is a float between 0 and 1 (e.g., top_p=0.7 means only tokens that sum up to 70% of the probability mass are considered).",
  "type": "double",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 0.7,
  "deprecation": {
    "replacement": "gen_ai.request.top_p",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.request.top_p"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55,
        57,
        61,
        108
      ]
    }
  ]
}

`ai.total_cost`Deprecated

doubleScrub: ManualVisibility: PublicOTel: False

The total cost for the tokens used.

Example12.34

Aliasesgen_ai.cost.total_tokens

Use gen_ai.cost.total_tokens instead.

Status: backfill

Changelog

v0.5.0#264

v0.4.0#228

v0.1.0#53

Raw JSON

{
  "key": "ai.total_cost",
  "brief": "The total cost for the tokens used.",
  "type": "double",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 12.34,
  "deprecation": {
    "replacement": "gen_ai.cost.total_tokens",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.cost.total_tokens"
  ],
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        53
      ]
    }
  ]
}

`ai.total_tokens.used`Deprecated

integerScrub: ManualVisibility: PublicOTel: False

The total number of tokens used to process the prompt.

Example30

Aliasesgen_ai.usage.total_tokens

Use gen_ai.usage.total_tokens instead.

Status: backfill

Changelog

v0.4.0#228

v0.1.0#57 #61 #108

v0.0.0

Raw JSON

{
  "key": "ai.total_tokens.used",
  "brief": "The total number of tokens used to process the prompt.",
  "type": "integer",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 30,
  "deprecation": {
    "replacement": "gen_ai.usage.total_tokens",
    "_status": "backfill"
  },
  "alias": [
    "gen_ai.usage.total_tokens"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        57,
        61,
        108
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

`ai.warnings`Deprecated

string[]Scrub: AutoVisibility: PublicOTel: False

Warning messages generated during model execution.

Example["Token limit exceeded"]

No replacement available at this time.

Changelog

v0.5.0#264

v0.1.0#55

Raw JSON

{
  "key": "ai.warnings",
  "brief": "Warning messages generated during model execution.",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "Token limit exceeded"
  ],
  "deprecation": {
    "_status": null
  },
  "changelog": [
    {
      "version": "0.5.0",
      "prs": [
        264
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        55
      ]
    }
  ]
}

Ai Attributes

Deprecated Attributes

ai.citationsDeprecated

ai.completion_tokens.usedDeprecated

ai.documentsDeprecated

ai.finish_reasonDeprecated

ai.frequency_penaltyDeprecated

ai.function_callDeprecated

ai.generation_idDeprecated

ai.input_messagesDeprecated

ai.is_search_requiredDeprecated

ai.metadataDeprecated

ai.model_idDeprecated

ai.model.providerDeprecated

ai.pipeline.nameDeprecated

ai.preambleDeprecated

ai.presence_penaltyDeprecated

ai.prompt_tokens.usedDeprecated

ai.prompt.messagesDeprecated

ai.raw_promptingDeprecated

ai.response_formatDeprecated

ai.response.textDeprecated

ai.response.toolCallsDeprecated

ai.responsesDeprecated

ai.search_queriesDeprecated

ai.search_resultsDeprecated

ai.seedDeprecated

ai.streamingDeprecated

ai.tagsDeprecated

ai.temperatureDeprecated

ai.textsDeprecated

ai.tool_callsDeprecated

ai.toolCall.argsDeprecated

ai.toolCall.resultDeprecated

ai.toolsDeprecated

ai.top_kDeprecated

ai.top_pDeprecated

ai.total_costDeprecated

ai.total_tokens.usedDeprecated

ai.warningsDeprecated

`ai.citations`Deprecated

`ai.completion_tokens.used`Deprecated

`ai.documents`Deprecated

`ai.finish_reason`Deprecated

`ai.frequency_penalty`Deprecated

`ai.function_call`Deprecated

`ai.generation_id`Deprecated

`ai.input_messages`Deprecated

`ai.is_search_required`Deprecated

`ai.metadata`Deprecated

`ai.model_id`Deprecated

`ai.model.provider`Deprecated

`ai.pipeline.name`Deprecated

`ai.preamble`Deprecated

`ai.presence_penalty`Deprecated

`ai.prompt_tokens.used`Deprecated

`ai.prompt.messages`Deprecated

`ai.raw_prompting`Deprecated

`ai.response_format`Deprecated

`ai.response.text`Deprecated

`ai.response.toolCalls`Deprecated

`ai.responses`Deprecated

`ai.search_queries`Deprecated

`ai.search_results`Deprecated

`ai.seed`Deprecated

`ai.streaming`Deprecated

`ai.tags`Deprecated

`ai.temperature`Deprecated

`ai.texts`Deprecated

`ai.tool_calls`Deprecated

`ai.toolCall.args`Deprecated

`ai.toolCall.result`Deprecated

`ai.tools`Deprecated

`ai.top_k`Deprecated

`ai.top_p`Deprecated

`ai.total_cost`Deprecated

`ai.total_tokens.used`Deprecated

`ai.warnings`Deprecated