> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-references/org/general/monitor-service-health_scheduled.md). # Surveillance planifiée de l'intégrité du service Alerter par e-mail lors de nouveaux problèmes de santé du service Microsoft 365 annoncés {% hint style="info" %} Ceci est 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](/fr/automatisation/runbooks/scheduling.md) pour plus de détails sur la configuration des planifications de runbook. {% endhint %} ### Description Interroge selon une planification le flux des incidents du service Microsoft 365 Service Health et identifie les problèmes dont la première publication Service Health se situe dans une fenêtre de rétrospective configurable, car Microsoft antidate souvent l’heure de début officielle et un filtrage basé uniquement sur celle-ci manquerait des alertes. Réduit éventuellement la surveillance à un ensemble choisi de services et envoie un e-mail d’alerte par problème nouvellement détecté, avec un objet indiquant le locataire et le titre du problème. Tous les détails du problème figurent dans le corps de l’e-mail ; le runbook ne génère aucun fichier de rapport. ### Configuration concernant 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 fourni. L’adresse de l’expéditeur est prise depuis le `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 sur les paramètres de rapport RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) pour plus de détails sur tous les paramètres disponibles. #### Branding des e-mails Le courriel de rapport respecte les paramètres facultatifs `RJReport.Branding.*` du tenant : * **Image d’en-tête et de pied de page** – URL HTTPS publiques, PNG/JPEG/GIF, 200 Ko max. chacune * **Lien du pied de page** – cible de l’image de pied de page * **Couleur d’accent 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’envoi du courriel de rapport — la valeur par défaut correspondante est utilisée à la place. Instructions de configuration et exigences relatives aux images : [Branding des e-mails](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional). ### Emplacement Organisation → Général → Surveiller l’état de santé du service (planifié) **Nom complet du runbook** rjgit-org\_general\_monitor-service-health\_scheduled ### Détails | Propriété | Valeur | | -------------- | --------------------------------------------------------------------------------------- | | Version | 1.3.0 | | Modules requis |

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

