RSyslog Documentation




Generates a random number between 0 and the number specified, though the maximum value supported is platform specific.

  • If a number is not specified then 0 is returned.
  • If 0 is provided as the maximum value, then 0 is returned.
  • If the specified value is greater than the maximum supported for the current platform, then rsyslog will log this in the debug output and use the maximum value supported instead.

While the original intent of this function was for load balancing, it is generic enough to be used for other purposes as well.


The random number must not be assumed to be crypto-grade.

New in version 8.12.0.


In the following example a random number between 0 and 123456 is generated.


See also

Help with configuring/using Rsyslog:

  • Mailing list - best route for general questions
  • GitHub: rsyslog source project - detailed questions, reporting issues that are believed to be bugs with Rsyslog
  • Stack Exchange (View, Ask) - experimental support from rsyslog community

See also

Contributing to Rsyslog:

Copyright 2008-2020 Rainer Gerhards (Großrinderfeld), and Others.

Scroll to top