Logs Overview

Log Viewer

The SenseDeep log viewer is a log browser with automatic log stream aggregation, live-tail, real-time updating and powerful search and query capabilities. It fetches log data transparently in the background so you never need to click reload again.

Viewer Features

Log Viewer

The SenseDeep log viewer supports:

Date Scrubber

The timeline scrubber permits you to jump to the start or end of the log file or any arbitrary date in between. Changing the scrubber modifies the highlighted current line in the log file. Clicking on the scrubber date box will display a date and time edit dialog.

Viewer Scrubber

Viewer Navigation Bar

The SenseDeep Viewer has a new navigation bar with the most common commands at your finger tips. These are also mapped to keyboard shortcuts.

Viewer Navigation

Expand Records

The Expand / Collapse icon will expand all log entries and display all fields vertically. Clicking the icon will collapse any expanded fields. You can also type the ENTER key or Command-Click / Control-Click on a row to expand or collapse individual records.

If a log entry contains JSON, it will be expanded and color coded. Properties will be displayed in sorted order. SenseDeep uses an abbreviated JSON presentation where quotes are removed from strings and end-of-line commas are also removed for clarity. If you export the current record to the clipboard (Cmd-E), the full JSON record with quotes and commas will be exported.

Expanded Items

Cut Down Log Events

Sometimes you may wish to only focus on new log data and not be distracted by any historical or prior log data. For example, you may be developing a Serverless Lambda application and you want to trigger a specific log condition and be able to easily locate that new log data. The SenseDeep Cut Log Data can help.

The cut log icon will discard all prior log data and display only new log data. This is useful when used in conjunction with the Live Tail option below. Clicking the cut icon a second time will restore the cut log entries.

Live Tail

The Live Tail icon puts the viewer into "Live Tail" mode where new log data is automatically fetched and appended to the end of the log view. If you have scrolled to the end of the view, the Viewer will automatically scroll as new log data is fetched.

Select Fields

The select fields icon will display the select fields dialog panel. SenseDeep will automatically select a default set of top level fields when the view is first created. Thereafter, you can add or remove fields. If you select the "Freeze" checkbox, the view fields will be fixed (frozen) and not be modified as new fields are discovered in the data stream.

By default, the Viewer orders fields in sorted order. If you add a field via the select fields dialog, it will be added to the end of the table. You can drag and drop Viewer field columns to reorder the fields.

Select Fields

The new Search dialog permits you to search within selected log records for specific text. You can search forwards, backwards or jump to the current line.

Not to be confused with the view filter text, which selects which log records to display, the search dialog selects the current record to jump to.

The search dialog can also be invoked via the Cmd-F keyboard shortcut. Use the Cmd-G keyboard shortcut to repeat a search.


Context and Navigation

Log files can be confusing places. Gigabytes of log data that is often confusingly similar. Find an application error and then maintaining context as you look around at related log data can be difficult. SenseDeep helps this situation by maintaining a "current" line context and by highlighting that line in blue to make it easily visible.

Current Line

You can navigate from the current line by using Arrow keys up and down, or by clicking on any line to make that the current line. Use right or left arrow to jump to the next or previous page. Use Cmd-J to jump back to the current line. The Search dialog (Cmd-F) can be used to search for a specific text pattern and jump the current line to the first such occurrence of the pattern.

SenseDeep preserves your context as you expand log entries, select new fields or resize or reorder columns.

Modifying and Saving Views

You can make changes to the log view presentation via the icons or via the "Modify View" icon. When clicked, the "Modify View" icon will display a slide-out panel with detailed options to filter the log events displayed.

View Modify

To filter log events, enter a text pattern, regular expression or text field expression to select the desired log events to display. You can specify text patterns that must match and also patterns to exclude log events from display.

You can also define the time range from which to select events by using an absolute start / end time or by a relative time period.

The expand, live tail and hide service events options are also selectable from the modify view panel.

You can save the view to a new name by selecting "New View" from the name pulldown and then entering a new name. You can select the view to display by clicking on the log title in the top left of the viewer.

You can create a dashboard widget that will invoke the viewer and display the desired view.

When you modify any viewer presentation option, a "Save" button will appear. Clicking save will persist your changes as the new default presentation for that view. If you are a member of a shared organization, your changes will be shared with all team members.


To copy the current record to the clipboard for export to another application, use the Cmd-E key to export the record to the clipboard.

Short Cuts

In summary, here are the keyboard shortcuts supported by the SenseDeep viewer:

On Windows, use Control instead of Cmd.

Tables Overview

See Also

© SenseDeep® LLC. All rights reserved. Privacy Policy and Terms of Use.


This web site uses cookies to provide you with a better viewing experience. Without cookies, you will not be able to view videos, contact chat or use other site features. By continuing, you are giving your consent to cookies being used.