Un incidente es una interrupción o degradación no planificada de un servicio. Gestionarlo bien tiene dos tiempos: la respuesta (mientras arde) y el aprendizaje (después). En la respuesta, lo que evita el caos son los roles claros —un comandante del incidente que coordina y decide (no arregla), personas técnicas que investigan y aplican la solución, y alguien de comunicaciones que informa a usuarios y al negocio— y unas fases: detectar, evaluar la gravedad, mitigar (restaurar el servicio ya, aunque sea con un apaño), resolver y cerrar. La prioridad número uno es recuperar el servicio, no encontrar la causa: eso viene después. Terminado el incidente se escribe un postmortem (o análisis post-incidente): un documento con la cronología, el impacto, qué falló y qué se hará para que no vuelva a pasar. Su regla de oro es ser blameless (sin culpa): se buscan causas —del sistema, del proceso—, no culpables, porque la gente actúa razonablemente con la información que tiene, y culpar solo consigue que la próxima vez se oculten los errores. El postmortem termina en acciones concretas con responsable y plazo (mejorar una alerta, añadir una validación, automatizar un paso), y ahí está el verdadero valor: cada incidente deja el sistema más resistente. La observabilidad es lo que permite detectar y diagnosticar; la gestión de incidentes es lo que convierte una caída inevitable en una mejora concreta en lugar de en un susto que se repite.
Ver índice de contenidos
Responder al incidente
Cuando algo se cae en producción, el enemigo es el caos: gente pisándose, nadie sabe quién decide, la información se pierde. Lo que lo evita son roles y fases definidos antes de que ocurra.
| Rol | Qué hace | Qué NO hace |
|---|---|---|
| Comandante del incidente | Coordina, prioriza y decide | No se pone a arreglar el fallo |
| Personas técnicas | Investigan y aplican la mitigación | No coordinan ni comunican al negocio |
| Comunicaciones | Informa a usuarios y a la organización | No investiga la causa técnica |
Mitigar primero, entender después
El error instintivo es lanzarse a buscar por qué falló mientras el servicio sigue caído. La prioridad es la contraria: restaurar el servicio cuanto antes, aunque sea con un apaño temporal (revertir el último despliegue, reiniciar, escalar, activar un modo degradado). Entender la causa raíz es importante, pero es trabajo del postmortem, no del momento del incidente. Confundir «mitigar» (parar el dolor) con «resolver» (arreglar de fondo) alarga las caídas: primero se corta la hemorragia, luego se investiga con calma.
El postmortem
El postmortem (o análisis post-incidente) es el documento que se escribe después de resolver el incidente. No es un trámite: es donde el fallo se convierte en aprendizaje. Sus secciones típicas:
| Sección | Qué recoge |
|---|---|
| Resumen e impacto | Qué pasó, a quién afectó, cuánto duró |
| Cronología | Los hechos en orden: detección, acciones, resolución |
| Causas | Qué falló y por qué, en el sistema y en el proceso |
| Qué funcionó y qué no | La respuesta misma: qué ayudó y qué estorbó |
| Acciones de mejora | Qué se hará para que no se repita, con responsable y plazo |
La regla que hace útil a un postmortem es que sea sin culpa (blameless). No se pregunta «¿quién rompió esto?», sino «¿qué hizo posible que esto se rompiera, y por qué pareció razonable en el momento?». La premisa es que las personas actúan de buena fe con la información que tienen; si alguien pudo borrar la base de datos con un comando, el problema no es esa persona, es que ese comando fuera tan fácil de ejecutar sin salvaguardas. Culpar tiene un efecto devastador: la próxima vez, la gente oculta los errores por miedo, y sin información honesta no hay aprendizaje. Un postmortem con culpables produce silencio; uno sin culpa produce sistemas mejores.
Que no se repita
Un postmortem que no cambia nada es tiempo perdido. El cierre del ciclo son las acciones de mejora: cada una con un responsable y un plazo, y con seguimiento hasta que se completan. Son lo que convierte el análisis en un sistema más resistente.
- Acciones concretas, no buenos deseos. «Añadir validación que impida el borrado sin confirmación», no «tener más cuidado».
- Con responsable y plazo. Una acción sin dueño ni fecha no se hace; se trata como cualquier tarea prioritaria.
- Atacar la causa, no el síntoma. Si la alerta no saltó, arreglar la alerta; no solo el fallo puntual de esta vez.
- Mejorar la detección. Muchas acciones son de observabilidad: alertas que faltaban, métricas que no se miraban.
- Automatizar lo manual y propenso a error. Si un paso a mano causó el incidente, el arreglo suele ser automatizarlo.
- Compartir el aprendizaje. El postmortem se difunde; otros equipos aprenden sin sufrir el mismo fallo.
- Revisar que las acciones se completen. Un postmortem archivado con acciones sin hacer no evita la repetición.
Todo el ciclo se apoya en poder ver el sistema. La observabilidad es lo que detecta el incidente (una alerta que salta), lo que da los datos para diagnosticarlo durante la respuesta, y lo que aporta la cronología objetiva al postmortem. Y muchas acciones de mejora consisten precisamente en mejorar la observabilidad: la alerta que debió saltar antes, la métrica que nadie vigilaba. Para los incidentes más graves —pérdida de datos, caída total— la preparación previa es la recuperación ante desastres.
Errores frecuentes
- Buscar la causa antes de restaurar el servicio. Primero se mitiga; la investigación va en el postmortem.
- No definir un comandante del incidente. Sin alguien que coordine, la respuesta es caótica y la gente se pisa.
- Postmortems con culpables. Generan miedo y ocultación; deben ser blameless, centrados en causas.
- Quedarse en el síntoma. Arreglar solo el fallo de hoy sin atacar por qué fue posible garantiza que vuelva.
- Acciones vagas o sin dueño. «Tener más cuidado» no es una acción; sin responsable ni plazo, no se hace.
- No comunicar durante el incidente. El silencio hacia usuarios y negocio multiplica el impacto percibido.
- Escribir el postmortem y archivarlo. Si no se difunde ni se completan las acciones, no sirvió de nada.
Preguntas frecuentes
¿Cómo se responde a un incidente en producción?
Responder a un incidente en producción de forma eficaz requiere organización y disciplina para evitar el caos que se produce cuando varias personas intentan solucionar un problema sin coordinación, y se basa en dos pilares: unos roles claros y unas fases definidas de antemano. En cuanto a los roles, es fundamental designar un comandante del incidente, que es la persona encargada de coordinar la respuesta, priorizar las acciones y tomar las decisiones, pero que precisamente por ello no debe ponerse a arreglar el fallo directamente, ya que su función es mantener la visión de conjunto y dirigir; junto a él, una o varias personas técnicas se ocupan de investigar el problema y aplicar la solución, mientras que una persona de comunicaciones se encarga de informar a los usuarios afectados y a la organización sobre el estado del incidente, liberando a los técnicos de esa tarea. Esta separación de responsabilidades evita que todos hagan lo mismo o que nadie coordine. En cuanto a las fases, la respuesta suele seguir una secuencia ordenada: primero detectar el incidente, idealmente de forma automática mediante alertas; después evaluar su gravedad e impacto para dimensionar la respuesta; a continuación mitigar, que es el paso más urgente y consiste en restaurar el servicio cuanto antes aunque sea con una solución temporal; luego resolver el problema de fondo; y finalmente cerrar el incidente. Un principio crucial es que la prioridad número uno durante el incidente es recuperar el servicio, no encontrar la causa, ya que la investigación detallada de por qué ocurrió se deja para después, en el análisis posterior. Confundir la mitigación, que consiste en detener el impacto cuanto antes con lo que sea necesario, como revertir un despliegue reciente, reiniciar, escalar recursos o activar un modo degradado, con la resolución de fondo del problema, alarga innecesariamente las caídas. En resumen, responder bien a un incidente consiste en activar roles claros con un comandante que coordina, seguir unas fases ordenadas y priorizar siempre restaurar el servicio antes que comprender la causa, dejando el aprendizaje profundo para la fase posterior.
¿Qué es un postmortem y para qué sirve?
Un postmortem, también llamado análisis post-incidente o retrospectiva de incidente, es un documento que se elabora después de haber resuelto un incidente en producción y cuyo propósito es analizar lo ocurrido para aprender de ello y evitar que vuelva a suceder. No se trata de un mero trámite burocrático ni de un informe para archivar, sino de la pieza que convierte un fallo en una fuente de mejora, y por eso se considera una de las prácticas más valiosas en la operación de servicios. Un buen postmortem suele recoger varias secciones. Un resumen del incidente y su impacto, que explica qué ocurrió, a quién y de qué manera afectó, y cuánto tiempo duró, para dimensionar la gravedad. Una cronología, que ordena los hechos en el tiempo, desde la detección hasta la resolución, incluyendo las acciones que se fueron tomando, lo que permite entender cómo se desarrolló el incidente y la respuesta. Un análisis de las causas, que identifica qué falló y por qué, tanto en el sistema como en los procesos, yendo más allá del síntoma inmediato. Una valoración de la propia respuesta, señalando qué funcionó bien y qué no durante la gestión del incidente, para mejorar la forma de responder en el futuro. Y, sobre todo, una lista de acciones de mejora concretas, que son los cambios que se llevarán a cabo para que el incidente no se repita. El valor del postmortem reside precisamente en esas acciones y en el aprendizaje colectivo que genera, ya que un incidente bien analizado deja al sistema y al equipo más preparados que antes. Para que cumpla su función, el postmortem debe elaborarse con una cultura sin culpa, centrada en las causas y no en señalar responsables, y debe difundirse para que otros equipos aprendan de él, así como dar seguimiento a que las acciones de mejora se completen realmente. Un postmortem que no deriva en cambios concretos o que se archiva sin más desperdicia su propósito.
¿Qué significa que un postmortem sea blameless (sin culpa)?
Que un postmortem sea blameless, es decir, sin culpa, significa que su análisis se centra en identificar las causas del incidente en el sistema y en los procesos, y no en señalar ni culpar a las personas que estuvieron involucradas, y es probablemente el principio más importante para que un postmortem resulte verdaderamente útil. La premisa de la que parte esta cultura sin culpa es que las personas, en general, actúan de buena fe y de forma razonable con la información y las herramientas que tienen disponibles en cada momento, de modo que cuando alguien comete un error que contribuye a un incidente, lo relevante no es la persona en sí, sino las condiciones del sistema o del proceso que hicieron posible ese error o que lo volvieron probable. Por ejemplo, si una persona pudo borrar accidentalmente una base de datos ejecutando un comando, el enfoque sin culpa no pregunta quién lo hizo para reprenderlo, sino por qué era posible ejecutar una acción tan destructiva de forma tan sencilla y sin salvaguardas, confirmaciones o mecanismos de protección; la causa a corregir es la ausencia de esas protecciones, no la persona. Este enfoque tiene una justificación muy práctica además de humana: culpar a las personas produce un efecto devastador sobre el aprendizaje, porque genera miedo, y el miedo lleva a que en el futuro la gente oculte los errores, no reporte los problemas a tiempo o no cuente toda la verdad de lo ocurrido, y sin información honesta y completa es imposible entender los incidentes y prevenirlos. En cambio, cuando las personas saben que no serán castigadas por errores cometidos de buena fe, colaboran abiertamente, comparten lo que realmente pasó y se puede llegar a las causas reales. Por eso un postmortem con culpables produce silencio y repetición de fallos, mientras que uno sin culpa produce transparencia, aprendizaje y sistemas más robustos. Ser blameless no significa que no haya responsabilidad, sino que la responsabilidad se orienta a mejorar el sistema colectivamente en lugar de a buscar a quién señalar, cambiando la pregunta de quién falló a qué hizo posible el fallo.
¿Por qué hay que restaurar el servicio antes de buscar la causa?
Hay que restaurar el servicio antes de dedicarse a buscar la causa raíz de un incidente porque, durante una interrupción en producción, la prioridad absoluta es reducir el impacto sobre los usuarios y el negocio, y ese impacto se detiene recuperando el servicio, no comprendiendo por qué falló, tarea esta última que puede llevar mucho tiempo y que puede realizarse con calma una vez restablecido el funcionamiento. La distinción clave es la que existe entre mitigar y resolver. Mitigar consiste en tomar las medidas necesarias para que el servicio vuelva a funcionar cuanto antes, aunque sea de forma temporal o imperfecta, mediante acciones como revertir el último despliegue que pudo introducir el problema, reiniciar componentes, escalar recursos para absorber una sobrecarga, redirigir el tráfico o activar un modo degradado que ofrezca al menos una funcionalidad básica. Resolver, en cambio, consiste en corregir de fondo el problema para que no vuelva a ocurrir, lo que requiere entender la causa y a menudo implementar cambios, algo que pertenece a una fase posterior. El error instintivo y muy común es lanzarse a investigar por qué ha fallado el sistema mientras este sigue caído, lo que prolonga innecesariamente la interrupción y el perjuicio, cuando en muchos casos existe una forma rápida de restaurar el servicio, como deshacer un cambio reciente, que permite parar el daño de inmediato aunque todavía no se sepa exactamente qué ocurrió. Una vez que el servicio está de nuevo operativo y los usuarios dejan de verse afectados, se dispone de tiempo y tranquilidad para investigar a fondo la causa raíz y aplicar la solución definitiva, todo ello documentado en el postmortem posterior. Esta filosofía de mitigar primero y entender después es un principio central de la gestión de incidentes, y confundir ambas cosas, quedándose atascado buscando la causa mientras el servicio permanece caído, es una de las formas más habituales de alargar las caídas y agravar su impacto. Por supuesto, comprender la causa es imprescindible, pero su lugar es después de haber detenido el sangrado.
¿Cómo consigo que un incidente no se repita?
Conseguir que un incidente no se repita es precisamente el objetivo último de toda la gestión de incidentes, y se logra a través de las acciones de mejora que surgen del postmortem, siempre que estas se definan bien y se lleven a cabo de verdad. El punto de partida es un buen análisis de las causas, que debe ir más allá del síntoma inmediato y llegar a entender qué hizo posible el fallo, tanto en el sistema como en los procesos, ya que si solo se corrige el síntoma puntual de esta vez sin atacar la causa subyacente, el incidente volverá a producirse de otra forma. A partir de ese análisis, se define una lista de acciones de mejora que deben cumplir varias condiciones para ser eficaces. Han de ser concretas y accionables, evitando los buenos deseos vagos como tener más cuidado, y formulándose como medidas específicas, por ejemplo añadir una validación que impida una operación peligrosa sin confirmación, mejorar una alerta que no saltó a tiempo, corregir una configuración o automatizar un paso manual. Cada acción debe tener un responsable claro y un plazo, porque una acción sin dueño ni fecha rara vez se completa, y conviene tratarlas con la misma prioridad que cualquier otro trabajo importante, haciendo seguimiento de su cumplimiento en lugar de dejar el postmortem archivado con las acciones pendientes, error muy común que anula todo el beneficio del análisis. Muchas de las acciones más valiosas suelen estar relacionadas con la detección, es decir, con mejorar la observabilidad, añadiendo alertas que faltaban o vigilando métricas que nadie miraba, de modo que un problema similar se detecte antes en el futuro; otras consisten en automatizar tareas manuales propensas a errores, ya que si un paso hecho a mano provocó el incidente, la solución robusta suele ser eliminar esa intervención manual. Además, es muy recomendable compartir y difundir el postmortem y su aprendizaje con otros equipos, para que puedan beneficiarse de la lección sin haber sufrido el mismo fallo. En definitiva, evitar la repetición depende de convertir el incidente en acciones de mejora concretas, con responsable y plazo, orientadas a la causa y no al síntoma, y de asegurarse de que esas acciones realmente se completen, cerrando así el ciclo de mejora continua.
¿Esto solo sirve para grandes empresas con equipos de SRE?
No, aunque las prácticas de gestión de incidentes y de postmortems se popularizaron en el ámbito de la ingeniería de confiabilidad de sitios de grandes empresas tecnológicas, sus principios son valiosos y aplicables a organizaciones y equipos de cualquier tamaño, adaptando su formalidad a la escala y las necesidades de cada caso. Es cierto que una gran empresa puede tener roles dedicados a tiempo completo, procesos muy formalizados, herramientas específicas y equipos de guardia estructurados, pero la esencia de estas prácticas no depende de ese despliegue de recursos, sino de unas ideas sencillas y universales que cualquier equipo puede adoptar con beneficio. Incluso en un equipo pequeño o en un proyecto modesto, tiene sentido acordar de antemano quién coordina cuando surge un problema serio, aunque esa persona asuma varios roles a la vez, y seguir la lógica de priorizar la restauración del servicio antes que la investigación de la causa. Del mismo modo, escribir un postmortem breve tras un incidente relevante, aunque sea un documento sencillo con la cronología, el impacto, las causas y unas pocas acciones de mejora, aporta un valor enorme para no repetir errores, y no requiere una gran infraestructura, solo la disciplina de hacerlo y la cultura adecuada. Precisamente la cultura sin culpa es quizá el elemento más importante y más transferible a cualquier tamaño de equipo, porque no cuesta dinero ni herramientas, sino una actitud de buscar causas en lugar de culpables, y es igual de necesaria en un equipo de tres personas que en uno de trescientas para fomentar la transparencia y el aprendizaje. Lo razonable es ajustar el nivel de formalidad al contexto: un equipo pequeño no necesita procesos pesados ni documentación exhaustiva para cada pequeña incidencia, pero sí se beneficia enormemente de aplicar los principios de coordinación, mitigación prioritaria, análisis sin culpa y acciones de mejora concretas ante los incidentes que importan. En resumen, estas prácticas no son un lujo exclusivo de grandes organizaciones, sino un conjunto de principios de sentido común que cualquier equipo que opere un servicio puede y debe adaptar a su realidad para operar de forma más fiable y aprender de los fallos.
Fuentes
Documentación oficial y material de la comunidad consultados para esta guía. Fecha de consulta: 28 de julio de 2026.
Aportes de la comunidad Underc0de
- Underc0de, foro. Dudas y pedidos generales. Operación de servicios.
- Underc0de, foro. Sección GNU/Linux. Administración de sistemas.
Documentación oficial
- Google SRE. Managing Incidents. Respuesta a incidentes con roles.
- Google SRE. Postmortem Culture: Learning from Failure. Cultura de postmortem sin culpa.
- PagerDuty. Incident Response Documentation. Guía abierta de respuesta a incidentes.
- Atlassian. Incident Postmortems. Cómo estructurar un postmortem.