Difference between revisions of "Pkgstats"

From ArchWiki
Jump to: navigation, search
(Add section about automatic running of pkgstats via time-based jobs (cron/systemd).)
(modified link)
 
(17 intermediate revisions by 13 users not shown)
Line 1: Line 1:
[[Category:Package management]]{{DISPLAYTITLE:pkgstats}}
+
{{DISPLAYTITLE:pkgstats}}
 +
[[Category:Package management]]
 
[[de:Pkgstats]]
 
[[de:Pkgstats]]
pkgstats sends a list of all installed packages, [https://www.archlinux.org/news/pkgstats-now-collects-modules-usage/ kernel modules], the architecture and the mirror you are using to the Arch Linux project.
+
[[es:Pkgstats]]
This information is anonymous and cannot be used to identify the user, but it will help Arch developers prioritize their efforts.
+
[[ja:Pkgstats]]
 +
[[ru:Pkgstats]]
 +
pkgstats sends a list of all installed packages, [https://www.archlinux.org/news/pkgstats-now-collects-modules-usage/ kernel modules], the architecture and the mirror you are using to the Arch Linux project. This information is anonymous and cannot be used to identify the user, but it will help Arch developers prioritize their efforts.
  
 
== Installation ==
 
== Installation ==
You can install {{Pkg|pkgstats}} from the [[Official Repositories]].
+
 
 +
[[Install]] the {{Pkg|pkgstats}} package.
  
 
== Usage ==
 
== Usage ==
  
$ pkgstats -h
+
''pkgstats'' is set up to automatically run every week using [[systemd/Timers]]. Once installed, it will be activated after the next reboot.
usage: /usr/bin/pkgstats [option]
+
options:
+
        -v      show the version of pkgstats
+
        -d      enable debug mode
+
        -h      show this help
+
        -s      show what information would be sent
+
                (but do not send anything)
+
        -q      be quiet except on errors
+
  
== Tip: set it once and forget about it ==
+
If you do not want to wait for a reboot cycle, you can manually [[start]] {{ic|pkgstats.timer}}.
In order to keep statistics up-to-date while not forcing users to remember to run {{ic|pkgstats}} periodically, a time-based job may be set so as to execute {{ic|pkgstats}} in the background once in a while.
+
  
=== Using cron ===
+
''pkgstats'' can also be run manually: see {{ic|pkgstats -h}} for usage information.
{{ic|/etc/cron.weekly/pkgstats}} file is installed by default by {{Pkg|pkgstats}}. However, if not done before {{ic|cron}} systemd service should be enabled. See [[Cron#Activation_an_autostart]].
+
 
+
=== Using systemd cron functionality ===
+
[[Systemd]] is capable of taking on a significant subset of the functionality of {{ic|cron}} through built-in support for calendar time events (from systemd version 197) as well as monotonic time events.
+
 
+
A custom example for {{ic|pkgstats}} can be found at [[systemd/cron_functionality#pkgstats ]]. The rest of that article should be followed in order to activate systemd cron functionality.
+
  
 
== Results and reference ==
 
== Results and reference ==
  
 
Statistics are available at https://www.archlinux.de/?page=Statistics.
 
Statistics are available at https://www.archlinux.de/?page=Statistics.
 +
 +
The following open source project allows you to get the statistics data as JSON: [https://github.com/chrissound/ArchLinuxPkgStatsScraper ArchLinuxPkgStatsScraper]
  
 
You can read the official [https://bbs.archlinux.org/viewtopic.php?id=105431 forum thread] for more info.
 
You can read the official [https://bbs.archlinux.org/viewtopic.php?id=105431 forum thread] for more info.

Latest revision as of 14:42, 26 November 2016

pkgstats sends a list of all installed packages, kernel modules, the architecture and the mirror you are using to the Arch Linux project. This information is anonymous and cannot be used to identify the user, but it will help Arch developers prioritize their efforts.

Installation

Install the pkgstats package.

Usage

pkgstats is set up to automatically run every week using systemd/Timers. Once installed, it will be activated after the next reboot.

If you do not want to wait for a reboot cycle, you can manually start pkgstats.timer.

pkgstats can also be run manually: see pkgstats -h for usage information.

Results and reference

Statistics are available at https://www.archlinux.de/?page=Statistics.

The following open source project allows you to get the statistics data as JSON: ArchLinuxPkgStatsScraper

You can read the official forum thread for more info.