You can configure Operational Insights to send email notifications when an issue occurs within a domain or with a Secure Agent.
You can configure alerts for the following events:
•The domain or the Secure Agent is unavailable.
•A collector, service, or node running within the domain is unavailable.
•CPU or memory consumption by a domain node, a domain service, or the Secure Agent host has crossed a configurable threshold.
•Disk usage by a Secure Agent has crossed a configurable threshold.
Note: You can view the alert notifications on the Home page.
You can view Informatica assets for organizations on the Infrastructure Alerts panel of the Alerts page. Parent organization users with sub-organization access privileges can switch to the sub-organization to view those assets.
You can enable or disable individual alerts or all alerts for each domain or Secure Agent that Operational Insights monitors. You also specify the Informatica Intelligent Cloud Services users, user group names, or email recipients outside the organization that receive alert notifications.
You can create alert scripts that Operational Insights executes to perform additional actions when an alert is triggered. See Use alert scripts for more information about creating and using alert scripts.
Configuring infrastructure alerts
When you configure the infrastructure alerts, you can configure the source of the alerts: domain, Secure Agent, or Secure Agent service. You can also include recipients for the alerts and optionally include a script for additional actions.
1Click Alerts in the left navigation bar.
2Click the Infrastructure Alerts tab.
3Select a domain, Secure Agent, or Secure Agent service.
4Configure each alert that you want to enable.
5Define the recipients that receive email notifications when an issue occurs. Perform one of the following steps:
- To add Informatica Intelligent Cloud Services user names, under the Email Recipients section, click Add Recipients > Users. Select users from the list and click Add. You can also search for users.
- To add Informatica Intelligent Cloud Services user groups, under the Email Recipients section, click Add Recipients > User Groups. Select user groups from the list and click Add. You can also search for user groups. When you add a user group, all the users who belong to the group receive the alert.
- To add an external email address that belongs to a user outside the organization, under the Email Recipients section, click Add Recipients > External Emails. Click + and enter a fully qualified and valid email address. Click Add. You can also add multiple external email addresses. The email addresses must be unique.
The Email Recipients section displays the selected users, user groups, and external email addresses.
Note: If you switch to a sub-organization from a parent organization to configure alerts, Operational Insights doesn't show all the parent organization users that are subscribed to the sub-organization. If a user doesn't appear on the email recipients list, enter the email address manually.
6If you want to use an alert script that Operational Insights executes to perform additional actions when an alert is triggered, select the Run Custom Script check box, and then enter the path to the script file on the Secure Agent host.
You can create scripts that Operational Insights executes to perform additional tasks when an alert is triggered, such as creating a support ticket or taking a snapshot of CPU statistics.
Operational Insights contains rules that correspond to the Secure Agent alerts that you enable. You specify the name of each rule to execute in the script. For each rule, you specify parameters that Operational Insights passes to the script.
An alert script can invoke a batch file, a shell script, or an EXE file. The executable file or program must be self contained.
Copy the script to a directory on the Secure Agent host. Each time the script executes, Operational Insights writes the script output and errors to log files in the same directory on the Secure Agent host where the script executes.
If the script output directory is under the Secure Agent installation directory, you might see an error when you open the log file on Windows. To resolve this issue, perform one of the following steps:
•Open the log file with the Administrator privilege.
•Grant read, write, and execute permissions for the script output directory and the files within it.
Alternatively, you can create the script output directory outside the Secure Agent installation directory and manually move the earlier log files to the new script output directory. In Administrator, open the Runtime Environments page. Edit the Secure Agent and select the OI Data Collector service. Edit the scriptLogDir property value for OpsInsights and specify a script output directory that is outside the Secure Agent installation directory.
Add the rule name and the rule parameters that for the rules you want to specify in the script file. Specify parameters as key value pairs.
You can configure multiple rules in a script.
The following table describes the rule names and parameters associated with Secure Agent alerts.
Secure Agent Alert
Rule Name
Rule Parameters
Secure Agent is unavailable for a duration of 15 minutes.
secure-agent-unavailable-rule
"ruleName":"secure-agent-unavailable-rule",
"timestamp":"${timestamp}",
"agentName":"${agentName}"
CPU usage by the Secure Agent exceeds xx % for a duration of 30 minutes.
secure-agent-cpu-overused-rule
"ruleName":"secure-agent-cpu-overused-rule",
"timestamp":"${timestamp}",
"agentName":"${agentName}",
"actualUsage":"${actualUsage}",
"thresholdValue":"${thresholdValue}"
Memory usage by the Secure Agent exceeds xx % for a duration of 30 minutes.
secure-agent-memory-overused-rule
"ruleName":"secure-agent-memory-overused-rule",
"timestamp":"${timestamp}",
"agentName":"${agentName}",
"actualUsage":"${actualUsage}",
"thresholdValue":"${thresholdValue}"
Configuring a Secure Agent to use an alert script
Complete the following steps to configure a Secure Agent to use an alert script.
1Copy the script file to the Secure Agent host.
2Click Alerts in the left navigation bar.
3Click Infrastructure Alerts.
4Select the Secure Agent that uses the alert script.
5Select the Run Custom Script check box.
6Click the Edit link, and then enter the path to the script file on the Secure Agent host.
7Click the Save link.
Purging Secure Agent script logs
You can specify the number of Secure Agent script log files to retain in the directory where the script runs. The application retains the most recent log files up to the value specified, and deletes all older log files.
By default, the application retains the 50 most recent script log files.
1Click Secure Agents.
2Select the Secure Agent where the Ops Insights Collector runs.
3Enter the number of log files to keep as the value for the scriptLogRetentionCount property.
Configuring alerts for Secure Agent services
You can configure Operational Insights to send alerts when an issue occurs with individual services on a Secure Agent.
You can configure alerts for the following events for a Secure Agent service:
•The service is unavailable
•CPU usage by the service crosses a configurable threshold
•Memory usage by the service crosses a configurable threshold
To configure alerts for Secure Agent services, perform the following steps:
1On the Infrastructure Alerts tab of the Alerts page, select the Secure Agent.
2If alerts are disabled for the Secure Agent, enable alerts.
aClick Enable All.
bEnable or disable individual Secure Agent alerts.
3Click Add Service Specific Alert.
4Select the Secure Agent service that you want to configure alerts for.
5Configure each alert that you want to enable.
6Enter an Informatica Intelligent Cloud Services user, user group names, or email recipients outside the organization that receive email notifications when an issue occurs.
7If you want Operational Insights to perform additional actions when an alert is triggered, enable Run Custom Script, and then enter the path to the script file on the Secure Agent machine.
8Repeat steps 3 through 7 for any additional Secure Agent services.