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

Exceptions