/Syslog

An Arduino library for logging to Syslog server in IETF format (RFC 5424) and BSD format (RFC 3164)

Primary LanguageC++MIT LicenseMIT

Syslog

An Arduino library for logging to Syslog server via UDP protocol in IETF (RFC 5424) and BSD (RFC 3164) message format

Build Status Join the chat at https://gitter.im/arcao/Syslog

How to use, see examples.

Features

  • Supports original Syslog severity level and facility constants
  • Supports both Syslog messge formats: IETF (RFC 5424) and BSD (RFC 3164)
  • Supports printf-like formatting via logf methods (use vsnprintf method inside)
  • Supports fluent interface, see AdvancedLogging example
  • Allows to ignore sending specified severity levels with logMask function, see AdvancedLogging example
  • Independent on underlying network hardware. The network hardware library has to implement methods of UDP astract class only.

Compatible Hardware

The library uses the Arduino UDP Network API (UDP class) for interacting with the underlying network hardware. This means it Just Works with a growing number of boards and shields, including:

  • ESP8266 / ESP32
  • Arduino Ethernet
  • Arduino Ethernet Shield
  • Arduino YUN – use the included BridgeUDP in place of EthernetUDP, and be sure to call a Bridge.begin() first
  • Arduino WiFi Shield
  • Intel Galileo/Edison
  • Arduino/Genuino MKR1000
  • Arduino module RTL00(RTL8710AF), F11AMIM13 (RTL8711AM)
  • ... you tell me!

Syslog message formats

This library supports both Syslog message formats IETF (RFC 5424) and BSD (RFC 3164). The newer IETF format is used by default. If you want to use older "obsolete" BSD format, just specify it with SYSLOG_PROTO_BSD constant in a last constructor parameter.

Syslog syslog(udpClient, host, port, device_hostname, app_name, default_priority, SYSLOG_PROTO_BSD);
// or
Syslog syslog(udpClient, ip, port, device_hostname, app_name, default_priority, SYSLOG_PROTO_BSD);
// or
Syslog syslog(udpClient, SYSLOG_PROTO_BSD);

Dependencies

  • This library is using the Arduino Time Library to send timestamp in the syslog messages.