Repository navigation
Getting Started
Home · Flows · Syslog devices · App settings
Install Simple (Sys) Log from the Homey App Store; the app requires Homey v12.3.0 or newer.
- Create a Flow and choose the event that should be recorded, such as a device state change.
- Add the Add Something to the Log action.
- Enter a message, or insert Flow tokens to include values from earlier cards.
- Save and enable the Flow, then trigger it once.
- Open Simple (Sys) Log's app settings and check that the new entry appears.
To keep entries easy to find, use a consistent group name. The group is shown as the App value in the log viewer. If you also want severity and facility metadata, choose an action that has those optional fields.
- In When, choose the door sensor's opened trigger.
- In Then, choose Add Something to the Simple Log.
- Enter a message such as
Front door opened, set the group toEntry, and choose a severity such as Notice. - Save the Flow, open the door to test it, and filter the settings view by
Entryto find the entry.
- Log only: use Add Something to the Log.
- Log and Timeline: use Add Something to the Timeline and the Log.
- Timeline only: use Add Something to the Timeline.
- Grouped log: use Add Something to the Simple Log and fill in the optional group, severity and facility fields.
The grouped Timeline-and-log action adds the group to both destinations. The app setting Show group in Timeline controls whether the group is prefixed to that Timeline message.
To start a second Flow when an entry is written, use A log is generated in
the When section. For example, filter it to group Entry and severity
Warning, then add a notification action that includes the trigger's log
token. The trigger reacts to new entries; it does not replay entries that were
already in the log.
Grouped actions can assign an optional severity and category. Leave either field empty when the distinction is not useful. See the full severity-level list and category list.
Open the app settings to filter the log or export it. You can also add Flow actions to clear the complete log, clear entries older than a number of days, or retrieve the log as a token. See Flows and App settings.
For an in-Homey automation, the Flow cards are usually the simplest way to record or retrieve data. Scripts and other Homey apps can use the app API.
Fields marked * BLL supported can optionally include BLL expressions.
Ordinary text and inserted Flow tokens do not require BLL. See
BLL coding for supported fields and examples.
To exchange messages with other Syslog systems, pair a Syslog client to send messages out or a Syslog server to receive messages. See Syslog devices for setup details and network requirements.
Next: check the first entry, try a notification Flow, or troubleshoot a missing entry.
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!