Dienstzustand überwachen, geplant

Per E-Mail über neue Microsoft 365-Dienstzustandsprobleme warnen

Dies ist ein geplantes Runbook. Es ist dafür vorgesehen, nach einem wiederkehrenden Zeitplan ausgeführt zu werden, statt für ein einzelnes Objekt ausgelöst zu werden. Siehe Zeitplanung für Details zur Konfiguration von Runbook-Zeitplänen.

Beschreibung

Überprüft den Microsoft 365-Dienstzustands-Feed auf Probleme, die Microsoft innerhalb der ausgewählten Anzahl von Stunden angekündigt hat. Jedes neue Problem wird als separate Warn-E-Mail gesendet, wobei der Mandant und der Problemtitel in der Betreffzeile und alle Details im Nachrichtentext stehen. Die Überwachung kann auf bestimmte Dienste beschränkt werden, und Hinweise sowie bereits behobene Probleme können eingeschlossen werden. Es werden keine Berichtdateien erstellt.

Häufige Anwendungsfälle

• Planen Sie das Runbook so, dass es zur oder etwas häufiger als Rückblickstunden erfasst, um jedes neue Service-Health-Problem genau einmal zu erfassen.
• Setzen Sie Dienste in eine durch Kommas getrennte Liste von Dienstnamen oder Kurz-IDs (ohne Beachtung der Groß-/Kleinschreibung abgeglichen) festlegen, um nur bestimmte Dienste wie Exchange Online oder Teams zu überwachen; lassen Sie das Feld leer, um alle Dienste zu überwachen.
• Lassen Sie Hinweise einschließen und Behobene Probleme einschließen bei ihrem Standardwert von nein für die geräuschärmste Konfiguration, die nur bei ungelösten Vorfällen warnt; setzen Sie einen der beiden Werte auf ja um auch Hinweise oder Probleme anzuzeigen, die Microsoft bereits als behoben markiert hat.

Wechselwirkungen der Parameter

• Ein Problem gilt als neu angekündigt, wenn sein erster Service-Health-Beitrag in das Rückblickstunden Fenster fällt (falls ersatzweise auf startDateTime zurückgegriffen wird, wenn das Problem keine Beiträge hat), nicht anhand von lastModifiedDateTime allein. Dadurch werden rückdatierte Probleme nicht übersehen, während Wiederholungswarnungen bei jedem Statusupdate eines laufenden Vorfalls vermieden werden.
• Das Runbook behält zwischen den Ausführungen keinen Zustand bei, daher bedeutet eine fehlgeschlagene oder übersprungene Ausführung, dass diese Warnungen nie gesendet werden, es sei denn Rückblickstunden wird das Zeitfenster vorübergehend für einen Nachhollauf erweitert.
• Pro neuem Problem wird eine E-Mail gesendet, sodass ein ereignisreicher Service-Health-Tag pro Ausführung mehrere E-Mails erzeugen kann.

Ausgabe der Ausführung

Jede Ausführung schreibt eine Zusammenfassung der Filterstufen und der Liste der neuen Probleme, einschließlich dessen, ob die Warn-E-Mail für jedes Problem gesendet wurde, in die Ausgabedaten Registerkarte des Jobs. Es werden keine Berichtdateien erstellt.

Einrichtung für den E-Mail-Versand

Das Senden eines E-Mail-Berichts ist optional und erfolgt nur, wenn ein Empfänger (EmailTo) angegeben ist. Die Absenderadresse wird aus der RJReport.EmailSender Mandanten-Einstellung übernommen.

Dieses Runbook sendet E-Mails über die Microsoft Graph API. Um E-Mails über die Graph API zu senden, müssen Sie in der Runbook-Anpassung eine vorhandene E-Mail-Adresse konfigurieren.

Siehe die RealmJoin Report Settings Dokumentation für Details zu allen verfügbaren Einstellungen.

E-Mail-Branding

Die Berichts-E-Mail berücksichtigt die optionalen RJReport.Branding.* Mandanten-Einstellungen:

• Header- und Footer-Bild – öffentliche HTTPS-URLs, PNG/JPEG/GIF, jeweils max. 200 KB
• Footer-Link – Ziel des Footer-Bildes
• Akzent- und Textfarbe – 6-stellige Hexwerte, z. B. #0052cc

Wenn diese Einstellungen nicht konfiguriert sind, werden die standardmäßigen RealmJoin-Grafiken und -Farben verwendet. Ein Bild, das nicht heruntergeladen oder validiert werden kann, oder ein ungültiger Farbwert verhindert niemals die Berichts-E-Mail – stattdessen wird der entsprechende Standard verwendet.

Einrichtungsanweisungen und Bildanforderungen: E-Mail-Branding.

Ort

