> 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/pt/automatizacao/runbooks/runbook-references/org/general/monitor-service-health_scheduled.md).

# Monitorizar estado de funcionamento do serviço agendado

Alertar por e-mail sobre novos problemas de estado de funcionamento do serviço do Microsoft 365

{% hint style="info" %}
Este é um runbook agendado. Foi concebido para ser executado num agendamento recorrente, em vez de ser acionado para um único objeto. Veja [Agendamento](https://docs.realmjoin.com/pt/automatizacao/runbooks/scheduling.md) para obter detalhes sobre como configurar agendamentos de runbook.
{% endhint %}

### Descrição

Verifica o feed de estado de saúde do serviço Microsoft 365 para problemas que a Microsoft anunciou nas horas escolhidas. Cada novo problema é enviado como um e-mail de alerta separado, com o Tenant e o título do problema no assunto e todos os detalhes no corpo. A monitorização pode ser limitada a determinados serviços, e comunicados e problemas já resolvidos podem ser incluídos. Não são criados ficheiros de relatório.

### Casos de uso comuns

* Agende o runbook para ser executado a intervalos iguais ou ligeiramente mais frequentes do que `LookbackHours` para capturar exatamente uma vez cada novo problema de Service Health.
* Defina `Serviços` para uma lista de nomes de serviços ou IDs curtos separados por vírgulas (correspondência não sensível a maiúsculas e minúsculas) para monitorizar apenas serviços específicos, como Exchange Online ou Teams; deixe-o vazio para monitorizar todos os serviços.
* Por predefinição, o runbook emite alertas sobre incidentes não resolvidos e comunicados (`IncludeAdvisories` estiver `true`, `IncludeResolvedIssues` estiver `false`). Defina `IncludeAdvisories` para `false` para a configuração com menos ruído, que emite alertas apenas sobre incidentes não resolvidos; defina `IncludeResolvedIssues` para `true` para também apresentar problemas que a Microsoft já marcou como resolvidos.

### Interações entre parâmetros

* Um problema conta como recém-anunciado quando a sua primeira publicação de Service Health se enquadra na `LookbackHours` janela (recorrendo a `startDateTime` se o problema não tiver publicações), e não por `lastModifiedDateTime` sozinho. Isto evita deixar passar problemas com data retroativa, ao mesmo tempo que impede novos alertas em cada atualização de estado de um incidente em curso.
* O runbook não mantém estado entre execuções, pelo que uma execução com falha ou ignorada significa que esses alertas nunca são enviados, a menos que `LookbackHours` seja temporariamente alargada para uma execução de recuperação.
* É enviado um e-mail por cada novo problema, por isso um dia movimentado de Service Health pode produzir vários e-mails por execução.

### Saída da execução

Cada execução escreve um resumo das fases de filtro e da lista de novos problemas, incluindo se o e-mail de alerta de cada problema foi enviado, para o **Dados de saída** separador do trabalho. Não são criados ficheiros de relatório.

### Configuração relativa ao envio de e-mails

O envio de um relatório por e-mail é opcional e só acontece quando é fornecido um destinatário (`EmailTo`) é fornecido. O endereço do remetente é obtido de `RJReport.EmailSender` definição do Tenant.

Este runbook envia e-mails usando a API Microsoft Graph. Para enviar e-mails via Graph API, é necessário configurar um endereço de e-mail existente na personalização do runbook.

Consulte a [Documentação das definições de relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para detalhes sobre todas as definições disponíveis.

#### Branding do e-mail

O e-mail do relatório respeita as opções facultativas `RJReport.Branding.*` definições do Tenant:

* **Imagem do cabeçalho e do rodapé** – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
* **Link do rodapé** – destino da imagem do rodapé
* **Cor de destaque e de texto** – valores hexadecimais de 6 dígitos, por exemplo `#0052cc`

Quando estas definições não estão configuradas, são usados os gráficos e as cores predefinidos do RealmJoin. Uma imagem que não possa ser transferida ou validada, ou um valor de cor inválido, nunca impede o e-mail de relatório – em vez disso, é usado o predefinido correspondente.

Instruções de configuração e requisitos de imagem: [Branding do e-mail](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Localização

Organização → Geral → Monitorizar o estado de saúde do serviço (Programado)

**Nome completo do runbook**

rjgit-org\_general\_monitor-service-health\_scheduled

### Detalhes

| Propriedade         | Valor                                                                                    |
| ------------------- | ---------------------------------------------------------------------------------------- |
| Versão              | 1.5.0                                                                                    |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| Agendável           | sim                                                                                      |

### Permissões

#### Permissões da aplicação

* **Tipo**: Microsoft Graph
  * Organization.Read.All
    * *Lê /organization para colocar o nome do Tenant no assunto e no rodapé do e-mail de alerta*
  * ServiceHealth.Read.All
    * *Lê /admin/serviceAnnouncement healthOverviews e issues para detetar problemas de Service Health recém-anunciados*
  * Mail.Send *(opcional — funcionalidade: relatório por e-mail)*
    * *Envia um e-mail de alerta por cada problema recém-detetado através de Send-RjRbReportEmail quando EmailTo está configurado*

### Parâmetros

#### Serviços

Serviços a monitorizar, separados por vírgulas, por exemplo Microsoft Intune, Microsoft Entra, Exchange Online. Deixe vazio para todos os serviços. Nomes curtos como Intune também funcionam.

| Propriedade                | Valor                  |
| -------------------------- | ---------------------- |
| Obrigatório                | false                  |
| Valor predefinido          |                        |
| Tipo                       | String                 |
| Nome de exibição no portal | Serviços a monitorizar |

#### LookbackHours

Quantas horas para trás procurar problemas recém-anunciados, de 1 a 168. Use o mesmo intervalo que o agendamento, por exemplo 24 para uma execução diária, para que nada seja perdido nem alertado duas vezes.

| Propriedade                | Valor                                     |
| -------------------------- | ----------------------------------------- |
| Obrigatório                | false                                     |
| Valor predefinido          | 24                                        |
| Tipo                       | Int32                                     |
| Nome de exibição no portal | Janela de observação retrospetiva (horas) |

#### IncludeAdvisories

Também emite alertas sobre comunicados, não apenas sobre incidentes.

| Propriedade                | Valor                |
| -------------------------- | -------------------- |
| Obrigatório                | false                |
| Valor predefinido          | Verdadeiro           |
| Tipo                       | Boolean              |
| Nome de exibição no portal | Incluir comunicados? |

#### IncludeResolvedIssues

Também emite alertas sobre problemas que a Microsoft já resolveu quando o runbook é executado.

| Propriedade                | Valor                         |
| -------------------------- | ----------------------------- |
| Obrigatório                | false                         |
| Valor predefinido          | Falso                         |
| Tipo                       | Boolean                       |
| Nome de exibição no portal | Incluir problemas resolvidos? |

#### EmailFrom

Endereço do remetente do e-mail de alerta. Obtido da definição do Tenant RJReport.EmailSender.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingHeaderImageUrl

Imagem do cabeçalho do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.HeaderImageUrl; o cabeçalho predefinido do RealmJoin é usado quando estiver vazio.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingFooterImageUrl

Imagem do rodapé do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.FooterImageUrl; o rodapé predefinido do RealmJoin é usado quando estiver vazio.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingFooterLink

Link associado à imagem do rodapé do e-mail do relatório. Obtido da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é usado quando estiver vazio.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingAccentColor

Cor de destaque do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.AccentColor; o valor predefinido do RealmJoin é usado quando estiver vazio ou inválido.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### BrandingTextColor

Cor do texto do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.TextColor; o valor predefinido do RealmJoin é usado quando estiver vazio ou inválido.

| Propriedade       | Valor                                           |
| ----------------- | ----------------------------------------------- |
| Obrigatório       | false                                           |
| Valor predefinido |                                                 |
| Tipo              | String                                          |
| Oculto no portal  | sim (predefinido via personalização do runbook) |

#### EmailTo

Endereços que recebem os e-mails de alerta, separados por vírgulas. É necessário pelo menos um.

| Propriedade                | Valor                                 |
| -------------------------- | ------------------------------------- |
| Obrigatório                | true                                  |
| Valor predefinido          |                                       |
| Tipo                       | String                                |
| Nome de exibição no portal | Endereço(s) de e-mail do destinatário |

[Voltar à visão geral da referência do runbook](https://docs.realmjoin.com/pt/automatizacao/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/pt/automatizacao/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.
