Automation with Shortcuts & Siri

LogRaker plugs into Apple's automation: its actions appear in the Shortcuts app, can be run by voice with Siri, and your Streams, Monitors, Servers, Layouts, and groups are searchable in Spotlight. There's nothing to turn on - everything appears automatically once LogRaker has launched once.

Many actions return a value, so a Shortcut can act on it: read a Monitor's error count and branch on it, find the Streams that have dropped and restart them, grab a Stream's last lines and email them. When you run a value-returning action with Siri, Siri speaks the result aloud.

Ask Siri

These phrases work out of the box (Siri may ask which Stream or Monitor you mean), and the same phrases surface in Spotlight:

“How many matches in LogRaker” - a Monitor's count
“How many total matches in LogRaker” - across every Monitor
“Start a Stream in LogRaker” / “Stop a Stream in LogRaker”
“Check a Stream in LogRaker” - its status
“Start all Streams in LogRaker” / “Stop all Streams in LogRaker” / “Restart all Streams in LogRaker”
“Silence LogRaker alarms”
“Is anything alarming in LogRaker”

All actions

Every action below is in the Shortcuts app under LogRaker, whether or not it has a Siri phrase. Each one that needs a Stream, Monitor, Server, Layout, or group takes it as a parameter you pick from a list.

Monitors

Get Monitor Match Count - the number of matches a Monitor currently has: the same count on its badge. Returns a number to branch on.
Get Total Match Count - the combined count across all Monitors (the Dock-badge total).
Get Monitor Matches - the most recent matches (the last 50 by default), each carrying its line, time, matched pattern, and - where the Source provides them - severity, host and process (read them with Get Details of). Branch on severity instead of matching text against the line.
Silence Alarms - stop any active Monitor alarm (looping sound and the screen flash).
Silence Monitor Alarm - silence the alarm for one specific Monitor, if it's the one sounding or flashing.
Is Monitor Alarming - whether a Monitor is alarming right now. Returns true/false to branch on.
Is Anything Alarming - whether any Monitor is alarming. Returns true/false.
Reset Monitor Count - mark a Monitor's current matches as seen: its badge drops to zero and any alarm clears (the same acknowledgement as Reset Count in the app).
Reset All Counts - the same for every Monitor at once.
Create Monitor - make a Monitor watching the Streams you name for the patterns you give it. A line matches when it contains any one of them. It joins a group called 'Shortcuts', and Undo removes it.
Open Monitor - bring LogRaker to the front and select that Monitor.

Streams

Start Stream, Stop Stream, Restart Stream - control a single Stream's tail.
Start All Streams / Stop All Streams - every Stream at once.
Restart All Streams - restart every Stream that's currently running (leaves stopped Streams off).
Get Stream Output - the most recent lines of a Stream's live output (the last 50 by default). Set Minimum Severity to take only the lines at that level or worse; a Stream that carries no severity is returned whole.
Get Stream Status - one of Streaming, Connecting, Reconnecting, Stopped, or Error.
Find Streams by Status - every Stream currently in a status you choose, returned as a list you can loop over.
Search Stream - the lines of a Stream that match what you're looking for, oldest first. Comparison offers the same choices as the Find and Filter fields ('Contains', 'Matches All', 'Matches Any', 'Matches Word', 'Wildcards', 'Regular Expression'), and Minimum Severity narrows it further. Searches the lines in memory.
Get Stream History - lines from a past time, fetched from the Source again rather than read from memory, so they can reach back past what the Stream holds. Give it From and optionally To. A Stream on a Server or a cloud service has to be running, since its connection does the asking.
Clear Stream - empty a Stream's output buffer.
Open Stream - bring LogRaker to the front and select that Stream.

Servers

Get Streams on Server - every Stream that uses a given Server, as a list.
Start Streams on Server / Stop Streams on Server - start or stop all of a Server's Streams at once.
Open Server - bring LogRaker to the front and select that Server.

Layouts

Open Layout - bring LogRaker to the front and select that multi-pane Layout.

Apple TV

