tla

Totoro log analyse.

Latest stable version：v2.0.0

1. Installation

Install from npm

$ npm install totoro-log-analyse -g

If it not works, you may need add sudo before the command, as follows.

Install from github

To get the latest function (may not be stable)

$ git clone [email protected]:totorojs/totoro-log-analyse.git
$ cd totoro-log-analyse
$ npm install -g

2. Set Mongodb

1. tla use mongodb to store log message, thus, install it first.

2. Start mongod.

   $ mongod

3. Connect to mongod and create a database named totoro.

   $ mongo
   > use totoro

4. Add a user which has readWrite privileges to it.

   > db.addUser({
       user: '{{userName}}',
       pwd: '{{password}}',
       roles: [ 'readWrite' ]
     })
   
   // If db.addUser() dose't work, you may use db.createUser()

5. Restart mongod with auth option .

   $ mongod --auth

3. Cli Options

-D, --dir

Specifies log directory.

Default: 'totoro-server-logs/'

-S, --start [s]

Start date of log file to process.

Let's assume today is 2014-02-14, and there are some log files as bellow:

totoro-server-logs/
  20140201.log
  20140202.log
  ...
  20140213.log
  20140214.log

If specifies --start=20140201, tla will process log files created since 2014-02-01.

If not specifies this option, will only process log files created today and later.

NOTE: tla will handle repeated log message and watch increased log message automatically.

Default: today

-s, --db

Db server.

Default: 'localhost:27017/totoro'

-u, --user

Db user name that is given readWrite privileges.

-w, --pwd

Db password.

-H, --host

HTTP server host.

tla supplies some HTTP api to query log info. After run tla, open {{host}}:{{port}} in browser, you will see all APIs.

Default: IP of your computer.

-P, --port

HTTP server port.

Default: 9997

-d, --debug

Show debug log.

-v, --version

Output the version number.

-h, --help

Output usage information.