IBM DataPower Operations Dashboard v1.0.16.0
A newer version of this product documentation is available.
You are viewing an older version. View latest at IBM DPOD Documentation.
System Health
The System Health dashboard provides an overview of all devices health state based on user-defined metrics.
The dashboard is composed of multiple cards, each representing the health of a device, optionally divided into device groups.
In addition, the dashboard displays the DPOD health state based on Internal Health Alerts.
Metrics
- The health of each device is based on several user-defined metrics. For example, the CPU of the device.
- A metric is basically a criteria and a set of thresholds that together define whether the state of the device in that aspect is one of: Good / Waring / Error.
- Metrics are based on the Alerts subsystem of DPOD:
- The user can define which alerts are part of the System Health by selecting the "System Health Metric" option under [Manage → Alert → Setup Alerts → Edit Alert].
- Each alert can be used as a simple alert, as a System Health metric, or both. Using an alert both for alerting and as a System Health metric is recommended, since it makes sure the System Health dashboard will precisely reflect the sent alerts.
- The following System Health metrics are defined by default:
- Devices CPU Metric
- Devices Memory Metric
- Devices Load Metric
- Devices Fan Metric
- Devices Temperature Metric
- Devices Voltage Metric
- Devices Space Encrypted Metric
- Devices Space Temp Metric
- Devices Space Internal Metric
- System Errors Metric
- Device Availability Metric - This is an internal metric based on "Device Resources Monitoring" option selected at the device level, that checks whether the device is available or not.
Device Health Calculation
- The System Health dashboard calculates the health of each device in the past hour.
- The past hour is divided to 5 parts:
- Last 5 minutes (may be configured via "System Health Dashboard Sample Time Range (min.)" System Parameter)
- Previous 10 minutes
- 3 parts of 15 minutes (the rest of the hour)
- Each part displays a single icon with the health of the device during that period of time:
Icon | Description | Last 5 minutes | Other parts |
---|---|---|---|
Good | No errors or warnings found in metric samples | (same) | |
Warning | Warnings found in metric samples | (same) | |
Error | Errors found in metric samples OR | (same) | |
Unknown | - | No metric samples found (e.g. DPOD alert subsystem was down) OR | |
+ red background color | Critical | No metric samples found (e.g. DPOD alert subsystem was down) OR | - |
- Each device may have a total warnings threshold which sets the health of that device to Error in case the number of metrics that are at Warning state exceeds that threshold in a specific time period (see Configuring Monitored Gateways).
- Each device may also have a warning damage points threshold which sets the health of that device to Error in case the summary of the damage points of all metrics that are at Warning state exceeds that threshold in a specific time period (see Configuring Monitored Gateways).
- Each System Health metric may be assigned with damage points, which should reflect the severity of that warning.
- For each device, the user can set thresholds and damage points per health metric, which override the default thresholds and damage points defined at the System Health metric level (see Configuring Monitored Gateways).
Devices Display Options
- For each device, the user can define whether the device is displayed in the System Health dashboard.
- The user may define device groups:
- Each device group has a name and a display order of that group
- Devices are assigned to one or more device groups with a defined display order
- For example: Production, Non-production
Device Health Dashboard
- Clicking a device card in the System Health dashboard opens the Device Health dashboard which displays a detailed view of a specific device health.
- This dashboard displays all metrics that were part of the device health calculation.
- For each metric, all samples are displayed in a chart, which displays each sample values when hovering.
- For analyzing a System Health metric, the user may click "Analyze" when hovering over the metric values. This will take the user to the appropriate dashboard for analyzing the values.
- Each System Health metric may be assigned with a drill-down dashboard.