Set Apple TV Sharing - turn sharing to paired Apple TVs on or off. Useful in an arrive-home or leave-home automation.
Is Apple TV Sharing On - whether this Mac is currently sharing. Returns true/false.
Apple TVs Watching - how many Apple TVs are showing a Dashboard right now. Returns a number.

Groups

The sidebar's folders work here too - Source Groups, Stream Groups, Layout Groups, and Monitor Groups.

Open Source Group, Open Stream Group, Open Layout Group, Open Monitor Group - bring LogRaker to the front and select that group.
Start Streams in Source Group / Stop Streams in Source Group - start or stop every Stream across the group's Sources at once.
Start Streams in Stream Group / Stop Streams in Stream Group - every Stream in the folder, including its nested groups.
Start Streams in Layout Group / Stop Streams in Layout Group - every Stream the group's Layouts drive.
Get Streams in Source Group / Get Streams in Stream Group / Get Streams in Layout Group - the group's Streams as a list, to loop over.
Get Monitors in Monitor Group - a Monitor Group's Monitors as a list (the Monitor counterpart, since Monitor Groups hold no Streams).

Workspaces

The sidebar's top-level partitions - see Workspaces.

Switch Workspace - show a Workspace's Sources, Layouts and Monitors in the sidebar. Streams keep running either way, so this changes the view and nothing else.
Get Current Workspace - the Workspace on screen, to branch on.
Start Streams in Workspace / Stop Streams in Workspace - every Stream the Workspace's Sources own, up or down together. Whichever Workspace is on screen, so an end-of-day shortcut can put staging down.

Whole lists (for looping)

Get All Streams / Get All Monitors - the full list, so a Shortcut can repeat with each and act on every one.

Reading details

Use Shortcuts' Get Details of action on a Stream, Monitor, Server, Layout, group, or Monitor match to read its fields directly - no separate action needed:

Stream - Name, Favorite, File, Source, Status, Starts Automatically.
Monitor - Name, Favorite, Patterns, Match Count, Is Alarming, Last Match, Color (Green, Amber, or Red - the live activity color for threshold-tinted Monitors, the chosen color otherwise), and Matches in Last Hour. "If Color is Red" is the building block for a go-red alert. A Monitor keeps as many recent matches as Monitor matches in Settings ▸ Streams allows (1,000 unless you change it), so Match Count and Matches in Last Hour never go above that number - compare against a lower number in a Shortcut.
Server - Name, Type, Location, Port (0 when no port is set, meaning the standard port 22).
Layout - Name, Favorite, Kind (including Dashboard), Streams, Monitors.
Source Group - Name, Sources. Stream Group - Name, Streams. Layout Group - Name, Layouts. Monitor Group - Name, Monitors.
Workspace - Name, Active, Sources, Layouts, Monitors.
Monitor Match - Line, Time, Pattern, Severity, Host, Process (from Get Monitor Matches).

Source (on a Stream) and Location (on a Server) are aware of the Source type: an SSH host (as user@host, with :port appended when a port is set), This Mac for a local Source, the region for Amazon CloudWatch, or the project for GCP / Firebase.

Spotlight

Your Streams, Monitors, Servers, Layouts, groups, and Workspaces are indexed into Spotlight: type a name and it appears as a result; press Return and LogRaker opens with it selected. (Spotlight indexes the names, not the log contents.)

Suggestions

The more you open a particular Stream, Monitor, Server, Layout, or group, the more macOS learns the habit and starts suggesting it - in Spotlight, in the Shortcuts app, and in Siri Suggestions. Nothing to set up; it builds up as you work.

Good to know

LogRaker must be running for the live actions; running one launches LogRaker if it isn't already open. The counts, output, and status reflect the running session.
Match counts are the live session. They accumulate while LogRaker runs and a Monitor's Streams are tailing, and reset when LogRaker relaunches - so right after a cold launch a count reads 0 until matches come in.
Pause has no Shortcut. Pausing only freezes a pane's on-screen output, not the tail, so there's nothing meaningful to automate.