Use debugging tools

This page explains tools that you can use to debug Container-Optimized OS.

Run the perf tool on Container-Optimized OS

By default, perf is installed on Container-Optimized OS. You can run perf on your cos instance from your shell command line.

If you have limited privilege, you might need to enable the use of the performance events system using the following command:

echo-1|sudotee/proc/sys/kernel/perf_event_paranoid

For information on how to use perf, refer to the perf manual and the kernel sysctl settings.

Enable kernel crash dump collection

In the rare event of a kernel panic, enabling kernel crash dump collection can help you and Cloud Customer Care determine the root cause. To enable crash dumps, see User Guide: Kernel Crash Dump Collection for COS in the open source documentation. This user guide explains how to collect kernel crash dumps on GKE nodes with Container-Optimized OS or Container-Optimized OS instances created from Compute Engine.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年10月24日 UTC.