Gen_ai Attributes

{
  "key": "gen_ai.agent.name",
  "brief": "The name of the agent being used.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "ResearchAssistant",
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        62,
        127
      ]
    }
  ]
}

{
  "key": "gen_ai.conversation.id",
  "brief": "The unique identifier for a conversation (session, thread), used to store and correlate messages within this conversation.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "conv_5j66UpCpwteGg4YSxUnt7lPY",
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        250
      ]
    }
  ]
}

{
  "key": "gen_ai.cost.input_tokens",
  "brief": "The cost of tokens used to process the AI input (prompt) in USD (without cached input tokens).",
  "type": "double",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "example": 123.45,
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        112
      ]
    }
  ]
}

{
  "key": "gen_ai.cost.output_tokens",
  "brief": "The cost of tokens used for creating the AI output in USD (without reasoning tokens).",
  "type": "double",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "example": 123.45,
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        112
      ]
    }
  ]
}

{
  "key": "gen_ai.cost.total_tokens",
  "brief": "The total cost for the tokens used.",
  "type": "double",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "example": 12.34,
  "alias": [
    "ai.total_cost"
  ],
  "changelog": [
    {
      "version": "next",
      "prs": [
        264
      ]
    },
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        126
      ]
    }
  ]
}

{
  "key": "gen_ai.embeddings.input",
  "brief": "The input to the embeddings model.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "example": "What's the weather in Paris?",
  "changelog": [
    {
      "version": "0.3.1",
      "prs": [
        195
      ]
    }
  ]
}

{
  "key": "gen_ai.input.messages",
  "brief": "The messages passed to the model. It has to be a stringified version of an array of objects. The `role` attribute of each object must be `\"user\"`, `\"assistant\"`, `\"tool\"`, or `\"system\"`. For messages of the role `\"tool\"`, the `content` can be a string or an arbitrary object with information about the tool call. For other messages the `content` can be either a string or a list of objects in the format `{type: \"text\", text:\"...\"}`.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "[{\"role\": \"user\", \"parts\": [{\"type\": \"text\", \"content\": \"Weather in Paris?\"}]}, {\"role\": \"assistant\", \"parts\": [{\"type\": \"tool_call\", \"id\": \"call_VSPygqKTWdrhaFErNvMV18Yl\", \"name\": \"get_weather\", \"arguments\": {\"location\": \"Paris\"}}]}, {\"role\": \"tool\", \"parts\": [{\"type\": \"tool_call_response\", \"id\": \"call_VSPygqKTWdrhaFErNvMV18Yl\", \"result\": \"rainy, 57°F\"}]}]",
  "alias": [
    "ai.texts"
  ],
  "changelog": [
    {
      "version": "next",
      "prs": [
        264
      ]
    },
    {
      "version": "0.4.0",
      "prs": [
        221
      ]
    }
  ]
}

{
  "key": "gen_ai.operation.name",
  "brief": "The name of the operation being performed. It has the following list of well-known values: 'chat', 'create_agent', 'embeddings', 'execute_tool', 'generate_content', 'invoke_agent', 'text_completion'. If one of them applies, then that value MUST be used. Otherwise a custom value MAY be used.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "chat",
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        225
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        62,
        127
      ]
    }
  ]
}

{
  "key": "gen_ai.operation.type",
  "brief": "The type of AI operation. Must be one of 'agent' (invoke_agent and create_agent spans), 'ai_client' (any LLM call), 'tool' (execute_tool spans), 'handoff' (handoff spans), 'other' (input and output processors, skill loading, guardrails etc.) . Added during ingestion based on span.op and gen_ai.operation.type. Used to filter and aggregate data in the UI",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "example": "tool",
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        257
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        113,
        127
      ]
    }
  ]
}

{
  "key": "gen_ai.output.messages",
  "brief": "The model's response messages. It has to be a stringified version of an array of message objects, which can include text responses and tool calls.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "[{\"role\": \"assistant\", \"parts\": [{\"type\": \"text\", \"content\": \"The weather in Paris is currently rainy with a temperature of 57°F.\"}], \"finish_reason\": \"stop\"}]",
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        221
      ]
    }
  ]
}

