Documentation

Installation

Installation requires you to download the installer and then run it on your device.

1. Login into your account using the License Key from order confirmation email and download the installer that matches your OS from the downloads page:

   

2. Double click the downloaded file and follow installer instructions.
3. When the installation is completed you can finally run the App.

First run

Find "Watch my logs!" using your OS App launcher and press Enter. If your OS will ask if you really want to run the app, select "Yes".

Find the "Watch my logs!" in the Applications folder, right click on the app and choose "Open" in the context menu.

After initial launch, you'll see the Main Screen with "Open Preferences" button:

General

General settings screen allows you to:

• Enable application autostart when you logging in into OS.
• Display app icon in tray. When enabled, and app is minimized, it will not
• Choose one of appearance options: System, Light, Dark.
• Select text editor to open when clicking on the file paths. The list of available editors: Atom, SublimeText, TextMate, PhpStorm, VS Code, VS Code Insiders.

Logs

Logs settings screen allows you to:

• Add/Remove/Enable/Disable log sources. Log source is a folder with *.log files or a *.log files.
• Truncate log sources.
• Setup configuration per log source. For now, there is one config option available that allows to replace part of the path. This options was added specifically for Docker users to fix not working clickable file paths.

Remote logs

Remote logs settings screen allows you to:

• Add/Remove ssh connections.
• Connect/Disconnect from the servers. The state of each connection persist between app sessions.
• Add/Remove/Enable/Disable paths to log sources. Log source is a folder with *.log files or a *.log files.

Actions

The easiest way to add an action - is to select a text in the main window and right click on it.

The following actions available:

• Hide from list
• Bring app to front
• Notify

The action is triggered when condition is true for the log entry. You can use:

• Simple string — A string
• Log filename — error.log
• Regex pattern — Task .* is finished
• Logical statement — {{ file != custom.log && level < error }}

Here is the list of available variables to use inside logical statement:

Advanced

Advanced settings screen allows you to:

• Edit library paths — the list of paths that are excluded from "jump to file" panel.
• Edit library paths exceptions — useful when you exclude "/vendor/" folder, but still want to include "/vendor/mycompany/" path.

General

When log sources are set and app found the records, the main screen will show them sorted by date. The feed is automatically updated when a new records are found in any of the log sources. The newest records added to the top of the list:

Search panel

Press CMD+F or CTRL+F to open search panel:

You may use the following format for the search input string:

• Simple string — Connection
• Logical statement — {{ file == name.log && level >= error && date >= 2024 }}

Here is the list of available variables to use inside logical statement:

Context menu

Use the right mouse to show context menu. It will also display a quick actions if you select some text in the feed:

Shortcuts

There are few shortcuts available when main screen is active:

• CMD+, or CTRL+, — open settings window.
• CMD+R or CTRL+R — rescan all log files.
• CMD+F or CTRL+F — open search panel.
• CMD+SHIFT+E or CTRL+SHIFT+E — truncate all log files.