Mercurial > kallithea
annotate docs/usage/statistics.rst @ 7445:a33d1337db05
tests: remove tests of UI notifications
This commit is part of the removal of the UI notification feature from
Kallithea, which is not deemed useful in its current form. Only email
notifications are preserved.
author | Thomas De Schampheleire <thomas.de_schampheleire@nokia.com> |
---|---|
date | Wed, 05 Dec 2018 07:40:00 +0100 |
parents | 5ae8e644aa88 |
children |
rev | line source |
---|---|
811 | 1 .. _statistics: |
2 | |
4974
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
3 ===================== |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
4 Repository statistics |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
5 ===================== |
811 | 6 |
5425
5ae8e644aa88
docs: spelling, grammar, content and typography
Søren Løvborg <sorenl@unity3d.com>
parents:
4974
diff
changeset
|
7 Kallithea has a *repository statistics* feature, disabled by default. When |
4974
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
8 enabled, the amount of commits per committer is visualized in a timeline. This |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
9 feature can be enabled using the ``Enable statistics`` checkbox on the |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
10 repository ``Settings`` page. |
811 | 11 |
4974
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
12 The statistics system makes heavy demands on the server resources, so |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
13 in order to keep a balance between usability and performance, statistics are |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
14 cached inside the database and gathered incrementally. |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
15 |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
16 When Celery is disabled: |
811 | 17 |
4974
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
18 On each first visit to the summary page a set of 250 commits are parsed and |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
19 added to the statistics cache. This incremental gathering also happens on each |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
20 visit to the statistics page, until all commits are fetched. |
811 | 21 |
4974
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
22 Statistics are kept cached until additional commits are added to the |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
23 repository. In such a case Kallithea will only fetch the new commits when |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
24 updating its statistics cache. |
811 | 25 |
4974
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
26 When Celery is enabled: |
811 | 27 |
4974
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
28 On the first visit to the summary page, Kallithea will create tasks that will |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
29 execute on Celery workers. These tasks will gather all of the statistics until |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
30 all commits are parsed. Each task parses 250 commits, then launches a new |
ac7e43325817
docs/usage: rework section on statistics
Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
parents:
4955
diff
changeset
|
31 task. |