Podman Monitor
Podman - Overview
Podman is a modern, daemonless container technology that enables you to build, manage, and run containers without requiring root privileges. It allows applications to be packaged along with all their dependencies, ensuring consistency across development and production environments while improving security and operational control.
Applications Manager supports Podman monitoring in both REST API and Prometheus modes, allowing you to track critical aspects of Podman environments such as container health, availability, and runtime statistics, enabling faster troubleshooting and informed decision-making during performance issues or downtimes. Some configuration details are available only in REST API mode. Learn more about the container monitoring solutions offered by Applications Manager.
Creating a new Podman monitor
Rest API to add a new Podman monitor: Click here
Once the prerequisites are fulfilled, follow the steps given below to create a new Podman monitor:
- Click on the New Monitor link.
- Select Podman under the Virtualization category.
- Specify the Display Name for the Podman monitor.
- Enter the Host Name/IP Address of the server where Podman is running.
- Enter the REST API port to access Podman. The default port used is 8080.
- If the Podman REST API is accessed over SSL, select the SSL is enabled option.
- Choose the Credential Details option:
- If you choose Use below credential , enter the User Name and Password to access the Podman Remote REST API.
- If you choose Select from credential list , select the appropriate credential from the preconfigured credential list.
- Enter the Timeout value in seconds for REST API communication.
- Specify the Polling Interval in minutes for monitoring Podman metrics.
- (Optional) Select the Advanced Settings checkbox to configure additional options:
- Specify the Discovery Filter Regex to filter Pods and Containers to be discovered and monitored. Only Pods and Containers matching the given regex will be added for monitoring.
- (Optional) Choose the Monitor Group with which you want to associate the Podman monitor. You can associate the monitor with multiple groups if required.
- Click Add Monitor(s).
This discovers the Podman instance and starts monitoring its Pods and Containers.
Monitored Parameters
Go to the Monitors Category View by clicking the Monitors tab. Click on Podman under the Virtualization table. Displayed is the Podman bulk configuration view distributed into three tabs:
- Availability tab gives the Availability history for the past 24 hours or 30 days.
- Performance tab gives the Health Status and events for the past 24 hours or 30 days.
- List view enables you to perform bulk admin configurations.
Click on the tabs listed below to view the corresponding metrics monitored:
Overview
| Parameter | Description | REST API Support | Prometheus Support |
|---|---|---|---|
| CLUSTER SUMMARY | |||
| Pods Count | Total number of pods available in the Podman environment, regardless of their state. |  | |
| Containers Count | Total number of containers available in the Podman environment, regardless of their state. | | |
| Image Count | Total number of container images stored in the Podman environment. | | |
| RESPONSE TIME | |||
| Response Time | Time taken by the Podman service to respond to API requests, indicating the overall responsiveness of the Podman engine (in ms). | | |
| CLUSTER PODS SUMMARY | |||
| Pods Count | Number of pods that are currently available. | | |
| Running Pods Count | Number of pods that currently have at least one container running. | | |
| Created Pods Count | Number of pods that are created but not yet started. | | |
| Stopped Pods Count | Number of pods that have been stopped and are not running any containers. | | |
| Paused Pods Count | Number of pods that are in a paused state, with all processes temporarily suspended. | | |
| Unknown Pods Count | Number of pods whose state cannot be determined due to errors or communication issues. | | |
| CLUSTER CONTAINER SUMMARY | |||
| Containers Count | Number of containers that are currently available. | | |
| Running Containers Count | Number of containers currently in a running state. | | |
| Transition Containers Count | Number of containers in a transitional state such as starting, stopping, or restarting. | | |
| Stopped Containers Count | Number of containers that are stopped and not executing any processes. | | |
| Configured Containers Count | Number of containers that are configured but not yet created or started. | | |
| Unknown Containers Count | Number of containers whose state cannot be identified due to system or API issues. | | |
Memory
| Parameter | Description | REST API Support | Prometheus Support |
|---|---|---|---|
| MEMORY DETAILS | |||
| Total Memory | Total physical memory available on the host machine (in GB). | | |
| Used Memory | Amount of physical memory currently being utilized (in GB). | | |
| Free Memory | Amount of physical memory available and not currently in use (in GB). | | |
| SWAP MEMORY DETAILS | |||
| Total Swap Memory | Total swap memory configured on the host system (in GB). | | |
| Free Swap Memory | Amount of available swap memory not currently in use (in GB). | | |
| Used Swap Memory | Percentage of swap memory currently being utilized (in %). | | |
Container
| Parameter | Description | REST API Support | Prometheus Support |
|---|---|---|---|
| CONTAINER DETAILS | |||
| Container ID | A unique identifier (hash) assigned to the container for internal reference and management. | | |
| Container Name | The user-friendly name assigned to the container. | | |
| Pod Name | The name of the pod to which this container belongs, if managed under a pod. | | |
| Container Image | The container image used to create the container (for example, ubuntu:22.04). | | |
| Namespace | The namespace under which the container is running in Podman. | |  |
| Container State | The current operational state of the container, such as Running, Exited, Stopped, Paused, or Created. | | |
| Restart Count | The total number of times the container has restarted due to failures or restart policies. | | |
| IP Address | The IP address assigned to the container within the pod or network. | | |
| Created Time | The timestamp indicating when the container was created in Podman. | | |
| Start Time | The timestamp indicating when the container was last started. | | |
| Exit Code | The exit status returned by the container when it last stopped. | | |
| Exit Time | The timestamp indicating when the container last exited. | | |
| CONTAINER USAGE STATS | |||
| CPU Usage | The CPU consumed by the container, measured as a percentage of total CPU usage (in %). | | |
| Memory Usage | The percentage of memory currently used by the container (in %). | | |
| Memory Usage | The amount of memory currently used by the container, measured in megabytes (in MB). | | |
| Incoming Traffic | The network data received by the container over its interfaces (in kB). | | |
| Outgoing Traffic | The network data sent from the container over its interfaces (in kB). | | |
| Disk Read IOPS | The rate of disk read input/output operations performed by the container’s storage layer (in kB). | | |
| Disk Write IOPS | The rate of disk write input/output operations performed by the container’s storage layer (in kB). | | |
| Uptime | The elapsed time since the container was last started, calculated as the difference between the current time and the container's start time. | | |
Pods
| Parameter | Description | REST API Support | Prometheus Support |
|---|---|---|---|
| POD DETAILS | |||
| Pod Name | The name assigned to the Podman pod. | | |
| Namespace | The namespace in which the pod is running. | | |
| Pod State | The current operational state of the pod, such as Running, Created, Stopped, Paused, or Unknown. | | |
| Container Count | Total number of containers present in the pod, regardless of their state. | | |
| Created Time | The timestamp indicating when the pod was created in Podman. | | |
| POD CONTAINER STATUS SUMMARY | |||
| Running Container Count | Number of containers inside the pod that are currently in the Running state. | | |
| Transition Container Count | Number of containers inside the pod that are in intermediate or transitional states, such as Paused, Restarting, or Removing. | | |
| Stopped Container Count | Number of containers inside the pod that are in a Stopped, Exited, or Dead state. | | |
| Configured Container Count | Number of containers inside the pod that are in a created or configured state. | | |
| Unknown Container Count | Number of containers whose state cannot be determined, for example due to API issues or missing responses. | | |
Images
| Parameter | Description | REST API Support | Prometheus Support |
|---|---|---|---|
| IMAGE DETAILS | |||
| Image Name | The repository name and tag of the image (for example, nginx:latest), used to identify the image. | | |
| Digest | The content-addressable SHA256 digest of the image, ensuring image integrity and identifying the exact image version. | | |
| Size | The actual disk size consumed by the image layers stored on the system (in kB). | | |
| Virtual Size | The total size of the image including all base and shared layers, which may be larger than the actual disk usage due to layer reuse (in kB). | | |
| Containers Count | The number of containers that are created from this image, irrespective of their current state. | | |
| Created Time | The date and time when the image was created or pulled into the Podman environment. | | |
Configuration
| Parameter | Description | REST API Support | Prometheus Support |
|---|---|---|---|
| Hostname | The name assigned to the host machine running the Podman service. | | |
| CPU Cores | The total number of CPU cores available on the host system. | | |
| Operating System | The operating system installed on the host machine, such as the Linux distribution. | | |
| Architecture | The hardware architecture of the host system, for example x86_64 or arm64. | | |
| Kernel Version | The version of the Linux kernel currently running on the host machine. | | |
| Version | The Podman engine version installed on the host. | | |
| API Version | The version of the Podman REST API supported by the server. | | |
| Build Time | The date and time when the Podman engine binary was built. | | |
| Server Uptime | The total duration for which the Podman service has been running since it was last started. | | |
