blob: 7e602f08e1f644e93dcde0b4512e4af8a3c0e396 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
# Observibility
## Logging
Gitaly leverages the [logrus](https://github.com/sirupsen/logrus) for exposing
log messages. Most request messages are created in the [logrus middleware][logrus-middleware].
Messages can be queried leveraging our [Kibana instance](https://log.gitlab.net).
[logrus-middleware]: https://github.com/grpc-ecosystem/go-grpc-middleware/tree/master/logging/logrus
## Prometheus
Gitaly emits low cardinality metrics through Prometheus. Most of these are added
by [go-grpc-prometheus](https://github.com/grpc-ecosystem/go-grpc-prometheus).
Many custom metrics were also added.
### Grafana
To display the prometheus metrics, GitLab leverages Grafana. Two instances are
available to view the dashboards. The dashboards can be found at:
[dashboards.gitlab.com](https://dashboards.gitlab.com).
#### Editing Gitaly dashboards
Use the Grafana web interface to make changes to dashboards if
necessary.
**Remember to hit the 'Save' button at the top of the Grafana screen when making changes.**
##### Tiled (repeated) dashboards
If you want to make a change across a tiled Grafana dashboard such as
the [feature request rate
overview](https://performance.gitlab.net/dashboard/db/gitaly-features-overview),
then edit the first tile (top left). Its settings get applied to the
other tiles as well. If you edit any tile other than the first your
changes will be lost.
##### Drop-down values
At the top of most of our Grafana dashboards you find drop-down menus
for GRPC method names, Prometheus jobs etc. The possible values in these
drop-downs are defined with Prometheus queries. To see or change these
queries go into the dashboard's global settings (the gear icon at the
top of the page) and look in the 'Templating' section. You can then edit
entries.
Note that Grafana 'templates' use a combination of PromQL and
Grafana-specific modifiers.
## Sentry
Errors are tracked in our sentry instance, and due to their sensitive nature only viewable
by developers at GitLab at [the error tracking page](https://gitlab.com/gitlab-org/gitaly/error_tracking).
|