Skip to content

docs(otel): document metric attribute cardinality control#337

Merged
yassin-berriai merged 2 commits into
mainfrom
litellm_docs_otel_metric_attribute_cardinality
Jun 13, 2026
Merged

docs(otel): document metric attribute cardinality control#337
yassin-berriai merged 2 commits into
mainfrom
litellm_docs_otel_metric_attribute_cardinality

Conversation

@yassin-berriai

Copy link
Copy Markdown
Contributor

Documents the OTEL metric attribute cardinality control added in BerriAI/litellm#30257 (LIT-3600).

Adds a "Control metric attribute cardinality" section to the OpenTelemetry page explaining how per-request attributes such as hidden_params and the metadata.* fields inflate metric time series and get throttled by backends like Splunk, then shows the callback_settings.otel.attributes block with the mutually-exclusive include_list and exclude_list, copy-pasteable YAML for both modes, the metrics-only scope, and the full list of valid attribute names. Also adds the attributes field to the OpenTelemetryConfig reference table.

Add a "Control metric attribute cardinality" section to the OpenTelemetry page
covering the callback_settings.otel.attributes include_list/exclude_list filter
that caps how many attributes get stamped onto gen_ai.client.* metrics, plus a
row for the new attributes field in the OpenTelemetryConfig reference table.

Pairs with BerriAI/litellm#30257 (LIT-3600)
@vercel

vercel Bot commented Jun 11, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
litellm Ready Ready Preview, Comment Jun 12, 2026 6:44am

Request Review

…not filterable

Reflect the implementation: gen_ai.token.type is a structural token-usage
discriminator stamped after filtering, so listing it in include_list or
exclude_list is rejected at startup rather than silently ignored. Remove it from
the include_list example and the valid-names list, and correct the nuance note.
@yassin-berriai yassin-berriai merged commit 60c108b into main Jun 13, 2026
2 checks passed
@yassin-berriai yassin-berriai deleted the litellm_docs_otel_metric_attribute_cardinality branch June 13, 2026 00:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant