psyslog (community library)

Summary

Name Value
Name psyslog
Version 0.1.0
Installs 871
License MIT
Author Hans Nielsen hans@stackallocated.com
URL https://github.com/hansnielsen/psyslog
Repository https://github.com/hansnielsen/psyslog.git
Download .tar.gz

A UDP syslog library for sending log data to remote servers

Example Build Testing

Device OS Version:

This table is generated from an automated build. Success only indicates that the code compiled successfully.

Library Read Me

This content is provided by the library maintainer and has not been validated or approved.

psyslog

About

This library provides a UDP syslog client for logging data from Particle apps.

It has been tested on the Photon in combination with rsyslog. Other devices and syslog daemons may work! Feel free to contact me via email (hans@stackallocated.com) if you have issues with untested devices.

Usage

Add the following to the top of your application:

#define SYSLOG_DEBUG
#include "psyslog/psyslog.h"

Then, set up the remote log endpoint:

syslog_initialize("logs.example.com", 514);

To actually log data, use the following macros:

LOGE("This is an error message!");
LOGI("Informational messages are less important);

By default, the library will log using the device's MAC address as its hostname. If you want to use the Particle device ID, add #define SYSLOG_USE_DEVICEID before the include.

syslog servers

An example rsyslog configuration file is included. It will automatically separate logs by hostname and store them in /var/log/particle/.

Browse Library Files