Portal:Toolforge/Admin/Runbooks/BuildsApiUpMetricUnknown

This happens when prometheus has no data from k8s on the builds-api pod.

The procedures in this runbook require admin permissions to complete.

Error / Incident

This usually comes in the form of an alert in alertmanager.

There you will get which project (tools, toolsbeta, ...) is the one it's failing for.

Debugging

This is a tricky one and it will be related to the way we gather metrics on tools/toolsbeta.

Note that this is not directly related to the metricsinfra monitoring project, but toolforge's own setup.

You can start by going to the project's prometheus page and trying to get the stats there, example for tools:

https://tools-prometheus.wmflabs.org/tools/graph?g0.expr=up%7Bjob%3D%22builds-api%22%7D&g0.tab=1&g0.stacked=0&g0.show_exemplars=0&g0.range_input=1h

Common issues

Add new issues here when you encounter them!

Prometheus k8s cert expired

We don't have yet a way to autorefresh the certs prometheus uses to authenticate against k8s, so they need renewal. When they expire prometheus is not able to get metrics from it (so any k8s related metric will just not be there).

If that's the case, you can follow this guide.

Related information

Karma UI (use project=tools or project=toolsbeta for filtering)
Tools prometheus
Toolsbeta prometheus
Alerts repository
Toolforge admin docs

Old incidents

Add any incident tasks here!