Síntomas
Es posible que vea uno o varios de los siguientes problemas. Otros problemas pueden dar lugar a los mismos problemas, por lo que debe usar las comprobaciones en Confirmar el problema para confirmar que una tarea de notificación se ha detenido es la causa.
- En los repositorios que no han usado GitHub Actions antes, como los nuevos repositorios, los flujos de trabajo no se ejecutan. La página de configuración del GitHub Actions repositorio y la página para agregar un ejecutor autohospedado devuelven un error 500. Los repositorios que ya usan GitHub Actions normalmente siguen funcionando.
- En las organizaciones que no han usado GitHub Actions antes, las páginas de configuración, ejecutores y grupos de ejecutores de la organización GitHub Actions devuelven un error 500. Si la empresa no ha usado GitHub Actions antes, los ejecutores de empresa y las páginas de grupos de ejecutores pueden producir un error de la misma manera.
- Una actualización o un parche en caliente, u otra ejecución de configuración que actualiza GitHub Actions, se pausa durante 15 minutos o más y, a continuación, se produce un error. El registro de configuración,
/data/user/common/ghe-config.log, contieneFailed to update the following host process. Este error también puede tener otras causas, especialmente durante una actualización. - El registro del sistema registra un mensaje nuevo aproximadamente cada segundo, que indica que una
SqlNotificationBackgroundWorktareais still running past its interval time. Las tareas estancadas en los procesos del agente de trabajo no registran este mensaje.
ghe-actions-check puede notificar que todos los servicios están en buen estado mientras se produce este problema, por lo que un resultado correcto no lo descarta.
Causas
GitHub Actions configura el almacenamiento para cada repositorio, usuario, organización y empresa la primera vez GitHub Actions que se usa allí. Este almacenamiento contiene registros de ejecutor y la otra configuración que GitHub Actions necesita.
Los GitHub Actions servicios se ejecutan como varios procesos. Cada proceso ejecuta tareas en segundo plano que comprueban las colas de notificaciones en las GitHub Actions bases de datos una vez por segundo y reconocen los cambios que encuentran. Algunas operaciones esperan hasta que otros procesos confirmen un cambio.
- La configuración inicial del almacenamiento espera a los dos procesos del servicio principal GitHub Actions,
actions-api-serveryactions-job-agent. - Una ejecución de configuración que actualiza GitHub Actions espera a los procesos del agente de trabajo, cuyos nombres terminan en
-job-agent.
Si una tarea en segundo plano de uno de estos procesos deja de funcionar, ya sea porque se bloquea o porque deja de ejecutarse, ese proceso deja de acusar recibo de los cambios, por lo que fallan las operaciones que esperan a ese proceso. La mayoría de las demás GitHub Actions actividades no dependen de las colas, por lo que el problema puede pasar desapercibido durante días, hasta que un nuevo repositorio lo necesite GitHub Actions o una ejecución de configuración lo actualice.
En los casos que GitHub se han investigado, la tarea no se recuperó por sí misma. No hay nada en GitHub Actions que lo reinicie y ghe-actions-check no detecta el problema. Al reiniciar los GitHub Actions servicios se inician nuevos procesos con nuevas tareas en segundo plano, lo que lo corrige. No se conoce la razón por la que la tarea se bloquea, por lo que el problema puede ocurrir de nuevo.
Confirmando el problema
Cada GitHub Actions proceso registra un latido cada 5 minutos mientras sus tareas de notificación funcionan. Cuando una tarea se bloquea en un proceso cuyo nombre termina en -api-server, ese proceso también registra un mensaje de tarea bloqueada aproximadamente una vez por segundo. Los procesos cuyos nombres terminan en -job-agent nunca registran mensajes de tarea detenidos, por lo que para esos procesos, solo los latidos muestran el problema.
-
Acceda por SSH al shell administrativo. En una configuración de alta disponibilidad, conéctese al servidor principal. En un clúster, ejecute estos comandos en cada nodo que ejecute GitHub Actions. Para enumerar esos nodos, ejecute
ghe-cluster-nodes --role actions. Para obtener más información, vea Acceder al shell administrativo (SSH). -
Para cada GitHub Actions proceso, cuente los latidos y los mensajes de tareas bloqueadas de los últimos 15 minutos. Si ha iniciado o reiniciado GitHub Actions hace menos de 15 minutos, espere hasta 15 minutos antes.
for p in actions-api-server actions-job-agent mps-api-server mps-job-agent token-api-server token-job-agent artifactcache-api-server artifactcache-job-agent; do log=$(sudo journalctl -t "$p" --since '15 min ago' --no-pager) hb=$(grep -c 'Deployment Notification Heartbeat' <<< "$log") case "$p" in *-job-agent) st="n/a" ;; *) st=$(grep -c 'SqlNotificationBackgroundWork.*still running past its interval' <<< "$log") ;; esac echo "$p: $hb heartbeats, $st stalled-task messages" doneLa salida tiene este aspecto. En este ejemplo, la tarea de notificación de
actions-api-serverse ha bloqueado.actions-api-server: 0 heartbeats, 900 stalled-task messages actions-job-agent: 3 heartbeats, n/a stalled-task messages mps-api-server: 3 heartbeats, 0 stalled-task messages mps-job-agent: 3 heartbeats, n/a stalled-task messages token-api-server: 3 heartbeats, 0 stalled-task messages token-job-agent: 2 heartbeats, n/a stalled-task messages artifactcache-api-server: 3 heartbeats, 0 stalled-task messages artifactcache-job-agent: 3 heartbeats, n/a stalled-task messages -
Use esta tabla para leer el resultado de cada proceso.
Resultado para un proceso Qué significa 2 o más pulsos de comprobación, y no más de unos pocos mensajes de tareas bloqueadas El proceso funciona. Una sola comprobación lenta puede registrar algunos mensajes de tarea detenidos. 0 latidos, mientras que otros procesos muestran 2 o más La tarea de notificación de este proceso se ha bloqueado. Aproximadamente 900 o más mensajes de tarea detenidos, lo que equivale a aproximadamente uno por segundo La tarea de notificación de este proceso se ha bloqueado. 1 latido, o más de unos pocos, pero menos de unos 900 mensajes de tareas atascadas Aún no está claro. Espere 15 minutos y vuelva a ejecutar los comandos. 0 heartbeats para cada proceso
GitHub Actions no se está ejecutando en este nodo. Compruebe que está conectado al nodo principal o a un nodo de clúster que ejecuta GitHub Actions. |
| 0 señales de latido solo para los dos procesos artifactcache | Esto se espera si ha deshabilitado el GitHub Actions servicio de caché. Para obtener más información, vea Utilidades de la línea de comandos. |
-
Compruebe que los procesos bloqueados coincidan con los síntomas.
- Los 500 errores se producen cuando
actions-api-serveroactions-job-agentse ha bloqueado. - Las ejecuciones de configuración fallan cuando un proceso cuyo nombre termina en
-job-agentse ha detenido.
Si ningún proceso se ha detenido o los procesos detenidos no coinciden con los síntomas, es probable que una tarea de notificación estancada no sea la causa. Consulte Cómo ponerse en contacto con Soporte de GitHub.
- Los 500 errores se producen cuando
-
Opcionalmente, para averiguar cuándo la tarea de un proceso cuyo nombre termina en
-api-serverse detuvo, vea su mensaje más reciente de tarea detenida. Reemplace PROCESS-NAME por el nombre del proceso.sudo journalctl -t PROCESS-NAME --since '15 min ago' --no-pager | grep 'SqlNotificationBackgroundWork.*still running past its interval' | tail -n 1La salida tiene este aspecto. Cada mensaje es una línea larga, abreviada aquí.
Mar 10 09:15:42 github-example-com-primary actions-api-server[2817]: {"logType": "ProductTrace", "logData": {"PreciseTimeStamp":"2026-03-10 09:15:42.1234","Level":"2", ... "Message":"Background task adcceb44-740e-44e8-a2cf-95c1d38db76c:Microsoft.TeamFoundation.Framework.Server.NotificationProcessor+SqlNotificationBackgroundWork:9442d144-43fd-4fe3-bdca-e460fdee6c01 is still running past its interval time and thus is delaying its next execution.\nThe next execution was supposed to occur 2.10:34:37.0512746 ago at 03/07/2026 22:41:05.", ... }}La fecha y hora después de
ago atindican aproximadamente cuándo la tarea se quedó atascada. Están en UTC, con la fecha en el orden de mes/día/año. El valor anterior a ellos muestra cuánto tiempo hace de eso, comoDAYS.HOURS:MINUTES:SECONDS. La parte de días solo aparece si fue hace un día o más.
Resolución del problema
Reinicie los GitHub Actions servicios. En una configuración de alta disponibilidad, ejecute todos los comandos en el servidor principal. En un clúster, ejecútelos en el nodo mySQL principal, que suele ser el nodo designado como mysql-master en el archivo de configuración del clúster. Para obtener más información, vea Inicializando el clúster.
Si una ejecución de configuración está en curso, espere a que finalice o produzca un error antes de empezar. Una ejecución que este problema bloquea falla después de 15 minutos o más.
Si tiene previsto ponerse en contacto con Soporte de GitHub acerca de este problema, lea Cómo ponerse en contacto con Soporte de GitHub antes de reiniciar.
Advertencia
Detener los servicios de GitHub Actions hace que GitHub Actions no esté disponible hasta que vuelva a iniciarlos. Los trabajos que se ejecutan al detener los servicios pueden producir un error. Si es posible, reinicie los servicios cuando se ejecuten pocos flujos de trabajo. Después del reinicio, vuelva a ejecutar los trabajos con errores. Los ejecutores autohospedados se vuelven a conectar por sí mismos.
-
Acceda por SSH al shell administrativo.
-
Compruebe que los GitHub Actions servicios y su almacenamiento están en buen estado.
ghe-actions-check ghe-actions-check -s blobCuando el almacenamiento es correcto, la última línea de la salida del segundo comando es
Blob Storage is healthy!. Si cualquiera de los comandos informa de que un servicio no llegó a estar en buen estado, o informa deStorage tests failed!, no continúe. Póngase en contacto con Soporte de GitHub en su lugar.ghe-actions-startejecuta la misma comprobación de almacenamiento, por lo que también fallaría. -
Detenga los GitHub Actions servicios.
ghe-actions-stopPara cada servicio, la salida incluye una línea que comienza por
Attempting to stop. Si la salida incluyeFailed to stop, continúe con el paso siguiente para volver a iniciar los servicios, póngase en contacto con Soporte de GitHub. -
Inicie los GitHub Actions servicios.
ghe-actions-startEsto puede tardar varios minutos. No lo interrumpa. Cuando finaliza, la última línea de la salida es
Actions was enabled!. Esto significa que los servicios se inician, no que están listos, así que compruébalos en el paso siguiente. Si el comando finaliza con un error en su lugar, GitHub Actions puede permanecer no disponible. Póngase en contacto con Soporte de GitHub inmediatamente. -
Compruebe que los servicios funcionan correctamente. Esto puede tardar unos minutos.
ghe-actions-checkCuando cada servicio es correcto, la salida tiene este aspecto.
MSSQL is healthy! Mps database is healthy! Mps nomad job is healthy! Mps AT health api is healthy! Token database is healthy! Token nomad job is healthy! Token AT health api is healthy! Actions database is healthy! Actions nomad job is healthy! Actions AT health api is healthy! Artifactcache database is healthy! Artifactcache nomad job is healthy! Artifactcache AT health api is healthy!Si ha deshabilitado el GitHub Actions servicio de caché, no se muestran las
Artifactcachelíneas. Mientras se inician los servicios, la salida también puede incluir líneas comoMps nomad job is not yet healthy (attempt 1 of 20), trying again in 10 seconds.... -
Dado que
ghe-actions-checkno puede detectar una tarea detenida, espere 15 minutos y, a continuación, vuelva a ejecutar la comprobación en Confirmar el problema . Cada proceso debe mostrar 2 o más latidos y no más de unos pocos mensajes de tarea detenidos. Si ha deshabilitado el GitHub Actions servicio de caché, los dosartifactcacheprocesos muestran0. -
Abra la GitHub Actions página de configuración de un repositorio afectado y compruebe que se carga. Si el modo de mantenimiento está habilitado, por ejemplo, porque va a actualizar, haga esto después de deshabilitar el modo de mantenimiento. La primera carga todavía puede producir un error. Si es así, espere un minuto y vuelva a cargar la página. Si la página sigue devolviendo un error 500, póngase en contacto con Soporte de GitHub. Para obtener más información, vea Administración de la configuración de Acciones de GitHub para un repositorio.
No es necesario limpiar el almacenamiento que no se pudo configurar. La próxima vez GitHub Actions se usa en un repositorio, usuario, organización o empresa afectados, GitHub Actions configura el almacenamiento que necesita. Es posible que los flujos de trabajo que deberían haberse ejecutado mientras se estaba produciendo el problema no se ejecutaran por sí solos. Si los necesita, vuelva a ejecutarlos.
La ejecución de una configuración con errores se vuelve a ejecutar
Si se produjo un error en una ejecución de configuración con Failed to update the following host process y un proceso cuyo nombre termina en -job-agent se había bloqueado, vuelva a ejecutar la ejecución de configuración después de reiniciar los servicios GitHub Actions. Si no se había bloqueado ningún proceso de agente de trabajo, no vuelva a ejecutarlo. Póngase en contacto con Soporte de GitHub en su lugar, ya que algo más probablemente causó el error.
Si la ejecución de configuración formaba parte de una actualización, aún no deshabilite el modo de mantenimiento. En una configuración de alta disponibilidad, permanezca en modo de mantenimiento hasta que haya actualizado todas las réplicas y la replicación esté actualizada. Para obtener más información, vea Actualizar con un paquete de actualización.
En un clúster, no siga estos pasos. Póngase en contacto con Soporte de GitHub en su lugar.
Advertencia
La ejecución ghe-config-apply interrumpe los servicios.
-
Si el modo de mantenimiento aún no está habilitado, habilítelo. Para obtener más información, vea Habilitar y programar el modo de mantenimiento.
-
Aplique la configuración.
ghe-config-applySi se produce un error en la ejecución de la configuración de nuevo, deje habilitado el modo de mantenimiento y póngase en contacto con Soporte de GitHub.
-
Cuando la configuración se ejecute correctamente, deshabilite el modo de mantenimiento. Si va a actualizar una configuración de alta disponibilidad, actualice primero cada réplica y espere hasta que la replicación esté al día.
Cómo evitar que vuelva a ocurrir
GitHub no sabe por qué la tarea se bloquea, por lo que no hay ninguna manera conocida de evitarlo. Puede encontrarlo antes de que afecte a los usuarios.
- Antes de actualizar o aplicar un hotpatch, compruebe si hay una tarea de notificación detenida, como se describe en Confirmar el problema. Si encuentra una tarea bloqueada, reinicie primero los servicios GitHub Actions. Esto puede impedir que la tarea detenida provoque un error en la ejecución de la configuración.
- Si reenvía los registros a un sistema de supervisión, alerte cuando un GitHub Actions proceso no registra
Deployment Notification Heartbeatdurante más de 15 minutos. Alerta también cuando los mensajes que contienen tantoSqlNotificationBackgroundWorkcomostill running past its intervalsiguen llegando durante más de 15 minutos. Para obtener más información, vea Reenvío de logs.
Contactar con Soporte de GitHub
Otros problemas pueden provocar los mismos errores 500 y errores de configuración. Si las comprobaciones no encuentran una tarea de notificación detenido, si una tarea se detiene de nuevo después del reinicio, si imprime Failed to stop, si ghe-actions-start ghe-actions-stop o ghe-actions-check notifica un error, o si no está seguro de alguno de estos pasos, póngase en contacto Soporte de GitHub en lugar de continuar. Para obtener más información, vea Crear un ticket de soporte.
Si ya ha abierto una incidencia, adjuntar un paquete de soporte técnico ayuda a Soporte de GitHub diagnosticar el problema más rápido. Genere un paquete de soporte extendido en cuanto observe el problema antes de reiniciar los GitHub Actions servicios. Los registros del momento en que la tarea se detuvo son los más útiles, y podrían tener varios días de antigüedad. Una agrupación de soporte extendido incluye registros de los últimos ocho días. Para obtener más información, vea Proporcionar datos al soporte técnico de GitHub.