Skip to content

Document AI Gateway telemetry - #1174

Merged
jerm-dro merged 1 commit into
mainfrom
jerm-dro/01M3CWPN0NM8Z2FQ0V8PFTHDJT
Sep 25, 2026
Merged

jerm-dro merged 1 commit into
mainfrom
jerm-dro/01M3CWPN0NM8Z2FQ0V8PFTHDJT

Conversation

@jerm-dro

@jerm-dro jerm-dro commented Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

Description

Adds an AI Gateway telemetry guide covering OpenTelemetry export, token metrics, request span attributes, and directory group attribution.

Documents labels for SCIM-derived groups and links the telemetry guide from the AI Gateway overview and audit logging guide.

Patch method

Fetched the head of stacklok/docs-website-internal#35 and confirmed that its merge base matched the current public main. Applied the combined diff for the internal PR commits (013fecd..f80138a) with git apply, restricted to the five documentation and navigation files changed by the PR.

This method excludes internal-repository changes to README.md and docusaurus.config.ts.

Type of change

  • New documentation

Related issues/PRs

  • Ports stacklok/docs-website-internal#35
  • Documents stacklok/stacklok-enterprise-platform#4386
  • Documents stacklok/stacklok-enterprise-platform#4387

Submitter checklist

Content and formatting

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

Navigation

  • New pages include a frontmatter section with title and description at a minimum
  • Sidebar navigation (sidebars.ts) updated for added, deleted, reordered, or renamed files
  • Redirects are not required because no pages moved, changed names, or were deleted

Reviewer checklist

Content

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

Copilot AI lite review requested due to automatic review settings September 25, 2026 18:27
@vercel

vercel Bot commented Sep 25, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
docs-website Ready Ready Preview Sep 25, 2026 6:28pm UTC

Request Review

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟡 Changes recommended

Three documentation nits remain regarding attribution wording, namespace placeholders, and issuer nesting.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 2 Low severity

Open (2)
What changed in this PR

Adds AI Gateway telemetry documentation covering OpenTelemetry export, token metrics, span attributes, and directory-group attribution.

Changes:

  • Adds and registers the telemetry guide.
  • Documents SCIM-derived group labels.
  • Links telemetry guidance from AI Gateway and audit-log pages.
File Summary
sidebars.ts Adds the telemetry page to AI Gateway navigation.
docs/​platform/​enterprise-directory/​scim-provisioning.mdx Documents derived-group labels. Nit (4 votes): Show group_variables nested under an issuer.
docs/​ai-gateway/​telemetry.mdx Adds the telemetry guide. Nit (1 vote): Use separate Enterprise Manager and gateway namespace placeholders.
docs/​ai-gateway/​index.mdx Highlights telemetry capabilities. Nit (2 votes): Clarify attribution is optional and span-level, not metric-level.
docs/​ai-gateway/​forward-audit-logs.mdx Links to telemetry guidance.

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/ai-gateway/index.mdx
Comment thread docs/platform/enterprise-directory/scim-provisioning.mdx
@jerm-dro

Copy link
Copy Markdown
Contributor Author

I'm not sure why the visual regression is failing, but I clicked through the modified pages and they seem copacetic.

@jerm-dro
jerm-dro merged commit 34c5162 into main Sep 25, 2026
6 of 7 checks passed
@jerm-dro
jerm-dro deleted the jerm-dro/01M3CWPN0NM8Z2FQ0V8PFTHDJT branch September 25, 2026 19:35

This branch was successfully deployed

1 active deployment
Preview — d5686642 Deployed Sep 25, 2026 by vercel[bot]
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.

3 participants