# Icinga2

Follow the steps below to configure a service so as to push related alert data from [Icinga2](https://icinga.com/docs/icinga2/latest/) into Squadcast.

Squadcast will then process this information to create incidents for this service as per your preferences.

### Using Icinga2 as an Alert Source

1. Navigate to **Services** -> **Service Overview** -> select or search for your Service. Expand the accordion -> In the Alert Sources section, click **Add**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4fbd74e7ca0b30173c47a1d58ed6a0804a0465aa%2FAlert_Sources.png?alt=media\&token=aaca6610-9d18-4dd4-9cf5-320042f326f1)

2\. Select **Icinga2**. Copy the displayed **Webhook URL** to [configure](#create-a-squadcast-webhook-in-icinga2) it within **Icinga2.** Finish by clicking **Add Alert Source** -> **Done**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-a3b3a7e8bf70c7ac5cb4f1b9fc473d546211a5fb%2FIncinga2.png?alt=media\&token=68bce0c3-16d1-4f6f-a556-71ec25a16df8)

{% hint style="warning" %}
**Important:**

When an alert source turns Active, it’ll show up under Configured Alert Sources, you can either generate a test alert from the integration or wait for a real-time alert to be generated by the Alert Source. An Alert Source is active if there is a recorded incident via that Alert Source for the Service.
{% endhint %}

### Create a Squadcast Webhook in Icinga2

**(3)** In the machine where Icinga2 is installed, go to `/etc/icinga2/conf.d/` directory and download *squadcast-icinga2.conf* from github.

You can also run the command below to get to the directory and download the `squadcast-icinga2.conf` configuration file.

```
cd /etc/icinga2/conf.d/
wget https://raw.githubusercontent.com/SquadcastHub/squadcast-icinga2-integration/master/squadcast-icinga2.conf
```

**(4)** Open the file with your text editor of choice and **replace** `<SQUADCAST_icinga2\_WEBHOOK_URL>` with the **Icinga2 Webhook URL** that you copied in step 2.

**(5)** Copy and paste the line below to the configuration files of all the hosts and services for which the alerts will have to be sent to Squadcast.

```javascript
vars.enable_squadcast = true
```

You can manually add this line to all the **Hosts** and **Services** for which you want the notifications to get into Squadcast, but, the easiest way to do this is to add it to templates that are used by all of your configuration objects.

For instance, on Debian-based systems, the default configuration has host objects that use the **generic-host** template and service objects that use the **generic-service** template. The templates are defined in `/etc/icinga2/conf.d/templates.conf` and can be modified as follows:

```javascript
template Host "generic-host" {
 max_check_attempts = 5
 check_interval = 1m
 retry_interval = 30s

 check_command = "hostalive"

 vars.enable_squadcast = true # Add this line
}


template Service "generic-service" {
 max_check_attempts = 3
 check_interval = 1m
 retry_interval = 30s

 vars.enable_squadcast = true # Add this line
}
```

**(6)** If you have added `enable_squadcast` to the template in step 5, ensure that the template is used by your host and service objects. For instance, if you added it to the **generic-host** or **generic-service** templates, your objects should have one of the following lines:

```javascript
import "generic-host" # All host objects should have this line in them
```

```javascript
import "generic-service" # All service objects should have this line in them
```

**(7)** Go to `/etc/icinga2/scripts/` directory and download `sq-icinga2.py`

```
cd /etc/icinga2/scripts/
wget https://raw.githubusercontent.com/SquadcastHub/squadcast-icinga2-integration/master/sq-icinga2.py
```

{% hint style="info" %}
**Note**\
\\

The above script require Python 3 to be installed on your Icinga2 server.\
The script have been tested to work with Python 3.7
{% endhint %}

**(8)** Make the scripts executable by running the command below:

```
chmod +x sq-icinga2.py
```

**(9)** Restart Icinga2 server. You can also use the command below to do so.

```
/etc/init.d/icinga2 restart
```

{% hint style="info" %}
**Restart Command**

The Restart Command might differ depending on the Icinga2 version and the host operating system used.\
Please refer to the documentation of your specific deployment.
{% endhint %}

Your Icinga2 Alert Source integration is good to go. Whenever an alert is triggered in Icinga2, an incident will be triggered in Squadcast as well.

Squadcast will **Auto-Resolve** the incident, if the alert gets resolved in Icinga2 and doesn't require any manual intervention from the user.

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*