logger
Project home

Summary	provide project WWW access log files and stats to project owners
Categories	None
Owner(s)	kohsuke, ryan_shoemaker

java.net records access to your project as an Apache log file. This service allows project owners to receive those raw log files. In addition, you can also see a summary of the www access for your project in a simple stats report. When your project signs up for this service, owner@YOURPROJECT.dev.java.net receives a periodic e-mail which contains the gzip-compressed log file and/or stats reports for the last period.

Why you should care about log files and stats

• To learn who is referencing your project
• To learn how many people are downloading your software
• To learn which pages are accessed frequently

Using the http/s log service

To receive daily log files for your project.

Add the special user "daily_logger" to your project as an observer. A project owner can do this by selecting "membership" of your project, then "add new member", type in daily_logger to the "mass add" text box, select "Observer" as the role, then click "Grant roles".

To receive weekly log files for your project.

Add the special user "weekly_logger" to your project as an observer. A project owner can do this by selecting "membership" of your project, then "add new member", type in weekly_logger to the "mass add" text box, select "Observer" as the role, then click "Grant roles".

Using the project stats report service

To receive daily stats reports for your project.

Add the special user "daily_project_stats" to your project as an observer. A project owner can do this by selecting "membership" of your project, then "add new member", type in daily_project_stats to the "mass add" text box, select "Observer" as the role, then click "Grant roles".

To receive weekly stats reports for your project.

Add the special user "weekly_project_stats" to your project as an observer. A project owner can do this by selecting "membership" of your project, then "add new member", type in weekly_project_stats to the "mass add" text box, select "Observer" as the role, then click "Grant roles".

To receive monthly stats reports for your project.

Add the special user "monthly_project_stats" to your project as an observer. A project owner can do this by selecting "membership" of your project, then "add new member", type in monthly_project_stats to the "mass add" text box, select "Observer" as the role, then click "Grant roles".

To stop the delivery of log files / project reports

Kick out the above logger user accounts from your project. A project owner can do this by selecting "membership" of your project, look for those user names, check all the roles assigned to them, then click "Revoke checked roles.

How to make use of log files

There are tons of log analysis tools/packages available for Apache log files. See a list of such tools that people are using.

It would be nice if this project can also deploy one of those log analysis tool so that we can deliver more visual report to thoe who wish. Any volunteer?

Viewing the stats reports

Simply save the zip file attached to the automated e-mail, unzip it, and load the index.html file in your web browser.

The reports allow you to track www access to your project as well as activity in the "Documents & Files" section of your project.

Click here to view a sample report