You add outbound plug-in instances so that you can notify users about alerts or capture alert data outside of VMware Aria Operations.

You can configure one or more instances of the same plug-in type if you need to direct alert information to multiple target systems.

The Automated Action plug-in is activated by default. If automated actions stop working, check the Automated Action plug-in and activate it if necessary. If you edit the Automated Action plug-in, you only need to provide the instance name.

Add a Standard Email Plug-In for VMware Aria Operations Outbound Alerts

You add a Standard Email Plug-In so that you can use Simple Mail Transfer Protocol (SMTP) to email VMware Aria Operations alert notifications to your virtual infrastructure administrators, network operations engineers, and other interested individuals. Alternately, you can also use your cloud proxy to communicate with your email server.

Prerequisites

Ensure that you have an email user account that you can use as the connection account for the alert notifications. If you choose to require authentication, you must also know the password for this account.

Procedure

  1. From the left menu, click Configure > Alerts, and then in the right pane, click Outbound Settings.
  2. Click Add, and from the Plug-In Type drop-down menu, select Standard Email Plugin.
    The dialog box expands to include your SMTP settings.
  3. Optionally, click the Use Proxy check box and then select the cloud proxy from the Collector/Group drop-down menu to establish a connection.
    Note: You must use a cloud proxy if your mail or rest server is located outside of AWS.
  4. Enter an Instance Name.
    This is the name that identifies this instance that you select when you later configure notification rules.
  5. Configure the SMTP options appropriate for your environment.
    Option Description
    Use Secure Connection
    Activates secure communication encryption using SSL/TLS. If you select this option, you must select a method in the Secure Connection Type drop-down menu.
    Note: In VMware Aria Operations, the Standard Email Plugin always uses the 'starttls' command when you select the Use Secure Connection checkbox and select TLS as the Secure Connection Type.
    Requires Authentication

    Activates authentication on the email user account that you use to configure this SMTP instance. If you select this option, you must provide a password for the user account.

    SMTP Host

    URL or IP address of your email host server.

    SMTP Port

    Default port SMTP uses to connect with the server.

    Secure Connection Type
    Select either SSL/TLS as the communication encryption method used in your environment from the drop-down menu. You must select a connection type if you select Use Secure Connection.
    Note: In VMware Aria Operations, the Standard Email Plugin always uses the 'starttls' command when you select the Use Secure Connection checkbox and select TLS as the Secure Connection Type.
    Sender Email Address

    Email address that appears on the notification message.

    Sender Name

    Displayed name for the sender email address.

    Credential Type Select the Credential Type from the list. If your Endpoint URL does not need any authentication, then select No Credential from the Credential Type list.
    Credential Add or edit the Credential details. Click the plus icon to enter the details of the new credentials in the Create New Credential pane, and click Save.
    This field appears only when you select Basic Authentication as the Credential Type.
    Note: When you upgrade to the latest version of VMware Aria Operations, all credentials get unassigned. The VMware Aria Operations administrator must assign the credentials from the Orphan and Unassigned page. For more information, see the topic, Managing Orphaned and Unassigned Content.
    Receiver Email Address

    Receiver's email address.

  6. Click Save.
  7. To start the outbound alert service for this plug-in, select the instance in the list and click Activate on the toolbar.

Results

This instance of the Standard Email Plug-In for outbound SMTP alerts is configured and running.

What to do next

Create notification rules that use the Standard Email Plug-In to send a message to your users about alerts requiring their attention. See User Scenario: Create a VMware Aria Operations Email Alert Notification.

Add an SNMP Trap Plug-In for VMware Aria Operations Outbound Alerts

You add an SNMP Trap plug-in when you want to configure VMware Aria Operations to log alerts on an existing SNMP Trap server in your environment.

You can provide filtering when you define a Notification using an SNMP Trap destination.

Prerequisites

Ensure that you have an SNMP Trap server configured in your environment, and that you know the IP address or host name, port number, and community that it uses.

