Use debugging tools
This page explains tools that you can use to debug
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 | sudo tee /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-07-02 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-02 UTC."],[[["The `perf` tool is pre-installed on Container-Optimized OS."],["You can directly execute `perf` commands on your `cos` instance via the command line."],["Elevated permissions might be required to enable performance events, which can be achieved by using the provided command."],["For guidance on utilizing `perf`, consult the `perf` manual and kernel sysctl settings."]]],[]]
