Saltar al contenido

Runbook

Documenta cómo operar y reparar un servicio: comprobaciones, pasos, rollback, a quién llamar y cómo saber que ha funcionado.

Rellénalo y previsualízalo

Runbook

Procedimiento: Reiniciar el worker de pagos
Servicio: API de pagos de clientes
Responsable: Equipo de plataforma
Última revisión: 3 de agosto de 2030

1. Cuándo usar este runbook

Úsalo cuando los pagos lleven más de 10 minutos en cola y el panel muestre el worker caído.

2. Accesos y herramientas necesarios

Acceso de lectura al panel de monitorización
Acceso por shell al host de salto de producción
Ser miembro del grupo de guardia

3. Comprobaciones antes de empezar

1. Confirma que la alerta es real: abre el panel de Pagos y revisa el tamaño de la cola.
2. Revisa la página de estado por si hay una caída del proveedor.
3. Avisa en el canal de incidencias de que empiezas.

4. Pasos

1. Inicia sesión en el host de salto.
2. Ejecuta el comando de reinicio del servicio para el worker.
3. Espera 2 minutos.
4. Comprueba que el tamaño de la cola baja.
5. Comprueba que tres pagos recientes se han completado.

5. Cómo confirmar que ha funcionado

Cola por debajo de 50 y bajando, sin errores nuevos durante 10 minutos.

6. Si no funciona

Detén el worker, cambia el servicio a la versión anterior y escala al ingeniero de pagos.

7. A quién llamar después

Quién Cómo contactarlos
Ingeniero de pagos de guardia por la herramienta de avisos
Responsable de plataforma +00 000 000 0000
Responsable de atención al cliente, si hay clientes afectados canal de soporte

8. Advertencias

Nunca reinicies los dos workers a la vez. No vacíes la cola a mano.

9. Después

Anota en el registro de incidencias las horas y lo que se hizo. Abre un ticket si no se conoce la causa.

Las plantillas son un punto de partida cuidadoso, no asesoramiento jurídico. Cuando la ley sea relevante, comprueba qué se aplica donde estés.

TI y proyectos

Para qué sirve esta plantilla

Runbook para operar y reparar un servicio: responsables, comprobaciones, pasos, rollback, escalado y contactos, para que quien esté de guardia pueda actuar.

Es gratis rellenarlo en línea, no requiere cuenta y se descarga como documento de Word o PDF. Ver todas las plantillas de TI y proyectos

TI y proyectos

Qué debes rellenar

El formulario pide 13 datos. El documento se completa solo a medida que escribe.

  • Servicio o sistema

    Por ejemplo: API de pagos de clientes

  • Nombre del procedimiento

    Por ejemplo: Reiniciar el worker de pagos

  • Equipo responsable

    Por ejemplo: Equipo de plataforma

  • Última revisión

    Por ejemplo: 3 de agosto de 2030

  • Cuándo usar este runbook

    Indica qué alerta o síntoma lleva a alguien hasta aquí.

    Por ejemplo: Úsalo cuando los pagos lleven más de 10 minutos en cola y el panel muestre el worker caído.

  • Accesos y herramientas necesarios

    Uno por línea.

    Por ejemplo: Acceso de lectura al panel de monitorización Acceso por shell al host de salto de producción Ser miembro del grupo de guardia

  • Comprobaciones antes de empezar

    Numeradas, una por línea.

    Por ejemplo: 1. Confirma que la alerta es real: abre el panel de Pagos y revisa el tamaño de la cola. 2. Revisa la página de estado por si hay una caída del proveedor. 3. Avisa en el canal de incidencias de que empiezas.

  • Pasos

    Una acción por línea, con los comandos exactos cuando sea seguro.

    Por ejemplo: 1. Inicia sesión en el host de salto. 2. Ejecuta el comando de reinicio del servicio para el worker. 3. Espera 2 minutos. 4. Comprueba que el tamaño de la cola baja. 5. Comprueba que tres pagos recientes se han completado.

  • Cómo confirmar que ha funcionado

    Lo que verás cuando esté resuelto.

    Por ejemplo: Cola por debajo de 50 y bajando, sin errores nuevos durante 10 minutos.

  • Si no funciona (rollback)

    Cómo deshacer o volver atrás.

    Por ejemplo: Detén el worker, cambia el servicio a la versión anterior y escala al ingeniero de pagos.

  • A quién llamar después

    Una fila por cada contacto.

    Por ejemplo: Ingeniero de pagos de guardia | por la herramienta de avisos Responsable de plataforma | +00 000 000 0000 Responsable de atención al cliente, si hay clientes afectados | canal de soporte

  • Advertencias (opcional)opcional

    Cosas que lo empeoran.

    Por ejemplo: Nunca reinicies los dos workers a la vez. No vacíes la cola a mano.

  • Después (opcional)opcional

    Por ejemplo: Anota en el registro de incidencias las horas y lo que se hizo. Abre un ticket si no se conoce la causa.

TI y proyectos

Qué incluye

Las partes de este documento, en orden.

  1. 11. Cuándo usar este runbook
  2. 22. Accesos y herramientas necesarios
  3. 33. Comprobaciones antes de empezar
  4. 44. Pasos
  5. 55. Cómo confirmar que ha funcionado
  6. 66. Si no funciona
  7. 77. A quién llamar después
  8. 88. Advertencias
  9. 99. Después

Plantillas

Cómo funciona

  1. 01

    Rellena

    Escribe tus datos en el formulario. El documento se completa solo mientras escribes; haz clic en cualquier espacio para saltar a su campo.

  2. 02

    Revisa

    Léelo entero. Los espacios que no hayas rellenado siguen marcados, para que nada salga a medias.

  3. 03

    Descarga

    Guárdalo como documento de Word para seguir editándolo, o como PDF para enviarlo o imprimirlo.

Hazlo tuyo con IA

Ábrelo en el chat y pide cambios: más corto, más firme, para otra situación, en otro idioma.

Adáptalo con nerix

TI y proyectos

Preguntas que hace la gente

¿Qué datos pide esta plantilla?

El formulario solicita 13 datos, empezando por Servicio o sistema, Nombre del procedimiento, Equipo responsable, Última revisión, Cuándo usar este runbook. 2 más son opcionales.

¿Puedo descargar esta plantilla en Word o PDF?

Sí. Cuando hayas rellenado el formulario, guárdalo como documento de Word para seguir editándolo, o como PDF para enviarlo o imprimirlo. Es gratis y no necesitas cuenta.

¿Se envía a algún sitio lo que escribo?

No. Lo que escribes permanece en tu navegador mientras rellenas el documento. Solo se envía a nerix si eliges abrir la plantilla en el chat.

¿Son gratis estas plantillas de TI y proyectos?

La mayoría sí. Rellénelas y descárguelas gratis en Word o PDF, sin cuenta. Algunos documentos más largos son premium: gratis para rellenar, de pago único para descargar y marcados con su precio.

¿Nos hace seguros una política de seguridad?

Ningún documento lo logra por sí solo. Una política ayuda cuando coincide con lo que la gente hace de verdad: mantenla breve, explícasela a tu equipo y revísala cada año.

¿El acta de proyecto es solo para proyectos grandes?

No. Un proyecto pequeño también se beneficia, porque una página con el objetivo, los límites y quién decide evita la mayoría de las discusiones posteriores.