# Backup reports

At the end of a backup job, you can configure Xen Orchestra to send backup reports directly by email, Slack or in Mattermost. It's up to you.

## Email

### Step-by-step

1. On the "settings/plugins" view you have to activate and configure the "Backup-reports" plugin.
   ![](./assets/backup-reports-plugin.png)

2. Still in the plugins view, you also have to configure the "transport-email" plugin.
   ![](./assets/transport-email-plugin.png)

3. Once it's done, you can now create your backup job. In the "report" selection you can choose the situation in wish you want to receive an email (always, never or failure).
   ![](./assets/backup-report-config.png)

:::tip
You can also modify existing backup jobs and change the behaviour of the report system.
:::

## XMPP

You can **be notified via XMPP** after the backup task is finished (scheduled "full backup", "snapshots" or "disaster recovery").

To configure it, 2 steps are needed in the plugin section (under "Settings"):

1. add a list of recipient(s) for the notifications (in the plugin "backup-reports" and for XMPP)
2. set the XMPP server

That's it: your next scheduled job will be recapped in a message:

![](https://xen-orchestra.com/blog/content/images/2015/12/xmpp.png)

## Slack or Mattermost

Xen Orchestra is able to send backup reports to Slack or Mattermost.

### Plugin configuration

Like all other xo-server plugins, it can be configured directly via the web interface, see [the plugin documentation](https://xen-orchestra.com/docs/plugins.html).

### Generate the Webhook

#### Slack

1. Log in your Slack team account

2. Click on the **Main menu** at the top and choose **Apps & Integrations**

![Apps & Integrations](./assets/DocImg1.png)

3. Search **Incoming WebHooks**

![Incoming WebHooks](./assets/DocImg2.png)

4. Click on **Add Configuration**

![Add Configuration](./assets/DocImg3.png)

5. Choose the default channel and click on **Add Incoming WebHooks integration**

![Add Incoming WebHooks integration](./assets/DocImg4.png)

6. Modify the default settings and click on **Save Settings**

![Save Settings](./assets/DocImg5.png)

#### Mattermost

You need to be an admin:

- Go into the MatterMost menu, then Integration
- Click on "Add Incoming webhook"
- "Add Incoming Webhook"

### Testing the plugin

#### Slack

![Slack configuration](./assets/DocImg6.png)

![Slack](./assets/DocImg7.png)

#### Mattermost

![Mattermost configuration](./assets/DocImg8.png)

![Mattermost](./assets/DocImg9.png)

## Web hooks

You can also configure web hooks to be sent to a custom server before and/or after a backup job runs. This won't send a formatted report but raw JSON data that you can use in custom scripts on your side. Follow the [web-hooks plugin documentation](./advanced.html#web-hooks) to configure it.