Merge branch 'gh-pages' of github.com:tstack/lnav
@ -0,0 +1,271 @@
|
||||
<html>
|
||||
<head>
|
||||
<title>lnav -- The Logfile Navigator</title>
|
||||
<style>
|
||||
ul.navbar {
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
ul.navbar li {
|
||||
list-style-type: none;
|
||||
display: inline;
|
||||
}
|
||||
|
||||
p.banner {
|
||||
padding: 8px;
|
||||
margin: 0px;
|
||||
font-family: sans-serif;
|
||||
font-weight: normal;
|
||||
font-size: x-large;
|
||||
color: #ffffff;
|
||||
background-color: #24913c;
|
||||
text-align: center;
|
||||
border-color: #38e05d;
|
||||
border-style: solid;
|
||||
border-width: 0px 0px 4px 0px;
|
||||
}
|
||||
|
||||
div.footer {
|
||||
border-style: solid;
|
||||
border-width: 8px 0px 0px 0px;
|
||||
border-color: #65e080;
|
||||
color: #ffffff;
|
||||
background-color: #00c12b;
|
||||
margin-bottom: 0px;
|
||||
padding: 8px;
|
||||
font-family: sans-serif;
|
||||
font-size: small;
|
||||
text-align: right;
|
||||
}
|
||||
|
||||
div.footer span.hosting {
|
||||
float: left;
|
||||
}
|
||||
|
||||
div.footer a {
|
||||
color: #ffffff;
|
||||
text-decoration: none;
|
||||
border-style: dotted;
|
||||
border-width: 0px 0px 1px 0px;
|
||||
}
|
||||
div.footer a:link {
|
||||
color: #ffffff;
|
||||
font-size: small;
|
||||
text-decoration: none;
|
||||
border-style: dotted;
|
||||
border-width: 0px 0px 1px 0px;
|
||||
}
|
||||
div.footer a:visited {
|
||||
color: #ffffff;
|
||||
font-size: small;
|
||||
text-decoration: none;
|
||||
border-style: dotted;
|
||||
border-width: 0px 0px 1px 0px;
|
||||
}
|
||||
div.footer a:hover {
|
||||
color: #ffffff;
|
||||
font-size: small;
|
||||
text-decoration: none;
|
||||
border-style: solid;
|
||||
border-width: 0px 0px 1px 0px;
|
||||
}
|
||||
|
||||
td.caption {
|
||||
font-size: small;
|
||||
text-align: left;
|
||||
width: 50%;
|
||||
}
|
||||
|
||||
body {
|
||||
margin-top: 0px;
|
||||
margin-left: 20%;
|
||||
margin-right: 20%;
|
||||
margin-bottom: 0px;
|
||||
}
|
||||
|
||||
h2 {
|
||||
font-family: sans-serif;
|
||||
color: #ffffff;
|
||||
font-weight: normal;
|
||||
border-style: solid;
|
||||
border-width: 0px 0px 0px 8px;
|
||||
border-color: #38e05d;
|
||||
padding: 4px;
|
||||
background-color: #24913c;
|
||||
}
|
||||
|
||||
div.ishot {
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
p {
|
||||
margin-bottom: 2em;
|
||||
}
|
||||
|
||||
table.sstable {
|
||||
width: 100%;
|
||||
}
|
||||
|
||||
table.sstable td {
|
||||
}
|
||||
|
||||
table.sstable td.thumb {
|
||||
text-align: center;
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<p class="banner">LNAV — The Logfile Navigator</p>
|
||||
|
||||
<ul class="navbar">
|
||||
<li><a href="#introduction">[Introduction]</a>
|
||||
<li><a href="#screenshots">[Screenshots]</a>
|
||||
<li><a href="#download">[Download]</a>
|
||||
<li><a href="#features">[Features]</a>
|
||||
<li><a href="#interface">[Interface Tour]</a>
|
||||
<li><a href="#links">[Links]</a>
|
||||
</ul>
|
||||
|
||||
<h2><a name="introduction">Introduction</a></h2>
|
||||
|
||||
The Logfile Navigator, <b>lnav</b> for short, is a <a href="http://en.wikipedia.org/wiki/Curses_(programming_library)">curses</a>-based
|
||||
tool for viewing and analyzing log files. The value added by <b>lnav</b> over text
|
||||
viewers / editors is that it takes advantage of any semantic information that
|
||||
can be gleaned from the log file, such as timestamps and log levels. Using this
|
||||
extra semantic information, <b>lnav</b> can do things like: interleaving messages from
|
||||
different files; generate histograms of messages over time; and providing
|
||||
hotkeys for navigating through the file. It is hoped that these features will
|
||||
allow the user to quickly and efficiently zero-in on problems.
|
||||
|
||||
<h2><a name="screenshots">Screenshots</a></h2>
|
||||
|
||||
<center>
|
||||
<table class="sstable">
|
||||
<tr>
|
||||
<td class="thumb"><a href="lnav-syslog.png"><img src="lnav-syslog-thumb.png"></a></td>
|
||||
<td class="thumb"><a href="lnav-hist.png"><img src="lnav-hist-thumb.png"></a></td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td class="caption">The standard view of a syslog file. Log lines are
|
||||
displayed with highlights. Errors are red and warnings are yellow.</td>
|
||||
<td class="caption">The histogram view of the same syslog file. The histogram
|
||||
shows the number of messages per time slice.</td>
|
||||
</tr>
|
||||
|
||||
</table>
|
||||
</center>
|
||||
|
||||
<h2><a name="download">Download</a></h2>
|
||||
|
||||
Source:
|
||||
<ul>
|
||||
<li><a href="http://github.org/tstack/lnav">Git Repository</a></li>
|
||||
<li><a href="http://cloud.github.com/downloads/tstack/lnav/lnav-0.3.0.tar.gz">lnav-0.3.0.tar.gz</a></li>
|
||||
</ul>
|
||||
|
||||
<h2><a name="features">Features</a></h2>
|
||||
|
||||
<p>
|
||||
The major features of <b>lnav</b> are:
|
||||
</p>
|
||||
|
||||
<ul>
|
||||
<li><b>Support for the following log file formats:</b>
|
||||
<blockquote>Syslog, Apache access log, strace, tcsh history, and
|
||||
generic log files with timestamps. The file format is automatically
|
||||
detected when the file is read in.</blockquote>
|
||||
<li><b>Histogram view:</b>
|
||||
<blockquote>Displays the number of log messages per bucket-of-time.
|
||||
Useful for getting an overview of what was happening over a long
|
||||
period of time.</blockquote>
|
||||
<li><b>Filters:</b>
|
||||
<blockquote>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.</blockquote>
|
||||
<li><b>"Live" operation:</b>
|
||||
<blockquote>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.</blockquote>
|
||||
<li><b>Automatic tailing:</b>
|
||||
<blockquote>The log file view automatically scrolls down to follow
|
||||
new lines that are added to files. Simply scroll up to lock the
|
||||
view in place and then scroll down to the bottom to resume
|
||||
tailing.</blockquote>
|
||||
<li><b>Time-of-day ordering of lines:</b>
|
||||
<blockquote>The log lines from all the files are loaded and then
|
||||
sorted by time-of-day. Relieves you of having to manually line up
|
||||
log messages from different files.</blockquote>
|
||||
<li><b>Syntax highlighting:</b>
|
||||
<blockquote>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.</blockquote>
|
||||
<li><b>Navigation:</b>
|
||||
<blockquote>There are hotkeys for jumping to the next or previous
|
||||
error or warning and moving forward or backward by an amount of
|
||||
time.</blockquote>
|
||||
<li><b>Use SQL to query logs:</b>
|
||||
<blockquote>Each log file line is treated as a row in a database
|
||||
that can be queried using SQL. The columns that are available
|
||||
depend on logs file types being viewed.</blockquote>
|
||||
<li><b>Command and search history:</b>
|
||||
<blockquote>Your previously entered commands and searches are saved
|
||||
so you can access them between sessions.</blockquote>
|
||||
</ul>
|
||||
|
||||
See the
|
||||
<a href="https://github.com/tstack/lnav/blob/master/src/help.txt">on-line
|
||||
help text</a> for more information.
|
||||
|
||||
<h2><a name="interface">Interface Tour</a></h2>
|
||||
|
||||
<div class="ishot"><img src="lnav-top.png"></div>
|
||||
<p>
|
||||
Top bar: Displays the current time, the number of warnings and errors above the
|
||||
top line and the name of the file where the top line came from.
|
||||
</p>
|
||||
|
||||
<div class="ishot"><img src="lnav-content.png"></div>
|
||||
<p>
|
||||
Main content: Displays the log lines in time sorted order and highlighted.
|
||||
Highlights are done for: errors, warnings, search terms, quoted strings, and
|
||||
some SQL syntax. On the far right, there is a proportional scroll bar displayed
|
||||
in reverse-video that shows the current position in the file.
|
||||
</p>
|
||||
|
||||
<div class="ishot"><img src="lnav-bottom.png"></div>
|
||||
<p>
|
||||
Bottom bar: Displays the current line number, the position
|
||||
in the file as a percentage, warnings and errors below the bottom line.
|
||||
</p>
|
||||
|
||||
<div class="ishot"><img src="lnav-entry.png"></div>
|
||||
<p>Entry line: Searches and commands are entered here. The entry line supports
|
||||
tab-completion in most contexts and displays suggestions in the entry
|
||||
box. In this screenshot, the user is typing in a SQL query. The top
|
||||
shows an error message indicating that the SQL statement is
|
||||
incomplete. Queries and searches are automatically checked for
|
||||
correctness as you type. The screenshot also shows suggestions for
|
||||
SQL keywords and column names after the user hit the TAB key twice.
|
||||
|
||||
<h2><a name="links">Related Links</a></h2>
|
||||
|
||||
<ul>
|
||||
<li><a href="http://www.microsoft.com/downloads/details.aspx?FamilyID=890cd06b-abf8-4c25-91b2-f8d975cf8c07&displaylang=en">Microsoft's Log Parser</a>
|
||||
</ul>
|
||||
|
||||
<div class="footer">
|
||||
<span class="hosting">Hosting by <a href="http://github.com">github.com</a>.
|
||||
</span>
|
||||
|
||||
<span class="contact">
|
||||
e-mail: <a href="mailto:timothyshanestack@gmail.com">timothyshanestack at
|
||||
gmail.com</a></span>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
After Width: | Height: | Size: 13 KiB |
After Width: | Height: | Size: 43 KiB |
After Width: | Height: | Size: 6.2 KiB |
After Width: | Height: | Size: 3.2 KiB |
After Width: | Height: | Size: 67 KiB |
After Width: | Height: | Size: 214 KiB |
After Width: | Height: | Size: 53 KiB |
After Width: | Height: | Size: 11 KiB |
After Width: | Height: | Size: 16 KiB |