Skip to main content

# Notification output channels

The following list contains all available Output Channels with a detailed description.

## Available output channels​

### Email​

For each Output Channel of this type you can define an SMTP Server, a sender address, username, and password for SMTP authentication (if required), and a template for the e-mail subject and body.

You can define that an Output Channel of this type is restricted to a certain User (recipient), to a Group of Users, to one or multiple Customers - which implies that it's restricted to all Users of the selected Customers that have the necessary Permissions.

### Mobile notification​

Any Avantra user using the Avantra Mobile App on an iOS or Android device is able to receive mobile notifications.

You can define that an Output Channel of this type is restricted to a certain User (recipient), to a Group of Users, to one or multiple Customers — which implies that it's restricted to all Users of the selected Customers that have the necessary Permissions.

### AWS - Simple Notification Service​

Notification messages are sent to a topic by means of the Amazon Web Services Simple Notification Service.

This Output Channel provides all the options that are available for the Simple Notification Service in Amazon Web Services.

### AWS - SMS​

Notification messages are sent as text messages by means of the Amazon Web Services Simple Notification Service.

This Output Channel provides all the options that are available for the SMS service in Amazon Web Services.

You can define that an Output Channel of this type is restricted to a certain User (recipient).

### Write into a log file​

For each Output Channel of this type, you can define an output file name, a template line defining the log file format, and a maximum line length.

### Run an external command​

For each Output Channel of this type, you can define an executable to run, a working directory, and the command line call as well as a timeout restricting the run time.

The command can be executed on the Avantra server, the Server hosting the Avantra Agent the Check is executed on, or on Servers defined by the use of System Selectors.

### Rewrite a template file​

The Output Channel allows you to rewrite template files. When defining this type of output channel, you can also use the Customer Filter to restrict it to one or more Customers.

### Create a ticket​

This Output Channel creates a Ticket within Avantra. You can define a short and a long description. Critical Check Results create Tickets with priority High, Warning Check Results create Tickets with priority `Medium`.

### Windows Event log​

This Output Channel creates an entry within the Windows Event Log if the Avantra Server is running on Microsoft Windows operating systems.

### RESTful Web Service​

This Output Channel delivers Notifications by calling a REST API that is provided by a third-party Web Service. It offers Basic and OAuth 2.0 authentication schemes, the latter of which are provided by profiles that may be shared between different REST and SOAP Output Channels.

### SOAP Web Service​

This Output Channel delivers Notifications by calling a SOAP Web Service. It offers Basic and OAuth 2.0 authentication schemes, the latter of which are provided by profiles that may be shared between different REST and SOAP Output Channels.

### In-browser notification​

This Output Channel delivers Notifications to Users logged into Avantra WebUI.

You can define that an Output Channel of this type is restricted to a certain User (recipient), to a Group of Users, to one or multiple Customers— which implies that it's restricted to all Users of the selected Customers that have the necessary Permissions.

### Ticket log​

This Output Channel is only available for Ticket Notification Actions and allows updating the particular Ticket triggering the Notification Action.

### SAP start/stop​

You can perform a Start, a Soft Shutdown, or a Hard Shutdown operation on:

- The affected SAP Instance or SAP System
- A single SAP Instance or SAP System
- All SAP Instances or SAP Systems defined in Selectors.

### Cloud automation​

You can perform a Start or a Stop operation on:

- The affected Cloud Server
- A single Cloud Server
- All Cloud Servers defined in Selectors.

### Null output channel​

An Output Channel that produces no output at all. Sounds useless, but you can use this if you want to only perform Check Confirmation.

### Composite output channel​

This Output Channel combines multiple other Output Channels. You can configure the conditions under which a particular Notification message is passed to one or more of the combined Output Channels.

All Output Channels can be restricted to a single or multiple Customers. In this case, they are only effective for Notifications generated for Notification Elements of Managed Objects owned by the defined Customers.

Every Notification takes some data with it. This data is primarily derived from the Notification Elements the Notification is triggered by, as well as the Managed Object the Notification Elements was running on, and the Customer owning the Managed Object. And there is even more, like the Notification reason, various timestamps, etc.

This data is available in the Output Channels by means of the so-called Interpolations. You best think of Interpolations as placeholders that are replaced by some real-world data once an Output Channel is executed.

note

