Skip to main content

Configuring custom alerts in your application in Pega Predictive Diagnostic Cloud

Suggest edit Updated on January 19, 2022

Pega Platform™ generates alerts that Pega Predictive Diagnostic Cloud™ (PDC) uses to identify problems in your application. In addition to standard alerts, you can configure custom alerts that your application sends to PDC. Use custom alerts to gather information about problems that are specific to your application. For example, if an activity that sends an encrypted file every day fails to send the file, your application can send a custom alert to PDC.

Caution: To protect personally identifiable information (PII), PDC sanitizes all the information that it receives from Pega Platform. For more information, see Data security in Pega Predictive Diagnostic Cloud. For custom alerts, you must ensure that the label, description, and correlation fields of your alerts do not contain any PII. If Pega determines that your custom alerts contain sensitive data, Pega will suspend this feature for you without warning.

If your application sends a custom alert and PDC creates a case for that alert, the case is displayed in the Custom Cases category. If you subscribe to the Custom Alerts event notifications, you receive a message for each custom alert. For more information, see Managing notifications in Pega Predictive Diagnostic Cloud.

Note: For Pega Platform 7.2 to 8.6, import the PDCClient ruleset to be able to configure custom alerts.

Configure a custom alert by performing the following tasks:

  1. Importing the PDCClient ruleset to your application
  2. Defining a custom alert in your application
  3. Configuring notifications about your custom alert.

Importing the PDCClient ruleset to your application

To define custom alerts and send them to PDC, import the PDCClient ruleset to your application.

  1. Download the .zip file with the PDCClient ruleset from the PDC Custom Alert Client page on Pega Marketplace.
  2. In the header of Dev Studio, click Configure > Application > Distribution > Import.
  3. Use the Import wizard to import the .zip file. For more information, see Import wizard landing page.
  4. Add the new ruleset to your application:
    1. Click Application Name > Switch Application, and then select the application in which you want to define and send custom alerts.
    2. Click Application Name > Definition to open the Application rule form.
    3. In the Application rulesets section, click Add ruleset.
    4. In the new field, enter PDCClient:01-01.

Defining a custom alert in your application

You can send alerts from your application to PDC. To send a custom alert to PDC, configure the parameters that you want to pass to the SendApplicationAlert activity.

  1. In the Dev Studio header search text field, search for and select the activity from which you want to call the SendApplicationAlert activity, for example, MyAlert.
  2. In the Method field, enter Call SendApplicationAlert.
  3. Click the Expand icon.
  4. In the Method Parameters section, enter values for the following fields:
    1. In the alertApplication field, enter the name of the application that you want to include in your alert.
    2. In the alertCode field, enter a unique code for your alert, for example, JOHN0001. PDC uses the code to create a unique alert ID with the prefix CA- that uniquely identifies your custom alert, for example, CA-JOHN0001.
    3. If you want PDC to treat your alert as urgent, select the isUrgent check box. Note: You can find all urgent events for a system on the Urgent Events tab of the Enterprise landing page.
    4. In the caseCorrelationValue field, enter the value by which you want PDC to correlate your custom alert with the corresponding case. If you leave the default value, PDC correlates the alert based on the system name and the code that you defined in step b.
    5. In the message field, enter the description that you want PDC to display in the case overview and in the event summary of your custom alert.
  5. Click Save.

For more information, see Activity form - Completing the Steps tab - Entering Method parameters.

Configuring notifications about your custom alert

PDC can send a notification about each occurrence of your custom alert to specified recipients. If you have defined multiple custom alerts, you can subscribe to a separate notification for each of these alerts.

For more information about configuring notifications, see Managing notifications in Pega Predictive Diagnostic Cloud.

  • Previous topic Subscribing to Pega Predictive Diagnostic Cloud notifications by using a REST API
  • Next topic List of performance and security alerts in Pega Platform
Did you find this content helpful? YesNo

100% found this useful

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us