mthenw/frontail


📝 streaming logs to the browser

License: MIT

Language: JavaScript

Keywords: devops, log-stream, log-viewer, stream-logs, syslog, tail


frontail – streaming logs to the browser

frontail is a Node.js application for streaming logs to the browser. It's a tail -F with UI.

frontial

Docker Pulls

Quick start

Features

  • log rotation (not on windows!)
  • auto-scrolling
  • marking logs
  • pausing logs
  • number of unread logs in favicon
  • themes (default, dark)
  • highlighting
  • search (Tab to focus, Esc to clear)
  • set filter from url parameter filter
  • tailing multiple files and stdin
  • basic authentication

Installation options

  • download a binary file from Releases page (currently frontail doesn't work on Windows)
  • using npm package: npm i frontail -g
  • using Docker image: docker run -d -P -v /var/log:/log mthenw/frontail /log/syslog

Usage

frontail [options] [file ...]

Options:

  -V, --version                 output the version number
  -h, --host <host>             listening host, default 0.0.0.0
  -p, --port <port>             listening port, default 9001
  -n, --number <number>         starting lines number, default 10
  -l, --lines <lines>           number on lines stored in browser, default 2000
  -t, --theme <theme>           name of the theme (default, dark)
  -d, --daemonize               run as daemon
  -U, --user <username>         Basic Authentication username, option works only along with -P option
  -P, --password <password>     Basic Authentication password, option works only along with -U option
  -k, --key <key.pem>           Private Key for HTTPS, option works only along with -c option
  -c, --certificate <cert.pem>  Certificate for HTTPS, option works only along with -k option
  --pid-path <path>             if run as daemon file that will store the process id, default /var/run/frontail.pid
  --log-path <path>             if run as daemon file that will be used as a log, default /dev/null
  --url-path <path>             URL path for the browser application, default /
  --ui-hide-topbar              hide topbar (log file name and search box)
  --ui-no-indent                don't indent log lines
  --ui-highlight                highlight words or lines if defined string found in logs, default preset
  --ui-highlight-preset <path>  custom preset for highlighting (see ./preset/default.json)
  --path <path>                 prefix path for the running application, default /
  --disable-usage-stats         disable gathering usage statistics
  --help                        output usage information

Web interface runs on http://[host]:[port].

Tailing multiple files

[file ...] accepts multiple paths, *, ? and other shell special characters(Wildcards, Quotes, Back Quotes and Apostrophes in shell commands).

stdin

Use - for streaming stdin:

./server | frontail -

Highlighting

--ui-highlight option turns on highlighting in UI. By default preset from ./preset/default.json is used:

{
    "words": {
        "err": "color: red;"
    },
    "lines": {
        "err": "font-weight: bold;"
    }
}

which means that every "err" string will be in red and every line containing "err" will be bolded.

New presets are very welcome. If you don't like default or you would like to share yours, please create PR with json file.

Available presets:

  • default
  • npmlog
  • python

Running behind nginx

Using the --url-path option frontail can run behind nginx with the example configuration

Using frontail with --url-path /frontail

events {
    worker_connections 1024;
}

http {
    server {
        listen      8080;
        server_name localhost;

        location /frontail {
            proxy_pass http://127.0.0.1:9001/frontail;

            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";
        }
    }
}

Usage statistics

frontail by default (from v4.5.0) gathers anonymous usage statistics in Google Analytics. It can be disabled with --disable-usage-stats.

The data is used to help me understand how frontail is used and I can make it better.

Project Statistics

Sourcerank 10
Repository Size 837 KB
Stars 1,206
Forks 189
Watchers 44
Open issues 29
Dependencies 596
Contributors 24
Tags 62
Created
Last updated
Last pushed

Top Contributors See all

Maciej Winnicki Lexx dependabot[bot] Manuel de la Peña Alexander Wunschik RoCat Pavlo Bashynskyi Alexey Gusev Matteo Contrini Todsaporn Banjerdkit Yago donnie' Krzysztof Starzyk Ryan Hunt Andre Sollie Andrew Wright sajith-shahabudeen Krishna novahawk13 Patrik Johnson

Packages Referencing this Repo

frontail
streaming logs to the browser
Latest release 4.9.1 - Updated - 1.21K stars

Recent Tags See all

v4.9.1 March 26, 2020
v4.9.0 February 03, 2020
v4.8.0 August 29, 2019
v4.7.0 August 26, 2019
v4.6.0 July 03, 2019
v4.5.4 February 21, 2019
v4.5.3 January 09, 2019
v4.5.2 January 09, 2019
v4.5.1 November 28, 2018
v4.5.0 November 22, 2018
v4.4.0 October 30, 2018
v4.3.3 October 24, 2018
v4.3.2 October 11, 2018
v4.2.2 July 25, 2018
v4.2.1 July 25, 2018

Interesting Forks See all

yagop/frontail
streaming logs to the browser
JavaScript - Last pushed - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2020-03-13 21:24:35 UTC

Login to resync this repository