Skip to content
This repository

Parse web server log files and visualize the access creating a video showing the locations on a world map.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 lib
Octocat-spinner-32 resources
Octocat-spinner-32 spec
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .rspec
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.rdoc
Octocat-spinner-32 Rakefile
README.rdoc

IP World Map

This tool can be used to visualize web access logfiles. It performs geo-location resolution on the IPs (using api.hostip.info) and can generate:

  • a fixed image

  • an animated image

  • a video

Installation

Install [Gemcutter](gemcutter.org) then execute:

sudo gem install ip-world-map

Usage

ip-world-map [options] logfile1 [logfile2] ...

Options

    --version                    Display the version
-h, --help                       Display this help message
-v, --verbose                    Verbose output
    --map-filename VALUE         The image to use as background
    --resolution VALUE           (eg.: 640x480)
    --fps VALUE                  Animation frames per second (eg.: 25)
    --fill-dot-color VALUE       (eg.: red, 'rgb(255,0,0)', '#FF0000')
    --fill-dot-scale VALUE       (eg.: 10.0)
    --fill-dot-opacity VALUE     range 0.0-1.0 (eg.: 0.0, 0.5, 1.0)
    --fill-dot-lifetime VALUE    (eg.: 15)
    --time-slot VALUE            real life time visualized per video frame (eg.: 10secs, 1min, 99hours, 1day)
    --output-format VALUE        image format (e.g.: gif, jpg, png) or video format (avi, mpg, mp4)
    --[no-]animate               generate an image or a video

Examples

Generate PNG image. That's the default output.

ip-world-map /var/log/apache2/access.log*

Generate AVI video with 640x480 and 25fps (default settings).

ip-world-map --animate --output-format avi /var/log/apache2/access.log*

Supported platforms

Tested with Ruby 1.8.7, 1.9.1 under *nix

Author

René Scheibe

License

Copyright (C) 2010-2011 René Scheibe <rene.scheibe@gmail.com>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Something went wrong with that request. Please try again.