If you are working with Filter Lists and Output Channels and you are working with Macros, you will find a button Convert to FTL that allows you to convert them into Interpolations.

## Defining output channels​

Although you can define an Output Channel while you are defining a Notification Action, we describe the two steps separately in here.

### Define an Email output channel​

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > Email in the toolbar.
   1. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
   2. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
   3. Choose one or more of the Supported Action Types.
   4. Click Finish. The Output Channel detail view is opened automatically.
2. Define a valid sender e-mail address in field Sender Mail Address, a default for this value can be defined in `Notifier.Mail.fromSenderName`.
3. A Sender Name can be configured also but is not mandatory. If more detailed control over the sender is required, open the sender details by clicking Edit Details…​ after you have saved the Output Channel. The Reply-To and the Return-Path e-mail address can be entered there.
4. Select a value for Recipient.
   1. If you want this Output Channel to deliver only to a single user, select Single user. Choose a User from the User drop-down list. You can only select a User that has the "Receive Notification Messages" permission for the Customers selected in Customer Filter.
   2. If you want this Output Channel to deliver to a group of users, select Group of users. You can only select a Group that has a Role containing the "Receive Notification Messages" permission for the Customers selected in Customer Filter.
   3. If you want this Output Channel to deliver to all Users of the selected Customers (or all Customers) that have the "Receive Notification Messages" permission, select Users of selected/all customers.
5. Select a value for Priority. Possible values are Highest, High, Normal, Low, and Lowest. Please note that it depends on the recipient's mail client how this value is interpreted.
6. You can also choose to send the messages as blind carbon copies (BCC) only.
7. Define the Subject of the e-mail.
   You can include any of the available Interpolations in this field. Click the Edit icon and select the appropriate one from the list.
8. To edit the Mail Content click Edit mail content…​. A dialog will be opened with the details of the mail content. It is possible to define either HTML or plain text content.
   You can include any of the available Interpolations in this field. Click the Edit icon and select the appropriate one from the list.
   When finished, Save your details and close the dialog.
9. Refer to Creating Mail Servers on how to create a mail server, and afterwards select a mail server from the Mail Server drop-down list.
10. Click Save.
11. You can test your settings by clicking Send Test Email.

#### Creating mail servers​

1. Select Configuration > Notifications from the top-level menu. Select More Manage Messaging Services …. Choose New Mail Server.
2. Fill in a Name, an optional Description, and choose a Customer.
   1. Choose either `SMTP` or `SMTPS` from the Protocol drop-down list.
   2. Define the server hostname in Target and optionally the Port number.
   3. Choose if or if not the server requires TLS (i.e. the so-called `STARTTLS` method).
   4. If your mail server requires authentication, please fill in a User and a Password.
3. Click Create to finish.

You can now use the mail server in the Mail Server field of the Email Output Channel.

### Define a Log File output channel​

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > Write into a log file in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Next.
6. Define a File Name. If you do not enter an absolute path to the file, the file location will be relative to the `log/notifier` directory of the Avantra Server.
   You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.

note

If you use Interpolations within this field you may face problems if the resolved value contains characters that are invalid for the use with file or directory names (e.g. the `NOTIFICATION_DATE` Interpolation contains a colon `:`). In this case you should write `${escapeFile(text)}` instead of `${text}`. escapeFile is a method that escapes these characters.

7. Define a Line Format.
   You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
8. You may define a maximum length for every line in Line Length. By default this is unrestricted.
   You may define a maximum size of the log file in field Maximum File Size. If the maximum file size is reached, a timestamp is appended to the file name and a new log file is created. Make sure you define a value ≥ 1 in Number of old Files to keep in this case.
9. Click Finish.

### Define a Command output channel​

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New Run an external command in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Next.
6. Define a Working Directory (optional). If you do not enter an absolute path to the file, the file location will be relative to the `tmp` directory of the Avantra Server.
   You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.

note

If you use Interpolations within this field you may face problems if the resolved value contains characters that are invalid for the use with file or directory names (e.g. the `NOTIFICATION_DATE` Interpolation contains a colon `:`). In this case you should write `${escapeFile(text)}` instead of `${text}`. escapeFile is a method that escapes these characters.

6. You may define a value for Command Timeout.
7. You have to define the command line call (i.e. the executable plus all the arguments) in the field Command Line.
8. You can also choose different commands per operating system, or select the host(s) to execute the command.
9. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.

