GitXplorerGitXplorer
s

Arduino-SimpleSyslog

public
8 stars
1 forks
0 issues

Commits

List of commits on branch main.
Verified
0b79d145ae465424f808189c437f8d72eb26fb3a

Update README.md

sscottchiefbaker committed 7 months ago
Verified
2ff003cfd73709e287bab1633d8fd4a63c876705

Update README.md

sscottchiefbaker committed 7 months ago
Unverified
d91ebfae77a46bdf21b078853c90c663961fa09f

Bump to version 0.1.1 so the linter is happy

sscottchiefbaker committed 2 years ago
Unverified
7ec93afd2570df7650d18dc35fc9281027e1e431

Update examples

sscottchiefbaker committed 2 years ago
Unverified
914872b767204285b15641eef8fcef7ef6a8a972

Expand docs with rsyslog info

sscottchiefbaker committed 2 years ago
Unverified
9a5aa0caa96baf2e11f6bac8e4fab661d19ee7be

Add syntax highlighting

sscottchiefbaker committed 2 years ago

README

The README file for this repository.

Arduino SimpleSyslog

Easily add remote syslog capabilities to your ESP32/ESP8266 projects.

Installation

Clone this repo to your Arduino libraries directory. On Linux this is ~/Arduino/libraries/. Alternately you can just drop SimpleSyslog.h in the same directory as your .ino script.

Usage

Include the SimpleSyslog library and create a global syslog object with your environment settings:

#include <SimpleSyslog.h>

SimpleSyslog syslog("ArduinoHostname", "ArduinoApp", "192.168.5.222");

Send a syslog message:

// Simple string syntax
syslog.printf(FAC_LOCAL7, PRI_INFO, "This is a simple LOCAL7.INFO syslog packet");

// Advanced printf() syntax supported also
syslog.printf(FAC_USER, PRI_DEBUG, "Uptime: %s", millis());

Valid facilities:

  • FAC_USER
  • FAC_LOCAL0
  • FAC_LOCAL1
  • FAC_LOCAL2
  • FAC_LOCAL3
  • FAC_LOCAL4
  • FAC_LOCAL5
  • FAC_LOCAL6
  • FAC_LOCAL7

Valid severities:

  • PRI_EMERGENCY
  • PRI_ALERT
  • PRI_CRITICAL
  • PRI_ERROR
  • PRI_WARNING
  • PRI_NOTICE
  • PRI_INFO
  • PRI_DEBUG

Configuring rsyslog to receive messages

You will need to configure your /etc/rsyslog.conf to accept incoming UDP syslog messages. Add these lines to your config and restart rsyslog

$ModLoad imudp
$UDPServerRun 514

You may want to configure a specific rule to handle your messages:

# /etc/rsyslog.d/arduino.conf
template(name="arduino" type="string" string="/var/log/arduino.log")

if ($syslogfacility-text == "local7" or $syslogfacility-text == "user") then {
    action(type="omfile" DynaFile="arduino" FileCreateMode="0644")
    stop
}

Based on

Borrowed from jerryr/EspSyslog and improved upon.