mirror of https://github.com/tstack/lnav.git
[docs] more stuff for lnav.org transition
This commit is contained in:
parent
f571feaedc
commit
a9aac1f36b
|
@ -4,10 +4,14 @@ title: Downloads
|
|||
permalink: /downloads
|
||||
---
|
||||
|
||||
The latest version is [**v0.9.0**](https://github.com/tstack/lnav/releases/latest).
|
||||
The latest release is [**v{{ site.version }}**](https://github.com/tstack/lnav/releases/latest).
|
||||
|
||||
The following options are available for installing **lnav**:
|
||||
|
||||
## Linux
|
||||
|
||||
Download a [statically linked 64-bit binary](https://github.com/tstack/lnav/releases/download/v{{site.version}}/lnav-{{site.version}}-musl-64bit.zip).
|
||||
|
||||
Install from the [Snap Store](https://snapcraft.io/lnav):
|
||||
|
||||
```shell
|
||||
|
@ -24,10 +28,17 @@ Install using [Homebrew](https://formulae.brew.sh/formula/lnav):
|
|||
|
||||
## Source
|
||||
|
||||
Download the [source](https://github.com/tstack/lnav/releases/download/v{{site.version}}/lnav-{{site.version}}.tar.gz)
|
||||
and install any dependencies. The following commands will unpack the source
|
||||
tar ball, configure the build for your system, build, and then install:
|
||||
|
||||
```shell
|
||||
% tar xvfz
|
||||
% cd lnav-
|
||||
% tar xvfz lnav-{{site.version}}.tar.gz
|
||||
% cd lnav-{{site.version}}
|
||||
% ./configure
|
||||
% make
|
||||
% make install
|
||||
```
|
||||
|
||||
If you would like to contribute to the development of lnav, visit our page on
|
||||
[GitHub](https://github.com/tstack/lnav).
|
||||
|
|
|
@ -2,3 +2,138 @@
|
|||
layout: page
|
||||
title: Features
|
||||
---
|
||||
|
||||
* TOC
|
||||
{:toc}
|
||||
|
||||
## Single Log View
|
||||
|
||||
All log file contents are merged into a single view based on message timestamps.
|
||||
You no longer need to manually correlate timestamps across multiple windows or
|
||||
figure out the order in which to view rotated log files. The color bars on the
|
||||
left-hand side help to show which file a message belongs to.
|
||||
|
||||
![Screenshot of lnav showing messages from multiple files](/assets/images/lnav-multi-file2.png)
|
||||
|
||||
## Automatic Log Format Detection
|
||||
|
||||
The log message format is automatically determined by lnav while scanning your
|
||||
files. The following formats are built in by default:
|
||||
|
||||
* Common Web Access Log format
|
||||
* CUPS page_log
|
||||
* Syslog
|
||||
* Glog
|
||||
* VMware ESXi/vCenter Logs
|
||||
* dpkg.log
|
||||
* uwsgi
|
||||
* "Generic" - Any message that starts with a timestamp
|
||||
* Strace
|
||||
* sudo
|
||||
|
||||
GZIP'ed and BZIP2'ed files are also detected automatically and decompressed on-the-fly.
|
||||
|
||||
## Filters
|
||||
|
||||
Display only lines that match or do not match a set of regular expressions.
|
||||
Useful for removing extraneous log lines that you are not interested in.
|
||||
|
||||
## Timeline View
|
||||
|
||||
The timeline view shows a histogram of messages over time. The number of
|
||||
warnings and errors are highlighted in the display so that you can easily see
|
||||
where problems have occurred. Once you have found a period of time that is of
|
||||
interest, a key-press will take you back to the log message view at the
|
||||
corresponding time.
|
||||
|
||||
![Screenshot of timeline view](/assets/images/lnav-hist.png)
|
||||
|
||||
## Pretty-Print View
|
||||
|
||||
The pretty-print view will reformat structured data, like XML or JSON, so that
|
||||
it is easier to read. Simply press SHIFT+P in the log view to have all the
|
||||
currently displayed lines pretty-printed.
|
||||
|
||||
The following screenshot shows an XML blob with no indentation:
|
||||
|
||||
![A flat blob of XML](/assets/images/lnav-before-pretty.png)
|
||||
|
||||
After pressing SHIFT+P, the XML is pretty-printed for easier viewing:
|
||||
|
||||
![A pretty-printed blob of XML](/assets/images/lnav-before-pretty.png)
|
||||
|
||||
## Query Logs Using SQL
|
||||
|
||||
Log files are directly used as the backing for SQLite virtual tables. This
|
||||
means you can perform queries on messages without having to load the data into
|
||||
an SQL database. For example, the screenshot below shows the result of
|
||||
running the following query against an Apache access_log file:
|
||||
|
||||
```sql
|
||||
SELECT c_ip, count(*), sum(sc_bytes) AS total FROM access_log
|
||||
GROUP BY c_ip ORDER BY total DESC;
|
||||
```
|
||||
|
||||
![The results of a SQL query](/assets/images/lnav-query.png)
|
||||
|
||||
## "Live" Operation
|
||||
|
||||
Searches are done as you type; new log lines are automatically loaded and
|
||||
searched as they are added; filters apply to lines as they are loaded; and, SQL
|
||||
queries are checked for correctness as you type.
|
||||
|
||||
## Themes
|
||||
|
||||
The UI can be [customized through themes](https://lnav.readthedocs.io/en/latest/config.html#theme-definitions).
|
||||
|
||||
![Animation of the UI cycling through themes](/assets/images/lnav-theme-cycle.gif)
|
||||
|
||||
## Syntax Highlighting
|
||||
|
||||
Errors and warnings are colored in red and yellow, respectively. Highlights are
|
||||
also applied to: SQL keywords, XML tags, file and line numbers in Java
|
||||
backtraces, and quoted strings. The search and SQL query prompt are also
|
||||
highlighted as you type, making it easier to see errors and matching brackets.
|
||||
|
||||
![Animation of syntax highlighting](/assets/images/lnav-syntax-highlight.gif)
|
||||
|
||||
## Tab-completion
|
||||
|
||||
The command prompt supports tab-completion for almost all operations. For
|
||||
example, when doing a search, you can tab-complete words that are displayed on
|
||||
screen rather than having to do a copy & paste.
|
||||
|
||||
![Animation of TAB-completion](/assets/images/lnav-tab-complete.gif)
|
||||
|
||||
## Custom Keymaps
|
||||
|
||||
[Hotkeys can be customized](https://lnav.readthedocs.io/en/latest/config.html#keymap-definitions)
|
||||
to run lnav commands or scripts.
|
||||
|
||||
## Sessions
|
||||
|
||||
Session information is saved automatically and restored when you are viewing the
|
||||
same set of files. The current location in files, bookmarks, and applied filters
|
||||
are all saved as part of the session.
|
||||
|
||||
## Headless Mode
|
||||
|
||||
The log processing features of lnav can be used in scripts if you have a canned
|
||||
set of operations or queries that you want to perform regularly. You can enable
|
||||
headless mode with the '-n' switch on the command-line and then use the '-c'
|
||||
flag to specify the commands or queries you want to execute. For example, to get
|
||||
the top 10 client IP addresses from an apache access log file and write the
|
||||
results to standard out in CSV format:
|
||||
|
||||
```shell
|
||||
% lnav -n \
|
||||
-c ';SELECT c_ip, count(*) AS total FROM access_log GROUP BY c_ip ORDER BY total DESC LIMIT 10' \
|
||||
-c ':write-csv-to -' \
|
||||
access.log
|
||||
|
||||
c_ip,total
|
||||
10.208.110.176,2989570
|
||||
10.178.4.102,11183
|
||||
10.32.110.197,2020
|
||||
10.29.165.250,443
|
||||
```
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
title: Blog
|
||||
title: ChangeBlog
|
||||
layout: home
|
||||
---
|
||||
|
|
@ -19,6 +19,7 @@
|
|||
# in the templates via {{ site.myvariable }}.
|
||||
|
||||
title: The Logfile Navigator
|
||||
version: 0.9.0
|
||||
email: support@lnav.org
|
||||
description: >- # this means to ignore newlines until "baseurl:"
|
||||
The Logfile Navigator, lnav for short, is an advanced log file viewer
|
||||
|
|
|
@ -8,6 +8,20 @@
|
|||
margin: 0 50px;
|
||||
}
|
||||
|
||||
#top-description {
|
||||
font-size: x-large;
|
||||
margin-top: 3em;
|
||||
margin-left: 1em;
|
||||
}
|
||||
|
||||
#intro {
|
||||
font-size: x-large;
|
||||
font-weight: lighter;
|
||||
margin-top: 2em;
|
||||
margin-bottom: 4em;
|
||||
margin-left: 2em;
|
||||
}
|
||||
|
||||
dl {
|
||||
display: grid;
|
||||
grid-template-rows: auto auto;
|
||||
|
@ -18,7 +32,7 @@
|
|||
font-weight: normal;
|
||||
font-size: x-large;
|
||||
text-align: center;
|
||||
border-bottom: 1px solid #ddd;
|
||||
border-bottom: 1px solid #8d8;
|
||||
margin: 20px 30px;
|
||||
}
|
||||
dl dd {
|
||||
|
@ -31,6 +45,10 @@
|
|||
|
||||
<body>
|
||||
|
||||
<a href="https://github.com/tstack/lnav">
|
||||
<img loading="lazy" width="149" style="position: absolute; z-index: 100" height="149" src="https://github.blog/wp-content/uploads/2008/12/forkme_left_green_007200.png?resize=149%2C149" class="attachment-full size-full" alt="Fork me on GitHub" data-recalc-dims="1">
|
||||
</a>
|
||||
|
||||
{%- include header.html -%}
|
||||
|
||||
<main class="page-content" aria-label="Content">
|
||||
|
|
Binary file not shown.
After Width: | Height: | Size: 78 KiB |
Binary file not shown.
After Width: | Height: | Size: 306 KiB |
Binary file not shown.
After Width: | Height: | Size: 85 KiB |
Binary file not shown.
After Width: | Height: | Size: 26 KiB |
Binary file not shown.
After Width: | Height: | Size: 402 KiB |
Binary file not shown.
After Width: | Height: | Size: 586 KiB |
|
@ -7,11 +7,15 @@ layout: top
|
|||
|
||||
![Screenshot of lnav](/assets/images/lnav-front-page.png){: style="float: right"}
|
||||
|
||||
## An advanced log file viewer for the small-scale
|
||||
<div id="top-description">
|
||||
An advanced log file viewer for the small-scale
|
||||
</div>
|
||||
|
||||
Watch and analyze your log files from a terminal.
|
||||
<div id="intro">
|
||||
<p>Watch and analyze your log files from a terminal.</p>
|
||||
|
||||
No server. No setup. Still featureful.
|
||||
<p>No server. No setup. Still featureful.</p>
|
||||
</div>
|
||||
|
||||
<dl>
|
||||
<dt>In Your Terminal</dt>
|
||||
|
|
Loading…
Reference in New Issue