Surveiller l'état de santé du service planifié

Alerter par e-mail sur les nouveaux incidents de santé du service Microsoft 365

Il s'agit d'un runbook planifié. Il est conçu pour s'exécuter selon une planification récurrente plutôt que d'être déclenché pour un objet unique. Voir Planification pour plus de détails sur la configuration des planifications du runbook.

Description

Vérifie le flux d’intégrité des services Microsoft 365 pour les problèmes que Microsoft a annoncés au cours du nombre d’heures choisi. Chaque nouveau problème est envoyé dans un e-mail d’alerte séparé, avec le Tenant et le titre du problème dans l’objet et tous les détails dans le corps du message. La surveillance peut être limitée à certains services, et les avis ainsi que les problèmes déjà résolus peuvent être inclus. Aucun fichier de rapport n’est créé.

Cas d’utilisation courants

Planifiez l’exécution du runbook à cette fréquence ou légèrement plus souvent que LookbackHours pour capturer chaque nouveau problème Service Health exactement une fois.
Définir Services à une liste de noms de services ou de courts identifiants, séparés par des virgules (correspondance insensible à la casse), afin de surveiller uniquement des services spécifiques, comme Exchange Online ou Teams ; laissez-le vide pour surveiller tous les services.
Laissez IncludeAdvisories et IncludeResolvedIssues à leur valeur par défaut de faux pour la configuration la moins bruyante, qui n’alerte que sur les incidents non résolus ; définissez l’un ou l’autre sur vrai pour également afficher les avis ou les problèmes que Microsoft a déjà marqués comme résolus.

Interactions des paramètres

Un problème est considéré comme nouvellement annoncé lorsque sa première publication Service Health se situe dans la LookbackHours fenêtre (en se repliant sur startDateTime si le problème n’a aucune publication), et non d’après lastModifiedDateTime seul. Cela évite de manquer les problèmes antidatés tout en empêchant les réalertes à chaque mise à jour d’état d’un incident en cours.
Le runbook ne conserve aucun état entre les exécutions, donc une exécution échouée ou ignorée signifie que ces alertes ne sont jamais envoyées, sauf si LookbackHours est temporairement élargie pour une exécution de rattrapage.
Un e-mail est envoyé par nouveau problème, donc une journée Service Health chargée peut produire plusieurs e-mails par exécution.

Sortie d’exécution

Chaque exécution écrit un résumé des étapes de filtrage et la liste des nouveaux problèmes, y compris si l’e-mail d’alerte pour chaque problème a été envoyé, dans l’ Données de sortie onglet de la tâche. Aucun fichier de rapport n’est créé.

Configuration de l’envoi d’e-mails

L’envoi d’un rapport par e-mail est facultatif et ne se produit que lorsqu’un destinataire (EmailTo) est renseignée. L’adresse de l’expéditeur est récupérée à partir du RJReport.EmailSender paramètre du tenant.

Ce runbook envoie des e-mails à l’aide de l’API Microsoft Graph. Pour envoyer des e-mails via l’API Graph, vous devez configurer une adresse e-mail existante dans la personnalisation du runbook.

Voir la documentation des paramètres de rapport RealmJoin pour plus de détails sur tous les paramètres disponibles.

Identité visuelle des e-mails

L’e-mail du rapport prend en compte le paramètre facultatif RJReport.Branding.* des paramètres du tenant :

Image d’en-tête et de pied de page – URL HTTPS publiques, PNG/JPEG/GIF, 200 Ko max. chacune
Lien de pied de page – cible de l’image de pied de page
Couleur d’accentuation et du texte – valeurs hexadécimales à 6 chiffres, par ex. #0052cc

Lorsque ces paramètres ne sont pas configurés, les graphiques et couleurs par défaut de RealmJoin sont utilisés. Une image qui ne peut pas être téléchargée ou validée, ou une valeur de couleur invalide, n’empêche jamais l’e-mail du rapport – la valeur par défaut correspondante est utilisée à la place.

Instructions de configuration et exigences relatives aux images : Identité visuelle des e-mails.

Emplacement

Organisation → Général → Surveiller l’état de santé des services (planifié)

Nom complet du runbook

rjgit-org_general_monitor-service-health_scheduled

Détails

Propriété

Valeur

Version

1.4.0

Modules requis

RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)

Planifiable

oui

Autorisations

Autorisations d’application

Type: Microsoft Graph
- Organization.Read.All
  - Lit /organization pour mettre le nom du Tenant dans l’objet et le pied de page de l’e-mail d’alerte
- ServiceHealth.Read.All
  - Lit /admin/serviceAnnouncement healthOverviews et issues pour détecter les problèmes Service Health nouvellement annoncés
- Mail.Send (facultatif — fonctionnalité : rapport par e-mail)
  - Envoie un e-mail d’alerte par problème nouvellement détecté via Send-RjRbReportEmail lorsque EmailTo est configuré

Paramètres

Services

Services à surveiller, séparés par des virgules, par exemple Microsoft Intune, Microsoft Entra, Exchange Online. Laissez vide pour tous les services. Les noms abrégés comme Intune fonctionnent aussi.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Nom d’affichage du portail

Services à surveiller

LookbackHours

Nombre d’heures à remonter pour rechercher les problèmes nouvellement annoncés, de 1 à 168. Utilisez le même intervalle que la planification, par exemple 24 pour une exécution quotidienne, afin que rien ne soit manqué ni alerté deux fois.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Int32

Nom d’affichage du portail

Fenêtre rétrospective (heures)

IncludeAdvisories

Alerte également sur les avis, pas seulement sur les incidents.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Faux

Type

Booléen

Nom d’affichage du portail

Inclure les avis ?

IncludeResolvedIssues

Alerte également sur les problèmes que Microsoft a déjà résolus au moment où le runbook s’exécute.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Faux

Type

Booléen

Nom d’affichage du portail

Inclure les problèmes résolus ?

EmailFrom

Adresse de l’expéditeur de l’e-mail d’alerte. Issue du paramètre du Tenant RJReport.EmailSender.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingHeaderImageUrl

Image d’en-tête de l’e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, 200 Ko max.). Récupérée à partir du paramètre du tenant RJReport.Branding.HeaderImageUrl ; l’en-tête RealmJoin par défaut est utilisé si vide.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingFooterImageUrl

Image de pied de page de l’e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, 200 Ko max.). Récupérée à partir du paramètre du tenant RJReport.Branding.FooterImageUrl ; le pied de page RealmJoin par défaut est utilisé si vide.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingFooterLink

Lien derrière l’image de pied de page de l’e-mail du rapport. Récupéré à partir du paramètre du tenant RJReport.Branding.FooterLink ; realmjoin.com est utilisé si vide.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingAccentColor

Couleur d’accentuation de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Récupérée à partir du paramètre du tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée si vide ou invalide.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

BrandingTextColor

Couleur du texte de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Récupérée à partir du paramètre du tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée si vide ou invalide.

Propriété

Valeur

Obligatoire

faux

Valeur par défaut

Type

Chaîne

Masqué dans le portail

oui (prédéfini via la personnalisation du runbook)

EmailTo

Adresses qui reçoivent les e-mails d’alerte, séparées par des virgules. Au moins une est requise.

Propriété

Valeur

Obligatoire

vrai

Valeur par défaut

Type

Chaîne

Nom d’affichage du portail

Adresse(s) e-mail du destinataire

Retour à la vue d’ensemble de la référence du runbook

Mis à jour il y a 7 jours

Ce contenu vous a-t-il été utile ?