Event-Reporting-Tool für eIAM und AGOV

Neuereungen

Das eIAM Operations Team erfasst Betriebsstörungen und geplante Wartungsarbeiten von AGOV und eIAM neu zentral im Event-Reporting-Tool. Mit einer einzigen Erfassung werden sämtliche Informationskanäle bedient. Dadurch erhalten Sie über alle Kanäle hinweg einheitliche und aktuelle Informationen.

Die Meldungen werden in Deutsch, Französisch, Italienisch, Rätoromanisch und Englisch veröffentlicht.

Das Event-Reporting-Tool ist ein internes Werkzeug des eIAM Operations Teams. Sie benötigen dafür keinen Zugang. Für Sie sichtbar sind die Statusanzeige, das Betriebsreporting und die Benachrichtigungen. Zusätzlich stehen Ihnen API-Endpunkte zur Verfügung, über die Sie die Informationen direkt abrufen und in Ihre internen Prozesse integrieren können.

Hintergrund

Bisher wurden die Statusseite, das Betriebsreporting und die Mitteilungen separat gepflegt. Dies führte zu Verzögerungen im Informationsfluss und teilweise zu unterschiedlichen Aussagen je nach Informationskanal.

Neu wird jede Meldung nur noch einmal zentral erfasst und anschliessend standardisiert über sämtliche Informationskanäle veröffentlicht.nden Aussagen je nach Kanal. Neu entsteht jede Meldung einmal und wird standardisiert auf allen Kanälen publiziert.

Kanäle


Kanäle Inhalt Bereiche
Statusanzeige Aktueller Zustand als Ampel, je Service, mit Statustext AGOV Help und eIAM Help
Betriebsreporting Laufende und vergangene Ausfälle und Teilausfälle je Monat, inkl. Verfügbarkeit AGOV und eIAM
Mail Meldung zu Störungen und Wartungen an registrierte Ansprechpersonen der dedizierten Verteilerlisten AGOV (an Verteiler fürKantone & Gemeinden)und eIAM inkl. AGOV(an eIAM-Verteiler)

Statusanzeige

Sie zeigt den Status des Gesamtsystems in Form einer Statuskachel, einen Statustext,sowie den Zustand der einzelnen Services. Als Statustext erscheint eine allfälligaufgeschalteter Event oder im Regelbetrieb ein Standardtext.

Bespiel der Anzeige im Regelbetrieb an Hand der AGOV Hilfeseite

Image showing the AGOV operational status
AGOV operational status


Bespiel der Anzeige mit Info-Text an Hand der eIAM Hilfeseite
Image showing the eIAM operational status
eIAM operational status


Zustände Bedeutung AGOV eIAM
🟢
 Uneingeschränkt verfügbar
eIAM status: green
Tile « Normal operation »
eIAM status: green
Tile «Normal operation»
🟠
 Teilstörung oder Einschränkung, z.B. geplante Wartung
AGOV status: orange
Tile «Partial fault»
eIAM status: orange
Tile «Partial fault»
🔴
 Störung
AGOV status: red
Tile « Fault »
eIAM status: red
Tile « Fault »

Bitte beachten Sie:
Der Ampel-Status der Kacheln entspricht schlechtesten offenen Ereignis. Wobei eIAM und AGOV unterschieden werden. AGOV hat den reinen AGOV-Fokus. eIAM beinhaltet AGOV auch, berücksichtigt aber insbesondere FED-LOGIN auch noch

Regelwerk für Ereignisse


Ergebnis Service Anmerkungen
Ausfall
🔴
Teilausfall, oder Wartung bzw. Information mit Auswirkung
🟠
Wartung bzw. Information ohne Auswirkung
🟢
(Text erscheint trotzdem) 		(siehe Beispiel vorher)

Ampel je Bereich: Rot gilt nur bei Ausfall der Anmeldung, sonst bleibt der Bereich orange.


