Gentoostats

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

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. The package is unstable, so add it to the /etc/portage/package.accept_keywords file.

root #eselect repository enable 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