Skip to content
semconv.com
↑↓ move↵ openUse with your agent →

gen_ai.usage.input_tokens

MovedGenAI registryintas of v1.44.0

The number of tokens used in the GenAI input (prompt).

This value SHOULD include all types of input tokens, including cached tokens. Instrumentations SHOULD make a best effort to populate this value, using a total provided by the provider when available or, depending on the provider API, by summing different token types parsed from the provider output.

Examples

Used by

events (1)

  • gen_ai.client.inference.operation.details

spans (8)

  • span.anthropic.inference.client
  • span.aws.bedrock.client
  • span.azure.ai.inference.client
  • span.gen_ai.embeddings.client
  • span.gen_ai.inference.client
  • span.gen_ai.invoke_agent.client
  • span.gen_ai.invoke_agent.internal
  • span.openai.inference.client

* required on that signal.

History

  1. v1.42.0deprecated

    Moved to the OpenTelemetry GenAI semantic conventions repository.

  2. v1.41.0

    Now referenced by attributes.gen_ai.invoke_agent.client, attributes.gen_ai.invoke_agent.common and 2 others (recommended).

  3. v1.40.0

    Now referenced by span.anthropic.inference.client (recommended).

  4. v1.37.0

    No longer referenced by span.gen_ai.azure.ai.inference.client and span.gen_ai.openai.inference.client.

  5. v1.37.0

    Now referenced by gen_ai.client.inference.operation.details, span.azure.ai.inference.client and 1 other (recommended).

  6. v1.35.0

    No longer referenced by span.gen_ai.az.ai.inference.client.

  7. v1.35.0

    Now referenced by span.gen_ai.azure.ai.inference.client (recommended).

  8. v1.34.0

    Now referenced by span.aws.bedrock.client (recommended).

  9. v1.33.0

    No longer referenced by attributes.gen_ai.openai_based, span.gen_ai.client and 3 others.

  10. v1.33.0

    Now referenced by attributes.gen_ai.inference.client, attributes.gen_ai.inference.openai_based and 4 others (recommended).

  11. v1.31.0

    No longer referenced by trace.gen_ai.az.ai.inference.client.

  12. v1.31.0

    Now referenced by attributes.gen_ai.openai_based, span.gen_ai.az.ai.inference.client and 1 other (recommended).

  13. v1.31.0

    Stability label respelled from experimental to development.

  14. v1.30.0

    Already present at v1.30.0, the oldest release tracked here (experimental).

Definition sourceRegistry docsJSONUse with your agent →