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

# Supervisar estado del servicio programado

Alertar por correo electrónico sobre nuevos problemas de estado del servicio de Microsoft 365

{% hint style="info" %}
Este es un runbook programado. Está diseñado para ejecutarse según una programación recurrente en lugar de activarse para un único objeto. Véase [Programación](/es/automatizacion/runbooks/scheduling.md) para obtener detalles sobre cómo configurar las programaciones del runbook.
{% endhint %}

### Descripción

Comprueba el feed de estado de servicio de Microsoft 365 en busca de incidencias que Microsoft haya anunciado dentro del número de horas elegido. Cada nueva incidencia se envía como un correo electrónico de alerta independiente, con el Tenant y el título de la incidencia en el asunto y todos los detalles en el cuerpo. La supervisión puede limitarse a determinados servicios, y se pueden incluir avisos e incidencias ya resueltas. No se crean archivos de informe.

### Casos de uso comunes

* Programa la ejecución del runbook para que se ejecute cada vez o ligeramente con más frecuencia que `Horas de búsqueda retrospectiva` para capturar exactamente una vez cada nueva incidencia de Service Health.
* Establece `Servicios` a una lista de nombres de servicios o identificadores cortos separados por comas (con coincidencia sin distinguir mayúsculas y minúsculas) para supervisar solo servicios específicos, como Exchange Online o Teams; déjelo vacío para supervisar todos los servicios.
* Deje `Incluir avisos` y `Incluir incidencias resueltas` en su valor predeterminado de `falso` para la configuración con menos ruido, que solo genera alertas sobre incidentes no resueltos; establezca cualquiera de ellos en `verdadero` para mostrar también avisos o incidencias que Microsoft ya haya marcado como resueltas.

### Interacciones de parámetros

* Una incidencia se considera anunciada recientemente cuando su primera publicación de Service Health cae dentro de la `Horas de búsqueda retrospectiva` ventana (recurrir a `startDateTime` si la incidencia no tiene publicaciones), no solo por `lastModifiedDateTime` . Esto evita que se pasen por alto incidencias con fecha anterior, a la vez que impide volver a generar alertas con cada actualización de estado de un incidente en curso.
* El runbook no conserva estado entre ejecuciones, por lo que una ejecución fallida u omitida significa que esas alertas nunca se envían a menos que `Horas de búsqueda retrospectiva` se amplíe temporalmente para una ejecución de puesta al día.
* Se envía un correo por cada nueva incidencia, por lo que un día de Service Health con mucha actividad puede generar varios correos por ejecución.

### Salida de la ejecución

Cada ejecución escribe un resumen de las etapas del filtro y la lista de incidencias nuevas, incluido si se envió el correo de alerta de cada incidencia, en la **Datos de salida** pestaña del trabajo. No se crean archivos de informe.

### Configuración relacionada con el envío de correo electrónico

El envío de un informe por correo electrónico es opcional y solo ocurre cuando se proporciona un destinatario (`EmailTo`) se proporciona. La dirección del remitente se toma de la `RJReport.EmailSender` configuración del Tenant.

Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos electrónicos a través de la API de Graph, debe configurar una dirección de correo electrónico existente en la personalización del runbook.

Consulte la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obtener detalles sobre todas las configuraciones disponibles.

#### Marca del correo electrónico

El correo electrónico del informe tiene en cuenta la opción opcional `RJReport.Branding.*` del Tenant:

* **Imagen de encabezado y pie de página** – URL HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada una
* **Enlace del pie de página** – destino de la imagen del pie de página
* **Color de acento y de texto** – valores hexadecimales de 6 dígitos, p. ej. `#0052cc`

Cuando estas configuraciones no están definidas, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no se puede descargar o validar, o un valor de color no válido, nunca impide el correo electrónico del informe; en su lugar se usa el valor predeterminado correspondiente.

