Skip to content

Getting Started

Arie J. Godschalk edited this page Nov 15, 2026 · 9 revisions

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.

Add your first log entry

  1. Create a Flow and choose the event that should be recorded, such as a device state change.
  2. Add the Add Something to the Log action.
  3. Enter a message, or insert Flow tokens to include values from earlier cards.
  4. Save and enable the Flow, then trigger it once.
  5. 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.

Example: record a door event

  1. In When, choose the door sensor's opened trigger.
  2. In Then, choose Add Something to the Simple Log.
  3. Enter a message such as Front door opened, set the group to Entry, and choose a severity such as Notice.
  4. Save the Flow, open the door to test it, and filter the settings view by Entry to find the entry.

Choose where the message goes

  • 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.

Severity and category

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.

Keep and export entries

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.

Clone this wiki locally