{
  "key": "gen_ai.pipeline.name",
  "brief": "Name of the AI pipeline or chain being executed.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "example": "Autofix Pipeline",
  "alias": [
    "ai.pipeline.name"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        76,
        127
      ]
    }
  ]
}

{
  "key": "gen_ai.provider.name",
  "brief": "The Generative AI provider as identified by the client or server instrumentation.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "openai",
  "alias": [
    "ai.model.provider",
    "gen_ai.system"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        253
      ]
    }
  ]
}

{
  "key": "gen_ai.request.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",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": 0.5,
  "alias": [
    "ai.frequency_penalty"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        57
      ]
    }
  ]
}

{
  "key": "gen_ai.request.max_tokens",
  "brief": "The maximum number of tokens to generate in the response.",
  "type": "integer",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": 2048,
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        62
      ]
    }
  ]
}

{
  "key": "gen_ai.request.model",
  "brief": "The model identifier being used for the request.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "gpt-4-turbo-preview",
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        62,
        127
      ]
    }
  ]
}

{
  "key": "gen_ai.request.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",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": 0.5,
  "alias": [
    "ai.presence_penalty"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        57
      ]
    }
  ]
}

{
  "key": "gen_ai.request.seed",
  "brief": "The seed, ideally models given the same seed and same other parameters will produce the exact same output.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "1234567890",
  "alias": [
    "ai.seed"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        57,
        127
      ]
    }
  ]
}

{
  "key": "gen_ai.request.temperature",
  "brief": "For an AI model call, the temperature parameter. Temperature essentially means how random the output will be.",
  "type": "double",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": 0.1,
  "alias": [
    "ai.temperature"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        57
      ]
    }
  ]
}

{
  "key": "gen_ai.request.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",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": 35,
  "alias": [
    "ai.top_k"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        57
      ]
    }
  ]
}

{
  "key": "gen_ai.request.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",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": 0.7,
  "alias": [
    "ai.top_p"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        57
      ]
    }
  ]
}

{
  "key": "gen_ai.response.finish_reasons",
  "brief": "The reason why the model stopped generating.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "COMPLETE",
  "alias": [
    "ai.finish_reason"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        57,
        127
      ]
    }
  ]
}

{
  "key": "gen_ai.response.id",
  "brief": "Unique identifier for the completion.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "gen_123abc",
  "alias": [
    "ai.generation_id"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        57,
        127
      ]
    }
  ]
}

{
  "key": "gen_ai.response.model",
  "brief": "The vendor-specific ID of the model used.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "gpt-4",
  "alias": [
    "ai.model_id"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        127
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

{
  "key": "gen_ai.response.streaming",
  "brief": "Whether or not the AI model call's response was streamed back asynchronously",
  "type": "boolean",
  "pii": {
    "key": "false"
  },
  "is_in_otel": false,
  "example": true,
  "alias": [
    "ai.streaming"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        76
      ]
    }
  ]
}

{
  "key": "gen_ai.response.time_to_first_token",
  "brief": "Time in seconds when the first response content chunk arrived in streaming responses.",
  "type": "double",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "example": 0.6853435,
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        227
      ]
    }
  ]
}

{
  "key": "gen_ai.response.tokens_per_second",
  "brief": "The total output tokens per seconds throughput",
  "type": "double",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "example": 12345.67,
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        66
      ]
    }
  ]
}

{
  "key": "gen_ai.system_instructions",
  "brief": "The system instructions passed to the model.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "You are a helpful assistant",
  "alias": [
    "ai.preamble"
  ],
  "changelog": [
    {
      "version": "next",
      "prs": [
        264
      ]
    },
    {
      "version": "0.4.0",
      "prs": [
        221
      ]
    }
  ]
}

