Cross-reference OTLP metadata in the Metadata docs page#308
Conversation
The metadata page only covered the SDK and REST API paths. Now that PromptLayer ingests metadata from OpenTelemetry span attributes (user.id, gen_ai.conversation.id, promptlayer.metadata.*), add a section pointing OTLP users to the dedicated OpenTelemetry guide. https://claude.ai/code/session_01WesPFyrXFLqXrTZHCXP9xN
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: b873329711
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
|
|
||
| If you instrument your app with OpenTelemetry, you can attach metadata directly from span attributes — no `track.metadata()` call required. PromptLayer automatically maps standard attributes like `user.id` and `gen_ai.conversation.id`, and also reads arbitrary `promptlayer.metadata.<key>` attributes. | ||
|
|
||
| See [Attaching User Identity & Metadata](/features/opentelemetry#attaching-user-identity-metadata) in the OpenTelemetry guide for details. |
There was a problem hiding this comment.
Use the correct OTEL heading slug in cross-reference link
The new link likely points to a non-existent anchor: the target heading is Attaching User Identity & Metadata, and this docs repo already uses double-hyphen anchors when punctuation is stripped (for example, links like #google-gemini--native-image-generation in features/supported-providers.mdx). Using #attaching-user-identity-metadata can fail to jump to the intended section, so users land at the top of the OpenTelemetry page instead of the metadata instructions.
Useful? React with 👍 / 👎.
Summary
features/prompt-history/metadata.mdxthat points users to the full OTLP metadata guide.Context
PR promptlayer-app#936 shipped support for ingesting searchable metadata from OTLP span attributes (
user.id,gen_ai.conversation.id,promptlayer.metadata.*, etc.). The feature is fully documented infeatures/opentelemetry.mdx, but users reading the Metadata page had no way to discover this alternative path. This change closes that discoverability gap with a brief cross-reference section.No changelog update included per automation guidelines.
Generated by Claude Code