Skip to content

Update chapter09: Align MicroProfile Telemetry content with spec 2.1#57

Merged
ttelang merged 2 commits into
v7.1from
copilot/update-chapter09-telemetry-spec
Mar 4, 2026
Merged

Update chapter09: Align MicroProfile Telemetry content with spec 2.1#57
ttelang merged 2 commits into
v7.1from
copilot/update-chapter09-telemetry-spec

Conversation

Copilot AI commented Mar 4, 2026

Copy link
Copy Markdown

Chapter 09 was written against Telemetry 1.1 and is missing entire signal pillars (metrics, logs) and contains several spec-incorrect configurations. Updates align strictly with the MicroProfile Telemetry 2.1 specification and Eclipse Writing Style Guide.

Spec correctness fixes

  • Dependency: 1.12.1, added required <type>pom</type> (BOM artifact)
  • Sampler config: otel.traces.sampler.traceidratio=0.1otel.traces.sampler.arg=0.1
  • Removed otel.exporter.jaeger.endpoint — not in 2.1 spec; only OTLP is required
  • HTTP attribute: http.status_code=500http.response.status_code=500 (stabilized HTTP semantic conventions from 2.0)
  • Jaeger Docker command: replaced legacy Zipkin/UDP multi-port command with OTLP-native ports (4317/4318)

New content per spec

  • Metrics section: Meter CDI injection example + required HTTP server and JVM metrics table (spec-mandated)
  • Logs section: explains the log bridge API model — runtimes bridge existing log frameworks; no new Log APIs exposed to applications
  • Exporting Telemetry Data: expanded from traces-only to all three signal exporters with correct otel.sdk.disabled=false activation

What's New in MicroProfile Telemetry 2.1

New terminal section covering:

  • OpenTelemetry Java upgrade v1.39.0 → v1.48.0
  • JVM metrics self-configuration fix (TCK)
  • No incompatible changes between 2.0 and 2.1
  • Migration path from both 1.1 and 2.0

Minor fixes

  • Typo: "Graphana Tempo" → "Grafana Tempo"
  • All modified sections marked with // Updated for MicroProfile Telemetry 2.1 using correct AsciiDoc line-comment syntax

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Co-authored-by: ttelang <133903+ttelang@users.noreply.github.com>
Copilot AI changed the title [WIP] Update chapter 09 to align with MicroProfile Telemetry 2.1 Update chapter09: Align MicroProfile Telemetry content with spec 2.1 Mar 4, 2026

@ttelang ttelang left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

LGTM

@ttelang ttelang marked this pull request as ready for review March 4, 2026 05:58
@ttelang ttelang merged commit 84487e2 into v7.1 Mar 4, 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