Registry / devops / node-red-contrib-syslog

node-red-contrib-syslog

library1.1.0jsnpmunverified

A Node-RED contrib node that formats msg.payload as valid RFC 3164 syslog messages for sending to syslog servers via UDP or TCP. It can also parse incoming syslog messages from a UDP input (Buffer). Version 1.1.0 is current. Key differentiators: simple integration with Node-RED flows, dynamic level/category/process/pid/hostname via msg.syslog, and built-in parsing of received syslog lines. This is a single-purpose utility node for syslog formatting within Node-RED, not a standalone library for syslog client/server.

devops

npm install node-red-contrib-syslog

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · NODE-RED-CONTRIB-S

node-red-contrib-syslog

devopsjavascriptv1.1.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Example of using the syslog node within a Node-RED flow: configure properties statically or dynamically via msg.syslog.

// Node-RED flow - no direct code import, but usage: // Drag a "syslog" node from palette, set properties, connect to UDP/TCP output. // Input: msg.payload (string) // Output: formatted syslog string in msg.payload // Dynamic overrides: // msg.syslog = { level: 6, category: 1, process: 'myapp', pid: 123, hostname: 'server1', time: new Date() }

Debug

Known issues

gotchaNode-RED nodes are not imported as ES modules; they are installed as npm packages and loaded by Node-RED runtime.

fix

Install via npm install node-red-contrib-syslog or Node-RED palette manager.

affects: >=1.0.0

gotchaInput parsing expects a Buffer from a UDP input node, not a string. Parsing will fail if msg.payload is already a string.

fix

Ensure the UDP input node is set to output a Buffer (default).

affects: >=1.0.0

gotchaTime override (msg.syslog.time) is accepted but may be overwritten by node's default if not a Date object or valid timestamp.

fix

Provide a JavaScript Date object or valid ISO string.

affects: >=1.0.0

gotchaSyslog level values must be integers 0-7; category 0-23. Invalid values may produce malformed messages or be ignored.

fix

Validate level and category before setting.

affects: >=1.0.0

Errors

Common errors & fixes

Cannot find module 'node-red-contrib-syslog'

Package not installed in Node-RED's node_modules or palette not configured.

fix

Run 'npm install node-red-contrib-syslog' in your Node-RED user directory (typically ~/.node-red) or use the palette manager.

msg.syslog is undefined

Syslog node is in parse mode but input is not a Buffer or is malformed.

fix

Ensure UDP input node outputs Buffer; check message format is RFC 3164 compliant.

Syslog message format is missing hostname or timestamp

Dynamic overrides not set and node properties left empty.

fix

Set the hostname in node properties or provide msg.syslog.hostname.

Upgrade

Version history

1.1.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/natcl/node-red-contrib-syslog ↗

packagenode-red-contrib-syslog ↗

homepagehttps://github.com/natcl/node-red-contrib-syslog#readme ↗