Procedure

  1. From the left menu, click Configure > Alerts, and then in the right pane, click Outbound Settings.
  2. Click Add, and from the Plug-In Type drop-down menu, select SNMP Trap Plugin.
    The dialog box expands to include your SNMP trap settings.
  3. Enter an Instance Name.
  4. (Optional) Click the Use Proxy check box and then select the cloud proxy from the Collector/Group drop-down menu to establish a connection.
    Note: You must use a cloud proxy if your SNMP destination host is located outside of AWS.
  5. Configure the SNMP trap settings appropriate to your environment.
    Option Description
    Destination Host

    IP address or fully qualified domain name of the SNMP management system to which you are sending alerts.

    Port

    Port used to connect to the SNMP management system. Default port is 162.

    Community

    Text string that allows access to the statistics. SNMP Community strings are used only by devices that support SNMPv1 and SNMPv2c protocol.

    Username

    User name to configure SNMP trap settings in your environment. If the user name is specified, SNMPv3 is considered as the protocol by the plugin.

    If left blank, SNMPv2c is considered as the protocol by the plugin.

    Note: SNMP uses User Datagram Protocol (UDP) as its transport protocol.
    Authentication Protocol

    Authentication algorithms available are SHA-224, SHA-256, SHA-384, SHA-512.

    Authentication Password

    Authentication password.

    Privacy Protocol

    Privacy algorithms available are AES192, AES256.

    Privacy Password

    Privacy password.

    Engine ID Engine ID serves as an identifier for the agent. It is used with a hashing function to generate localized keys for authentication and encryption of SNMP v3 messages.

    It is mandatory to specify the Engine ID when configuring the SNMP Trap plugin. If you do not add the Engine ID and save the SNMP Trap plugin instance, the field is auto-generated the next time you edit the settings.

  6. Click Test to validate the connection.
    Note: The Community and Username options are mutually exclusive. Define either one of them to avoid an error. If you add a user name, you can optionally define the Authentication Protocol and Authentication Password followed by the Privacy Protocol and Privacy Password. The privacy protocol and its password cannot be defined independent of the authentication protocol and its password.

Results

This instance of the SNMP Trap plug-in is configured and running.

What to do next

When the plug-in is added, configure notifications for receiving the SNMP traps.

Add a Service-Now Notification Plug-In for Outbound Alerts

You add a Service-Now Notification plug-in when you want to integrate Service Now ticketing system with VMware Aria Operations. Service Now creates an incident whenever an alert is triggered in VMware Aria Operations.

Using Service-Now Notification Plug-In you can send alert notifications to the Service Now ticketing system to create incidents. The incident includes information like the Caller, Category, Subcategory, Business Service, and other attributes related to alerts.

Prerequisites

Ensure that you have log in credentials for Service-Now.

Ensure that you are assigned with IT Infrastructure Library (ITIL) role in Service Now.

Procedure

  1. From the left menu, click Configure > Alerts, and then in the right pane, click Outbound Settings.
  2. Click Add and from the Plug-In Type drop-down menu, select Service-Now Notification Plug-in.
    The dialog box expands to include your plug-in instance settings.
  3. Enter an Instance Name.
  4. Enter the Service Now URL.
    https://dev22418.service-now.com/
  5. Enter a value for the Connection Count.
    The connection count represents the maximum number of open connections allowed per node in VMware Aria Operations.
  6. Select the Credential Type from the list.
    Note: If your Endpoint URL does not need any authentication, then select No Credential from the Credential Type list.
  7. Add or edit the Credential details. Click the plus icon to enter the details of the new credentials in the Create New Credential pane, and click Save. This field appears only when you select Basic Authentication as the Credential Type.
    Note: When you upgrade to the latest version of VMware Aria Operations, all credentials get unassigned. The VMware Aria Operations administrator must assign the credentials from the Orphan and Unassigned page. For more information, see the topic, Managing Orphaned and Unassigned Content.
  8. To verify the specified paths, credentials, and permissions, click Test.
  9. Click Save.

Results

This instance of the Service-Now Notifications plug-in is configured and running.

What to do next

When the plug-in is added, configure notifications for creating incidents in Service-Now ticketing system.

Notifications - Add a Slack Plugin for Outbound Notifications

You can add a Slack plug-in to forward alerts and configure multiple notification rules with different slack channels. The Slack plug-in allows you to receive pre-formatted alert details with alert fields and helps you run VMware Aria Operations using alert links to troubleshoot further.

Prerequisites

Procedure

  1. From the left menu, click Configure > Alerts, and then in the right pane, click Outbound Settings.
  2. Click Add and from the Plugin Type drop-down menu, select Slack Plugin.
    The dialog box expands to include your plug-in instance settings.
  3. Enter an Instance Name.
  4. Enter a value for the Connection Count.
    The connection count represents the maximum number of open connections allowed per node in VMware Aria Operations.
  5. To verify the specified paths, credentials, and permissions, click Test.
  6. Click Save.

Results

This instance of the Slack plugin is configured and running.

What to do next

When the plugin is added, configure notifications for different slack channels.

Add a Webhook Notification Plugin for Outbound Instance

You can integrate Webhook with any endpoint REST API and configure outbound payload.

Prerequisites

Ensure that you have login credentials for Webhook.

