Set agent resource thresholds and alerts

You can configure threshold settings that define agent resource status by multiple metrics. You can also configure alerts to send notification to yourself and other users when any of the system resources reaches a critical state.

About this task

When you set threshold limits, you define the parameters for the safe, concern, and critical states of these system resource metrics:

  • Memory
  • CPU
  • Disk

In Planning Analytics Workspace, these states are displayed on the Databases page. A check mark in a green circle green check mark icon indicates a resource in a healthy state. A yellow triangle with an exclamation mark yellow triangle check mark icon indicates a resource in a concern state. A slash in a red circle yellow triangle check mark icon indicates a resource in a critical state.

Agent health report

In Planning Analytics Workspace Classic, these states are displayed on the Databases page. A green square indicates a resource in a healthy state. A yellow square indicates a resource in a concern state. A red square indicates a resource in a critical state.

System status icons

For Planning Analytics Administration on Cloud, threshold and alert settings apply to your entire environment.

Local onlyFor Planning Analytics Administration Local, you must configure threshold and alert settings for each agent in your environment. Unique system resource metrics are displayed for each agent in your environment.

Set agent resource thresholds and alerts in Planning Analytics Workspace

Procedure

  1. Click the Administration tile on the Planning Analytics Workspace Home page.
  2. Click Databases.
  3. Click the Agent tab on the Databases page.
  4. Click the specific agent for which you want to set thresholds and alerts.
  5. Click the Alerts tab.
    Agent threshold and alert settings
  6. For each system resource, set the Warning threshold and Critical threshold.

    When resource usage falls below the Warning threshold, the resource is in a healthy state. When resource usage is at or above the Warning threshold, but below the Critical threshold, the resource is in a concern state. When resource usage is at or above the Critical threshold, the resource is in a critical state.

    You can set thresholds for the following system resources:

    Memory usage
    Measures system memory usage in GBs.
    Default Warning threshold - 70 percent of installed system memory, expressed in GBs.
    Default Critical threshold - 80 percent of installed system memory, expressed in GBs.
    CPU usage
    Measures CPU usage as a percentage of total CPU capacity on the system.
    Default Warning threshold - 70
    Default Critical threshold - 95
    Disk usage
    Measures disk usage as a percentage of all system disk storage. The default Concern at range for Disk Usage is 65 to 85.
    Default Warning threshold - 65
    Default Critical threshold - 85
  7. If you want to be alerted by email when a resource reaches a critical state:
    1. Select the Alert at critical condition option for the resource.
    2. Enter the email addresses of the users to receive notification in the Notify email ID(s) box. When typing, you can separate addresses with a comma, space, tab, or enter. You can also paste a comma-delimited list of email addresses in this box.

      For Planning Analytics Administration on Cloud, notification emails are sent from administration@planning-analytics.ibmcloud.com.

      Local onlyFor Planning Analytics Administration Local, notification emails are sent from the mail address specified by the PAA_EMAIL_ADDRESS property in the bootstrap.properties file for a given agent. The default value for this property is administration@planning-analytics.ibmcloud.com, but you can modify it to use an email address that is more relevant for your environment. See Install and configure the Planning Analytics Administration agent (local only) for details on the bootstrap.properties file.

    3. Click Apply.
  8. You can click Restore to original values at any time to restore the default threshold and alert settings. Note that Restore also removes any email addresses from the Notify email ID(s) box.

Set agent resource thresholds and alerts in Planning Analytics Workspace Classic

Procedure

  1. Click Configuration icon next to the system resources on the Databases page.
  2. For each system resource, set the Warning threshold and Critical threshold.

    When resource usage falls below the Warning threshold, the resource is in a safe state. When resource usage is at or above the Warning threshold, but below the Critical threshold, the resource is in a concern state. When resource usage is at or above the Critical threshold, the resource is in a critical state.

    You can set thresholds for the following system resources:

    Memory usage
    Measures system memory usage in GBs.
    Default Warning threshold - 70 percent of installed system memory, expressed in GBs.
    Default Critical threshold - 80 percent of installed system memory, expressed in GBs.
    CPU usage
    Measures CPU usage as a percentage of total CPU capacity on the system.
    Default Warning threshold - 70
    Default Critical threshold - 95
    Disk usage
    Measures disk usage as a percentage of all system disk storage. The default Concern at range for Disk Usage is 65 to 85.
    Default Warning threshold - 65
    Default Critical threshold - 85
  3. If you want to be alerted by email when a resource reaches a critical state:
    1. Select the Alert at critical condition option for the resource.
    2. Enter the email addresses of the users to receive notification in the Notify email ID(s) box. When typing, you can separate addresses with a comma, space, tab, or enter. You can also paste a comma-delimited list of email addresses in this box.

      For Planning Analytics Administration on Cloud, notification emails are sent from administration@planning-analytics.ibmcloud.com.

      Local onlyFor Planning Analytics Administration Local, notification emails are sent from the mail address specified by the PAA_EMAIL_ADDRESS property in the bootstrap.properties file for a given agent. The default value for this property is administration@planning-analytics.ibmcloud.com, but you can modify it to use an email address that is more relevant for your environment. See Install and configure the Planning Analytics Administration agent (local only) for details on the bootstrap.properties file.

    3. Click Apply.
  4. You can click Restore at any time to restore the default threshold and alert settings. Note that Restore also removes any email addresses from the Notify email ID(s) box.