> 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. Ele foi projetado para ser executado em um agendamento recorrente, em vez de ser acionado para um único objeto. Veja [Agendamento](/pt/automatizacao/runbooks/scheduling.md) para obter detalhes sobre como configurar os agendamentos do runbook.
{% endhint %}
### Descrição
Verifica o feed de integridade do serviço do Microsoft 365 em busca de problemas que a Microsoft anunciou dentro do número de horas escolhido. Cada novo problema é enviado como um email de alerta separado, com o Tenant e o título do problema no assunto e todos os detalhes no corpo. O monitoramento pode ser limitado a serviços específicos, e podem ser incluídos avisos e problemas já resolvidos. Não são criados ficheiros de relatório.
### Casos de uso comuns
* Agende o runbook para ser executado à mesma frequência ou um pouco mais frequentemente do que `Horas de retrospetiva` para detetar cada novo problema de Service Health exatamente uma vez.
* Defina `Serviços` para uma lista de nomes de serviços ou identificadores curtos separados por vírgulas (correspondência sem distinção entre maiúsculas e minúsculas) para monitorizar apenas serviços específicos, como Exchange Online ou Teams; deixe em branco para monitorizar todos os serviços.
* Deixe `Incluir avisos` e `Incluir problemas resolvidos` com o valor predefinido de `falso` para a configuração com menos ruído, que alerta apenas sobre incidentes não resolvidos; defina qualquer um deles como `verdadeiro` para também apresentar avisos ou 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 ocorre dentro da `Horas de retrospetiva` janela (recorrendo a `startDateTime` se o problema não tiver publicações), e não por `lastModifiedDateTime` sozinho. Isto evita perder problemas datados retroativamente, ao mesmo tempo que impede novo alerta a 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 falhada ou ignorada significa que esses alertas nunca são enviados, a menos que `Horas de retrospetiva` seja temporariamente alargado para uma execução de recuperação.
* É enviado um email por cada novo problema, pelo que um dia de Service Health movimentado pode gerar vários emails por execução.
### Saída da execução
Cada execução escreve um resumo das etapas de filtragem e a lista de novos problemas, incluindo se o email 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 emails
Enviar um relatório por email é opcional e só acontece quando é fornecido um destinatário (`EmailTo`). O endereço do remetente é obtido da definição do `RJReport.EmailSender` Tenant.
Este runbook envia emails utilizando a API do Microsoft Graph. Para enviar emails através da Graph API, é necessário configurar um endereço de email 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 obter detalhes sobre todas as definições disponíveis.
#### Branding do email
O email do relatório respeita as definições opcionais de `RJReport.Branding.*` do Tenant:
* **Imagem do cabeçalho e do rodapé** – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
* **Ligação no rodapé** – destino da imagem do rodapé
* **Cor de destaque e do texto** – valores hexadecimais de 6 dígitos, por exemplo `#0052cc`
Quando estas definições não estão configuradas, são utilizadas as imagens e cores predefinidas do RealmJoin. Uma imagem que não possa ser transferida ou validada, ou um valor de cor inválido, nunca impede o email do relatório – é utilizada em vez disso a predefinição correspondente.
Instruções de configuração e requisitos da imagem: [Branding do email](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).
### Localização
Organização → Geral → Monitorizar Service Health (Agendado)
**Nome completo do Runbook**
rjgit-org\_general\_monitor-service-health\_scheduled
### Detalhes
| Propriedade | Valor |
| ------------------- | ---------------------------------------------------------------------------------------- |
| Versão | 1.4.0 |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
|
| 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 email 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 email)*
* *Envia um email 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 em branco para todos os serviços. Nomes curtos como Intune também funcionam.
| Propriedade | Valor |
| -------------------------- | ---------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Serviços a monitorizar |
#### Horas de retrospetiva
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 | falso |
| Valor predefinido | 24 |
| Tipo | Int32 |
| Nome de exibição do portal | Janela de retrospetiva (horas) |
#### Incluir avisos
Também alerta sobre avisos, não apenas sobre incidentes.
| Propriedade | Valor |
| -------------------------- | --------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Incluir avisos? |
#### Incluir problemas resolvidos
Também alerta sobre problemas que a Microsoft já resolveu quando o runbook é executado.
| Propriedade | Valor |
| -------------------------- | ----------------------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do 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 | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingHeaderImageUrl
Imagem de cabeçalho do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.HeaderImageUrl; é utilizado o cabeçalho predefinido do RealmJoin quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingFooterImageUrl
Imagem de rodapé do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.FooterImageUrl; é utilizado o rodapé predefinido do RealmJoin quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingFooterLink
Ligação por trás da imagem de rodapé do email do relatório. Obtida da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é utilizado quando estiver vazio.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingAccentColor
Cor de destaque do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.AccentColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### BrandingTextColor
Cor do texto do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.TextColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### EmailTo
Endereços que recebem os emails de alerta, separados por vírgulas. É necessário pelo menos um.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------ |
| Obrigatório | verdadeiro |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Endereço(s) de email do(s) destinatário(s) |
[Voltar à visão geral da referência do Runbook](/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=&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.