ignio Integration Guide

Digitate’ s flagship product, ignio, is an award winning cognitive automation product suite for the enterprise that enables smarter and faster decision-making to accelerate transformation, improve performance, and predict & prevent problems.

Unique pre-built knowledge significantly reduces the time required for ignio’s AI to learn and understand the infrastructure and its business context. ignio makes IT operations automations both simple and powerful. Out-of-the-box skills enable ignio to execute many routine tasks on its own. Complete automation workflows can be built without the need for static programming or scripting. As a result, IT Operations staff can devote more time to innovation and transformation.

Benefits

Minimize or eliminate business revenue loss due to IT failures

  • Handle Incidents – Reduces time required to recover from an IT outage by 90%
  • Manage Alerts – Reduces operational risks by more than 90%
  • Optimize Proactively – Helps identify and eliminate up to 30% of issues proactively

Enable positive business growth through improved user experience

  • Perform Actions – Reduces up to 90% of time required to process user requests
  • Learn Context – Automation that is adaptive, easy to scale and agile

Enhance efficiency of IT Operations

  • Up to 60%  reduction in manual effort spent on managing IT Operations

How it Works

  • Ignio takes help of PagerDuty to route notifications which are consumed by the recipient(s) as is without taking any action, while in the other case notifications are acted upon by the recipient(s) to help ignio resolve the incident.
  • Actionable events or incidents that are required to be acted upon in-order to be resolved will be routed to PagerDuty. Some of these notifications will be resolved or they would be escalated to other recipients who would act on these events for resolution.
  • In case of escalated incidents, ignio provides enrichment to assist triaging by providing notes in PagerDuty, and PagerDuty allows the provision to select automation actions for ignio to execute and assist in incident resolution.
  • In some customer integrations, pure notification messages are routed to PagerDuty for end user consumption. For instance, frequently occurring events getting suppressed which can indicate possibility of optimization of thresholds, alerting frequency at the source, etc. Or through notifications, provide the incident status to the interested stakeholders.

Requirements

  • PagerDuty integrations require an Admin base role for account authorization. If you do not have this role, please reach out to a PagerDuty Admin or Account Owner within your organization to configure the integration.

Support

This integration is built and supported by Digitate. If you need help with this integration, contact ignio.support@digitate.com.

Integration Walkthrough

In PagerDuty

Integrate with a Service

    1. From the Configuration menu, select Services.
    2. There are two ways to add an integration to a service:
    • If you are adding your integration to an existing service: Click the name of the service you want to add the integration to. Then, select the Integrations tab and click the New Integration button.
    • If you are creating a new service for your integration: Please read our documentation in section Configuring Services and Integrations and follow the steps outlined in the Create a New Service section, selecting ignio as the Integration Type. Continue with the In ignio section (below) once you have finished these steps.
    Select ignio Integration Type

    Add Service – Image 1

    1. Enter an Integration Name and select ignio from the Integration Type menu.
    2. Click the Add Integration button to save your new integration. You will be redirected to the Integrations tab for your service.
    3. An Integration Key will be generated on this screen. Keep this key saved in a safe place, as it will be used when you configure the integration with ignio in the next section.
Ignio Service

Ignio Service Integration Key

Integrate with a Ruleset 

  • Go to Configuration -> Event Rules -> Default Global Rules -> Incoming Event Source
  • Copy the Integration key. (Marked in blue rectangle in below image)

Note: The Integration Key is generated only by an Admin account

Ignio Event Rule

Ignio – PagerDuty Integration Depiction

Ignio Diagram

In ignio

Perform the following steps to setup the PagerDuty integration in ignio

  1. Login to ignio using credentials with administrative privileges
  2. Go to Maps.
  3. Create a node under an appropriate org unit

Note: Typical hierarchy of the entities is as follows. Enterprise (Org Unit) is the global org unit on the top in the hierarchy.

User creates appropriate org units under the “Enterprise” Org Unit and creates the said entity under this org unit.

In the current case an org unit named “Integration” is created, and the “Add Entity” operation is carried on this Org Unit.

Ignio Add EntityAdding Entity: Image – 3

Prerequisite:

Ensure the capability named “Notification” is already installed in ignio.

Note: The “Capability” in ignio parlance is an executable code which performs certain operations. In the current case sending a notification using PagerDuty is the expected operation. This Capability is developed using an in-house tool called studio.

  1. Select the “Entity” option and search for the entity type “PagerDuty”Select Entity Instance

Select Entity Instance: Image – 4

  1. Fill in the name of the integration and routing key as shown in the below screen.

Note: This routing key is also known as the Integration Key generated in PagerDuty. (Refer step 8 “Get Integration key” above)

Add Entity Instance

  1. Pager Duty instance is ready to be used. Next, configure scenarios for notification sending.

Go to Settings Policy Configurations

  1. Select the org unit for which you want to configure the policies for notifications.

Note: You can opt to apply the policies at the top at the Enterprise level or at the specific Org Unit level under it. Applying the policies at the Enterprise level cascades it to all the org units under it.

Selecting Org Unit for Policy Configuration: Image – 14

Selecting Org Unit for Policy Configuration: Image – 6

  1. Select the “Events” configuration parameter and select the “Alert notification” option, click Next as shown below.

Note: Below is a simplified view of a Policy Configuration. Normally, there are many other parameters listed with “Events”. Th same is the case with the policies under “List of policies”.

Selecting Policy to be applied: Image – 15

Selecting Policy to be applied: Image – 7

  1. Click on the Alert notification entry
  2. Click on “Add New”
  3. Click on “Add new instance”. (Marked in blue rectangle in image –8) This shows a new policy configuration screen as shown in step 9.

    Adding instance of selected policy: Image – 16

    Adding instance of selected policy: Image –8

  4. Select the tool as “Pager Duty” and fill in the other details.

 

Populate “Alert Notification” policy configuration: Image – 17

Populate “Alert Notification” policy configuration: Image – 9

An explanation of the Instance parameters are found below. (Refer Image – 9)

  • Tool – Select value “Pager Duty”
  • Type – Per Event / Batch
  • If Batch is selected “Minimum occurrences”, “Check Interval” and “Event duration” should be populated.
  • Event Status –Event status for which notification is sent. For e.g. Duplicate, suppressed etc.
  • Priority – Select the event priority on which the notification is sent
  • Severity – Select the event severity on which the notification is sent
  • Subject –Title or summary for this notification.
  • Content – The content of the notification sent out to the user.
  1. Any alert from ignio on a specific entity, for which a policy is set, gets applied to it. In this case the “Alert Notification” policy. This event is sent to PagerDuty and as a result appropriate notification is sent out by PagerDuty to various recipients through various channels as configured in PagerDuty.

Start Using PagerDuty Today

Try PagerDuty free for 14 days — no credit card required.