https://github.com/real-serious-games/logviewer
A web application for viewing log files stored in a MongoDB database. Logs are assumed to be in Serilog format.
https://github.com/real-serious-games/logviewer
Last synced: 6 months ago
JSON representation
A web application for viewing log files stored in a MongoDB database. Logs are assumed to be in Serilog format.
- Host: GitHub
- URL: https://github.com/real-serious-games/logviewer
- Owner: Real-Serious-Games
- License: mit
- Created: 2015-01-08T01:26:21.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2020-09-04T04:06:13.000Z (about 5 years ago)
- Last Synced: 2025-04-12T19:13:17.940Z (6 months ago)
- Language: JavaScript
- Size: 1.96 MB
- Stars: 7
- Watchers: 10
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LogViewer
A front end viewer for displaying and querying a collection of logs. This system expects the logs to be in the [Serilog](http://serilog.net/) structured logging format.
The logs will also need to be stored somewhere. The LogViewer is set up to use a plugin style system for connecting to this source. Currently the source code includes a mongo db plugin called mongodb-input.js (which is used by default when run from the command line) that can be used as a guide for creating your own. It is also possible to pipe logs directly from the [RSG LogServer](https://github.com/Real-Serious-Games/LogServer) as it has also been designed to use plugins for it's output.
## Installation
Clone the repo and then run `npm install` to install its dependencies.
## Run
node ./bin/rsg-log-viewer [options]
## Configuration
Edit the file config.json to set the port the server will run on. Any configuration needed for your input plugin will go in here as well and can be overridden on the command line. For instance if you want to use the default mongodb plugin you'd include the database configuration as follows.
{
"port": "3412",
"secret": "secret",
"host": "localhost",
"database": "logs",
"logCollection": "logs"
}
### Command line options
Option | Description
:---: | ---
--secret | if provided (and --usesecret is provided as well) then this will override the secret provided in the config file.
--port | override the config file's port number
--config | provide the path to a config file, using this instead of the default config.js file
--inputplugin | provides a path to the plugin to use as the input source for the logs [defualt: mongodb-input.js] eg. --inputplugin="./mongodb-input"