Repository navigation
Syslog client
Syslog devices · Home · Flow actions
The Syslog client sends Flow messages to an external Syslog receiver. It can also forward selected entries written to Simple (Sys) Log.
Pair a Syslog client device in Homey, then open its settings. You can pair multiple clients, each with its own destination and forwarding threshold.
| Setting | Purpose and default |
|---|---|
| Server | Hostname or IP address of the external Syslog receiver. |
| Port | Receiver port; defaults to 514. |
| Transport mode |
TCP or UDP; defaults to TCP. Match the receiver's transport. |
| Use RFC5424 | Off by default, which sends RFC 3164 messages. Turn it on when the receiver expects RFC 5424. |
| App name | Identifies the sending app; defaults to Homey. |
| Hostname | Sender hostname. When left blank, the Syslog client library uses its default hostname. |
| Log all Syslogs to the default Simple Log | On by default. Also stores messages sent with the device's Flow action in the local log. |
| Log all default Logs to this Syslog from Level | Defaults to No. Select a severity to enable automatic forwarding of Homey log entries at that level and less urgent levels. |
For example, selecting Warning sends Warning, Notice, Info and Debug entries. See Severity levels for all severity IDs and labels. No disables automatic forwarding; it does not disable the device's explicit Flow action.
- Configure the destination hostname/IP, port, transport and message format.
- In a Flow's Then section, add Add Something to the Syslog and select this client device.
- Enter the message. Optionally select a group, severity and facility.
- Save the Flow and check the receiver's log. If local copying is enabled, also check Simple (Sys) Log's app settings.
When a group is supplied, the client uses it as the Syslog application name for that message; otherwise it uses the configured App name. In RFC 5424 the application name is in the message header. With RFC 3164 it is prefixed to the message text.
The device action's Message and optional App/group fields support BLL expressions. BLL is optional; if it is unavailable, the expression text remains unchanged. See BLL coding for syntax and examples.
The automatic severity setting forwards entries written to Simple (Sys) Log with its normal log source. It is separate from sending a message through the device Flow action. The local-copy setting does not control automatic forwarding.
For the card's arguments and example, see Syslog client Flowcards.
The client supports TCP and UDP, but has no TLS transport option. Messages sent by this device are not encrypted by Simple (Sys) Log. Keep the receiver on a trusted network or use a separately secured relay or tunnel; do not send passwords, tokens or other secrets in Syslog messages.
The device Flow action's optional severity and category fields set Syslog priority metadata. See Severity levels and Categories for all labels and numeric values. These fields are separate from the group/App label.
Support development - If Simple (Sys) Log is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!