Skip to content

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

  1. Get added to co2-calculator-sysadmins on groups.epfl.ch by the lead developer. This is what makes alert mail reach you.
  2. Ask a namespace admin (DRP roster) for OpenShift access on each cluster, then oc login --web.
  3. Ask ENAC-IT for the Tempo Grafana, and for Infisical and GlitchTip invitations.
  4. Ask for read access to EPFL-ENAC/openshift-app-config.
  5. 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.