> 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). # Programado para supervisar el estado del servicio Enviar alertas por correo electrónico sobre incidencias de estado del servicio de Microsoft 365 recién anunciadas {% hint style="info" %} Este es un runbook programado. Está diseñado para ejecutarse según una programación recurrente en lugar de desencadenarse para un único objeto. Vea [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 incidencias de Microsoft 365 Service Health según una programación e identifica las incidencias cuyo primer mensaje de Service Health cae dentro de una ventana de búsqueda retrospectiva configurable, ya que Microsoft frecuentemente retrasa la hora oficial de inicio y filtrar solo en función de eso omitiría alertas. Opcionalmente limita la supervisión a un conjunto elegido de servicios y envía un correo de alerta por cada incidencia detectada recientemente, con un asunto que nombra el Tenant y el título de la incidencia. Todos los detalles de la incidencia se incluyen en el cuerpo del correo; el runbook no genera archivos de informe. ### Configuración relativa al envío de correos electrónicos Enviar un informe por correo electrónico es opcional y solo ocurre cuando se proporciona un destinatario (`EmailTo`) . 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 mediante Graph API, necesitas configurar una dirección de correo electrónico existente en la personalización del runbook. Consulta 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 respeta las configuraciones opcionales `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, por ejemplo `#0052cc` Cuando estas configuraciones no están definidas, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no se pueda 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 Organization → General → Monitor Service Health (Scheduled) **Nombre completo del runbook** rjgit-org\_general\_monitor-service-health\_scheduled ### Detalles | Propiedad | Valor | | ------------------ | --------------------------------------------------------------------------------------- | | Versión | 1.3.0 | | Módulos requeridos |

RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.38.0)

| | Programable | sí | ### Notas Casos de uso comunes: * Programa el runbook para que se ejecute con una frecuencia igual o ligeramente mayor que LookbackHours para detectar exactamente una vez cada nueva incidencia de Service Health. * Establece Services como una lista separada por comas de nombres de servicios 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 incidencias que Microsoft ya haya marcado como resueltas. Interacciones de parámetros: * Una incidencia cuenta como anunciada recientemente cuando su primer mensaje de Service Health cae dentro de la ventana de LookbackHours (recayendo en startDateTime si la incidencia no tiene mensajes), no solo por lastModifiedDateTime. Esto evita pasar por alto incidencias con fecha anterior y, al mismo tiempo, impide reactivar alertas en cada actualización de estado de un incidente en curso. * El runbook no mantiene estado entre ejecuciones, por lo que una ejecución fallida u omitida significa que esas alertas nunca se envían, a menos que LookbackHours se amplíe temporalmente para una ejecución de recuperación. * Se envía un correo por cada nueva incidencia, por lo que un día con mucha actividad en Service Health puede generar varios correos por ejecución. ### Permisos #### Permisos de aplicación * **Tipo**: Microsoft Graph * Mail.Send *(opcional — característica: informe por correo electrónico)* * *Envía un correo de alerta por cada incidencia detectada recientemente mediante Send-RjReportEmail cuando EmailTo está configurado* * Organization.Read.All * *Lee /organization para incluir 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 incidencias de Service Health anunciadas recientemente* ### Parámetros #### Servicios Lista separada por comas de nombres de servicios de Microsoft 365 que se supervisarán, 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 en el nombre visible del servicio como en su identificador corto, por lo que Intune coincide con Microsoft Intune. Los nombres válidos pueden encontrarse en la página de estado de los servicios del centro de administración de Microsoft 365. | Propiedad | Valor | | ---------------------------- | -------------------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Nombre mostrado en el portal | Servicios a supervisar (separados por comas, dejar vacío para todos) | #### LookbackHours Cuántas horas hacia atrás buscar incidencias anunciadas recientemente. Configura esto con el mismo intervalo que la programación del runbook, por ejemplo 24 para una programación diaria, de modo que no se omita ninguna incidencia y no se alerte dos veces sobre ninguna. | Propiedad | Valor | | ---------------------------- | ---------------------------------------------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | 24 | | Tipo | Int32 | | Nombre mostrado en el portal | Ventana de búsqueda retrospectiva (horas 1 - 168) - coincidir con el intervalo de 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 | | ---------------------------- | ----------------------------------- | | Obligatorio | false | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre mostrado en el portal | Incluir avisos (no solo incidentes) | #### IncludeResolvedIssues Si se establece en false, se omiten las incidencias que Microsoft ya haya marcado como resueltas cuando se ejecute el runbook. Si se establece en true, las incidencias resueltas también se notifican. | Propiedad | Valor | | ---------------------------- | -------------------------------- | | Obligatorio | false | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre mostrado en el portal | Incluir incidencias ya resueltas | #### EmailFrom La dirección de correo del remitente utilizada para los correos de alerta por incidencia. Esto debe configurarse en la personalización del runbook. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingHeaderImageUrl URL HTTPS pública opcional de una imagen de encabezado personalizada (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ía, se usa la imagen de encabezado predeterminada de RealmJoin. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingFooterImageUrl URL HTTPS pública opcional de una imagen de pie de página personalizada (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ía, se usa la imagen de pie de página predeterminada de RealmJoin. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingFooterLink URL opcional a la que enlaza la imagen del pie de página. Se obtiene de la configuración del tenant RJReport.Branding.FooterLink. Cuando está vacía, se usa el enlace predeterminado (). | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingAccentColor Anulación opcional del color de acento (hexadecimal de 6 dígitos, por ejemplo '#0052cc') para la plantilla del correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.AccentColor. Cuando está vacío o no es válido, se usa el color de acento predeterminado de RealmJoin. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### BrandingTextColor Anulación opcional del color de texto (hexadecimal de 6 dígitos) para la plantilla del correo electrónico del informe. Se obtiene de la configuración del tenant RJReport.Branding.TextColor. Cuando está vacío o no es válido, se usa el color de texto predeterminado de RealmJoin. | Propiedad | Valor | | -------------------- | ----------------------------------------------------------- | | Obligatorio | false | | Valor predeterminado | | | Tipo | String | | Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) | #### EmailTo Lista separada por comas de direcciones de correo electrónico de los destinatarios de los correos de alerta por incidencia. Se requiere al menos un destinatario válido. | Propiedad | Valor | | ---------------------------- | ----------------------------------------------------------------- | | Obligatorio | true | | Valor predeterminado | | | Tipo | String | | Nombre mostrado en el portal | Dirección(es) de correo electrónico del destinatario de la alerta | [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 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=&goal= ``` `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.