> 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 el estado del servicio programado

{% 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. Consulte [Programación](/es/automatizacion/runbooks/scheduling.md) para obtener detalles sobre cómo configurar las programaciones del runbook.
{% endhint %}

### Descripción

Consulta el feed de problemas de estado de servicio de Microsoft 365 en un horario e identifica los problemas cuyo primer mensaje de Service Health cae dentro de una ventana de retroceso configurable, ya que Microsoft con frecuencia retrotrae la hora oficial de inicio y filtrar solo en base a eso dejaría pasar alertas. Opcionalmente restringe la supervisión a un conjunto elegido de servicios y envía un correo de alerta por cada problema recién detectado, con un asunto que incluye el nombre del Tenant y el título del problema. Todos los detalles del problema se incluyen en el cuerpo del correo; el runbook no genera archivos de informe.

### Configuración relacionada con el envío de correos electrónicos

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

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

Consulta la [documentación de RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obtener más detalles.

#### Branding del correo electrónico

El correo electrónico del informe tiene en cuenta la configuración opcional `RJReport.Branding.*` de Tenant: una imagen de encabezado personalizada, una imagen de pie de página personalizada (URL HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada una), un enlace personalizado en el pie de página y colores personalizados 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 de branding que no se pueda descargar o validar, o un valor de color que no sea un color hexadecimal válido, nunca impide el envío del correo del informe; en su lugar, se usa el valor predeterminado correspondiente.

Consulta la [documentación de RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para ver los detalles de configuración.

### 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.3.0                                                                                   |
| Módulos requeridos | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>Microsoft.Graph.Authentication (>= 2.38.0)</p> |
| Programable        | sí                                                                                      |

### Notas

Casos de uso comunes:

* Programa el runbook para que se ejecute a intervalos iguales o ligeramente menores que LookbackHours para captar cada nuevo problema de Service Health exactamente una vez.
* Establece Services como una lista separada por comas de nombres de servicio o identificadores cortos (coincidencia sin distinguir mayúsculas y minúsculas) para supervisar solo servicios específicos, como Exchange Online o Teams; déjalo vacío para supervisar todos los servicios.
* Deja IncludeAdvisories e IncludeResolvedIssues en su valor predeterminado de $false para la configuración con menos ruido, que solo alerta sobre incidentes no resueltos; establece cualquiera de ellos en $true para mostrar también avisos o problemas que Microsoft ya haya marcado como resueltos.

Interacciones de parámetros:

* Un problema cuenta como anunciado recientemente cuando su primer mensaje de Service Health cae dentro de la ventana LookbackHours (tomando startDateTime como referencia si el problema no tiene publicaciones), no solo por lastModifiedDateTime. Esto evita pasar por alto problemas con fecha retroactiva y, al mismo tiempo, evita reactivar alertas en cada actualización de estado de un incidente en curso.
* El runbook no mantiene estado entre ejecuciones, así que una ejecución fallida o omitida significa que esas alertas nunca se envían, salvo que LookbackHours se amplíe temporalmente para una ejecución de recuperación.
* Se envía un correo por cada problema nuevo, por lo que un día con mucha actividad de Service Health puede generar varios correos por ejecución.

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * Mail.Send *(opcional — función: informe por correo electrónico)*
    * *Envía un correo de alerta por cada problema recién detectado mediante Send-RjReportEmail cuando EmailTo está configurado*
  * Organization.Read.All
    * *Lee /organization para poner 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 problemas de estado de servicio anunciados recientemente*

### Parámetros

#### Servicios

Lista separada por comas de nombres de servicios de Microsoft 365 para supervisar, por ejemplo Microsoft Intune, Microsoft Entra, Exchange Online. Déjala vacía para supervisar todos los servicios. La coincidencia no distingue mayúsculas y minúsculas tanto con el nombre visible del servicio como con su identificador corto, por lo que Intune coincide con Microsoft Intune. Los nombres válidos se pueden encontrar en la página de estado de servicio del centro de administración de Microsoft 365.

| Propiedad                        | Valor                                                                |
| -------------------------------- | -------------------------------------------------------------------- |
| Requerido                        | falso                                                                |
| Valor predeterminado             |                                                                      |
| Tipo                             | Cadena                                                               |
| Nombre para mostrar en el portal | Servicios a supervisar (separados por comas, dejar vacío para todos) |

#### LookbackHours

Cuántas horas hacia atrás buscar problemas anunciados recientemente. Establece esto en el mismo intervalo que la programación del runbook, por ejemplo 24 para una programación diaria, de modo que no se pase por alto ningún problema y ninguno genere alerta dos veces.

| Propiedad                        | Valor                                                                                     |
| -------------------------------- | ----------------------------------------------------------------------------------------- |
| Requerido                        | falso                                                                                     |
| Valor predeterminado             | 24                                                                                        |
| Tipo                             | Int32                                                                                     |
| Nombre para mostrar en el portal | Ventana de retroceso (horas 1 - 168) - debe coincidir con el intervalo de la programación |

#### IncludeAdvisories

Si se establece en false, solo los incidentes generan una alerta. Si se establece en true, también se alertará sobre los avisos.

| Propiedad                        | Valor                               |
| -------------------------------- | ----------------------------------- |
| Requerido                        | falso                               |
| Valor predeterminado             | Falso                               |
| Tipo                             | Booleano                            |
| Nombre para mostrar en el portal | Incluir avisos (no solo incidentes) |

#### IncludeResolvedIssues

Si se establece en false, los problemas que Microsoft ya haya marcado como resueltos cuando se ejecute el runbook se omiten. Si se establece en true, los problemas resueltos también se notifican.

| Propiedad                        | Valor                          |
| -------------------------------- | ------------------------------ |
| Requerido                        | falso                          |
| Valor predeterminado             | Falso                          |
| Tipo                             | Booleano                       |
| Nombre para mostrar en el portal | Incluir problemas ya resueltos |

#### EmailFrom

La dirección de correo del remitente utilizada para los correos de alerta por problema. Debe configurarse en la personalización del runbook.

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

#### BrandingHeaderImageUrl

URL HTTPS pública opcional de una imagen personalizada de encabezado (PNG/JPEG/GIF, máx. 200 KB) para los correos de alerta. Se obtiene de la configuración del Tenant RJReport.Branding.HeaderImageUrl. Cuando está vacío, se usa el gráfico de encabezado predeterminado de RealmJoin.

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

#### BrandingFooterImageUrl

URL HTTPS pública opcional de una imagen personalizada de pie de página (PNG/JPEG/GIF, máx. 200 KB) para los correos de alerta. Se obtiene de la configuración del Tenant RJReport.Branding.FooterImageUrl. Cuando está vacío, se usa el gráfico de pie de página predeterminado de RealmJoin.

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

#### BrandingFooterLink

URL opcional a la que enlaza la imagen del pie de página. Procede de la configuración de Tenant RJReport.Branding.FooterLink. Cuando está vacía, se usa el enlace predeterminado (<https://www.realmjoin.com>).

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

#### BrandingAccentColor

Reemplazo opcional del color de acento (hex de 6 dígitos, p. ej. '#0052cc') para la plantilla del correo del informe. Procede de la configuración de Tenant RJReport.Branding.AccentColor. Cuando está vacío o es inválido, se usa el color de acento predeterminado de RealmJoin.

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

#### BrandingTextColor

Reemplazo opcional del color de texto (hex de 6 dígitos) para la plantilla del correo del informe. Procede de la configuración de Tenant RJReport.Branding.TextColor. Cuando está vacío o es inválido, se usa el color de texto predeterminado de RealmJoin.

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

#### EmailTo

Lista separada por comas de direcciones de correo electrónico de los destinatarios de los correos de alerta por problema. Se requiere al menos un destinatario válido.

| Propiedad                        | Valor                                                               |
| -------------------------------- | ------------------------------------------------------------------- |
| Requerido                        | true                                                                |
| Valor predeterminado             |                                                                     |
| Tipo                             | Cadena                                                              |
| Nombre para mostrar en el portal | Direcciones de correo electrónico de los destinatarios de la alerta |

[Volver a la vista general de la 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 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/es/automatizacion/runbooks/runbook-references/org/general/monitor-service-health_scheduled.md?ask=<question>&goal=<endgoal>
```

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