You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[APM] Document OTel infrastructure tab support (#5715)
## 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#252188Closes: #5511
## Generative AI disclosure
1. Did you use a generative AI (GenAI) tool to assist in creating this
contribution?
- [x] Yes
- [ ] No
2. 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)
The **Infrastructure** tab provides information about the containers, pods, and hosts that the selected service is linked to. The data sources and navigation behavior depend on whether the service is instrumented with [Elastic {{product.apm}}](#observability-apm-infrastructure-elastic-apm) or [OpenTelemetry (OTel)](#observability-apm-infrastructure-otel).
17
17
18
-
The Applications UI Infrastructure functionality is in beta and is subject to change. The design and code is less mature than official generally available features and is being provided as-is with no warranties.
18
+
IT ops and software reliability engineers (SREs) can use this tab to quickly find a service’s underlying infrastructure resources when debugging a problem. Knowing what infrastructure is related to a service allows you to remediate issues by restarting, killing hanging instances, changing configuration, rolling back deployments, scaling up, scaling out, and so on.
19
+
20
+
::::{tip}
21
+
**Why is the infrastructure tab empty?**
19
22
23
+
If there is no data in the Application UI’s infrastructure tab for a selected service, you can read more about why this happens and how to fix it in the [troubleshooting docs](/troubleshoot/observability/apm/common-problems.md#troubleshooting-apm-infra-data).
20
24
::::
21
25
22
-
The **Infrastructure** tab provides information about the containers, pods, and hosts that the selected service is linked to.
For services instrumented with Elastic {{product.apm}}, the tab uses the following data sources:
23
29
24
-
***Pods**: Uses the `kubernetes.pod.name` from the [APM metrics data streams](/solutions/observability/apm/metrics.md).
25
-
***Containers**: Uses the `container.id` from the [APM metrics data streams](/solutions/observability/apm/metrics.md).
26
-
***Hosts**: If the application is containerized—if the APM metrics documents include `container.id`—the `host.name` is used from the infrastructure data streams (filtered by `container.id`). If not, `host.hostname` is used from the APM metrics data streams.
30
+
***Pods**: Uses the `kubernetes.pod.name` from the [{{product.apm}} metrics data streams](/solutions/observability/apm/metrics.md).
31
+
***Containers**: Uses the `container.id` from the [{{product.apm}} metrics data streams](/solutions/observability/apm/metrics.md).
32
+
***Hosts**: If the application is containerized—if the {{product.apm}} metrics documents include `container.id`—the `host.name` is used from the infrastructure data streams (filtered by `container.id`). If not, `host.hostname` is used from the {{product.apm}} metrics data streams.
27
33
28
34
:::{image} /solutions/images/serverless-infra.png
29
35
:alt: Example view of the Infrastructure tab in the Applications UI
30
36
:screenshot:
31
37
:::
32
38
33
-
IT ops and software reliability engineers (SREs) can use this tab to quickly find a service’s underlying infrastructure resources when debugging a problem. Knowing what infrastructure is related to a service allows you to remediate issues by restarting, killing hanging instances, changing configuration, rolling back deployments, scaling up, scaling out, and so on.
If there is no data in the Application UI’s infrastructure tab for a selected service, you can read more about why this happens and how to fix it in the [troubleshooting docs](/troubleshoot/observability/apm/common-problems.md#troubleshooting-apm-infra-data).
45
+
For services instrumented with OpenTelemetry, the tab exclusively shows OTel-observed infrastructure. Click-through destinations differ by resource type:
39
46
40
-
::::
47
+
***Hosts**: Links to the [**Hosts**](/solutions/observability/infra-and-hosts/analyze-compare-hosts.md) UI, which supports OpenTelemetry and its semantic conventions.
48
+
***Containers** and **Pods**: Link to [**Metrics** in Discover](/solutions/observability/infra-and-hosts/discover-metrics.md), as the Containers and Pods UIs do not yet support OTel semantic conventions.
0 commit comments