note

If you use Interpolations within this field you may face problems if the resolved value contains quotes. In this case you should write `${escapeCmd(text)}` instead of `${text}`. escapeCmd is a method that escapes these characters.

10. Click Finish. The Output Channel detail view is opened automatically.
11. By default, the command is executed on the host running the Avantra Server. But you can also choose a different Scope: either the Server hosting the Managed Object the Notification Element is generated for, or an arbitrary set of Servers defined by a Selectors.
    For commands executed on remote hosts, it may be handy to define different commands for Unix and Windows hosts. Push New in order to add an additional command for a different platform. Adapt the OS field accordingly.
12. Click Save in case you made any modifications.

### Define a Rewrite a template output channel​

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > Rewrite a template file in the toolbar
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Next.
6. Define a File Name. If you do not enter an absolute path to the file, the file location will be relative to the `log/notifier` directory of the Avantra Server.
7. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.

note

If you use Interpolations within this field you may face problems if the resolved value contains characters that are invalid for the use with file or directory names (e.g. the `NOTIFICATION_DATE` Interpolation contains a colon `:`). In this case you should write `${escapeFile(text)}` instead of `${text}`. escapeFile is a method that escapes these characters.

8. Define a template text in Template.
9. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.

note

If you use Interpolations within this field you may face problems if the resolved value contains characters that have a special meaning in XML, like < or >. In this case you should write `${escapeXml(text)}` instead of `${text}`. escapeXml is a method that escapes these characters.

10. Click Finish.

### Define a Ticket output channel​

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New Create a ticket in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Next.
6. Define a Ticket Summary.
7. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
8. Optionally, define a template text in Ticket Detail Description.
9. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
10. Click Finish.

### Define a AWS - Simple Notification Service output channel​

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > AWS – Simple Notification Service in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Next.
6. Create an AWS – Simple Notification Service record as described in Handling AWS SNS Services and select it from the Service drop-down list.
7. Define a Topic ARN. For more information hover over (?).
8. Define an optional Subject. For more information hover over (?). You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
9. Define a Message. For more information hover over (?).
10. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
11. Define Attributes. For more information hover over (?).

#### Handling AWS SNS Services​

You need to create an AWS Simple Notification Service record in Avantra before you can make use of the AWS – Simple Notification service.

This record contains the credentials of an Amazon Web Services user with programmatic access and a customer-managed policy attached.

You can create an AWS API user with minimum access to EC2 and a policy, but use the following JSON policy instead:

    {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "AllowPublishToTopic",
                "Effect": "Allow",
                "Action": [
                    "sns:Publish"
                ],
                "Resource": "*"
            }
        ]
    }

1. Select Configuration > Notifications from the top-level menu. Select More > Manage Messaging Services.... Choose New > AWS – Simple Notification Service.
2. Fill in a Name, an optional Description, and choose a Customer.
3. Fill in the AWS Access Key ID, the AWS Secret Access Key, and choose a Region.
4. Click Create to finish.

You can now use the AWS – Simple Notification Service in the Service field of the AWS — Simple Notification Service Output Channel.

### Define a AWS - SMS output channel​

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > AWS – SMS in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Next.
6. Create an AWS – Simple Notification Service record as described in Handling AWS SNS Services for SMS and select it from the Service drop-down list.
7. Define a Sender ID. For more information hover over (?). You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
8. Choose a Mode.
9. Define a Max. Price (USD) you are willing to pay per text message. For more information hover over (?).
10. Define a Message. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
11. Select a value for Recipients.
12. Click Save.

#### Handling AWS SNS Services for SMS​

You need to create an AWS Simple Notification Service record in Avantra before you can make use of the AWS – SMS service.

This record contains the credentials of an Amazon Web Services user with programmatic access and a customer-managed policy attached.

You can create an AWS API user with minimum access to EC2 and a policy, but use the following JSON policy instead:

    {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "AllowSendSms",
                "Effect": "Allow",
                "Action": [
                    "sns:SetSMSAttributes",
                    "sns:Publish"
                ],
                "Resource": "*"
            }
        ]
    }

