> 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'état des services {% hint style="info" %} 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 seul objet. Voir [Planification](/fr/automatisation/runbooks/scheduling.md) pour plus de détails sur la façon de configurer les planifications du runbook. {% endhint %} ### Description Interroge le flux des problèmes Service Health Microsoft 365 selon une planification et identifie les problèmes dont la première publication Service Health se situe dans une fenêtre de retour en arrière configurable, car Microsoft date fréquemment le début officiel de façon rétroactive et se baser uniquement sur cela manquerait des alertes. Peut, en option, restreindre la surveillance à un ensemble de services choisi et envoie un e-mail d’alerte par problème nouvellement détecté, avec pour objet le nom du locataire et le titre du problème. Tous les détails du problème sont inclus dans le corps de l’e-mail ; le runbook ne produit aucun fichier de rapport. ### Configuration relative à 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 reprise du `RJReport.EmailSender` paramètre 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 RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) pour plus de détails. #### Branding de l’e-mail L’e-mail du rapport respecte les `RJReport.Branding.*` paramètres Tenant facultatifs : une image d’en-tête personnalisée, une image de pied de page personnalisée (URL HTTPS publiques, PNG/JPEG/GIF, 200 KB max. chacune), un lien de pied de page personnalisé, ainsi que des couleurs d’accent et de texte personnalisées (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 de branding qui ne peut pas être téléchargée ou validée, ou une valeur de couleur qui n’est pas une couleur hexadécimale valide, n’empêche jamais l’envoi de l’e-mail du rapport - la valeur par défaut correspondante est utilisée à la place. Voir la [documentation RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) pour les détails de configuration. ### Emplacement Organisation → Général → Surveiller l’intégrité 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 exactement une fois chaque nouveau problème Service Health. * Définissez Services sur une liste séparée par des virgules de noms de services ou d’identifiants courts (comparés sans tenir compte de la casse) pour surveiller uniquement des services spécifiques, comme Exchange Online ou Teams ; laissez le champ 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 afficher aussi les avis ou les problèmes que Microsoft a déjà marqués comme résolus. Interactions des paramètres : * Un problème est comptabilisé comme nouvellement annoncé lorsque sa première publication Service Health se situe dans la fenêtre LookbackHours (en retombant sur startDateTime si le problème n’a aucune publication), et non pas uniquement selon lastModifiedDateTime. Cela évite de manquer des problèmes datés rétrospectivement tout en empêchant de relancer des 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 seront jamais envoyées, sauf si LookbackHours est 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 mettre 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 sur le nom d’affichage du service et sur son identifiant court, donc Intune correspond à Microsoft Intune. Les noms valides peuvent être trouvés sur la page d’intégrité des services du centre d’administration Microsoft 365. | Propriété | Valeur | | -------------------------- | ------------------------------------------------------------------------ | | Obligatoire | faux | | Valeur par défaut | | | Type | Chaîne de caractères | | Nom d’affichage du portail | Services à surveiller (séparés par des virgules, laisser vide pour tous) | #### LookbackHours Nombre d’heures à regarder en arrière pour rechercher les problèmes nouvellement annoncés. Réglez-le 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 | faux | | Valeur par défaut | 24 | | Type | Int32 | | Nom d’affichage du portail | Fenêtre de retour en arrière (heures 1 - 168) - à faire correspondre à l’intervalle de planification | #### IncludeAdvisories Si défini sur false, seuls les incidents déclenchent une alerte. Si défini sur true, les avis déclenchent aussi des alertes. | Propriété | Valeur | | -------------------------- | ---------------------------------------------- | | Obligatoire | faux | | Valeur par défaut | Faux | | Type | Booléen | | Nom d’affichage du portail | Inclure les avis (pas seulement les incidents) | #### IncludeResolvedIssues Si défini sur false, les problèmes que Microsoft a déjà marqués comme résolus au moment où le runbook s’exécute sont ignorés. Si défini sur true, les problèmes résolus sont quand même signalés. | Propriété | Valeur | | -------------------------- | ---------------------------------- | | Obligatoire | faux | | Valeur par défaut | Faux | | Type | Booléen | | Nom d’affichage du portail | Inclure les problèmes déjà résolus | #### EmailFrom L’adresse e-mail de l’expéditeur utilisée pour les e-mails d’alerte par problème. Elle doit être configurée dans la personnalisation du runbook. | Propriété | Valeur | | ---------------------- | -------------------------------------------------- | | Obligatoire | faux | | Valeur par défaut | | | Type | Chaîne de caractères | | Masqué dans le portail | oui (prédéfini 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, l’image d’en-tête RealmJoin par défaut est utilisée. | Propriété | Valeur | | ---------------------- | -------------------------------------------------- | | Obligatoire | faux | | Valeur par défaut | | | Type | Chaîne de caractères | | Masqué dans le portail | oui (prédéfini 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, l’image de pied de page RealmJoin par défaut est utilisée. | Propriété | Valeur | | ---------------------- | -------------------------------------------------- | | Obligatoire | faux | | Valeur par défaut | | | Type | Chaîne de caractères | | Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) | #### BrandingFooterLink URL facultative vers laquelle pointe l’image de pied de page. Provenant du paramètre Tenant RJReport.Branding.FooterLink. Lorsqu’elle est vide, le lien par défaut () est utilisé. | Propriété | Valeur | | ---------------------- | -------------------------------------------------- | | Obligatoire | faux | | Valeur par défaut | | | Type | Chaîne de caractères | | Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) | #### BrandingAccentColor Remplacement facultatif de la couleur d’accent (hexadécimal à 6 chiffres, par ex. '#0052cc') pour le modèle d’e-mail du rapport. Provenant du paramètre 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 | faux | | Valeur par défaut | | | Type | Chaîne de caractères | | Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) | #### BrandingTextColor Remplacement facultatif de la couleur du texte (hexadécimal à 6 chiffres) pour le modèle d’e-mail du rapport. Provenant du paramètre 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 | faux | | Valeur par défaut | | | Type | Chaîne de caractères | | Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) | #### EmailTo Liste séparée par des virgules des adresses e-mail des destinataires des e-mails d’alerte par problème. Au moins un destinataire valide est requis. | Propriété | Valeur | | -------------------------- | -------------------------------------------------------------- | | Obligatoire | vrai | | Valeur par défaut | | | Type | Chaîne de caractères | | Nom d’affichage du portail | Adresse(s) e-mail du ou des destinataires de l’e-mail 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.