Tools and Access¶
Every tool an operator of co2-calculator touches, what it is for, and how a newcomer gets in. Incident procedure is in Operations; per-environment links are there too.
Tools¶
| Tool | Use it for | Where | Access |
|---|---|---|---|
| Icinga | External probes and the status page: http, https, api, DNS, PostgreSQL, certificate, per env | enacitmonitoring22.epfl.ch/icingaweb2 | EPFL LDAP login. Host group co2-calculator. Managed by the ENAC-IT Icinga admins (DRP roster) |
| Grafana, per cluster | Metrics, the "specific graphs" dashboard, alert state | One instance per cluster, links in Operations | OpenShift login, same group as the namespace |
| Tempo | Traces from backend and worker | enac-k8s-grafana.epfl.ch, Explore, Tempo data source | ENAC-IT Grafana account; ask the ENAC-IT sysadmins |
| Loki (OpenShift Logging) | Container logs per namespace, one day at a time for offline analysis | OpenShift console, Observe → Logs; or scripts/loki-dump.sh prod 2026-09-23 for an NDJSON dump |
OpenShift login, same group as the namespace (oc login first) |
OpenShift console, oc |
Pods, logs, ExternalSecret status, rollouts | One console per cluster, links in Operations | Granted by a namespace admin (DRP roster). The prod admin binding is admin-SVC1751 (ClusterRole admin), tied to the SVC1751 service unit; which EPFL group feeds it is being confirmed. Then oc login --web |
| ArgoCD | Sync state, diff, rollback | One per cluster, links in Operations | OpenShift login |
| GlitchTip | Frontend JavaScript errors, with a trace_id expected to match Tempo (not yet verified) |
enac-it-glitchtip.epfl.ch | Dedicated account, not SSO. Team credentials are in Infisical under ENAC-IT K8S/k8s-prod/epfl-enac/glitchtip. Details: Frontend Error Monitoring |
| Infisical | All application secrets, all environments | enac-it-secrets.epfl.ch, path /epfl/co2-calculator |
Invitation by the Infisical admins (DRP roster); login is a dedicated email, not SSO |
| Quay | Container images | quay-its.epfl.ch/organization/svc1751 | Organisation svc1751, team co2-calculator-devops; pulls use the read-only robot account |
| Matomo | Usage analytics. Tracking is on in all three environments, site id 17 | enac-webanalytics.epfl.ch/piwik | Invitation only. Setup: plan 2649 |
| GitHub | Code, CI, and the private GitOps repo openshift-app-config |
github.com/EPFL-ENAC | EPFL-ENAC organisation membership; the GitOps repo needs an explicit grant |
| Teams channel | GlitchTip alert feed | Private co2-calculator channel | Ask the lead developer |
EPFL identities behind the service¶
| Identity | Kind | Purpose | Note |
|---|---|---|---|
svc-calcco2-epfl-api |
Service account (M07583) | Backend access to api.epfl.ch |
12-month lifetime, expires 2026-10-20. Renew on services.epfl.ch before then |
co2-calculator-ops |
Group (S42207) | Unclear, see below | Owner: lead developer. Administered by enacit4research-devops |
co2-calculator-sysadmins |
Group | Alert mail: Alertmanager, Icinga, GlitchTip. The only one with a distribution list | Membership link in the DRP |
enacit4research-devops |
Group (S36814) | ENAC-IT devops; owns the Quay organisation contact | Contains ENAC-IT-admins |
Two groups exist by accident. Two people each created one without
coordinating. co2-calculator-sysadmins carries the distribution list
and receives every alert. Nobody has confirmed what co2-calculator-ops
grants; Quay is the leading guess. Decision of 2026-09-07: keep both
until that is known, then merge into one. A sysadmin left
co2-calculator-ops on that day to see whether any access disappears.
What is actually bound to a namespace, checked 2026-09-07 on prod: one
human-facing binding, admin-SVC1751 → ClusterRole admin; the rest are
OpenShift Pipelines and system roles. Re-check before trusting this line:
oc get rolebindings -n svc1751p-co2-calculator-prod
Onboarding an operator¶
- Get added to
co2-calculator-sysadminson groups.epfl.ch by the lead developer. This is what makes alert mail reach you. - Ask a namespace admin (DRP roster) for OpenShift access on each
cluster, then
oc login --web. - Ask ENAC-IT for the Tempo Grafana, and for Infisical and GlitchTip invitations.
- Ask for read access to
EPFL-ENAC/openshift-app-config. - Read Operations and the DRP, then bookmark the links table.
When someone leaves, reverse the list. Group membership drives alert mail; OpenShift and the rest are per-tool grants.