1. Select Configuration > Notifications from the top-level menu. Select More > Manage Messaging Services.... Choose New > AWS – Simple Notification Service.
2. Fill in a Name, an optional Description, and choose a Customer.
3. Fill in the AWS Access Key ID, the AWS Secret Access Key, and choose a Region that supports SMS sending.
4. Click Create to finish.

You can now use the AWS - Simple Notification Service in the Service field of the AWS - SMS Output Channel.

### Define a UI Browser output channel​

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > Avantra Browser Notification in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.Choose one or more of the Supported Action Types.
4. Click Next.
5. Select a value for Recipient:
   1. If you want this Output Channel to deliver only to a single user, select Single user. Choose a User from the User drop-down list. You can only select a User that has the "Receive Notification Messages" permission for the Customers selected in Customer Filter.
   2. If you want this Output Channel to deliver to a group of users, select Group of users. You can only select a Group that has a Role containing the "Receive Notification Messages" permission for the Customers selected in Customer Filter.
   3. If you want this Output Channel to deliver to all Users of the selected Customers (or all Customers) that have the "Receive Notification Messages" permission, select Users of selected/all customers.
6. Click Next.
7. Define a Message. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
8. Click Finish. The Output Channel detail view is opened automatically.
9. You can also select a Severity and upload an audio file for Audio Source. The audio file is played whenever a browser notification is generated.

### Define a Mobile output channel​

1. Select Configuration > Notifications from the top-level menu. Select the Channels tab. Choose New > Avantra MobileApp Notification in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Next.
6. Select a value for Recipient.
   1. If you want this Output Channel to deliver only to a single user, select Single user. Choose a User from the User drop-down list. You can only select a User that has the "Receive Notification Messages" permission for the Customers selected in Customer Filter.
   2. If you want this Output Channel to deliver to a group of users, select Group of users. You can only select a Group that has a Role containing the "Receive Notification Messages" permission for the Customers selected in Customer Filter.
   3. If you want this Output Channel to deliver to all Users of the selected Customers (or all Customers) that have the "Receive Notification Messages" permission, select Users of selected/all customers.
7. Click Next.
8. Define an Alert Message. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
9. Click Finish.

### Define a EventLog output channel​

note

This Output Channel is only available if the Avantra Server is running on Microsoft Windows operating systems.

In order to define an EventLog Output Channel proceed as follows:

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New Windows event log in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Next.
6. Define a Message Format. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
7. You can also define Event Source, Event Server, Event ID, Category ID, and select a Type.
8. Click Finish.

### Define a REST output channel​

note

Consult the documentation of the REST API of the Web Service you plan to connect to.

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > RESTful Web Service in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Finish. The Output Channel detail view is opened automatically.
6. Define the REST API URL. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
7. Choose the Protocol and the request Method.
8. You can define additional headers using the `+` next to Headers.
9. If you desire authentication or authorization, you can choose between Basic and OAuth 2.0. For Basic authentication, fill in User and Password. For the setup of OAuth 2.0 see Using OAuth 2.0 with the RESTful Web Service Output Channel.
10. Click Save.

### Define a ServiceNow Incident Output Channel​

note

Before you start, please perform the steps described in ServiceNow, in particular, Authorizing Avantra with ServiceNow.

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > ServiceNow Incident in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Finish. The Output Channel detail view is opened automatically.
6. Choose a value for ServiceNow Authentication, the Urgency.
7. Adapt Short Description and Additional Comments if desired.
8. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
9. Click Save.

#### Using Additional Attribute Mapping*​

1. In your ServiceNow instance, under System Definition search for `tables` and select them.
2. Search for `imp_incident` and select it.
3. Use New to create additional attributes. Please note that the field Column Name gets filled automatically. Keep a note of these values. You will need them later for the definition in the Output Channel.
4. Map the new fields to the existing ServiceNow table, Search for transform in your ServiceNow instance. Under Administration, click on Transform Maps. Select table Transform Incidents.
5. Map all the fields using the Mapping Assist.
6. Click Save once you are done.
7. In Avantra WebUI, proceed to the ServiceNow Output Channel and fill in the mappings.

### Define a ServiceNow Event API output channel​

