Gentoostats

From Gentoo Wiki
Jump to: navigation, search
Resources
Warning
This page is a work in progress by gokturk (talk | contribs). Treat its contents with caution.
The information in this article has been deprecated. It may or may not be relevant for contemporary usage. Handle with care!

gentoostats can collect several statistics from Gentoo machines. It was a Google Summer of Code 2011 project.

Installation

Gentoostats is available through the betagarden ebuild repository. Make sure the git USE flag has been enabled for app-portage/layman to install the repository. Also, the package is unstable, so add it to the /etc/portage/package.accept_keywords file.

root #layman -a betagarden
root #emerge --ask gentoostats

When first installed, the program created a unique identifier for your machine. Use this identifier later to view the statistics of your machine. The identifier is stored in /etc/gentoostats/auth.cfg.

Configuration

Sending statistics

Sending statistics from a machine is simple. You can control which statistics are sent by editing /etc/gentoostats/payload.cfg.

root #gentoostats-send

Usage

Viewing statistics

The website can be used to view some aggregated statistics. To view the stats in JSON (instead of the regular HTML view), you have to add the "Accept:application/json" HTTP Header to your request. For instance:

user $curl -H "Accept:application/json" http://soc.dev.gentoo.org/gentoostats/arch

You can also use the command-line interface to request JSON formatted statistics. For instance to view the statistics available on sys-kernel/gentoo-sources or view what different architectures are used:

root #gentoostats-cli search -p gentoo-sources
root #gentoostats-cli list arch

The following options are available:

  • search
    • -c, --category
    • -p', --package
    • -v', --version
    • -r', --repo
    • --min_hosts
    • --max_hosts
  • list
    • arch
    • feature
    • lang
    • mirror
    • repo
    • package
    • use