VictorOps + Zebrium Integration Benefits

• Automatically adds root cause to a VictorOps incident triggered by any existing monitoring, APM, log manager, help desk tools, etc.
• Each incident is augmented with a clear set of events and charts showing root cause and symptoms.
• This means faster MTTR and less hunting for root cause.

How it Works

1. Any existing monitoring, APM, logger, help desk tool raises an alarm.
2. Through an existing integration with VictorOps, an incident is created.
3. At that same instant, VictorOps automatically calls an outbound webhook to Zebrium with all the incident details.
4. Zebrium correlates those incident details with its Autonomous Incident Detection and Root Cause by looking across logs and metrics.
5. The VictorOps incident is updated with Zebrium Incident details and likely root cause via the VictorOps API.
6. If you need to drill down further to logs or metrics, it’s just one click from your VictorOps Incident.

Requirements

• VictorOps user must have permissions to create API Keys and Outgoing Webhooks

Support

If you need help with this integration, please contact Zebrium by email to support@zebrium.com

Integration Walkthrough

In VictorOps (part 1 of 2)

Configuring API Access for Zebrium

1. From the Integrations tab, select API.
2. Click the + New Key button.
3. Enter a description (e.g. Zebrium Incident Detection).
4. Click the Create Key button.
5. Copy the API ID and the API KEY and save for later use when configuring Zebrium.

In Zebrium (part 1 of 1)

Configuring a Webhook for VictorOps

1. From the User menu area, click on the Settings Menu.
2. Click the Inbound Integrations menu item.
3. Click the Create Inbound Integration button, select VictorOps as the Inbound Integration Type and click Create.
4. Enter the VictorOps API ID that was copied in step 6 above when Configuring API Access for Zebrium
5. Enter the VictorOps API Key that was copied in step 6 above when Configuring API Access for Zebrium
6. Click the Create button.
7. Copy the Incoming Webhook URL and save for later use when configuring the VictorOps Outgoing Webhook.

In VictorOps (part 2 of 2)

Adding the Zebrium Webhook to VictorOps

1. From the Integrations menu, select Outgoing Webhooks.
2. Click the + Add Webhook button.
3. In the Event drop-down menu, select Incident-Triggered
4. In the Method drop-down menu, select POST
5. In the Content-Type drop-down menu, select application/json
6. Do not Add Custom Header
7. In the To text box, enter the Incoming Webhook URL that was copied in step 8 above when Configuring a Webhook for VictorOps.

8. In the Payload text box, enter the following:

    {
      "ze_entity_type" : "${{INCIDENT.ENTITY_TYPE}}",
      "ze_ack" : "${{STATE.ACK_MSG}}",
      "ze_user" : "${{STATE.ACK_USER}}",
      "ze_timestamp" : "${{STATE.ACK_TIMESTAMP}}",
      "ze_alert_ct" : "${{STATE.ALERT_COUNT}}",
      "ze_current_alert_phase" : "${{STATE.CURRENT_ALERT_PHASE}}",
      "ze_current_state" : "${{STATE.CURRENT_STATE}}",
      "ze_entity_id" : "${{STATE.ENTITY_ID}}",
      "ze_host" : "${{STATE.HOST}}",
      "ze_incident_name" : "${{STATE.INCIDENT_NAME}}",
      "ze_incident_timestamp" : "${{STATE.INCIDENT_TIMESTAMP}}",
      "ze_last_timestamp" : "${{STATE.LAST_TIMESTAMP}}",
      "ze_monitor_type" : "${{STATE.MONITOR_TYPE}}",
      "ze_service" : "${{STATE.SERVICE}}"
    }
   

9. Enter a description (e.g. Zebrium Incident Detection).
10. Click the Save button.

How to Uninstall

In VictorOps

Disable API Access

1. From the Integrations tab, select API.
2. Click X on the desired API Key.
3. Click the Delete Key button after confirming you wish to proceed.

Delete Outgoing Webhook

1. From the Integrations menu, select Outgoing Webhooks.
2. On the desired Outgoing Webhook, pull down the menu and select Delete
3. Click the Delete button after confirming you wish to proceed.

In Zebrium

Disable Webhook for VictorOps

1. From the User drop-down menu, select Settings.
2. Click the VictorOps tab.
3. Hover over the webhook you wish to remove and click the Red X.
4. Click the Continue button after confirming you wish to proceed.