mirror of https://github.com/tstack/lnav.git
289 lines
7.5 KiB
ReStructuredText
289 lines
7.5 KiB
ReStructuredText
.. _hotkeys:
|
|
|
|
Hotkey Reference
|
|
================
|
|
|
|
This reference covers the keys used to control **lnav**. Consult the `built-in
|
|
help <https://github.com/tstack/lnav/blob/master/src/help.txt>`_ in **lnav** for
|
|
a more detailed explanation of each key.
|
|
|
|
Spatial Navigation
|
|
------------------
|
|
|
|
The majority of these hotkeys should be available in all views.
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
:widths: 6 6 6 20
|
|
|
|
* - Keypress
|
|
-
|
|
-
|
|
- Command
|
|
* - :kbd:`Space`
|
|
- :kbd:`PgDn`
|
|
-
|
|
- Down a page
|
|
* - :kbd:`b`
|
|
- :kbd:`Backspace`
|
|
- :kbd:`PgUp`
|
|
- Up a page
|
|
* - :kbd:`j`
|
|
- :kbd:`↓`
|
|
-
|
|
- Down a line
|
|
* - :kbd:`k`
|
|
- :kbd:`↑`
|
|
-
|
|
- Up a line
|
|
* - :kbd:`h`
|
|
- :kbd:`←`
|
|
-
|
|
- Left half a page. In the log view, pressing left while at the start of
|
|
the message text will reveal the source file name for each line.
|
|
Pressing again will reveal the full path.
|
|
* - :kbd:`Shift` + :kbd:`h`
|
|
- :kbd:`Shift` + :kbd:`←`
|
|
-
|
|
- Left ten columns
|
|
* - :kbd:`l`
|
|
- :kbd:`→`
|
|
-
|
|
- Right half a page
|
|
* - :kbd:`Shift` + :kbd:`l`
|
|
- :kbd:`Shift` + :kbd:`→`
|
|
-
|
|
- Right ten columns
|
|
* - :kbd:`Home`
|
|
- :kbd:`g`
|
|
-
|
|
- Top of the view
|
|
* - :kbd:`End`
|
|
- :kbd:`G`
|
|
-
|
|
- Bottom of the view
|
|
* - :kbd:`e`
|
|
- :kbd:`Shift` + :kbd:`e`
|
|
-
|
|
- Next/previous error
|
|
* - :kbd:`w`
|
|
- :kbd:`Shift` + :kbd:`w`
|
|
-
|
|
- Next/previous warning
|
|
* - :kbd:`n`
|
|
- :kbd:`Shift` + :kbd:`n`
|
|
-
|
|
- Next/previous search hit
|
|
* - :kbd:`>`
|
|
- :kbd:`<`
|
|
-
|
|
- Next/previous search hit (horizontal)
|
|
* - :kbd:`f`
|
|
- :kbd:`Shift` + :kbd:`f`
|
|
-
|
|
- Next/previous file
|
|
* - :kbd:`u`
|
|
- :kbd:`Shift` + :kbd:`u`
|
|
-
|
|
- Next/previous bookmark
|
|
* - :kbd:`o`
|
|
- :kbd:`Shift` + :kbd:`o`
|
|
-
|
|
- Forward/backward through log messages with a matching "opid" field
|
|
* - :kbd:`s`
|
|
- :kbd:`Shift` + :kbd:`s`
|
|
-
|
|
- Next/previous slow down in the log message rate
|
|
* - :kbd:`{`
|
|
- :kbd:`}`
|
|
-
|
|
- Previous/next location in history
|
|
|
|
Chronological Navigation
|
|
------------------------
|
|
|
|
These hotkeys are only functional on views that are time-based, like the log
|
|
view or the histogram view.
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
:widths: 5 5 20
|
|
|
|
* - Keypress
|
|
-
|
|
- Command
|
|
* - :kbd:`d`
|
|
- :kbd:`Shift` + :kbd:`d`
|
|
- Forward/backward 24 hours
|
|
* - :kbd:`1` - :kbd:`6`
|
|
- :kbd:`Shift` + :kbd:`1` - :kbd:`6`
|
|
- Next/previous n'th ten minute of the hour
|
|
* - :kbd:`7`
|
|
- :kbd:`8`
|
|
- Previous/next minute
|
|
* - :kbd:`0`
|
|
- :kbd:`Shift` + :kbd:`0`
|
|
- Next/previous day
|
|
* - :kbd:`r`
|
|
- :kbd:`Shift` + :kbd:`r`
|
|
- Forward/backward by the relative time that was last used with the goto command.
|
|
|
|
Breadcrumb Navigation
|
|
---------------------
|
|
|
|
The following hotkeys are related to the breadcrumb bar that is below the top
|
|
status bar.
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
:widths: 5 20
|
|
|
|
* - Keypress
|
|
- Description
|
|
* - :kbd:`ENTER`
|
|
- Focus on the breadcrumb bar. Or, if the bar is currently focused,
|
|
accept the selected value and drop focus.
|
|
* - :kbd:`Escape`
|
|
- Drop focus on the breadcrumb bar.
|
|
* - :kbd:`←`
|
|
- Select the crumb to the left. If the first crumb is selected, the
|
|
selection will wrap around to the last crumb.
|
|
* - :kbd:`→`
|
|
- Accept the current value, which might mean navigating to the value in
|
|
the view, then selecting the crumb to the right.
|
|
* - :kbd:`Ctrl` + :kbd:`a`
|
|
- Select the first crumb.
|
|
* - :kbd:`Ctrl` + :kbd:`e`
|
|
- Select the last crumb.
|
|
* - :kbd:`↓`
|
|
- Select the next value in the crumb dropdown.
|
|
* - :kbd:`↑`
|
|
- Select the previous value in the crumb dropdown.
|
|
* - :kbd:`Home`
|
|
- Select the first value in the crumb dropdown.
|
|
* - :kbd:`End`
|
|
- Select the last value in the crumb dropdown.
|
|
|
|
While a crumb is selected, you can perform a fuzzy search on the possible
|
|
values by typing in the value you are interested in.
|
|
|
|
.. _hotkeys_bookmarks:
|
|
|
|
Bookmarks
|
|
---------
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
:widths: 5 20
|
|
|
|
* - Keypress
|
|
- Command
|
|
* - :kbd:`m`
|
|
- Mark/unmark the top line
|
|
* - :kbd:`Shift` + :kbd:`m`
|
|
- Mark/unmark the range of lines from the last marked to the top
|
|
* - :kbd:`Shift` + :kbd:`j`
|
|
- Mark/unmark the next line after the previously marked
|
|
* - :kbd:`Shift` + :kbd:`k`
|
|
- Mark/unmark the previous line
|
|
* - :kbd:`c`
|
|
- Copy marked lines to the clipboard
|
|
* - :kbd:`Shift` + :kbd:`c`
|
|
- Clear marked lines
|
|
|
|
.. _hotkeys_display:
|
|
|
|
Display
|
|
-------
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
:widths: 5 20
|
|
|
|
* - Keypress
|
|
- Command
|
|
* - :kbd:`?`
|
|
- View/leave builtin help
|
|
* - :kbd:`q`
|
|
- Return to the previous view/quit
|
|
* - :kbd:`Shift` + :kbd:`q`
|
|
- Return to the previous view/quit while matching the top times of the two views
|
|
* - :kbd:`a`
|
|
- Restore the view that was previously popped with 'q/Q'
|
|
* - :kbd:`Shift` + :kbd:`a`
|
|
- Restore the view that was previously popped with 'q/Q' and match the top times of the views
|
|
* - :kbd:`Shift` + :kbd:`p`
|
|
- Switch to/from the pretty-printed view of the displayed log or text files
|
|
* - :kbd:`Shift` + :kbd:`t`
|
|
- Display elapsed time between lines
|
|
* - :kbd:`t`
|
|
- Switch to/from the text file view
|
|
* - :kbd:`i`
|
|
- Switch to/from the histogram view
|
|
* - :kbd:`Shift` + :kbd:`i`
|
|
- Switch to/from the histogram view
|
|
* - :kbd:`v`
|
|
- Switch to/from the SQL result view
|
|
* - :kbd:`Shift` + :kbd:`v`
|
|
- Switch to/from the SQL result view and move to the corresponding in the
|
|
log_line column
|
|
* - :kbd:`p`
|
|
- Toggle the display of the log parser results
|
|
* - :kbd:`Tab`
|
|
- In the log/text views, focus on the configuration panel for editing
|
|
filters and examining the list of loaded files. In the SQL result view,
|
|
cycle through columns to display as bar graphs
|
|
* - :kbd:`Ctrl` + :kbd:`l`
|
|
- Switch to lo-fi mode. The displayed log lines will be dumped to the
|
|
terminal without any decorations so they can be copied easily.
|
|
* - :kbd:`Ctrl` + :kbd:`w`
|
|
- Toggle word-wrap.
|
|
* - :kbd:`Ctrl` + :kbd:`p`
|
|
- Show/hide the data preview panel that may be opened when entering
|
|
commands or SQL queries.
|
|
* - :kbd:`Ctrl` + :kbd:`f`
|
|
- Toggle the enabled/disabled state of all filters in the current view.
|
|
* - :kbd:`x`
|
|
- Toggle the hiding of log message fields. The hidden fields will be
|
|
replaced with three bullets and highlighted in yellow.
|
|
* - :kbd:`=`
|
|
- Pause/unpause loading of new file data.
|
|
|
|
Session
|
|
-------
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
:widths: 5 20
|
|
|
|
* - Keypress
|
|
- Command
|
|
* - :kbd:`Ctrl` + :kbd:`R`
|
|
- Reset the current :ref:`session<sessions>` state.
|
|
|
|
Query Prompts
|
|
-------------
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
:widths: 5 20
|
|
|
|
* - Keypress
|
|
- Command
|
|
* - :kbd:`/`
|
|
- Search for lines matching a regular expression
|
|
* - :kbd:`;`
|
|
- Open the :ref:`sql-ext` to execute SQL statements/queries
|
|
* - :kbd:`:`
|
|
- Execute an internal command, see :ref:`commands` for more information
|
|
* - :kbd:`\|`
|
|
- Execute an lnav script located in a format directory
|
|
* - :kbd:`Ctrl` + :kbd:`]`
|
|
- Abort the prompt
|
|
|
|
Customizing
|
|
-----------
|
|
|
|
You can customize the behavior of hotkeys by defining your own keymaps.
|
|
Consult the :ref:`Keymaps<keymaps>` configuration section for more information.
|