Notifier Setup Tab
- Kevin Wu
- Former user (Deleted)
A notifier is defined as the target where event messages are sent. A notifier may output information to Azure Application Insight, any type of database table, log file, SNMP trap, Mail, SNS topic, or the standard System Log.
Setting | Description |
|---|---|
Notification Type | Select the output type for the notification in this drop-down list. See the detailed descriptions of the notification types in the section below, Notification Type Configuration. |
Duplicate Suppression (sec) | Enter the number of seconds during which an identical event is suppressed from being logged. The default value is 0. |
Base Configuration | The Base Configuration settings vary depending on the selected notification type and can be the location of a log file, database profile, or credentials, etc. See the respective notification type descriptions below for more information. |
Target Field Configuration | These settings are used for constructing the content of the notification, and they vary depending on which notification type you have selected, see information about each notification type below. |
Notification Type Configuration
The event notification types that you can configure are:
Azure Application Insight
Database
When you select the Database notification type, Event fields can be inserted into database tables using either plain SQL statements or calls to stored procedures.
Setting | Description |
|---|---|
Database | Browse and select the database profile defining the database in which the table resides, see Database Profile for information about how to define a Database profile. |
SQL Statement | Type in any SQL statement, using '?' for variables which are to be mapped against event fields in the Event Setup tab. Trailing semicolons are not used. In the case of running several statements, they must be embedded in a block. |
Log File
When you select the Log File notification type, messages can be routed to ordinary text files on the local file system.
Event Notification - Notification Type Log File
Setting | Description |
|---|---|
Directory | Enter the path to the directory where the file in which events are to be logged resides. |
Filename | Enter the name of the file in which events are to be logged. In case the file does not exist, it will be created when the first message for the specific event map arrives. New messages are appended. |
Size | Select this check box to define the maximum size of the file. When this parameter is exceeded, the existing file is renamed and a new one is created upon the arrival of the next event. The old file will receive an extension to the file name, according to |
Time | Select this check box to define the maximum lifetime of a file before it is rotated. When this parameter is exceeded, the existing file is renamed and a new is created upon the arrival of the next event. If the time is set to rotate every:
The old file will receive an extension to the file name, according to If both Size and Time are set, both behaviors apply. |
Separator | Select how to separate logged events from each other. Valid options are:
|
Log Line | Enter the text to go into the log file. For further information about how to obtain the text, see Target Field Configuration below. |
Note!
Do not configure two different Event Notifiers to log information to the same file. Messages may be lost since only one notifier at a time can write to a file. Define one Event Notifier with several Event Setups instead.
Send Mail
When you select the Send Mail notification type, emails can be sent to one or several recipients when the specified events occur. Make sure the correct mail parameters have been configured in the platform.conf. You must enter a value for the property mz.notifier.mailfrom, see Platform Properties for more information about the mail properties.
Setting | Description |
|---|---|
Sender | Enter a label or name to be displayed in the Sender of the mail. The text in the Sender field will not replace the value of the For further information about how to obtain the text, see Target Field Configuration below. |
Recipient | Enter the mail address(es) to one or several recipients. Use a comma to separate, if several. Click on the Add... button to select mail addresses, configured for available users. For further information about how to obtain the text, see Target Field Configuration below. |
Subject | Enter the subject/heading of the mail. If Event Contents is selected, newlines will be replaced with spaces to make the subject readable. If the string exceeds 100 characters, it is truncated. For further information about how to obtain the text, see Target Field Configuration below. |
Message | Enter the body of the mail message. For further information about how to obtain the text, see Target Field Configuration below. |
Send SNMP Trap
When you select the Send SNMP Trap notification type, events may be sent in the form of SNMP traps to systems configured to receive such information. For the MIB definition, see the $MZ_HOME/etc/mz_trap_mib.txt file.
Note!
A new SNMP trap format is now available. For backward compatibility purposes, the previous invalid format will still be used by default. However, if you want to use the new format you can add the property
snmp.trap.format.b
to the platform.conf and set it to true to activate the new values.
You can use the topo command to set the property snmp.trap.format.b:
$ mzsh topo set topo://container:<container>/pico:platform/val:config.properties.snmp.trap.format.b true
The value of the agent Address field will be taken from the Container property pico.rcp.server.host .
Event Notification - Notification Type Send SNMP Trap
Setting | Description |
|---|---|
IP Address | Enter the IP address of the target host. |
Port | Enter the port on the target host defined for the SNMP communication. |
Community | Enter the community name string used for the authentication process. |
Version | Select which SNMP version to use in this drop-down list containing all supported versions. |
User Message | Enter a string to be sent out as SNMP traps. For further information about how to obtain the text, see Target Field Configuration below. |
Send SNMP Trap, Alarm
When you select the Send SNMP Trap Alarm notification type, you can create a notification type that is similar to the Send SNMP Trap notification type, with one difference; It is specifically designed to work for Alarm events.
Event Notification - Notification Type Send SNMP Trap Alarm
Setting | Description |
|---|---|
IP Address | Enter the IP address of the target host. |
Port | Enter the port on the target host defined for the SNMP communication. |
Community | Enter the community name string used for the authentication process. |
Version | Select which SNMP version to use in this drop-down list containing all supported versions. |
Target Field Configuration alarm* | Configure the content for each field in the alarms. For further information about how to obtain the text, see Target Field Configuration below. |
SNS Topic
When you select the SNS Topic notification type, messages produced by the selected events are routed as SNS topics to the specified Amazon S3 region.
Setting | Description |
|---|---|
Access Key | Enter the access key for the user who owns the Amazon S3 account in this field. |
Secret Key | Enter the secret key for the stated access key in this field. |
Region | Enter the name of the Amazon S3 region in this field. |
Use Amazon Profile | Select this option to route the event notification to an Amazon Profile. If this option is selected, click Browse to select the Amazon Profile to be used. Note! In order for the SNS Topic notification type to work with an Amazon Profile with Inherit from AWS EC2 configuration selected, ensure that the AWS EC2 instance contains sufficient permissions to perform the SNS:Publish action. For more information see Configuring the AWS EC2 Access Policy. |
Topic | Configure the SNS topic. For further information about how to obtain the text, see Target Field Configuration below. |
Message | Enter the body of the topic. For further information about how to obtain the text, see Target Field Configuration below. |
Configuring the AWS EC2 Access Policy
There are two methods to configure the AWS EC2 as follows:
Add AmazonSNSFullAccess Policy to IAM Role
Access the AWS EC2 instance page and select the IAM Role that you are using in the instance.
AWS EC2 Instance - IAM Role
In the Permissions tab, click the Add permissions drop-down and select Attach policies.
AWS EC2 Instance - Add permissions
Search for AmazonSNSFullAccess to add this permission.
AWS EC2 Instance - Add AmazonSNSFullAccess permission
Creating An Inline Policy to IAM Role
Access the AWS EC2 instance page and select the IAM Role that you are using in the instance.
AWS EC2 Instance - IAM Role
In the Permissions tab, click the Add permissions drop-down and select Create inline policy.
AWS EC2 Instance - Create inline policy
Select the SNS service.
AWS EC2 Instance - Select SNS service
Specify the following:
AWS EC2 instance - Actions allowed
Actions allowed - publish
Write - Publish
Effect - Allow
Resources - Specific
topic - Tick Any in this account option
Click Next.
Enter the policy name and click Create policy.
System Log
When you select the System Log notification type, messages produced by the selected events are sent to the standard System Log. The Contents field from each event is used as the message in the log.
Event Notification - Notification Type System Log
Target Field Configuration
Some of the notifier types have one or many parameters that may be dynamically populated by data from an event. These parameters are configured in the Target Field Configuration section.
Depending on the parameter type, there will be one or several population types available in the list next to it.
Manual
Select Manual to hard code a value, and thus give no possibility to select any dynamic values to be embedded in the message. The value entered will be assigned to the parameter exactly as typed.
Target Field Configuration - Log Line
Event Field
Select Event Field to assign the value of one specific event field. The event fields for the added events can be viewed in the Event Setup Tab.
For further information about fields valid for selection, see Event Fields.
Event Contents
Select Event Contents to add the event value of each event's Contents field. All event types have suitable event content text. For example, in the figure Events can be customized to suit any target, the Event Contents string will be:
Username: mzadmin3, Action: Notifier AnumberEvents updated.Another example is that the following string is reported for a User Defined Event:
Workflow name: <name>, Agent name: <name>, Message: <string>The Message string originates from the dispatchMessage function. Note that nothing will be logged unless dispatchMessage is used. Also, in this case, the Field Maps in the Event Setup will be disabled.
Formatted
Select Formatted to enter text combined with variable names, which are assigned to event field values in the Event Setup Tab tab.
Each variable in Notifier Setup has its own Notifier Field in Event Setup - Send Mail
For each variable entered in a field with the Formatted option selected, a notifier field will be added in the Event Setup tab where you can then assign event field values.
Variable names must be preceded by a $, started with a letter, and be comprised of a sequence of letters, digits, or underscores.
Target Field Configuration - Log Line
The settings in the screenshot above will be interpreted as containing the variables 'NO' and 'ANUM'.