← Documentation

Getting Started

LogRaker's main window is a two-pane layout: a sidebar of configured sources on the left, the live tail output on the right. To get something flowing, you need one source and one stream.

Adding your first source

A Source is "where the logs live." Three kinds are supported, each with its own entry in the + menu at the bottom of the sidebar:

Pick the kind that matches where your logs are. Each opens a sheet tailored to its inputs. Filling in name + the kind- specific fields (file path for local, host/user/key for SSH, project ID + auth for GCP) is enough - save and the source appears in the sidebar.

What LogRaker can tail

Across those sources, LogRaker reads:

Adding your first stream

A Stream is one specific file - or a systemd journal, or one GCP Logging filter - on a source. One source can have many streams. From the sidebar + menu, choose New Stream…, pick the source, type the absolute path to the file you want to tail (or pick it with the Browse button on local sources). Save.

The new stream appears nested under its source in the sidebar. Click it to start tailing - the right pane shows the live output.

Status indicators

Each stream row in the sidebar has a colored status LED:

A small waveform glyph next to the LED sweeps like a heartbeat monitor while new output arrives - the trace draws in from the left and dies away behind the beam - and runs out during quiet periods, so you can see at a glance which streams are actually active.

In the Web Edition, LogRaker's Dock icon carries the same signal: a small LED in its corner shows the overall status of all your streams - the worst state wins, so a single failing stream turns it red. When nothing is streaming, the LED disappears.

Auto-start

By default, streams start tailing only when you select them in the sidebar. Turn on Auto-stream at startup in the stream editor if you want a stream to begin tailing the moment LogRaker launches - useful for streams you always want running in the background.

Arranging the sidebar

The sidebar has three sections - Sources, Layouts, and Monitors. Drag a section's header up or down to reorder them (put Monitors on top, say); a dashed outline shows the section you're moving and an insertion line shows where it'll land. To collapse a section, move the pointer over its header and click the chevron that appears at the right edge; click it again to expand. A collapsed section keeps its chevron showing, so you can always tell what's hidden. The order, and whether each section is collapsed, are remembered and sync across your Macs via iCloud. (Your individual groups and folders keep their own open/closed state on each Mac.)

Right-click a section - its header, a row in it, or the empty space below - for that section's New… actions, the same ones the toolbar's + menu offers. Groups drag up and down to reorder them within their section.

Moving around

Back (⌘[) and Forward (⌘]) retrace your trail through the sidebar, like a browser - also on the toolbar chevrons and in the View menu. Every jump counts, including the ones a board card or a match makes for you; a new jump clears the Forward trail, and anything deleted along the way is skipped.

Coming back puts you where you were: a Monitor Board keeps its card selection, a Monitor's match list keeps the line you had picked, and a stream returns to the line you had selected.

Editions, briefly

If you got LogRaker from the Mac App Store, you're running the App Store Edition (sandboxed). If you downloaded it from lograker.app, you're running the Web Edition (not sandboxed). The Welcome window and About panel both show which one you have. The two differ only in file-access rules - see Local System Sources for what that means in practice.