Skip to content

otel: condense late-policy recovery docs - #337588

Closed
Ross Wollman (rwoll) wants to merge 2 commits into
mainfrom
rwoll/otel-monitoring-docs-concise
Closed

Ross Wollman (rwoll) wants to merge 2 commits into
mainfrom
rwoll/otel-monitoring-docs-concise

Conversation

@rwoll

Copy link
Copy Markdown
Member

Follow-up to review feedback on #336701 asking whether the late-policy recovery docs could be more concise.

The Activation section now describes only what users and administrators see:

  • The activation conditions come first.
  • Most OTel changes show a Reload Window prompt.
  • Enterprise policy that turns on OTLP export after startup triggers one extension-host restart per session. If that doesn't apply the policy, Copilot shows a reload warning.
  • An identity denial takes effect without a reload.
  • The limitations involving environment variables are listed.

Implementation details are removed: the debounce, the session-ID bookkeeping, the grace period and how the recovery signal is detected. The behavior is unchanged.

Addresses review feedback on #336701: keep the user-visible reload and recovery behavior and drop implementation detail.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings September 23, 2026 23:40
@rwoll Ross Wollman (rwoll) self-assigned this Sep 23, 2026
Reviewed-head: f97ddb7
Pull-request: #337588
Approved-by: rwoll via PR Sign-Off
Requested-by: copilot
@rwoll
Ross Wollman (rwoll) enabled auto-merge (squash) September 23, 2026 23:41

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

The restart boundary and environment-variable precedence descriptions remain inaccurate.

Get a fresh assessment by requesting another Copilot review.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Condenses OTel activation and recovery documentation around user-visible behavior.

Changes:

  • Removes internal implementation details.
  • Summarizes reload, restart, identity-denial, and environment-variable behavior.
  • Needs clarification that automatic restart applies only when policy first arrives after startup.
  • Needs precise wording about environment-variable precedence.
File Description
extensions/​copilot/​docs/​monitoring/​agent_monitoring.md Simplifies OTel activation and recovery guidance; two documentation clarifications remain.

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

- `github.copilot.chat.otel.enabled` is `true`, or
- `github.copilot.chat.otel.dbSpanExporter.enabled` is `true` (the SDK pipeline must be active to feed the SQLite store).

OTel configuration is read at startup, so most changes need a window reload. Copilot shows a **Reload Window** prompt for them. There is one exception: enterprise policy that turns on OTLP export after Copilot has already started without it. For that case, Copilot restarts the window's extension hosts once per editor session to apply the policy. This also interrupts other extensions. If the restart doesn't apply the policy, Copilot shows a warning with **Reload Window**. An identity-capture denial takes effect for subsequent exports without a reload.
@github-actions

Copy link
Copy Markdown
Contributor

Screenshot Changes

Base: e550b8b9 Current: e8f02a04

Changed (1)

chat/agent-lifecycle/chatAgentLifecycle/RetainedFollowUpLatestTurn/Light
Before After
before after

1 insignificant change(s) omitted (≤20 px, Δ≤2). See CI logs for details.

auto-merge was automatically disabled September 24, 2026 00:06

Pull request was closed

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