Saltar al contenido
Flag Autopsy

Investigación forense de incidentes con feature flags

Encuentra el cambio de flag que rompió producción.

Flag Autopsy pone tu registro de cambios de flags junto a una gráfica de errores o latencia, encuentra el momento en que empezó el pico y ordena cada cambio según la probabilidad de que sea la causa. Obtienes un sospechoso principal, el tiempo que tardaron en apagarlo y un informe listo para el postmortem.

Cómo decide
CASE 0421errores de pago
  1. 1pricing_cache 25 % → 50 %
  2. 2checkout_v2 0 % → 50 %Sospechoso principal
  3. 3dark_mode activado

Qué es

Una herramienta forense para incidentes causados por feature flags. Lee registros de cambios de LaunchDarkly, Unleash, Flagsmith, GrowthBook, de tu propia tabla de auditoría o de notas sueltas.

Para quién es

Para ingenieros de guardia, responsables de despliegues y equipos SRE que necesitan saber rápido qué interruptor revertir, y para quienes escriben el postmortem después.

Qué resuelve

Cuando los errores se disparan, quizá cambiaron cinco flags en la última hora. En lugar de adivinar, ves qué cambio coincide con el pico y cuáles son las pruebas.

Haz la autopsia

Pega el registro de cambios y, si la tienes, la métrica alrededor del incidente. Todo se analiza en esta página y no se sube nada.

Líneas JSON, un array JSON o líneas de texto como: 14:02 mira turned on checkout_v2 in prod 50%

Hora y valor en cada línea, por ejemplo ⁦14:03,2.9⁩. Sirven la tasa de errores, el número de 5xx o la latencia p95. Opcional.

Solo hace falta sin métrica. Por ejemplo 14:03 o ⁦2026-10-21 14:03⁩.

Las conclusiones aparecen aquí

Pega un registro y pulsa Hacer la autopsia, o abre el caso de ejemplo para ver un informe completo.

Cómo decide

La puntuación es un indicio, no una prueba definitiva. Te dice dónde mirar primero.

  1. Detección del pico

    Cada punto se compara con la mediana de los puntos anteriores. El pico empieza cuando un valor llega al menos al doble del nivel normal y se sale claramente de su ruido habitual.

  2. Momento

    Los cambios hechos minutos antes del pico puntúan más alto. La puntuación baja a lo largo de la hora siguiente y se ignoran los cambios muy posteriores al inicio.

  3. Antes y después

    Para cada cambio se compara la métrica en los 15 minutos anteriores y posteriores. Una subida brusca suma puntos.

  4. Exposición

    Activar un flag o ampliar su despliegue aumenta la sospecha, más cuanto mayor es el salto. Apagar algo o cambiarlo fuera de producción la reduce.

  5. Confirmación

    Si al volver a apagar el flag la métrica se recupera en menos de 20 minutos, esa es la prueba más fuerte de todas.

  6. Buenas prácticas

    Aparte, señala hábitos que hacen más probables los incidentes: saltarse staging, saltos enormes, encendidos y apagados seguidos, cambios de madrugada y cambios sin autor.

Cómo se usa

  1. Exporta el registro

    Copia el registro de auditoría de tu herramienta de flags para la ventana del incidente, o escribe los cambios a mano con su hora.

  2. Añade la métrica

    Exporta la tasa de errores o la latencia desde tu panel como hora y valor. Si no tienes métrica, escribe el inicio del incidente.

  3. Lee el veredicto

    Revisa el sospechoso principal, sus pruebas y la gráfica. Las marcas muestran el momento exacto de cada cambio.

  4. Comparte el informe

    Copia el informe en el canal del incidente o descárgalo en Markdown para el postmortem.

Conviene saber

  • Las horas sin zona horaria se leen tal cual. Las que llevan zona se convierten a UTC, así que mantén ambas entradas en la misma zona.
  • Las líneas de texto se entienden mejor en inglés. Los campos JSON funcionan en cualquier idioma.
  • Coincidir en el tiempo no es ser la causa. Un despliegue o un pico de tráfico en el mismo momento no aparecen aquí.
  • Nada sale de tu navegador. Quita secretos y datos personales antes de compartir el informe.

Preguntas

¿Con qué herramientas de flags funciona?

Con cualquiera cuyo registro de auditoría puedas copiar. Se reconocen solos los campos habituales como key, flag, environment, user, from, to y rollout.

¿Y si no tengo métrica?

Escribe la hora de inicio del incidente. Los cambios se ordenarán solo por momento, exposición y entorno.

¿Por qué mi cambio en staging tiene cero?

Un cambio en staging no puede romper producción directamente, así que se descarta. Aun así cuenta como paso por staging para los cambios posteriores en producción.

¿La puntuación de sospecha es una probabilidad?

No. Es una suma ponderada de las pruebas con un tope de 95, porque una herramienta así nunca puede estar segura del todo.

Habla con el creador

¿Tienes una pregunta, una idea o una oferta de trabajo? Escribe por X o Telegram.

Apoya al creador

Si esta herramienta te ahorró tiempo, puedes enviar una propina a esta dirección EVM desde tu propia billetera.

0xd28Fd90eD69092bd01598f237aad33a0cc9c3EeA