icon-zpa.svg
Secure Private Access (ZPA)

Configuring Notifications

Within the ZPA Admin Portal, you can create notifications.

Adding a Notification

To add a new notification:

  1. Go to Configuration & Control > Notification Management > Notifications.
  2. Click Add.

The Add Notification window appears.

  1. In the Add Notification window:
  • On the General Information tab, provide the following information:

    • Name: The name of the notification.
    • Status: Indicates the status of the notification (i.e., Enabled or Disabled). By default, the status is set to Enabled.
    • Select a component from the drop-down menu. The following is a list of available components:

      If you are within a Microtenant, you can only create notifications for App Connectors and ZPA Private Service Edges.

      Click the Delete icon (Delete icon in the ZPA Admin Portal) to remove a selected component. After a component is selected, a drop-down menu appears for the Categories, Priorities, and selection of the components.

      After a component is selected, select the desired App Connectors, Cloud Connectors, or Private Service Edges from the list of available components:

      • App Connectors: Select an App Connector from the drop-down menu. You can search for a specific App Connector, select an individual App Connector, click Select All Displayed to select all App Connectors displayed in the drop-down menu, click Clear All to remove all selections, or click the Delete icon next to the selected App Connector to remove it. All App Connectors are selected by default.
      • Cloud Connectors: Select a Cloud Connector from the drop-down menu. You can search for a specific Cloud Connector, select an individual Cloud Connector, click Select All Displayed to select all Cloud Connectors displayed in the drop-down menu, click Clear All to remove all selections, or click the Delete icon next to the selected Cloud Connector to remove it. All Cloud Connectors are selected by default.
      • Private Service Edges: Select a Private Service Edge from the drop-down menu. You can search for a specific Private Service Edge, select an individual Private Service Edge, click Select All Displayed to select all Private Service Edges displayed in the drop-down menu, click Clear All to remove all selections, or click the Delete icon next to the selected Private Service Edge to remove it. All Private Service Edges are selected by default.

      A drop-down menu is not available for the Backup and Restore and Zscaler Client Connector components.

      Close
    • Select a category from the drop-down menu. You can select an individual category, click Select All Displayed to select all categories displayed in the drop-down menu, or click Clear All to remove all selections. All categories are selected by default. The following is a list of supported categories:

      • Backup Configuration: Indicates notifications regarding configuration backups and backups that are created manually or automatically.
      • Connectivity and Upgrade: Indicates notifications regarding the component connectivity and component upgrades.
      • Enrollment: Indicates notifications regarding the component enrollment.
      • System Resource: Indicates notifications regarding the component system resources.
      • Usage Metrics: Indicates notifications regarding the component usage metrics.
      Close
    • Select the priority of the notification (i.e., Low, Medium, and High). You can select an individual priority, click Select All Displayed to select all priorities displayed in the drop-down menu, or click Clear All to remove all selections. All priorities are selected by default.

      Close

    Close
  • On the Events tab:

    1. Click Add Events.
    2. Select the desired event.

    For events that require text input, enter an integer value within the supported range. To learn more, see the events table.

    1. Click Next.

    The following table provides a list of events, as well as the category and component the event belongs to:

    EventCategoryComponentDescription
    Application Exceeded Count LimitUsage MetricsApp ConnectorsAn event indicating when the component’s application count has exceeded the limit. The Application Exceeded Count Limit value must be an integer between 4500 and 6000. The default value is set to 4500.
    Backup CompletedBackup ConfigurationBackup and RestoreAn event indicating when the backup is completed. To learn more, see About Backup and Restore and Restoring Policies and Configurations from a Backup.
    Backup FailedBackup ConfigurationBackup and RestoreAn event indicating when the backup has failed. To learn more, see About Backup and Restore and Restoring Policies and Configurations from a Backup.
    Bandwidth Utilization Exceeded LimitUsage MetricsApp Connectors, Private Service EdgesAn event indicating when the component’s bandwidth utilization has exceeded the limit. The Bandwidth Utilization Exceeded Limit value must be an integer greater than or equal to 250 Mbps. The default value is set to 250.
    Control Connection DisconnectedConnectivity and UpgradeApp Connectors, Private Service EdgesAn event indicating when the control connection for an App Connector or ZPA Private Service Edge disconnects.
    CPU Exceeded LimitUsage MetricsApp Connectors, Private Service EdgesAn event indicating when the component’s CPU utilization has exceeded the limit. The CPU Exceeded Limit value must be an integer between 75% and 99%. The default value is set to 75. To learn more, see Monitoring App Connector Performance.
    CPU StarvationSystem ResourceApp ConnectorsAn event indicating when the App Connector's CPU is missing resources needed for operations.
    Disk Space Exceeded LimitUsage MetricsApp Connectors, Private Service EdgesAn event indicating when the component's available disk space is less than the indicated threshold. The Disk Space Exceeded Limit value must be an integer between 0 and 1024 MB. The default value is set to 1024. To learn more, see Monitoring App Connector Performance.
    Enrollment CompletedEnrollmentApp Connectors, Private Service Edges, Cloud ConnectorsAn event indicating when the enrollment of the component is completed.
    File Descriptors ExhaustedUsage MetricsApp Connectors, Private Service EdgesAn event indicating when the component’s file descriptors are exhausted. The File Descriptors Exhausted value must be an integer between 75% and 99%. The default value is set to 75. To learn more, see Monitoring App Connector Performance.
    Invalid System Listen IP ConfigurationSystem ResourcePrivate Service EdgesAn event indicating when the listen IP address configuration for a ZPA Private Service Edge is invalid.
    Last Component DisconnectedConnectivity and UpgradeApp Connectors, Private Service EdgesAn event indicating that all App Connectors in an App Connector group or all ZPA Private Service Edges in a ZPA Private Service Edge group are disconnected.
    Outdated Component Manager VersionConnectivity and UpgradeApp Connectors, Private Service EdgesAn event indicating the Manager version is outdated for the selected components.
    Provisioning Key Utilization Exceeded LimitEnrollmentApp Connectors, Private Service Edges, Cloud ConnectorsAn event indicating when the provisioning key has exceeded the limit for the selected components.
    Restore CompletedBackup ConfigurationBackup and RestoreAn event indicating when the restore is completed. To learn more, see About Backup and Restore and Restoring Policies and Configurations from a Backup.
    Restore FailedBackup ConfigurationBackup and RestoreAn event indicating when the restore has failed. To learn more, see About Backup and Restore and Restoring Policies and Configurations from a Backup.
    SCIM Users Successfully DeletedEnrollmentZscaler Client ConnectorAn event indicating when SCIM users are deleted successfully.
    Source Port Consumption ExhaustedUsage MetricsApp Connectors, Private Service EdgesAn event indicating when the component's source TCP or UDP ports are exhausted. The exhausted values must be an integer between 75% and 99%. The default value is set to 75.
    System Memory Exceeded LimitUsage MetricsApp Connectors, Private Service EdgesAn event indicating when the component’s system memory has exceeded the limit. The System Memory Exceeded Limit value must be an integer between 75% and 99%. The default value is set to 75. To learn more, see Monitoring App Connector Performance.
    Upgrade CompleteConnectivity and UpgradeApp Connectors, Private Service EdgesAn event indicating when an upgrade is complete for the selected components.
    Upgrade FailedConnectivity and UpgradeApp Connectors, Private Service EdgesAn event indicating when an upgrade fails for the selected components.
    Close
  • On the Action tab:

    • Throttling enforces limits and timeout durations on the notification. Throttling is set to Disabled by default. When Throttling is Enabled, the Throttling Limit and Throttling Timeout fields appear.

      • Throttling Limit: Enter an integer value to indicate the throttling limit.
      • Throttling Timeout: Enter an integer value in hours to indicate the throttling timeout.

      For example, the Throttling Limit value is 3, and the Throttling Timeout value is 1 hour. If the notification is set to trigger when the App Connector CPU is greater than 80%, the recipients receive only three email notifications within the last hour if the CPU of the App Connector exceeds the 80% threshold.

      Close
    • Under the Recipients section:

      1. Select the recipients from the drop-down menu. You can search for a specific recipient, select an individual recipient, click Select All Displayed to select all recipients displayed in the drop-down menu, click Clear All to remove all selections, or click the Delete icon next to the selected recipient to remove it.
      2. In the Distribution List field, enter the desired distribution list in the following format: example@test.com.
      3. Click Add Items so that the distribution list receives notifications after the notification is configured.
      1. Click Next.

      Subject: [!] ZPA: Automatic Usage Metrics for Connector Lab App Connector with HIGH priority

      Body: You are receiving this message because you requested notifications for:

      • Tenant Name: SafemarchTenant ID: 198745983939657747ZPA
      • Cloud Name: ProductionZPA
      • Component: App ConnectorName: Lab App Connector
      • Priority: HIGH
      • Event/Notification alert: Event triggered as a result of Memory exceeded
      • Review the relevant dashboards, analytics, and configuration settings in the ZPA Admin Portal.

      Thank you,

      Zscaler

      The sender email domain for the notifications might come from no-reply@private.zscaler.com or no-reply@zpatwo.net depending on your organization's assigned cloud. To learn more, see What Is My Cloud Name for ZPA?

      Close

      Close
    Close
    1. Review your configured settings.
    2. Click Save.
    Close

Editing a Notification

To edit a notification:

  1. Go to Configuration & Control > Notification Management > Notifications.
  2. In the table, locate the notification you want to modify and click the Edit icon (Edit icon in the ZPA Admin Portal).

    The Edit Notification window appears.

  3. In the Edit Notification window, modify fields as necessary, and then continue the steps to edit a notification. To learn more about each field and the steps to edit a notification, see the steps to add a notification.

Copying a Notification

To copy a notification:

  1. Go to Configuration & Control > Notification Management > Notifications.
  2. In the table, locate the notification you want to copy and click the Copy icon ().
    The Add Notification window appears that contains the prepopulated fields from the copied notification.
  3. In the Add Notification window, modify fields as necessary, and then continue the steps to add the new notification. To learn more about each field and the steps to add a notification, see the steps to add a notification.
Related Articles
About NotificationsConfiguring Notifications