1. Select Configuration > Notifications from the top-level menu. Then select the Channels tab. Lastly, choose New > ServiceNow Event API in the toolbar.
2. Fill in the Name and Description fields (optional). The name of the output channel has to be unique.
3. If you plan to restrict the output channel to one or more customers, select the appropriate items in the Customer Filter.
4. Choose one or more of the Support Action Types.
5. Click Finish. The detail view of the Output Channel opens automatically.
6. Select a value for ServiceNow Authentication from the drop-down menu.
7. Fill in the rest of the fields, such as Source, Source Instance, Node, Resource, Metric Name, Type, Message Key, Description. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
8. Also, it's possible to define any number of additional fields using mappings in the Additional Information Mapping section. To learn more about ServiceNow Custom Alert Fields, see ServiceNow Documentation: Custom Alert Fields for more information.
9. Click Save.

### Define a SOAP output channel​

note

Consult the documentation of the Web Service you plan to connect to.

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > SOAP Web Service in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Finish. The Output Channel detail view is opened automatically.
6. Define the WSDL URL. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
7. Choose the Protocol and the request Method.
8. You can define additional headers using the next to Headers.
9. If authentication or authorization is needed, you can choose between Basic and OAuth 2.0. For Basic authentication, fill in User and Password. For the setup of OAuth 2.0 see Using OAuth 2.0 with the RESTful Web Service Output Channel.
10. Click Save.

### Define a Cloud Automation output channel​

note

This function is only available with the Avantra Automation, Cloud and Enterprise Editions. For more information about editions please see the Avantra Editions Matrix.

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > Cloud Automation in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Finish. The Output Channel detail view is opened automatically.
6. In Selection choose the Cloud Server you want to stop or start. This can be:
   1. A single Cloud Server whose name you have to choose from the list in Server. This Selection usually is only useful for Server Checks. For other Notification Elements, it may not have the desired result.
   2. The affected Cloud Server. This is, for instance, the Server a notified Check is executed for.
   3. Predefined or ad-hoc Selectors of Servers.
7. In ActThis Selection usually is only useful for Server Checks. For other Notification Elements, it may not have the desired result.ion, you can choose whether to start or stop the System.
8. Click Save.

### Define a SAP Automation output channel​

note

This function is only available with the Avantra Automation, Cloud and Enterprise Editions. For more information about editions please see the Avantra Editions Matrix.

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > SAP Start/Stop in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Finish. The Output Channel detail view is opened automatically.
6. In Selection choose the Systems you want to stop or start. This can be:
   1. A single SAP Instance or SAP System whose name you have to choose from the list in SAP System or SAP Instance, respectively.
   2. The affected SAP Instance or SAP System. This is, for instance, the System a notified Check is executed for. This Selection usually is only useful for SAP Instance or SAP System Checks. For other Notification Elements, it may not have the desired result.
   3. Predefined or ad-hoc Selectors of SAP Instances or SAP Systems.
7. In Action you can choose whether to start the System or to perform a soft or hard shutdown. For a soft shutdown – which is only available for ABAP SAP Instances and SAP System – you can also define a soft shutdown timeout.
8. Click Save.

### Define a Ticket Log output channel​

note

This Output Channel is only available for Ticket Notification Actions. It modifies the Ticket that triggers the Notification Action.

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > Create a ticket log in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Finish. The Output Channel detail view is opened automatically.
6. Choose values for Type, Author, and Ticket Log. Optionally choose a New Status and if or if not the entry will be flagged Hidden.
7. Fill in a text for the Log Content. You can include any of the available Interpolations in this field. Click the edit icon and select the appropriate one from the list.
8. Click Save.

### Define a Null output channel​

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > Null channel in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Finish.

### Define a Composite output channel​

1. Select Configuration > Notifications from the top-level menu. Select the Output Channels tab. Choose New > Composite Output Channel in the toolbar.
2. Fill in a Name and optionally a Description. The name of the Output Channel has to be unique.
3. If you plan to restrict the Output Channel to one or multiple Customers select the appropriate items from Customer Filter.
4. Choose one or more of the Supported Action Types.
5. Click Next.
6. Fill in at least two Output Channels using `+`, and for the second one choose whether it's executed in any case, only if the previous Output Channel fails, or only if the previous Output Channel succeeds. Repeat for a third, fourth, and fifth Output Channel, if desired.
7. Click Finish.

note

You cannot add a Composite Output Channel into another Composite Output Channel.

note

If you are working with Filter Lists and Output Channels and you are working with Macros, you will find a button Convert to FTL that allows you to convert them into Interpolations.