{
  "key": "gen_ai.tool.call.arguments",
  "brief": "The arguments of the tool call. It has to be a stringified version of the arguments to the tool.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "{\"location\": \"Paris\"}",
  "alias": [
    "gen_ai.tool.input"
  ],
  "changelog": [
    {
      "version": "next",
      "prs": [
        265
      ]
    },
    {
      "version": "0.4.0",
      "prs": [
        221
      ]
    }
  ]
}

{
  "key": "gen_ai.tool.call.result",
  "brief": "The result of the tool call. It has to be a stringified version of the result of the tool.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "rainy, 57°F",
  "alias": [
    "gen_ai.tool.output",
    "gen_ai.tool.message"
  ],
  "changelog": [
    {
      "version": "next",
      "prs": [
        265
      ]
    },
    {
      "version": "0.4.0",
      "prs": [
        221
      ]
    }
  ]
}

{
  "key": "gen_ai.tool.definitions",
  "brief": "The list of source system tool definitions available to the GenAI agent or model.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "[{\"type\": \"function\", \"name\": \"get_current_weather\", \"description\": \"Get the current weather in a given location\", \"parameters\": {\"type\": \"object\", \"properties\": {\"location\": {\"type\": \"string\", \"description\": \"The city and state, e.g. San Francisco, CA\"}, \"unit\": {\"type\": \"string\", \"enum\": [\"celsius\", \"fahrenheit\"]}}, \"required\": [\"location\", \"unit\"]}}]",
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        221
      ]
    }
  ]
}

{
  "key": "gen_ai.tool.description",
  "brief": "The description of the tool being used.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "Searches the web for current information about a topic",
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        62,
        127
      ]
    }
  ]
}

{
  "key": "gen_ai.tool.name",
  "brief": "Name of the tool utilized by the agent.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "Flights",
  "alias": [
    "ai.function_call"
  ],
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        57,
        127
      ]
    }
  ]
}

{
  "key": "gen_ai.tool.type",
  "brief": "The type of tool being used.",
  "type": "string",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": "function",
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        62,
        127
      ]
    }
  ]
}

{
  "key": "gen_ai.usage.input_tokens",
  "brief": "The number of tokens used to process the AI input (prompt) including cached input tokens.",
  "type": "integer",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": 10,
  "alias": [
    "ai.prompt_tokens.used",
    "gen_ai.usage.prompt_tokens"
  ],
  "changelog": [
    {
      "version": "next",
      "prs": [
        261
      ]
    },
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        112
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

{
  "key": "gen_ai.usage.input_tokens.cache_write",
  "brief": "The number of tokens written to the cache when processing the AI input (prompt).",
  "type": "integer",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "example": 100,
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        217,
        228
      ]
    }
  ]
}

{
  "key": "gen_ai.usage.input_tokens.cached",
  "brief": "The number of cached tokens used to process the AI input (prompt).",
  "type": "integer",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "example": 50,
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        62,
        112
      ]
    }
  ]
}

{
  "key": "gen_ai.usage.output_tokens",
  "brief": "The number of tokens used for creating the AI output (including reasoning tokens).",
  "type": "integer",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": true,
  "example": 10,
  "alias": [
    "ai.completion_tokens.used",
    "gen_ai.usage.completion_tokens"
  ],
  "changelog": [
    {
      "version": "next",
      "prs": [
        261
      ]
    },
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        112
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

{
  "key": "gen_ai.usage.output_tokens.reasoning",
  "brief": "The number of tokens used for reasoning to create the AI output.",
  "type": "integer",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "example": 75,
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        62,
        112
      ]
    }
  ]
}

{
  "key": "gen_ai.usage.total_tokens",
  "brief": "The total number of tokens used to process the prompt. (input tokens plus output todkens)",
  "type": "integer",
  "pii": {
    "key": "maybe"
  },
  "is_in_otel": false,
  "example": 20,
  "alias": [
    "ai.total_tokens.used"
  ],
  "changelog": [
    {
      "version": "0.4.0",
      "prs": [
        228
      ]
    },
    {
      "version": "0.1.0",
      "prs": [
        57
      ]
    }
  ]
}