Bereich
🔴
🟠
🟢
AGOV Login mit AGOV ist rot mindestens ein Service orange oder rot alle Services grün
eIAM alle drei Logins (AGOV, CH-LOGIN, FED-LOGIN) sind rot mindestens ein Service orange oder rot alle Services grün

Bitte beachten Sie:
Zeigt die Seite «Status kann derzeit nicht abgerufen werden», ist nur die Anzeige betroffen, nicht zwingend der Dienst. Bitte stellen Sie dazu keine Supportanfragen.

Bespiel der Anzeige mit Event an Hand der AGOV Hilfeseite

Image showing the AGOV operational status with login disruption
AGOV operational status with login disruption

Bespiel der Anzeige für gleichen Event an Hand der eIAM Hilfeseite

Image showing the eIAM operational status with AGOV login disruption
eIAM operational status with AGOV login disruption

Status- und Reporting-Daten maschinell über API abrufen

Beide zur Verfügung gestellte API-Endpunkte sind öffentlich. Es braucht kein Login und kein API-Key. Die APIs liefern Daten im JSON-Format. Sie decken beide Bereiche ab, AGOV und eIAM.

Endpunkt Zweck Aktualisierung
GET
https://ops.eiam.admin.ch/ert/status 		Aktuelle Ampel je Bereich und Service, mit Statustext alle 30 Sekunden
GET
https://ops.eiam.admin.ch/ert/reporting 		Ausfälle und Teilausfälle je Kalendermonat, inkl. Verfügbarkeit

Status: Die Antwort enthält immer die Bereiche agov und eiam.

curl -s https://ops.eiam.admin.ch/ert/status

state ist g(grün), o(orange) oder r(rot), updated der Zeitpunkt (CET) der letzten Änderung.

Reporting:
Je Monat erhalten Sie Ausfallzeit in Minuten, Verfügbarkeit in Prozent und die publizierten Ausfälle und Teilausfälle. Ausfall und Teilausfall zählen mit voller Dauer, Ereignisse nur auf “Übrige Services” nicht. Informations- und Wartungsmeldungen erscheinen nur in der Statusanzeige.

curl -s "https://ops.eiam.admin.ch/ert/reporting?scope=agov&months=3"

Parameter       Werte                     Standard
scope             agov oder eiam        eiam
month            1 bis 24                   eiam
lang               de, en, fr, it, rm        eiam

Der Status liefert mit lang=all alle Sprachen in einer Antwort.

Bitte beachten Sie:

  • Fragen Sie den Status höchstens alle 30 Sekunden, das Reporting höchstens alle60 Sekunden ab. Es gelten höchstens 60 Anfragen pro Minute und IP-Adresse, danach antwortet der Dienst mit 429.
  • Zeigen Sie bei Fehlern oder Timeouts den letzten erfolgreichen Stand mit Zeitpunkt weiter an und ignorieren Sie unbekannte zusätzliche Felder.
  • Der Abruf funktioniert direkt aus dem Browser. Bei vielen Besuchenden empfehlen wir einen serverseitigen Abruf mit eigenem Cache.

Benachrichtigung per Mail

Das Operation-Team informiert angemeldete Ansprechpersonen bei Störungen und Wartungen per Mail. Eine Meldung wird von der Erstmeldung über allfällige Zwischenmeldungen bis zum Abschluss laufend nachgeführt. Sollte der Event bei der Erstmeldung bereits abgeschlossen sein, dann erhalten Sie eine Erstmeldung/Abschluss.

Auswirkungen und Handlungsbedarf für Sie

  • Grundsätzlich besteht für Sie kein Handlungsbedarf.
  • Für den automatisierten Bezug der Status- oder Reporting-Informationen nutzen Sie bitte die oben beschriebenen Endpunkte. Die Nutzung ist freiwillig. Angaben sind ohne Gewähr.
  • Sind Sie interessiert an den Informationen über eIAM oder AGOV und erhalten Sie noch keine entsprechenden Informationen, dann melden Sie sich wie folgt: