![](<https://live.versio.io/importer/importer-event-receiver.svg>)

# Event receiver

With the Versio.io event receiver you can receive events via the SNMP trap, Syslog and MQTT protocols.

## Configuration

You can find the configuration option in Versio.io at `Environment settings > OneImporter > Configurations > Event receiver`.

Here you can edit all existing configurations, create new configurations or delete existing configurations. Click `Add` to proceed to the configuration. To edit an existing configuration, click the arrow on the left of your importer name to expand the configuration options.

The following configuration options are available:

| Field | Description | Advice |
| --- | --- | --- |
| **SNMP trap** | Switch the connection on and off, configure it and specify the port via which the messages are to be received. This applies to v1 and v2 messages. | Use the standard port `162` |
| **SNMP V3** | You can also activate and configure SNMP for version 3. You can then also receive encrypted SNMP traps. |  |
| **Syslog** | Switch the connection on and off and configure the port on which the messages are to be received and the protocols to be supported. | Use the default port `514`. |
| **MQTT** | Coming soon. |  |
| **Executing OneImporter** | Select a Versio.io OneImporter to import the data based on the importer configuration. | Requires an installed OneImporter: [Installation instructions](<https://docs.versio.io/setup-one-importer/index.md>) |
| **Schedule time (cron format)** | Determine the frequency of imports in CRON format | Learn more about CRON format: [https://en.wikipedia.org/wiki/Cron](<https://en.wikipedia.org/wiki/Cron>) |

*Table: Event receiver configuration parameters*

The following image is an example of an event receiver configuration:

![Versio.io event receiver configuration](<https://docs.versio.io/img/importer/event-receiver/event-reveiver-configuration.png>) *Figure: Example of a Versio.io event receiver configuration*

Read more about [Versio.io Event Management](<https://www.versio.io/solution-event-processing-management.html>).

## Frequent causes of errors

> **Attention:** Please make absolutely sure that the firewall is correctly configured or switched off! We have often experienced in projects that no events could be received because the firewall blocked them. **Remember that a TCP dump takes place before the firewall.**

```bash
# Check the status of the firewall
sudo systemctl status firewalld
# Stop the firewall
sudo systemctl stop firewalld
# Disable the firewall
sudo systemctl disable firewalld
```

## Syslog installation and configuration

If the syslog daemon is not yet present on the host system, you can install it with the following command:

```bash
# Check if syslog daemon is running
sudo systemctl status rsyslog

# Debian based systems (Ubuntu)
sudo apt-get install rsyslog

# Red Hat based systems
sudo yum install rsyslog
```

*Command line: Install the syslog daemon*

Then configure in the file `/etc/rsyslog.conf` which messages are to be sent to which syslog server depending on the severity level:

```bash
# Transport protocol: @ (UDP) or @@ (TCP)
*.warning @<your-remote-server-ip>:514
```

*Command line: Configure syslog as needed*

**Attention:** Changes to the syslog configuration will not take effect until the syslog daemon has been restarted!

```bash
sudo systemctl restart rsyslog
```

*Command line: Restart the syslog service*

## Reference

- [Syslog on Wikipedia](<https://en.wikipedia.org/wiki/Syslog>)
- [SNMP on Wikipedia](<https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol>)
- [MQTT on Wikipedia](<https://en.wikipedia.org/wiki/MQTT>)
