Mercurial > kallithea
annotate docs/usage/statistics.rst @ 6453:ebe7d95f698b
auth: simplify the double invoked auth classes used for permission checking
Also avoid storing request state in the Has Permission instances. The instances
er temporary and only used once and there is thus not real problem, but it is
simpler and cleaner this way.
author | Mads Kiilerich <mads@kiilerich.com> |
---|---|
date | Sun, 22 Jan 2017 01:16:52 +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. |