Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Latest commit 91c3e1a Aug 10, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Release version Jun 26, 2014 Update Aug 18, 2014 Update Jul 8, 2014 do not rely on $HOME as it may not be set on some distributions Aug 10, 2016
gee_sample_log.txt Update gee_sample_log.txt Jul 3, 2014

This is a troubleshooting script for Compute Engine customer issues

Self diagnosis tool to identify issues with SSH login/accessibility of your linux based Google Compute Engine instance. Gather relevant diagnostic information in a single exchange for the support team. The tool does not aim to fix any issues, just log information for analysis.


Note: ideally you should provide --zone [zone of the instance] to avoid zone lookups or specify gcloud config set compute/zone [zone_name]

for an existing instance

gcloud compute instances add-metadata [instance_name] --metadata startup-script-url=

WARNING: the following command will reboot the machine if uptime is a concern you should snapshot and clone your disk and instance with the startup-script specified instead :

gcloud compute instances reset [instance_name]

if this fails with resource not ready you need to delete the instance keeping the disk take note of the instance configuration than recreate the instance with

gcloud compute instances describe [instance_name]
gcloud compute instances delete [instance_name] --keep-disks all
gcloud compute instances create [instance_name] --disk boot=yes name=[instance_disk_name] --metadata startup-script-url=

for a new instance

gcloud compute instances create [instance_name] --metadata startup-script-url=

You can inspect the output with

gcloud compute instances get-serial-port-output [instance_name]

once the instance is up.

you may use to deploy a modified version of this script to your own GCS bucket redefining the ACCOUNT PROJECT BUCKET variables in the script and calling your addinstance with[YOUR_BUCKET]/ defined as startup script.


The customer has privacy control with flags which skips the given section

[..] --skip=[network,metadata,authkeys,sshdconf,sshd,sys,usersec,traceroute]

Read the comments in the code to learn the reason for each command and how to interpret the output. Alternatively if network connection to cloud storage is still working the output can be directed to a file and that copied across after running the tool, which file than can be trimmed by the customer before sending it to the support team.

You can’t perform that action at this time.