Skip to main content

ServiceNow Endpoint Configuration

Integrate with ServiceNow to receive Logz.io notifications in your ServiceNow workspace.

Adding a ServiceNow notification endpoint​

1. Add a dedicated user in your ServiceNow workspace​

Open your ServiceNow instance and create a new user. See ServiceNow docs for details.

Special requirements:

  1. Check off Web service access only.
  2. Assign the user the role incident_manager.

Logz.io - ServiceNow integration requires the user role: incident_manager

2. Add the endpoint​

Go to the Notification endpoints page, and click Add endpoint. Fill in the form:

  1. Type: Select the option ServiceNow.
  2. Instance URL: Enter the URL for your ServiceNow instance.
  3. Username: Enter a ServiceNow username that has been assigned the role incident_manager.
  4. Password: Provide the password for the above ServiceNow username.

3. Test the endpoint (Optional)​

Click Run the test to test your endpoint. Logz.io shows if the message was successfully sent.

Check that the message arrived at the target endpoint.

4. Save the endpoint​

Save your endpoint.

Logz.io ServiceNow Notification template​

The ServiceNow endpoint comes preconfigured with the following notification template. The double-brackets indicate variables that will be auto-populated by Logz.io with data specific to the triggered alert.

{
"short_description": "{{alert_severity}}: {{alert_title}}",
"correlation_id": "logzio_{{alert_definition_id}}",
"state": "1",
"description": "Severity: {{alert_severity}}\nAlert Description: {{alert_description}}\n\nURL to investigate the alert:\n{{alert_app_url}}/#/view-triggered-alert?&from={{alert_timeframe_start_epoch_millis}}&to={{alert_timeframe_end_epoch_millis}}&definitionId={{alert_definition_id}}&switchToAccountId={{account_id}}\n\nLog samples:\n{{alert_samples}}"
"work_notes":"Investigate the alert:\n[code]<a href="{{alert_app_url}}/#/view-triggered-alert?&from={{alert_timeframe_start_epoch_millis}}&to={{alert_timeframe_end_epoch_millis}}&definitionId={{alert_definition_id}}&switchToAccountId={{account_id}}">View in OpenSearch Dashboards</a>[/code]"
}
Important

ServiceNow endpoints do not support Logz.io resolved alerts.