OpenShift Monitoring
OpenShift - Overview
OpenShift is a powerful and flexible open source container application orchestrated and managed by Kubernetes. They’re complex to set up, monitor and maintain. To outmaneuver the operational challenges faced when dealing with OpenShift containers, round-the-clock OpenShift monitoring is necessary. Applications Manager's OpenShift monitoring capabilities helps you to simplify application maintenance and ensures that OpenShift performance is up to par.
Creating a new OpenShift monitor
Using the REST API to add a new OpenShift monitor: Click here
Prerequisites for monitoring Openshift monitor with Prometheus integration : Refer here
Follow the steps given below to create a new OpenShift monitor:
- Click on New Monitor link. Select Openshift under Virtualization category.
- Specify the Display Name of the OpenShift Server.
- Enter the Hostname of the server on which OpenShift is running.
- If you choose the Use Below Credentials option, then enter basic authentication details used to connect with System using SSH.
- Check Public Key Authentication option if you use SSH2.
- Prompt - Specify the command prompt value, which is the last character in your command prompt. Default value is $ and possible values are >, #, etc.
- SSH Port - Enter the SSH Port. By default, it is 22.
- Enable the Collect major metrics using REST APIoption to collect the major metrics of Openshift environment through REST API. After enabling this option, enter the following information:
- Websocket Port: Port of the OpenShift application. By default, port number is 8443.
- Service Account Token: Service account token of the OpenShift cluster administrator user.
Note: For the Service Account Token, the user should ensure that "Cluster Reader Permission" is assigned. Click here to learn how to obtain the service account token
- Enter the OpenShift authentication details (OpenShift User Name and OpenShift Password) used to connect with cluster.
- If you choose the Select from credential list option, then select the respective credential from preconfigured credential list.
- Enable the Monitor Specific Project(s)option if you wish to monitor only specific project(s) in the OpenShift environment. After enabling, specify the following details:
- Filter Condition: Select the filtering condition to include or exclude monitoring of specific project(s) in the OpenShift environment.
- Project Name(s): Specify the name of the project(s) to be included/excluded while monitoring. You can enter multiple project names as comma-separated values.
- Specify the Timeout in seconds.
- Specify the Polling Interval in minutes.
- Choose the Monitor Group with which you want to associate the OpenShift to, from the combo box (optional). You can choose multiple groups to associate your monitor.
- Click Add Monitor(s). This discovers the OpenShift from the network and starts monitoring it.
Note: In the OpenShift architecture, it is sufficient to add the primary master node alone to the Applications Manager. Applications Manager will automatically discover all the other master and worker nodes within the cluster and monitor them closely. There is no need to individually add each node as an OpenShift monitor as this will lead to a performance issue.
Monitored Parameters
Go to the Monitors Category View by clicking the Monitors tab. Click on OpenShift under the Virtualization table. Displayed is the OpenShift 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.
On clicking a monitor from the list, you'll be taken to the OpenShift monitor dashboard. It has 9 tabs-
Overview
| Parameter |
Description |
Supported in SSH mode |
Supported in Prometheus |
| CLUSTER USAGE DETAILS |
| Average Cluster CPU Usage |
Average CPU used by the cluster in %. |
|
|
| Average Cluster Memory Usage |
Average memory used by the cluster in %. |
|
|
| CLUSTER DETAILS - PODS |
| Pod Utilization |
Number of pods used in %. |
|
|
| Used Pod Count |
Number of pods used. |
|
|
| Maximum Pod Count |
Total number of pods available. |
|
|
| Top 5 Nodes by Used Pod Count |
Graph of top 5 nodes by used pod count. |
|
|
| NODE DETAILS |
| Master Node Count |
Number of Master nodes present. |
|
|
| Worker Node Count |
Number of Worker nodes present. |
|
|
| Component Details |
| Component Name |
Name of the component. |
|
|
| Status |
Health of the component. |
|
|
| Component Message |
Message shown when the component status is unhealthy. |
|
|
| Summary Details |
| Project Count |
Total number of projects in the system. |
|
|
| Node Count |
Total number of nodes in the system. |
|
|
| Pod Count |
Total number of pods in the system. |
|
|
| Running Pod Count |
Total number of running pods in the system. |
|
|
| Containers Count |
Total number of containers in the system. |
|
|
| Service Count |
Total number of services in the system. |
|
|
| Deployment Count |
Total number of deployments in the system. |
|
|
| Replication Count |
Total number of replications in the system. |
|
|
| ReplicaSet Count |
Total number of replica sets in the system. |
|
|
| Jobs Count |
Total number of jobs in the system. |
|
|
Project
| Parameter |
Description |
Supported in SSH mode |
Supported in Prometheus |
| Project Name |
Name of the project. |
|
|
| Project Display Name |
Name given by the user. |
|
|
| Project Requester |
Name of the user who requested the project. |
|
|
| Project Status |
Status of the project. |
|
|
| Project Description |
Description of the project. |
|
|
| Project Created Time |
Time at which the project was created. |
|
|
Node
| Parameter |
Description |
Supported in SSH mode |
Supported in Prometheus |
| Top 5 Nodes by CPU Usage |
Graph of top 5 nodes by CPU Usage. |
|
|
| Top 5 Nodes by Memory Usage |
Graph of top 5 nodes by Memory Usage |
|
|
| Node Memory & CPU Details |
| Name |
Name of the Node |
|
|
| Allocatable CPU Processor Count |
Number of CPU processors that can be allocated in the node. |
|
|
| CPU Limit(%) |
CPU limit of the node in %. |
|
|
| CPU Request(%) |
Amount of CPU requested in %. |
|
|
| Allocatable Memory(GiB) |
Amount of memory allocatable in GiB. |
|
|
| Memory Limit(%) |
Memory limit of the node in %. |
|
|
| Memory Request(%) |
Amount of memory requested in %. |
|
|
| Node Pod Details |
| Name |
Name of the node. |
|
|
| Pod Usage Details |
Amount of pods used- Green represent free pods and red represents used pods. |
|
|
| Used Pod Count |
Number of pods used. |
|
|
| Allocatable Pod Count |
Number of pods allocatable. |
|
|
| Pod Utilization(%) |
Number of pods used in %. |
|
|
| Image Count |
Number of container images. |
|
|
| Node Details |
| Name |
Name of the node. |
|
|
| Hostname |
Name of the machine it is hosted on. |
|
|
| Internal IP |
IP address of the machine. |
|
|
| OS |
OS of the machine. |
|
|
| Type |
Type of the machine. |
|
|
| Allocatable Ephemeral Storage(GiB) |
Amount of allocatable ephemeral storage in GiB. |
|
|
| Action |
You can perform the following action-
- Describe Instance-Detailed information about the instance is shown in a new tab.
|
|
|
Pods
| Parameter |
Description |
Supported in SSH mode |
Supported in Prometheus |
| Pod Details |
| Pod Name |
Name of the pod. |
|
|
| Project Name |
Name of the project in which the pod is created. |
|
|
| Pod Node Name |
Name of the node in which the pod resides. |
|
|
| Pod Application |
Name of the pod application. |
|
|
| Pod Type |
Type of the pod. |
|
|
| Pod IP |
IP address of the pod. |
|
|
| Pod Status |
Status of the pod. |
|
|
| Pod Start Time |
Time at which the pod was started. |
|
|
| Pod Created Time |
Time at which the pod was created. |
|
|
| Top 10 Pods by CPU Usage |
Graph of top 10 pods by CPU Usage. |
|
|
| Top 10 Pods by Memory Usage |
Graph of top 10 pods by Memory Usage. |
|
|
| Pod Memory & CPU Details |
| Pod Name |
Name of the pod. |
|
|
| Number of Containers |
Number of containers in the pod. |
|
|
| Pod CPU Limit(%) |
CPU limit of the pod in %. |
|
|
| Pod CPU Request (%) |
Amount of CPU requested in %. |
|
|
| Pod Memory Limit(%) |
Memory limit of the pod in %. |
|
|
| Pod Memory Request(%) |
Amount of memory requested in %. |
|
|
| Pod Persistent Volumes Claim |
Name of persistent volume claim of the pod. |
|
|
Containers
| Parameter |
Description |
Supported in SSH mode |
Supported in Prometheus |
| Top 5 Containers by Restart count |
Graph of top 5 nodes by Restart count |
|
|
| Container Details |
| Container Name |
Name of the container. |
|
|
| Container Image |
Image of the container. |
|
|
| Pod Name |
Name of the pod which has the container. |
|
|
| Container Status |
Status of the container. |
|
|
| Container Restart Count |
Number of times the container was restarted. |
|
|
| Container Start Time |
Time at which the container was started. |
|
|
Services
| Parameter |
Description |
Supported in SSH mode |
Supported in Prometheus |
| Services Details |
| Name |
Name of the service. |
|
|
| Project Name |
Name of the project in which the service is created. |
|
|
| Application |
Name of the application it is used in. |
|
|
| Service Type |
Type of the service. |
|
|
| Cluster IP |
IP address of the cluster. |
|
|
| Service Ports |
Number of service ports. |
|
|
| Created Time |
Time at which the service was created. |
|
|
| Deployment Details |
| Name |
Name of the deployment. |
|
|
| Project Name |
Name of the project in which the deployment is created. |
|
|
| Replica Set |
Name of the replica set. |
|
|
| Desired Replica |
Desired Replica specifies the number of pods that needs to be replicated. |
|
|
| Running Replica |
Running Replica displays the number of replicas that are currently running. |
|
|
| Available Replica |
Available replica specifies the number of application replicas that are available to your users. |
|
|
| Deployment Availability |
States whether the deployment is available or not. |
|
|
| Actions |
You can perform 2 actions-
- Describe Instance - Detailed information about the instance is shown in a new tab.
- Delete Instance - Deletes the instance from OpenShift environment.
|
|
|
Replica
| Parameter |
Description |
Supported in SSH mode |
Supported in Prometheus |
| Replication Controller Details |
| Name |
Name of the Replication Controller. |
|
|
| Project Name |
Name of the project in which the replication controller is created. |
|
|
| Desired Replica |
Desired Replica specifies the number of pods that needs to be replicated. |
|
|
| Running Replica |
Running Replica displays the number of replicas that are currently running. |
|
|
| Available Replica |
Available replica specifes the number of application replicas that are available to your users. |
|
|
| Actions |
You can perform 2 actions-
- Describe Instance-Detailed information about the instance is shown in a new tab.
- Delete Instance- Deletes the instance from OpenShift environment.
|
|
|
| Replication Set Details |
| Name |
Name of the Replication Set. |
|
|
| Project Name |
Name of the project in which the replication set is created. |
|
|
| Desired Replica |
Desired Replica specifies the number of pods that needs to be replicated. |
|
|
| Running Replica |
Running Replica displays the number of replicas that are currently running. |
|
|
| Available Replica |
Available replica specifes the number of application replicas that are available to your users. |
|
|
| Actions |
You can perform 2 actions-
- Describe Instance - Detailed information about the instance is shown in a new tab.
- Delete Instance - Deletes the instance from OpenShift environment.
|
|
|
Jobs
| Parameter |
Description |
Supported in SSH mode |
Supported in Prometheus |
| Name |
Name of the job. |
|
|
| Project Name |
Name of the project in which the job is created. |
|
|
| Parallelism Replica |
Parallelism Replica specifies the number of pod replicas running in parallel that should execute a job. |
|
|
| Desired Replica |
Desired replica specifies the number of concurrently running pods that should execute a job. |
|
|
| Successful Replica |
Displays the number of successful pod count |
|
|
| Actions |
You can perform 2 actions-
- Describe Instance-Detailed information about the instance is shown in a new tab.
- Delete Instance- Deletes the instance from OpenShift environment.
|
|
|
| Job Start Time |
Time at which the job was started. |
|
|
| Job Completion(Min) |
Time taken to complete the job. |
|
|
Persistent Volume Claims
| Parameter |
Description |
Supported in SSH mode |
Supported in Prometheus |
| PVC Name |
Name of the PVC. |
|
|
| Project Name |
Name of the project in which the persistent volume claim is created. |
|
|
| PVC Access Mode |
Mode through which PVC can be accessed. |
|
|
| PVC Storage Class |
Mode of storage - Automatic or Manual. |
|
|
| PVC Status |
Status of the PVC. |
|
|
| PV Name |
Name of the persistent volume. |
|
|
| PVC Request(GiB) |
Amount of PVC requested in GiB. |
|
|
| PV Capacity(GiB) |
Total capacity of PV in GiB. |
|
|
| PVC Created Time |
Time at which the PVC was created. |
|
|
