riemannx v2.4.1 API Reference
Modules
Riemannx is a riemann client that supports UDP/TCP sockets and also supports a hybrid connection where smaller packets are sent via UDP and the rest over TCP
This is the behaviour specification for all connections as well as a generic API for communication with them based on the settings given in your config
The combined connection worker works out when it’s possible to use UDP and will transmit via TCP when the message size exceeds the total max byte size
Using the TCP connection will only send traffic via TCP, all traffic can be sent via TCP as opposed to UDP where you are limited by packet size, there is however an overhead penalty using purely TCP which is why the combined connection is the recommended default
TLS is a secure TCP connection, you can use this if communicating with your riemann server securely is important - it carries some overhead and is much slower than UDP/combined but the trade-off is obviously worth it if security is a concern
Using the UDP connection is not recommended at all, events will be dropped if they exceed the max_udp_size set. You can increase this server side and set the desired value in this client
This is a utility module used to get settings as and when they are needed