NAME

gcloud beta compute diagnose export-logs - triggers instance to gather logs and upload them to a Cloud Storage Bucket

SYNOPSIS

gcloud beta compute diagnose export-logs INSTANCE_NAME [--collect-process-traces] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(BETA) Gathers logs from a running Compute Engine VM and exports them to a Google Cloud Storage Bucket. Outputs a path to the logs within the Bucket.

EXAMPLES

To export logs and upload them to a Cloud Storage Bucket, run:

$ gcloud beta compute diagnose export-logs example-instance \ --zone=us-central1

POSITIONAL ARGUMENTS

INSTANCE_NAME

Name of the instance to operate on. For details on valid instance names, refer to the criteria documented under the field 'name' at: https://cloud.google.com/compute/docs/reference/rest/v1/instances

FLAGS

--collect-process-traces

Collect a 10 minute trace of the running system. On Windows, this utilizes Windows Performance Recorder. It records CPU, disk, file, and network activity during that time.

--zone=ZONE

Zone of the instance to operate on. If not specified, you might be prompted to select a zone (interactive mode only). gcloud attempts to identify the appropriate zone by searching for resources in your currently active project. If the zone cannot be determined, gcloud prompts you for a selection with all available Google Cloud Platform zones.

To avoid prompting when this flag is omitted, the user can set the compute/zone property:

$ gcloud config set compute/zone ZONE

A list of zones can be fetched by running:

$ gcloud compute zones list

To unset the property, run:

$ gcloud config unset compute/zone

Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE.

GCLOUD WIDE FLAGS

These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

NOTES

This command is currently in beta and might change without notice. These variants are also available:

$ gcloud compute diagnose export-logs

$ gcloud alpha compute diagnose export-logs