> 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).

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

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

{% 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 configuration des planifications de runbook.
{% endhint %}

### Description

Vérifie le flux d’état de santé des services Microsoft 365 pour détecter les problèmes que Microsoft a annoncés au cours du nombre d’heures choisi. Chaque nouveau problème est envoyé sous forme d’e-mail d’alerte distinct, 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 à une fréquence égale ou légèrement plus élevée que `LookbackHours` pour détecter chaque nouveau problème d’état de santé des services exactement une fois.
* Défini `Services` vers une liste de noms de services ou d’identifiants courts séparés par des virgules (correspondance insensible à la casse) pour surveiller uniquement certains services, comme Exchange Online ou Teams ; laissez 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 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 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 par `lastModifiedDateTime` seulement. Cela évite de manquer des problèmes antidatés tout en empêchant de renvoyer des 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, 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 générer plusieurs e-mails par exécution.

### Sortie de l’exécution

Chaque exécution écrit dans l’ **onglet Données de sortie** onglet du travail 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é. 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 n’a lieu que lorsqu’un destinataire (`EmailTo`) est renseignée. L’adresse de l’expéditeur est prise dans le `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 des 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

L’e-mail du rapport prend en compte l’optionnel `RJReport.Branding.*` paramètres 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’accent et de texte** – valeurs hexadécimales à 6 chiffres, par ex. `#0052cc`

Lorsque ces paramètres ne sont pas configurés, les graphismes 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 non valide, n’empêche jamais l’envoi de l’e-mail du rapport : le défaut correspondant est utilisé à 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é 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 | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| 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 d’état de santé des services 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 courts 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 signalé deux fois.

| Propriété                  | Valeur                           |
| -------------------------- | -------------------------------- |
| Obligatoire                | faux                             |
| Valeur par défaut          | 24                               |
| Type                       | Int32                            |
| Nom d’affichage du portail | Fenêtre de consultation (heures) |

#### IncludeAdvisories

Alerte aussi 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 aussi 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 d'expéditeur de l'e-mail d'alerte. Prise à partir 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.). Prise dans le paramètre 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.). Prise dans le paramètre 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. Pris dans le paramètre 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’accent de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Prise dans le paramètre Tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée si vide ou non valide.

| 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. Prise dans le paramètre Tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée si vide ou non valide.

| 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 à 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-references/org/general/monitor-service-health_scheduled.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
