[docs] Update documentation for features from 2026-05-07

[github-actions]

Documentation Updates - 2026-05-07

This PR updates the documentation based on features merged in the last 24 hours.

Features Documented

• Copilot CLI OTLP trace forwarding and COPILOT_OTEL_FILE_EXPORTER_PATH env var (from feat: enhance OTLP telemetry #30800)
• Multi-endpoint fan-out forms for observability.otlp.endpoint (object and array forms)
• copilot-otel.jsonl artifact file
• Corrected artifact location for OTLP debug files (agent artifact, not firewall-audit-logs)

📝 Detailed Changes & References

Changes Made

• Updated docs/src/content/docs/reference/frontmatter.md to:
  • Document all three forms of observability.otlp.endpoint (string, object, array)
  • Add a new "Injected environment variables" subsection listing OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_HEADERS, OTEL_SERVICE_NAME, GH_AW_OTLP_ENDPOINTS, and the new COPILOT_OTEL_FILE_EXPORTER_PATH
  • Update the Fields table to reflect the polymorphic endpoint type
• Updated docs/src/content/docs/guides/custom-otlp-attributes.md to:
  • Correct the artifact download command from --artifacts firewall to --artifacts agent
  • Add copilot-otel.jsonl alongside otel.jsonl in the debugging section
  • Add note about automatic Copilot CLI OTEL trace forwarding
• Updated docs/src/content/docs/reference/artifacts.md to:
  • Add otel.jsonl and copilot-otel.jsonl to the agent artifact contents (present when OTLP is configured)

Merged PRs Referenced

• feat: enhance OTLP telemetry #30800 - feat: enhance otlp telemetry

Skipped Issues

No open documentation issues found (GitHub CLI commands were unavailable in this run).

Notes

The COPILOT_OTEL_FILE_EXPORTER_PATH env var tells Copilot CLI where to write its own OTLP spans. When set, Copilot CLI writes traces to /tmp/gh-aw/copilot-otel.jsonl, and gh-aw's conclusion step automatically reads and forwards those traces to all configured OTLP endpoints.

Generated by Daily Documentation Updater · ● 567.7K · ◷

• expires on May 8, 2026, 11:26 AM UTC