You can configure a webhook to send alert notifications to a remote web server. Webhooks provide notifications over HTTP POST/PUT.

Prerequisites

Verify that you are logged in to the vRealize Log Insight web user interface as a Super Admin user, or a user associated with a role that has the relevant permissions. See Create and Modify Roles for more information. The URL format of the web user interface is https://log-insight-host, where log-insight-host is the IP address or host name of the vRealize Log Insight virtual appliance.

Procedure

  1. Navigate to the Administration tab.
  2. Under Configuration, click Webhook.
  3. Click New Webhook.
  4. In the Name text box, enter a name for the webhook.
  5. Enter the following information.
    Option Description
    Endpoint Select the endpoint to which you want to send the notification, for example, Slack, Pager Duty, or a custom endpoint. Based on the selected endpoint type:
    • The user interface provides additional input options.
    • The user interface populates the webhook payload with a predefined template, which you can customize according to your requirement.
    Webhook URL Enter the URL for the remote web server where you want to post the webhook notifications. To verify the connection, click Test Alert.

    You can enter multiple webhook URLs separated by a blank space.

    Integration Key If you select a Pager Duty endpoint, enter an integration key for webhook requests.
    Advanced Settings If you select a custom endpoint, enter additional information such as content type, action, and so on.

    The default value for Content Type is JSON and Action is POST. You can customize these options and add additional headers to the request under Custom Headers. If the configured remote web server requires authorization to POST/PUT the webhook notification, enter the user name and password to authenticate with the server in the Authorization User and Authorization Password text boxes.

    Webhook Payload This area is auto-populated based on your selection in the Endpoint drop-down menu. You can customize the payload, which is the template of the body sent as a part of the POST/PUT webhook notification request. The body can be in XML or JSON format.
    Parameters You can use the list of parameters to construct the webhook payload. The parameters are replaced with the actual values while sending the webhook notification.
    • AlertName
    • AlertType
    • SearchPeriod
    • HitOperator
    • messages
    • HasMoreResults
    • Url
    • EditUrl
    • Info
    • Recommendation
    • NumHits
    • TriggeredAt
    • SourceInfo
  6. Click Save.