https://github.com/camathieu/accessmon

W3C Access Log File Analyser
https://github.com/camathieu/accessmon

Last synced: 20 days ago
JSON representation

W3C Access Log File Analyser

• Host: GitHub
• URL: https://github.com/camathieu/accessmon
• Owner: camathieu
• Created: 2019-05-09T15:19:47.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-05-13T09:25:50.000Z (over 5 years ago)
• Last Synced: 2024-10-16T05:35:07.086Z (2 months ago)
• Language: Go
• Homepage:
• Size: 112 KB
• Stars: 0
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Authors: AUTHORS

Awesome Lists containing this project

README

        
Access Mon

==========

Access Mon is able to display statistics about HTTP server logs in the [W3C Common Log File Format](https://www.w3.org/Daemon/User/Config/Logging.html)

```

$ ./accessmon --help

Usage of ./accessmon:

  -logfile string

        log file path (default "/tmp/access.log")

  -offline

        offline mode ( cat )

  -refresh duration

        screen refresh interval ( online mode only ) (default 10s)

  -threshold float

        total request per second moving average alerting threshold (default 10)

  -window duration

        total request per second moving average alerting window (default 2m0s)

```

By default access mon will seek to the end of the logfile and tail -f,

displaying every 10 seconds statistics about the last 10 seconds of received logs.

of received logs. If no logs have been received a warning message will be displayed.

If configured the program will detect and alert when the total number of requests

raise above the configured threshold ( 10 request per second by default ) for

the consecutive configured period of time ( 2 minutes by default ).

In offline mode the program will open and read the whole logfile ( cat ) and

run the alert detection algorithm.

Building from sources

=====================

Having a standard Golang environment installed simply run make

The accessmon binary will be available in the cmd directory

```

make && cd cmd && ./accessmon

```

Running linters and tests

```

make lint && make test

```

Building docker image

```

make docker

```