Skip to content

Cross-reference OTLP metadata in the Metadata docs page#308

Merged
bb220 merged 1 commit into
masterfrom
claude/nice-fermi-iMvuU
May 20, 2026
Merged

Cross-reference OTLP metadata in the Metadata docs page#308
bb220 merged 1 commit into
masterfrom
claude/nice-fermi-iMvuU

Conversation

@bb220
Copy link
Copy Markdown
Collaborator

@bb220 bb220 commented May 20, 2026

Summary

  • Adds a short "Attaching metadata via OpenTelemetry" section to features/prompt-history/metadata.mdx that 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 in features/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

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
@bb220 bb220 added the automation label May 20, 2026 — with Claude
@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 20, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
promptlayer 🟢 Ready View Preview May 20, 2026, 1:37 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 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.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge 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 👍 / 👎.

@bb220 bb220 merged commit d73d50c into master May 20, 2026
4 checks passed
@bb220 bb220 deleted the claude/nice-fermi-iMvuU branch May 20, 2026 13:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants