gcloud: Tue Mar 1 04:29:52 UTC 2022

gcloud/alpha/compute/diagnose/export-logs

@@ -0,0 +1,72 @@
+NAME
+    gcloud alpha compute diagnose export-logs - triggers instance to gather
+        logs and upload them to a Cloud Storage Bucket
+
+SYNOPSIS
+    gcloud alpha compute diagnose export-logs INSTANCE_NAME
+        [--collect-process-traces] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (ALPHA) 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 alpha 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 alpha and might change without notice. If this
+    command fails with API permission errors despite specifying the correct
+    project, you might be trying to access an API with an invitation-only early
+    access allowlist. These variants are also available:
+
+        $ gcloud compute diagnose export-logs
+
+        $ gcloud beta compute diagnose export-logs
+