| | Planifiable | oui | ### Notes Cas d'utilisation courants : * Planifiez l’exécution du runbook à un intervalle égal à LookbackHours ou légèrement plus fréquent afin de détecter chaque nouveau problème Service Health exactement une fois. * Définissez Services sur une liste séparée par des virgules de noms de services ou d’identifiants courts (correspondance insensible à la casse) pour 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 $false pour la configuration la moins bruyante, qui n’alerte que sur les incidents non résolus ; définissez l’un ou l’autre sur $true pour également faire remonter les avis ou les problèmes que Microsoft a déjà marqués comme résolus. Interactions entre paramètres : * Un problème est considéré comme nouvellement annoncé lorsque sa première publication Service Health se situe dans la fenêtre LookbackHours (en revenant à startDateTime si le problème n’a aucune publication) - et non sur la seule base de lastModifiedDateTime. Cela évite de manquer les problèmes antidatés tout en empêchant les réalertes à chaque mise à jour de statut 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, à moins que LookbackHours ne soit temporairement élargi 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. ### Autorisations #### Autorisations d'application * **Type**: Microsoft Graph * Mail.Send *(facultatif — fonctionnalité : rapport par e-mail)* * *Envoie un e-mail d’alerte par problème nouvellement détecté via Send-RjReportEmail lorsque EmailTo est configuré* * Organization.Read.All * *Lit /organization pour insérer le nom du locataire 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* ### Paramètres #### Services Liste séparée par des virgules des noms de services Microsoft 365 à surveiller, par exemple Microsoft Intune, Microsoft Entra, Exchange Online. Laissez vide pour surveiller tous les services. La correspondance est insensible à la casse, à la fois pour le nom d’affichage du service et pour son identifiant court ; ainsi, Intune correspond à Microsoft Intune. Les noms valides peuvent être trouvés sur la page d’état de santé des services du centre d’administration Microsoft 365. | Propriété | Valeur | | -------------------------- | ------------------------------------------------------------------------ | | Obligatoire | false | | Valeur par défaut | | | Type | String | | Nom d’affichage du portail | Services à surveiller (séparés par des virgules, laisser vide pour tous) | #### LookbackHours Nombre d’heures à remonter pour rechercher les problèmes nouvellement annoncés. Réglez cette valeur sur le même intervalle que la planification du runbook, par exemple 24 pour une planification quotidienne, afin qu’aucun problème ne soit manqué et qu’aucune alerte ne soit envoyée deux fois. | Propriété | Valeur | | -------------------------- | ------------------------------------------------------------------------------------------------ | | Obligatoire | false | | Valeur par défaut | 24 | | Type | Int32 | | Nom d’affichage du portail | Fenêtre de rétrospective (heures 1 - 168) - à faire correspondre à l’intervalle de planification | #### IncludeAdvisories Si la valeur est false, seuls les incidents déclenchent une alerte. Si la valeur est true, les avis sont également signalés. | Propriété | Valeur | | -------------------------- | ---------------------------------------------- | | Obligatoire | false | | Valeur par défaut | Faux | | Type | Booléen | | Nom d’affichage du portail | Inclure les avis (pas seulement les incidents) | #### IncludeResolvedIssues Si la valeur est false, les problèmes que Microsoft a déjà marqués comme résolus au moment de l’exécution du runbook sont ignorés. Si la valeur est true, les problèmes résolus sont tout de même signalés. | Propriété | Valeur | | -------------------------- | ---------------------------------- | | Obligatoire | false | | Valeur par défaut | Faux | | Type | Booléen | | Nom d’affichage du portail | Inclure les problèmes déjà résolus | #### EmailFrom Adresse e-mail de l’expéditeur utilisée pour les e-mails d’alerte par problème. Cela doit être configuré dans la personnalisation du runbook. | Propriété | Valeur | | ---------------------- | ----------------------------------------------------- | | Obligatoire | false | | Valeur par défaut | | | Type | String | | masqué dans le portail | oui (préconfiguré via la personnalisation du runbook) | #### BrandingHeaderImageUrl URL HTTPS publique facultative d’une image d’en-tête personnalisée (PNG/JPEG/GIF, 200 Ko max.) pour les e-mails d’alerte. Provenant du paramètre de locataire RJReport.Branding.HeaderImageUrl. Lorsqu’elle est vide, le visuel d’en-tête par défaut de RealmJoin est utilisé. | Propriété | Valeur | | ---------------------- | ----------------------------------------------------- | | Obligatoire | false | | Valeur par défaut | | | Type | String | | masqué dans le portail | oui (préconfiguré via la personnalisation du runbook) | #### BrandingFooterImageUrl URL HTTPS publique facultative d’une image de pied de page personnalisée (PNG/JPEG/GIF, 200 Ko max.) pour les e-mails d’alerte. Provenant du paramètre de locataire RJReport.Branding.FooterImageUrl. Lorsqu’elle est vide, le visuel de pied de page par défaut de RealmJoin est utilisé. | Propriété | Valeur | | ---------------------- | ----------------------------------------------------- | | Obligatoire | false | | Valeur par défaut | | | Type | String | | masqué dans le portail | oui (préconfiguré via la personnalisation du runbook) | #### BrandingFooterLink URL facultative vers laquelle renvoie l’image de pied de page. Provenant du paramètre du tenant RJReport.Branding.FooterLink. Lorsqu’elle est vide, le lien par défaut () est utilisé. | Propriété | Valeur | | ---------------------- | ----------------------------------------------------- | | Obligatoire | false | | Valeur par défaut | | | Type | String | | masqué dans le portail | oui (préconfiguré via la personnalisation du runbook) | #### BrandingAccentColor Remplacement facultatif de la couleur d’accent (hexadécimal à 6 chiffres, par ex. « #0052cc ») pour le modèle de courriel de rapport. Provenant du paramètre du tenant RJReport.Branding.AccentColor. Lorsqu’elle est vide ou invalide, la couleur d’accent par défaut de RealmJoin est utilisée. | Propriété | Valeur | | ---------------------- | ----------------------------------------------------- | | Obligatoire | false | | Valeur par défaut | | | Type | String | | masqué dans le portail | oui (préconfiguré via la personnalisation du runbook) | #### BrandingTextColor Remplacement facultatif de la couleur du texte (hexadécimal à 6 chiffres) pour le modèle de courriel de rapport. Provenant du paramètre du tenant RJReport.Branding.TextColor. Lorsqu’elle est vide ou invalide, la couleur du texte par défaut de RealmJoin est utilisée. | Propriété | Valeur | | ---------------------- | ----------------------------------------------------- | | Obligatoire | false | | Valeur par défaut | | | Type | String | | masqué dans le portail | oui (préconfiguré via la personnalisation du runbook) | #### EmailTo Liste séparée par des virgules des adresses e-mail des destinataires pour les e-mails d’alerte par problème. Au moins un destinataire valide est requis. | Propriété | Valeur | | -------------------------- | -------------------------------------------------------- | | Obligatoire | true | | Valeur par défaut | | | Type | String | | Nom d’affichage du portail | Adresse(s) e-mail des destinataires des e-mails d’alerte | [Retour à l’aperçu de la référence du runbook](/fr/automatisation/runbooks/runbook-references.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-references/org/general/monitor-service-health_scheduled.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.