Event receiver
With the Versio.io event receiver you can receive events from protocols SNMP Traps, Syslog and MQTT.
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 configurations click the arrow on the left of your importer name to expand the configuration options.
Following configuration options are available:
| Field | Description | Advice |
|---|---|---|
| SNMP trap | Switch on and off and configure the connection and specify the port via which the messages are to be received. This applies to V1 and V2 messages. | Use 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 514en. |
| MQTT | Is coming soon. | |
| Executing OneImporter | Select a Versio.io OneImporter to import the data based on the importer configuration. | Requires installed OneImporter: Installation instruction |
| Schedule time (cron format) | Determine the frequency of imports in CRON format | Learn more about CRON format: https://en.wikipedia.org/wiki/Cron |
Table: Event receiver configuration parameters
The following image is an example of a event receiver configuration:
Figure: Example of a Versio.io event receiver configuration
Read more about Versio.io Event Management.
Frequent cause 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 it. Remember that a TCP dump takes place before the firewall.
# 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:
# 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 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:
# 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!
sudo systemctl restart rsyslog
Command line: Restart the Syslog service