Instrucciones de configuración y requisitos de imagen: [Marca del correo electrónico](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Ubicación

Organización → General → Supervisar Service Health (Programado)

**Nombre completo del runbook**

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

### Detalles

| Propiedad          | Valor                                                                                    |
| ------------------ | ---------------------------------------------------------------------------------------- |
| Versión            | 1.4.0                                                                                    |
| Módulos requeridos | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| Programable        | sí                                                                                       |

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * Organization.Read.All
    * *Lee /organization para colocar el nombre del Tenant en el asunto y el pie de página del correo de alerta*
  * ServiceHealth.Read.All
    * *Lee /admin/serviceAnnouncement healthOverviews y issues para detectar nuevas incidencias de Service Health anunciadas*
  * Mail.Send *(opcional — característica: informe por correo electrónico)*
    * *Envía un correo electrónico de alerta por cada incidencia detectada recientemente mediante Send-RjRbReportEmail cuando EmailTo está configurado*

### Parámetros

#### Servicios

Servicios a supervisar, separados por comas; por ejemplo, Microsoft Intune, Microsoft Entra, Exchange Online. Déjelo vacío para todos los servicios. Los nombres abreviados, como Intune, también funcionan.

| Propiedad                      | Valor                  |
| ------------------------------ | ---------------------- |
| Requerido                      | falso                  |
| Valor predeterminado           |                        |
| Tipo                           | Cadena                 |
| Nombre para mostrar del portal | Servicios a supervisar |

#### Horas de búsqueda retrospectiva

Cuántas horas hacia atrás buscar incidencias anunciadas recientemente, de 1 a 168. Use el mismo intervalo que la programación, por ejemplo 24 para una ejecución diaria, para que no se pase nada por alto ni se genere una alerta dos veces.

| Propiedad                      | Valor                                     |
| ------------------------------ | ----------------------------------------- |
| Requerido                      | falso                                     |
| Valor predeterminado           | 24                                        |
| Tipo                           | Int32                                     |
| Nombre para mostrar del portal | Ventana de búsqueda retrospectiva (horas) |

#### Incluir avisos

También genera alertas sobre avisos, no solo sobre incidentes.

| Propiedad                      | Valor            |
| ------------------------------ | ---------------- |
| Requerido                      | falso            |
| Valor predeterminado           | Falso            |
| Tipo                           | Booleano         |
| Nombre para mostrar del portal | ¿Incluir avisos? |

#### Incluir incidencias resueltas

También genera alertas sobre incidencias que Microsoft ya haya resuelto cuando se ejecute el runbook.

| Propiedad                      | Valor                           |
| ------------------------------ | ------------------------------- |
| Requerido                      | falso                           |
| Valor predeterminado           | Falso                           |
| Tipo                           | Booleano                        |
| Nombre para mostrar del portal | ¿Incluir incidencias resueltas? |

#### EmailFrom

Dirección del remitente del correo electrónico de alerta. Tomada de la configuración de Tenant RJReport.EmailSender.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### BrandingHeaderImageUrl

Imagen de encabezado del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.HeaderImageUrl; se usa el encabezado predeterminado de RealmJoin cuando está vacío.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### BrandingFooterImageUrl

Imagen de pie de página del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.FooterImageUrl; se usa el pie de página predeterminado de RealmJoin cuando está vacío.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### BrandingFooterLink

Enlace asociado a la imagen de pie de página del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.Branding.FooterLink; realmjoin.com se usa cuando está vacío.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### BrandingAccentColor

Color de acento del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.AccentColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### BrandingTextColor

Color de texto del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.TextColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### EmailTo

Direcciones que reciben los correos electrónicos de alerta, separadas por comas. Se requiere al menos una.

| Propiedad                      | Valor                                                |
| ------------------------------ | ---------------------------------------------------- |
| Requerido                      | verdadero                                            |
| Valor predeterminado           |                                                      |
| Tipo                           | Cadena                                               |
| Nombre para mostrar del portal | Dirección(es) de correo electrónico del destinatario |

[Volver a la vista general de referencia del runbook](/es/automatizacion/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/es/automatizacion/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.
