Issues

Un issue es el registro único de un problema: algo que encontraron las propias comprobaciones de Polylane, o una alerta que envió una herramienta conectada. El registro lleva la cuenta (huella, ocurrencias, veredicto, severidad); el hilo de la ejecución de corrección que lo trabaja es donde lees lo que ocurrió.

Qué hace

Cada detección pasa por un único ciclo de vida, sea cual sea su origen: se registra, una ejecución de corrección llega a un veredicto, un incidente confirmado se trabaja hasta una corrección y el issue se resuelve cuando el problema termina. No hay una cola de alertas en bruto que triar a mano. Los duplicados se fusionan con el issue que ya existe, así que un problema es un registro y un hilo.

De dónde vienen los issues

Cómo funciona

1. Un hallazgo se registra con una huella construida a partir de su origen: el recurso y la comprobación para las detecciones de Polylane, la integración y el id de alerta para las alertas de proveedores. Un disparo que coincide con un issue abierto incrementa su recuento de ocurrencias en lugar de crear un duplicado.
2. Una ejecución de corrección lee la carga bruta, la consulta detrás de la alerta, las métricas recientes y tu código, y después registra uno de dos veredictos: confirmed (un problema real) o dismissed (ruido o comportamiento esperado). Un hallazgo que pertenece a un issue ya abierto, o a uno resuelto recientemente, se une a ese issue en su lugar.
3. Un issue confirmado se trabaja hasta una corrección en el mismo hilo, salvo que el umbral mínimo de severidad del espacio de trabajo o el límite del plan lo retenga para que lo arranque una persona. La severidad es una de critical, high, medium, low o info, y la ejecución puede recalificarla una vez que ha leído la evidencia.
4. El issue se resuelve cuando el problema termina: una recuperación del proveedor, una comprobación posterior que vuelve limpia o una alerta que permanece en silencio. También puedes marcarlo como Resolved tú mismo. Si el mismo problema vuelve en 24 horas (más tiempo para los issues que señalan un defecto de código), el issue existente se reabre y su ejecución de corrección lo examina de nuevo.

Estados

Un issue también lleva resolvedAt una vez que el problema ha terminado, cualquiera que sea su estado.

Dónde encontrarlo

Abre Issues en la consola para explorar detecciones, filtrar por gravedad o estado y encontrar issues activos o retenidos. Cada issue tiene una página con sus evidencias, investigación, cronología y propiedades. Usa Investigate para iniciar una ejecución u Open thread para continuar la conversación. El campo _html_url de la API enlaza directamente a esta página, incluso para issues sin ejecución.

En Threads, el preajuste Fix runs muestra las conversaciones con el agente. El último mensaje de la ejecución contiene su resultado: un pull request, ninguna corrección necesaria o algo que requiere tu atención. La barra lateral abre las evidencias y cualquier escalado, con Open full page para ver el registro completo.

Cada cuenta de nube, integración y recurso de la topología tiene una pestaña Problems que lista las ejecuciones de corrección en ese ámbito. Un issue que nunca tuvo una ejecución aparece como una tarjeta en el feed; despliégala y usa Investigate para iniciar una. Desde scripts, el issue es un objeto de primera clase en la referencia de la API, que se lee con el ámbito issues:read y se edita con issues:write.

Relacionado

• Ejecuciones de corrección para cómo una ejecución llega a su veredicto y trabaja un issue confirmado.
• Threads para leer una transcripción y su evidencia.
• Escalations para qué ocurre cuando el agente te necesita.
• Clouds para las cuentas y recursos a los que se delimitan los issues.