Procedure

  1. From the left menu, click Configure > Alerts, and then in the right pane, click Outbound Settings.
  2. Click Add and from the Plugin Type drop-down menu, select Webhook Notification Plugin.
    The dialog box expands to include your plugin instance settings.
  3. Enter an Instance Name.
  4. Select the Use Proxy checkbox and then select the Collector/Group from the list.
    Note: When the credential type is OAuth Authentication, you can only select a single cloud proxy and not a collector group.
  5. Enter the Webhook URL.
    Note: For notifications that reference webhook outbound instances, the URL that you enter here serves as a base URL that is combined with the endpoint URL suffix defined in related webhook payload templates.
  6. Enter a value for the Connection Count.
    The connection count represents the maximum number of open connections allowed per node in VMware Aria Operations.
  7. Select the Credential Type from the list.
    Note: If your Endpoint URL does not need any authentication, then select No Credential from the Credential Type list.
  8. Add or edit the Credential details. Click the plus icon and enter the details of the new credentials in the right pane, and click Save.
    Note: When you upgrade to the latest version of VMware Aria Operations, all credentials get unassigned. The VMware Aria Operations administrator must assign the credentials from the Orphan and Unassigned page. For more information, see the topic, Managing Orphaned and Unassigned Content.
    The fields in the Create New Credential pane appear based on the Credential Type you select.
    Credential Type Fields
    Basic Authentication Enter the Name, User Name, and Password.
    Bearer Token Enter the Name of the credential and the Token.
    OAuth Authentication Enter the following details:
    • Name: Enter a name for the authentication.
    • Grant Type: Select either Client Credentials or Password Credentials.
    • Authentication URL: Enter the URL from where the access token can be retrieved.
    • Client ID: Enter the client ID for the authentication URL.
    • Client Secret: Enter the client secret for the authentication URL.
    • User Name: Enter the user name for the authentication URL.
      Note: This field appears only when the grant type is Password Credentials.
    • Password: Enter the password for the authentication URL.
      Note: This field appears only when the grant type is Password Credentials.
    • Scope: Enter the labels to specify the access token. The labels specify the permissions that the access tokens will have.
    • Send Credentials: Select either In auth header or In body.
      • In auth header: Sends the Client ID and Client Secret in the header.
      • In body: Sends the Client ID and Client Secret in the payload body.
      Note: This field appears only when the grant type is Client Credentials.
    • Access Token Path: Enter your access token path.
    • Validity Token Path: To keep track of when the token is going to expire, enter the validity token path and select the format from the drop-down list. You can choose one of the following formats:
      • Second
      • Milisecond
      • Absolute Time
    • Header Name: Enter a header name. By default, the header name is 'Authorization'.
    • Prefix: Enter a prefix. By default, the prefix is 'Bearer'.
    • Use Proxy: Select this check box to activate the Collector/Group drop-down list.
    • Collector/Group: Select the cloud proxy from the list.
      Note: When the credential type is OAuth Authentication, you can only select a single cloud proxy and not a collector group.
    Certificate Enter the following details:
    • Name: Enter the name of the certificate.
    • Certificate: Enter the certificate in the X.509 format.
    • Certificate Key: Enter the private key. The formats supported are Open SSL, PKCS1, and PKCS8
    API Key Enter the Name, API Key, and the API Value.
  9. To verify the specified paths, credentials, and permissions, click Test.
    Note:
    • The Test feature does not currently support the Custom Templates. If the template contains a custom headers, the test might fail.
  10. Click Save.

Results

This instance of the Webhook Notification plugin is configured and running.

Sample Email Alert

Here is a sample email for a newly created alert.

Alert Definition Name: Node is experiencing swapping due to memory pressure
Alert Definition Description: Node is experiencing swapping due to memory pressure
Object Name : VMware Aria Operations Node-VMwareAria Cluster Node
Object Type : vC-Ops-Node
Alert Impact: risk
Alert State : warning
Alert Type : Application
Alert Sub-Type : Performance
Object Health State: info
Object Risk State: warning
Object Efficiency State: info
Control State: Open
Symptoms:
SYMPTOM SET - self
Symptom Name Object Name Object ID Metric Message Info
Node swap usage at Warning level VMware Aria Operations Node-VMware Aria Cluster Node 50ec874a-2d7d-4e78-98b1-afb26fd67e58 Swap|Workload 59.183 > 30.0
Recommendations:
Notification Rule Name: rule1
Notification Rule Description:
Alert ID : badc2266-935d-4fb9-8594-e2e71e4866fc
VCOps Server - VMwareAriaClusterNode

Alert details(link)

VMware Hosted Email plug-in for Outbound Settings

Use the VMware hosted email plug-in for alert notifications and reports delivery in VMware Aria Operations.

Procedure

  1. From the left menu, click Configure > Alerts, and then in the right pane, click Outbound Settings.
    The Outbound Settings page appears.
  2. The VMware hosted email plug-in is enabled by default. Click the vertical ellipsis and click Edit.
  3. Enter the Receiver's Email Address and click Send to test the connection. The Send button appears after you enter the email address.
    Note: You can receive a maximum of 24 thousand emails in a day.
  4. Click Save.