Skip to content

Commit 5b05e61

Browse files
[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#252188 Closes: #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)
1 parent 40a3c8d commit 5b05e61

2 files changed

Lines changed: 87 additions & 73 deletions

File tree

solutions/observability/apm/infrastructure.md

Lines changed: 22 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ mapped_pages:
33
- https://www.elastic.co/guide/en/observability/current/apm-infrastructure.html
44
- https://www.elastic.co/guide/en/serverless/current/observability-apm-infrastructure.html
55
applies_to:
6-
stack: ga
7-
serverless: ga
6+
stack: beta
7+
serverless: beta
88
products:
99
- id: observability
1010
- id: apm
@@ -13,28 +13,36 @@ products:
1313

1414
# Infrastructure [observability-apm-infrastructure]
1515

16-
::::{important}
16+
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).
1717

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?**
1922

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).
2024
::::
2125

22-
The **Infrastructure** tab provides information about the containers, pods, and hosts that the selected service is linked to.
26+
## Elastic {{product.apm}}-instrumented services [observability-apm-infrastructure-elastic-apm]
27+
28+
For services instrumented with Elastic {{product.apm}}, the tab uses the following data sources:
2329

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.
2733

2834
:::{image} /solutions/images/serverless-infra.png
2935
:alt: Example view of the Infrastructure tab in the Applications UI
3036
:screenshot:
3137
:::
3238

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.
39+
## OTel-instrumented services [observability-apm-infrastructure-otel]
40+
```{applies_to}
41+
stack: ga 9.4
42+
serverless: ga
43+
```
3444

35-
::::{tip}
36-
**Why is the infrastructure tab empty?**
37-
38-
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:
3946

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

Comments
 (0)