Skip to content

Getting Started

Arie J. Godschalk edited this page Nov 13, 2026 · 12 revisions

Getting started

Home · Flows · App settings

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.

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.

Severity

Grouped actions can assign one of the standard severity levels:

Value Name
0 Emergency
1 Alert
2 Critical
3 Error
4 Warning
5 Notice
6 Info
7 Debug

Severity is optional. Leave it empty when the distinction is not useful. The facility field is also optional; choose the appropriate value from the Flow card's 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.

Clone this wiki locally