> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Estado de salud de las integraciones

> Entender los estados de salud de las integraciones y cómo Wirespeed supervisa sus integraciones conectadas

> [!NOTE]
>
> El estado de salud de las integraciones es visible en la página de configuración de [Integraciones](https://app.wirespeed.co/settings/integrations), en la página de detalle de cada integración y en el panel de inicio.

Wirespeed supervisa de forma continua cada integración conectada y muestra su estado de salud en toda la plataforma. Si una fuente de detección deja de ingestar datos, una acción de remediación empieza a fallar o un flujo de registros se silencia, lo verá de inmediato antes de que afecte a un caso o a una respuesta automatizada.

Los estados de salud se evalúan automáticamente de forma continua. No se requiere ninguna configuración.

## Estados de salud

| Estado | Color del distintivo | Significado |
| - | - | - |
| **Correcto** | Verde | La integración funciona con normalidad, sin errores ni advertencias recientes. |
| **Inestable** | Amarillo | La integración experimenta errores intermitentes o un volumen elevado de advertencias. |
| **Incorrecto** | Rojo | La integración tiene fallos persistentes que pueden impedir que entregue datos o ejecute acciones de forma fiable. |
| **En silencio** | Verde azulado | Un [reenviador de registros](https://docs.wirespeed.co/es/integrations/log-forwarders.md) que no ha recibido eventos durante unos días, durante menos tiempo del que permite la actividad habitual de esa fuente. En silencio no es un fallo, así que pasar a En silencio solo se notifica cuando pone fin a un estado Incorrecto o Inestable. Consulte [Reenviadores en silencio](https://docs.wirespeed.co/es/integrations/forwarder-data-usage.md#quiet-forwarders). |
| **Pendiente** | Gris | Aún se están recopilando datos de salud, la integración está en una ventana de mantenimiento o el tipo de integración no está sujeto a la supervisión de salud. |

## Dónde se muestra el estado de salud

### Panel

El panel de inicio incluye una barra de distribución de salud en la parte superior de la tarjeta Integraciones. La barra muestra un desglose codificado por colores de todas las integraciones conectadas por estado de salud. Al hacer clic en cualquier segmento, se navega directamente a la lista de integraciones filtrada por ese estado.

La lista del panel muestra las categorías de integraciones en orden alfabético. Una categoría con una integración Incorrecta o Inestable muestra un icono de advertencia. Las integraciones en silencio no.

### Lista de integraciones

Cada fila de la lista de integraciones en la página de configuración de [Integraciones](https://app.wirespeed.co/settings/integrations) muestra un distintivo de salud. La lista se ordena por estado de salud de forma predeterminada, de modo que las integraciones que requieren atención aparecen arriba.

Al pasar el cursor sobre un distintivo Incorrecto o Inestable se muestra una información emergente con el número de errores o advertencias detectados y cuándo comenzó el estado actual. Al pasar el cursor sobre un distintivo En silencio se muestra cuándo la integración quedó en silencio.

También puede filtrar la lista de integraciones por estado de salud con la barra de filtros situada encima de la tabla.

### Página de detalle de la integración

Al abrir una integración individual se muestra su distintivo de salud en el encabezado de la página. Si la integración está Incorrecta, Inestable o En silencio, aparece un banner debajo del encabezado con un mensaje específico del contexto:

* **Incorrecto o Inestable (reenviador de registros):** Para las integraciones que reciben registros a través de un [reenviador de registros](https://docs.wirespeed.co/es/integrations/log-forwarders.md), el banner indica que no se reciben eventos, o que se descartan o rechazan, e incluye un enlace a la guía [Uso de datos del reenviador](https://docs.wirespeed.co/es/integrations/forwarder-data-usage.md#forwarder-health) en ese texto. La pestaña Uso de datos muestra el mismo detalle.
* **Incorrecto (integración de nivel crítico):** Para fuentes de detección, fuentes de registros, agentes de punto de conexión y proveedores de identidad, el banner indica que la integración puede no poder enviar o recibir datos de forma fiable, incluidas las acciones de remediación automatizadas, y le invita a comprobar la configuración o a ponerse en contacto con el soporte.
* **Incorrecto (otros tipos de integración):** El banner indica cuánto tiempo lleva fallando la integración.
* **Inestable:** El banner indica que la integración experimenta fallos intermitentes y muestra cuándo cambió el estado por última vez.
* **En silencio:** Un banner informativo explica que no han llegado eventos recientemente y que no se envían notificaciones mientras la integración está en silencio.

Si el proveedor publica una página de estado, los banners Incorrecto e Inestable incluyen un enlace a ella.

### Panel de actividad de 30 días

La página de configuración de integraciones incluye un panel de salud encima de la lista de integraciones con dos vistas:

* **Gráfico de donut** — muestra el recuento actual de integraciones en cada estado de salud.
* **Barra de actividad** — una sola barra proporcional que muestra el volumen agregado de Éxitos (verde), Advertencias (amarillo) y Errores (rojo) registrados en todas las integraciones durante los últimos 30 días. Al pasar el cursor sobre un segmento se muestra el recuento total de ese tipo y las principales integraciones que contribuyen por volumen. Al hacer clic en el segmento Errores o Advertencias se navega a la lista de integraciones filtrada por el estado de salud correspondiente.

## Cómo se determina el estado de salud

Wirespeed evalúa el estado de salud a partir de los registros de actividad recientes de cada integración. La evaluación se ejecuta automáticamente cada hora.

El sistema aplica umbrales distintos según lo que haga una integración:

* **Fuentes de detección y de registros** (p. ej. CrowdStrike, SentinelOne, Microsoft Defender) se supervisan de forma más agresiva. Los errores que persisten durante 4 horas, o una tasa de errores alta en una sola hora, activarán un estado Incorrecto.
* **Agentes de punto de conexión y proveedores de identidad** (p. ej. Jamf Pro, Okta, Entra ID) se marcan como Incorrectos si se producen errores en tres días naturales consecutivos.
* **Acciones de remediación, entrega de notificaciones, webhooks y tickets** (p. ej. aislamiento de punto de conexión, deshabilitación de usuario, entrega de mensajes de Slack, Jira) se marcan como Inestables tras errores que persisten durante 4 horas **y** al menos un fallo posterior confirma que el problema sigue ocurriendo (un solo error seguido de tiempo de inactividad no escala). Una vez Inestable, estas rachas de fallo permanecen abiertas hasta que la acción vuelve a realizarse correctamente (o ha pasado aproximadamente una semana sin más errores) — el silencio por inactividad más corto que eso no las devuelve a Correcto.
* **Integraciones de enriquecimiento** (p. ej. inteligencia de amenazas, búsqueda de IP, reputación de archivos) reciben una ventana más larga: los errores deben persistir durante 24 horas antes de que la integración se marque como Incorrecta.

Una integración no volverá inmediatamente a Correcto después de resolver un problema.

* Para la supervisión de detección, registros, identidad, punto de conexión y enriquecimiento, Wirespeed requiere un periodo de silencio de 24 horas sin errores ni advertencias en las áreas afectadas antes de que se borre el estado. Esto evita el parpadeo causado por recuperaciones transitorias.
* Para las acciones de remediación, notificación, webhook y tickets, una racha de fallo Inestable abierta se borra cuando se registra una ejecución correcta, o cuando no ha habido más errores durante aproximadamente una semana (no cuando la integración simplemente está inactiva durante un periodo más corto). Tras ese borrado por éxito o inactividad, el periodo de silencio habitual sigue aplicándose para que una sola recuperación no haga parpadear el distintivo.

Las integraciones en una ventana de mantenimiento configurada se muestran como **Pendiente** durante ese periodo y se excluyen de la evaluación de salud.

## Notificaciones por correo electrónico

> [!WARNING]
>
> Las notificaciones por correo electrónico para las transiciones de salud se están desplegando gradualmente y es posible que aún no estén habilitadas para todas las cuentas. Los distintivos, banners, barra del panel y panel de actividad de la aplicación están disponibles ahora para todos los clientes.

Cuando las notificaciones por correo electrónico están habilitadas para su cuenta, Wirespeed enviará una alerta cuando una integración pase a un nuevo estado de salud:

* **Incorrecto** — se envía cuando una integración supera el umbral de fallo de su tipo.
* **Recuperado** — se envía cuando una integración vuelve a Correcto, o pasa a En silencio, tras un periodo en estado Incorrecto.

Las transiciones a Inestable se muestran en el producto (distintivos, banners, resumen de actividad diaria) pero no se envían por correo electrónico, para evitar ruido por advertencias intermitentes.

Una integración Correcta que pasa a En silencio no se notifica en ningún canal, ni tampoco una integración en silencio que vuelve a Correcto. Una integración Incorrecta o Inestable que pasa a En silencio se notifica como una recuperación, con las mismas reglas que una vuelta a Correcto. Una integración en silencio que pasa a Incorrecto se notifica como cualquier otra.

Las notificaciones respetan el silenciamiento a nivel de integración. Si un operador ha silenciado una integración, no se enviarán correos de transición de salud para esa integración.

## Preguntas frecuentes

> [accordion] ¿Por qué mi integración muestra Pendiente?
>
> Pendiente significa que aún se están recopilando datos de salud para esa integración, que la integración está en una ventana de mantenimiento activa o que el tipo de integración no está sujeto a la supervisión de salud. En las integraciones recién conectadas, el estado se actualizará en el primer ciclo de evaluación.

> [accordion] ¿Cuánto tarda en marcarse como Incorrecta una integración que falla?
>
> Depende del tipo de integración. Las fuentes de detección y de registros se marcan como Incorrectas tras 4 horas de errores persistentes o una tasa de errores alta en una sola hora. Los agentes de punto de conexión y los proveedores de identidad se marcan como Incorrectos tras errores en tres días naturales consecutivos. Las integraciones de remediación, notificación y tickets se marcan como Inestables tras 4 horas cuando los fallos se repiten (un error posterior al primero, sin una ejecución correcta entremedias). Las integraciones de enriquecimiento requieren 24 horas de errores persistentes antes de pasar a Incorrecto.

> [accordion] Mi integración está corregida. ¿Por qué sigue mostrando Incorrecto o Inestable?
>
> Para las fuentes de detección y similares supervisadas de forma continua, Wirespeed requiere un periodo de silencio de 24 horas sin errores ni advertencias antes de que el estado vuelva a Correcto. Eso evita el parpadeo durante recuperaciones parciales.
>
> Para tickets y otras acciones impulsadas por eventos, Inestable se borra con una ejecución correcta de esa acción (o cuando no ha habido más errores durante aproximadamente una semana), no solo por un breve intervalo de inactividad. Tras un éxito, el periodo de silencio sigue aplicándose antes de que el distintivo pase a Correcto.
>
> Si la integración se ha recuperado realmente y el estado no se ha actualizado, pruebe a desencadenar una comprobación de salud manual desde la página de configuración de [Integraciones](https://app.wirespeed.co/settings/integrations).

> [accordion] ¿Se me notificará cuando una integración se recupere?
>
> Sí. Cuando las notificaciones por correo electrónico están habilitadas para su cuenta, Wirespeed envía una notificación de recuperación cuando una integración vuelve a Correcto tras haber estado Incorrecta, o cuando un reenviador de registros Incorrecto pasa a En silencio.

> [accordion] ¿Por qué mi integración de Slack o Teams no muestra un estado de salud?
>
> Las integraciones de Slack, Teams y Email se supervisan al mismo nivel que las integraciones de remediación. Normalmente se mostrarán como Correctas cuando la entrega de mensajes funciona con normalidad, y pueden mostrar Inestable o Incorrecto si la entrega de mensajes falla de forma persistente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.