Organisation → Allgemein → Service Health überwachen (geplant)

Vollständiger Runbook-Name

rjgit-org_general_monitor-service-health_scheduled

Details

Eigenschaft	Wert
Version	1.4.0
Erforderliche Module	RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)
Planbar	ja

Berechtigungen

Anwendungsberechtigungen

• Typ: Microsoft Graph

  • Organization.Read.All

    • Liest /organization, um den Namen des Mandanten in die Betreffzeile und die Fußzeile der Warn-E-Mail aufzunehmen
  • ServiceHealth.Read.All

    • Liest /admin/serviceAnnouncement healthOverviews und issues, um neu angekündigte Service-Health-Probleme zu erkennen
  • Mail.Send (optional — Funktion: E-Mail-Bericht)

    • Sendet bei konfiguriertem EmailTo eine Warn-E-Mail pro neu erkanntem Problem über Send-RjRbReportEmail

Parameter

Dienste

Zu überwachende Dienste, durch Kommas getrennt, z. B. Microsoft Intune, Microsoft Entra, Exchange Online. Für alle Dienste leer lassen. Kurznamen wie Intune funktionieren ebenfalls.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge
Anzeigename im Portal	Zu überwachende Dienste

Rückblickstunden

Wie viele Stunden rückwärts nach neu angekündigten Problemen gesucht werden soll, 1 bis 168. Verwenden Sie dasselbe Intervall wie der Zeitplan, z. B. 24 für einen täglichen Lauf, damit nichts verpasst oder doppelt gemeldet wird.

Eigenschaft	Wert
Erforderlich	nein
Standardwert	24
Typ	Int32
Anzeigename im Portal	Rückblickfenster (Stunden)

Hinweise einschließen

Warnt auch bei Hinweisen, nicht nur bei Vorfällen.

Eigenschaft	Wert
Erforderlich	nein
Standardwert	Falsch
Typ	Boolesch
Anzeigename im Portal	Hinweise einschließen?

Behobene Probleme einschließen

Warnt auch bei Problemen, die Microsoft bereits behoben hat, wenn das Runbook ausgeführt wird.

Eigenschaft	Wert
Erforderlich	nein
Standardwert	Falsch
Typ	Boolesch
Anzeigename im Portal	Behobene Probleme einschließen?

EmailFrom

Absenderadresse der Warn-E-Mail. Aus der Mandanteneinstellung RJReport.EmailSender entnommen.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge
Im Portal ausgeblendet	ja (vorkonfiguriert über Runbook-Anpassung)

BrandingHeaderImageUrl

Headerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanten-Einstellung RJReport.Branding.HeaderImageUrl übernommen; bei leerem Wert wird der standardmäßige RealmJoin-Header verwendet.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge
Im Portal ausgeblendet	ja (vorkonfiguriert über Runbook-Anpassung)

BrandingFooterImageUrl

Footerbild der Berichts-E-Mail (HTTPS-URL, PNG/JPEG/GIF, max. 200 KB). Wird aus der Mandanten-Einstellung RJReport.Branding.FooterImageUrl übernommen; bei leerem Wert wird der standardmäßige RealmJoin-Footer verwendet.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge
Im Portal ausgeblendet	ja (vorkonfiguriert über Runbook-Anpassung)

BrandingFooterLink

Link hinter dem Footerbild der Berichts-E-Mail. Wird aus der Mandanten-Einstellung RJReport.Branding.FooterLink übernommen; bei leerem Wert wird realmjoin.com verwendet.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge
Im Portal ausgeblendet	ja (vorkonfiguriert über Runbook-Anpassung)

BrandingAccentColor

Akzentfarbe der Berichts-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanten-Einstellung RJReport.Branding.AccentColor übernommen; bei leerem oder ungültigem Wert wird der Standard von RealmJoin verwendet.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge
Im Portal ausgeblendet	ja (vorkonfiguriert über Runbook-Anpassung)

BrandingTextColor

Textfarbe der Berichts-E-Mail als 6-stelliger Hexwert. Wird aus der Mandanten-Einstellung RJReport.Branding.TextColor übernommen; bei leerem oder ungültigem Wert wird der Standard von RealmJoin verwendet.

Eigenschaft	Wert
Erforderlich	nein
Standardwert
Typ	Zeichenfolge
Im Portal ausgeblendet	ja (vorkonfiguriert über Runbook-Anpassung)

EmailTo

Adressen, die die Warn-E-Mails erhalten, durch Kommas getrennt. Mindestens eine ist erforderlich.

Eigenschaft	Wert
Erforderlich	ja
Standardwert
Typ	Zeichenfolge
Anzeigename im Portal	E-Mail-Adresse(n) des Empfängers

Zurück zur Runbook-Reference-Übersicht