Skip to content

Add docstrings for constants for OpenTelemetry span operations and environment variables#210

Open
JimDaly wants to merge 1 commit into
microsoft:mainfrom
JimDaly:constant-docs
Open

Add docstrings for constants for OpenTelemetry span operations and environment variables#210
JimDaly wants to merge 1 commit into
microsoft:mainfrom
JimDaly:constant-docs

Conversation

@JimDaly

@JimDaly JimDaly commented Jun 17, 2026

Copy link
Copy Markdown
Member

Copilot tells me that adding these changes will make the constants appear in the generated reference documentation on learn.microsoft.com

@github-actions

Copy link
Copy Markdown

Performance comparison

Threshold: regressions >15.0% on gating scenarios fail the build. Higher ops/s is better; positive Δ means the PR is slower.

Scenario Gating Baseline (ops/s) Candidate (ops/s) Δ % Status
azure_monitor_log yes 20,340.9 20,353.3 -0.06%
azure_monitor_span yes 156,690.7 153,798.8 +1.88%
otel_log no 23,623.9 23,607.7 +0.07%
otel_span no 34,524.4 34,327.7 +0.57%

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.

Pull request overview

This PR updates the Agent365 constants module to explicitly document span operation names, semantic convention keys, feature switches, and environment variables so they can be surfaced in generated API reference documentation.

Changes:

  • Expanded the module docstring in microsoft.opentelemetry.a365.constants to enumerate/export-document the available constants.
  • Grouped constants in the docstring by category (span operations, semantic conventions, feature switches, env vars, etc.).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines 9 to +13
Superset of microsoft-agents-a365-observability-core constants plus
package-specific environment variable constants.

Span operation names:
:var INVOKE_AGENT_OPERATION_NAME: Span operation name for agent invocation.
Comment thread src/microsoft/opentelemetry/a365/constants.py
@JimDaly JimDaly changed the title Add constants for OpenTelemetry span operations and environment variables Add docstrings for constants for OpenTelemetry span operations and environment variables Jun 18, 2026
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.

2 participants