...
Note: This guide is intended to be specifically for opHA 3/4, opEvents 3/4 and NMIS 9. The tool is available for previous versions, but the syntax and some parameters can change. .
For users of opHA-Message Bus for Events, this document is redundant. To configure streaming events between pollers and primaries please review our opEvents Event Actions and Escalations documentation.
In order to integrate the poller events into the primary server on an opHA environment, we can make use of the create_remote_event.pl tool.
...
More information: Deduplication and storm control in opEvents#StatefulDeduplication,ForwardedEventsandReorderProtectionreorder_protection
Poller sending duplicate events to the primary
...
We have recently rewritten create remote event in Go, called fast-remote-event, and have provided the option to use token auth skipping which skips out one of the auth requests from the old Perl version.
...
We have retained all arguments from the perl version.
Version 1.1.0 1 can be downloaded here: https://dl-omk.opmantek.com/remote_event/fast-remote-event-1.1.01-Linux-x86_64.bin
| Code Block |
|---|
-d int
Log Level (default 4)
-p string
Password for the remote user
-path string
Path for generate auth token script (default "/usr/local/omk/bin/generate_auth_token.pl")
-q Quiet level, (1|true|0|false). Don't output anything (default true), -q=0 to see event id of remote system.
-retry int
Maximum number of retries
-s string
http://servername:portnumber/omk, API endpoint details are automatic. (default "http://localhost:8042/omk")
-t string
Token for auth
-u string
Username for remote server (default "nmis")
-v Verify the servers TLs connection (default true)
-version
Print out the version |
...
If your Opmantek Applications directory is in a non standard location you can use -path to point to the full path of generate_auth_token.pl which is shiped shipped in /usr/local/omk/bin/generate_auth_token.pl, in future versions we aim to remove this.
...
Sometimes the end server is busy but using the flag -retry you can instruct the http handler to make X amount of requests to try again, this will perform a back off to try and not swamp the end server.
Version History
V1.1.1
17th January 2025
allow use of '=' in the stdin input
V1.1.0
8th June 2023
Fix issue where fast-remote-event would crash when receiving a a server response other than JSON.
V1.0.1
22nd May 2023
Internal Release
V1.0.0
First Release
...