service/prometheus.md

@@ -13,6 +13,31 @@ layer on top (see [Grafana][]).
 
 # Tutorial
 
+## Training course plan
+
+- Where can I find documentation? In the wiki, in [Prometheus](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/prometheus) and
+  [Grafana](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/howto/grafana)
+- Where do I reach the different web sites for the monitoring service?
+  See the [web dashboards section](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/prometheus#web-dashboards)
+- Where do i watch for alerts? Join the `#tor-alerts` IRC channel! See
+  also [how to access alerting history](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/prometheus#checking-alert-history)
+- How can we use silences to prevent some alerts from firing? See
+  [Silencing an alert in advance](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/prometheus#silencing-an-alert-in-advance) and following
+- [Architecture overview](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/prometheus#design)
+- [Alerting philosophy](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/prometheus#alerting-philosophy)
+- [Adding metrics](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/prometheus#adding-metrics-to-applications)
+- [How to add alerts](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/prometheus#writing-an-alert)
+- [Queries cheat sheet](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/prometheus#queries-cheat-sheet)
+- [Alert debugging](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/prometheus#alert-debugging):
+  - Alert unit tests
+  - Alert routing tests
+  - Ensuring the tags required for routing are there
+  - Link to prom graphs from prom's alert page
+- Where are we in [TPA-RFC-33][], show the various milestones:
+  - %"TPA-RFC-33-A: emergency Icinga retirement"
+  - %"TPA-RFC-33-B: Prometheus server merge, more exporters"
+  - %"TPA-RFC-33-C: Prometheus high availability, long term metrics, other exporters"
+
 ## Web dashboards
 
 The main Prometheus web interface is available at: