Podman Monitoring (Open Beta)
Instana automatically discovers and monitors Podman containers to provide you with real-time insights into metadata (labels), metrics, and any supported technologies that are running within each discovered container. The Podman sensor is automatically deployed and configured after you install the Instana agent.
Open Beta information
The Podman Monitoring Open Beta is supported in Instana SaaS from release 246. For self-hosted (on-premises) Instana, the Podman Monitoring Open Beta is supported only if your Instana backend is installed from release 247.
Metrics collection
To view the metrics, select Infrastructure in the sidebar of the Instana User interface, click a specific monitored host, and then you can see a Host dashboard with all the collected metrics and monitored processes.
By default, Podman metrics are collected every 5 seconds. You can change the interval by editing the agent configuration file <agent_install_dir>/etc/instana/configuration.yml
:
com.instana.plugin.podman:
interval: 5
To view detailed information for the running container, click Get Container Info. The displayed information is the same as the result of the podman inspect command.
Configuration data
Configuration | Description |
---|---|
Image | The Podman image name. |
Command | Entry point of container |
Created At | The timestamp when the container is created . |
Started At | The timestamp where the container is started. |
Container ID | The container ID. |
Name | The container name. |
Graph Driver | The configured graph driver. |
Podman version | The Podman version in use. |
Container Labels | Labels that are applied to the container. |
Performance metrics
You can use the Podman Engine API to get performance metrics. These performance metrics are returned from the /v4.0.0/libpod/containers/{id}/stats?stream=false
endpoint. See the Podman API doc reference.
The following performance metrics are provided:
CPU Total %
The CPU Total % metric is the total percentage of CPU usage. The current measured KPI value is displayed.
The value of the CPU Total % metric is collected from the total_usage
key that is returned in the cpu_stats
object.
Memory usage %
The Memory usage % metric is the total memory usage in percentage. The current measured KPI value is displayed.
The value of the Memory usage % metric is calculated as quotient of usage
and limit
keys that are returned in the memory_stats
object.
CPU
The CPU metric is the total, kernel, user metrics and their normalized values in range [0, 100]%, and these values are displayed on a graph over a selected time period. The values are collected from the total_usage
,
system_usage
, and user_usage
keys that are returned in the cpu_stats
object.
Throttling count and time values are displayed on a graph over a selected time period.
These values are collected from the throttling_count
and throttling_time
keys that are returned in the cpu_stats
object.
Memory
The Memory metric shows the memory limit and memory usage, and is displayed on a graph over a selected time period.
The values are collected from the usage
, max_usage
, and limit
keys that are returned in the memory_stats
object. The memory usage is displayed in percentage.
Block IO
The Block IO metric shows the read and write values, and are displayed on a graph over a selected time period.
The values are collected from the blkio.io_service_bytes
key that are returned in the blkio_stats
object.
Health signature
Each sensor has a curated knowledge base of health signatures that are evaluated continuously against the incoming metrics, and are used to raise issues or incidents depending on user impact. Built-in events trigger issues or incidents based on failing health signatures on entities. By default, the build-in event health rule for metrics CPU usages and Memory usages is activated as soon as the Podman sensor is activated for the container.