Risoluzione dei problemi di blocco parziale delle vCPU
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Linux
Questo documento descrive come risolvere i problemi di soft lockup delle vCPU. Un soft lockup
si verifica quando la vCPU di un'istanza di macchina virtuale (VM) non è in grado di eseguire una nuova attività
per più di 20 secondi. La maggior parte dei blocchi software è causata da bug nel software
dell'applicazione.
I soft lockup possono causare la mancata risposta delle VM per brevi periodi di tempo,
interrompere l'accesso SSH alle VM e attivare timeout o failover delle applicazioni. Le VM
che riscontrano un blocco parziale potrebbero anche avere un utilizzo della CPU insolitamente alto o
insolitamente basso, a seconda della causa esatta del blocco parziale.
Identificare i blocchi parziali
Per identificare se la tua VM sta riscontrando un soft lockup, esegui una delle
seguenti operazioni:
Dopo aver identificato che si sta verificando un blocco temporaneo, prova i seguenti
passaggi per la risoluzione dei problemi:
Controlla il sito del fornitore del sistema operativo per verificare la presenza di errori noti nella tua versione del sistema operativo. A volte
potresti trovare riferimenti a moduli del kernel specifici nelloanalisi dello stacke che
suggeriscono una particolare funzione o operazione coinvolta.
Identifica se il blocco soft si ripete con una determinata frequenza, ad esempio
in concomitanza con un carico elevato o determinate attività. Se i soft lockup
sono correlati a un carico elevato, potrebbe essere necessario riconfigurare il carico di lavoro, ad esempio utilizzando una VM più grande o suddividendo il carico su più VM.
Controlla se i soft lockup sono correlati a modifiche all'ambiente di runtime, ad esempio nuove implementazioni di software o aggiornamenti delle immagini del sistema operativo.
Valuta se si sono verificati eventi di manutenzione intorno al momento del soft lockup esaminando gli audit log per gli audit log degli eventi di sistema.
Se i passaggi per la risoluzione dei problemi precedenti non hanno risolto il problema,
invia una richiesta di assistenza
e includi tutte le informazioni che hai raccolto durante la risoluzione dei problemi.
Best practice per evitare i soft lockup
Per evitare che le tue VM subiscano blocchi temporanei, ti consigliamo di
implementare le seguenti best practice:
Assicurati di aver configurato i componenti ridondanti appropriati per il tuo sistema, come i cluster ad alta disponibilità, per fornire una funzionalità di failover se una determinata VM subisce un soft lockup prolungato. Per ulteriori informazioni,
vedi Progettare sistemi resilienti.
Testa il tuo carico di lavoro con eventi di manutenzione simulati per scoprire come funziona durante la migrazione live (se abilitata), in particolare durante il test di carico.
Se esegui un kernel Linux personalizzato o moduli personalizzati nella tua VM, testa le nuove modifiche sotto carico prima di eseguirne il deployment nell'ambiente di produzione.
Conferma che le modifiche personalizzate non ti impediscono di ricevere assistenza
dal fornitore del sistema operativo.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eSoft lockups occur when a VM's vCPU cannot run a new task for over 20 seconds, often due to application software bugs.\u003c/p\u003e\n"],["\u003cp\u003eSoft lockups can cause VMs to become unresponsive, disrupt SSH access, and trigger application timeouts or failovers.\u003c/p\u003e\n"],["\u003cp\u003eSoft lockups can be identified by reviewing serial port output or operating system logs for a soft lockup stack trace, such as \u003ccode\u003ewatchdog: BUG: soft lockup - CPU#3 stuck for 22s!\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshooting soft lockups involves checking for OS vendor known issues, identifying patterns with high load or environment changes, and evaluating maintenance events.\u003c/p\u003e\n"],["\u003cp\u003ePreventive measures include using redundant components, compute-optimized machine families for intense workloads, testing with simulated maintenance events, and keeping the OS up to date.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting vCPU soft lockups\n\nLinux\n\n*** ** * ** ***\n\nThis document describes how to troubleshoot vCPU soft lockups. A *soft lockup*\noccurs when a virtual machine (VM) instance's vCPU is unable to run a new task\nfor more than 20 seconds. Most soft lockups are caused by bugs in application\nsoftware.\n\nSoft lockups can cause VMs to become unresponsive for short periods of time,\ndisrupt SSH access to VMs, and trigger application timeouts or failover. VMs\nthat are experiencing a soft lockup might also have unusually high or\nunusually low CPU utilization, depending on the exact cause of the soft lockup.\n\nIdentify soft lockups\n---------------------\n\nTo identify whether your VM is experiencing a soft lockup, do one of the\nfollowing:\n\n- If you previously enabled [serial port output logging](/compute/docs/troubleshooting/viewing-serial-port-output#enable-stackdriver) for your VM, [review serial port output](/compute/docs/troubleshooting/viewing-serial-port-output#viewing_serial_port_output) for a soft lockup stack trace.\n- Review your VM's operating system logs (`/var/log/messages`) for a soft lockup stack trace.\n\n**Example soft lockup stack trace** \n\n```\nwatchdog: BUG: soft lockup - CPU#3 stuck for 22s!\n```\n\nTo detect future soft lockups, you can do the following:\n\n1. [Enable serial port output logging](/compute/docs/troubleshooting/viewing-serial-port-output#enable-stackdriver).\n\n2. [Create a log-based alerting policy](/logging/docs/alerting/log-based-alerts#lba-definition)\n for the following log:\n\n ```\n resource.type=\"gce_instance\" log_id(\"serialconsole.googleapis.com/serial_port_1_output\") textPayload=~\"watchdog.*lockup\"\n ```\n | **Note:** When you test the query, it is likely that no logs appear. This is expected behavior.\n\nTroubleshoot soft lockups\n-------------------------\n\nAfter you've identified that a soft lockup is occurring, try the following\ntroubleshooting steps to resolve the issue:\n\n1. Check your OS vendor's site for known errors with your OS version. Sometimes you might find reference to specific kernel modules in the stack trace that suggests a particular function or operation that is involved.\n2. Identify whether the soft lockup repeats with any frequency, such as coinciding with high load or certain activities. If the soft lockups correlate with high load, you might need to reconfigure your workload, for example by using a larger VM or splitting the load across more VMs.\n3. Check if the soft lockups correlate with any changes to your runtime environment such as new software deployments or OS image updates.\n4. Evaluate whether any [maintenance events](/compute/docs/instances/host-maintenance-overview#maintenanceevents) have taken place around the time of the soft lockup, by reviewing [audit logs](/compute/docs/logging/audit-logging#viewing_logs) for system event audit logs.\n\nIf the proceeding troubleshooting steps didn't resolve the issue,\n[file a support case](/support/docs/customer-care-procedures#create_a_support_case)\nand include all of the information you gathered from troubleshooting.\n\nBest practices to avoid soft lockups\n------------------------------------\n\nTo help prevent your VMs from experiencing soft lockups, we recommend\nimplementing the following best practices:\n\n- Ensure that you have appropriate redundant components configured for your system, such as high availability clusters, to provide a failover capability if a particular VM experiences a prolonged soft lockup. For more information, see [Designing resilient systems](/compute/docs/tutorials/robustsystems).\n- For compute-intensive workloads, consider using [compute-optimized machine families](/compute/docs/compute-optimized-machines).\n- Test your workload with simulated [maintenance events](/compute/docs/instances/host-maintenance-overview#maintenanceevents) to learn how your workload performs during live migration (if enabled), particularly under load testing.\n- If you're running a custom Linux Kernel or custom modules in your VM, test new changes under load before deploying them to your production environment. Confirm that your custom changes don't disqualify you from receiving support from your OS vendor.\n- Keep your operating system up to date. For more information, see [Operating system details](/compute/docs/images/os-details)."]]
