Skip to content

[APM] Document OTel infrastructure tab support#5715

Merged
alexandra5000 merged 7 commits into
elastic:mainfrom
alexandra5000:apm-infrastructure-otel
Apr 2, 2026
Merged

[APM] Document OTel infrastructure tab support#5715
alexandra5000 merged 7 commits into
elastic:mainfrom
alexandra5000:apm-infrastructure-otel

Conversation

@alexandra5000

Copy link
Copy Markdown
Contributor

Summary

Updates the APM Infrastructure tab docs to reflect new behavior for OTel-instrumented services (available in 9.4):

  • Previously, the Infrastructure tab only showed infrastructure observed by Metricbeat/Elastic Agent.
  • Now, for OTel-instrumented services, the tab exclusively shows OTel-observed hosts, pods, and containers, with different click-through destinations (Hosts UI for hosts; Metrics in Discover for containers and pods).

Changes:

  • solutions/observability/apm/infrastructure.md: Split into Elastic APM and OTel sections; added links to destination UIs.
  • troubleshoot/observability/apm/common-problems.md: Added OTel-specific guidance to the "No data in infrastructure tab" troubleshooting section.

Relates to: elastic/kibana#252188
Closes: #5511

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No
  1. If you answered "Yes" to the previous question, please specify the tool(s) and model(s) used (e.g., Google Gemini, OpenAI ChatGPT-4, etc.).

Tool(s) and model(s) used: Claude Code (claude-sonnet-4-6)

…for services instrumented with Elastic APM and OpenTelemetry

- Added specific navigation behavior and links for Pods, Containers, and Hosts based on the instrumentation type
@alexandra5000 alexandra5000 marked this pull request as ready for review March 31, 2026 19:01
@alexandra5000 alexandra5000 requested review from a team as code owners March 31, 2026 19:01

@mdbirnstiehl mdbirnstiehl left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Overall, LGTM! I think the applies_to needs to be updated from migration times, and one small suggestion you can take or leave!

Comment thread solutions/observability/apm/infrastructure.md Outdated
Comment thread solutions/observability/apm/infrastructure.md Outdated
@alexandra5000

Copy link
Copy Markdown
Contributor Author

Hey @roshan-elastic, I made the update that you asked for in #5511. Could you review it please?

@roshan-elastic

Copy link
Copy Markdown

Hey @alexandra5000 - got a link?

@alexandra5000

alexandra5000 commented Apr 2, 2026

Copy link
Copy Markdown
Contributor Author

Hey @roshan-elastic, unfortunately the PR preview is temporarily disabled, so there's no way right now to generate a shareable link.

You can serve it locally:

  1. Install docs-builder (if you haven't already):

curl -sL https://ela.st/docs-builder-install | sh

  1. Check out my branch (apm-infrastructure-otel) in the docs-content repo.

  2. Run from the repo root:

docs-builder serve

  1. Open http://localhost:3000/

Full instructions are at contribute locally if you want more detail. Sorry for the inconvenience!

@roshan-elastic

Copy link
Copy Markdown

LGTM - thanks @alexandra5000 !

@alexandra5000 alexandra5000 enabled auto-merge (squash) April 2, 2026 17:40
@alexandra5000 alexandra5000 merged commit 5b05e61 into elastic:main Apr 2, 2026
6 checks passed
@alexandra5000 alexandra5000 deleted the apm-infrastructure-otel branch April 2, 2026 17:41
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.

[Internal]: Update APM Infrastructure tab documentation for OTel

3 participants