gcloud: Wed Aug 3 09:18:38 UTC 2022

gcloud/compute/os-config/help

@@ -3,7 +3,7 @@ NAME
         instances
 
 SYNOPSIS
-    gcloud compute os-config GROUP [GCLOUD_WIDE_FLAG ...]
+    gcloud compute os-config GROUP | COMMAND [GCLOUD_WIDE_FLAG ...]
 
 DESCRIPTION
     Manage OS Config tasks for Compute Engine VM instances.
@@ -34,6 +34,13 @@ GROUPS
      vulnerability-reports
         Display vulnerability reports for a Compute Engine VM.
 
+COMMANDS
+    COMMAND is one of the following:
+
+     troubleshoot
+        Troubleshoot issues with the setup of VM Manager on a specified VM
+        instance.
+
 NOTES
     These variants are also available:
 

gcloud/compute/os-config/troubleshoot

@@ -0,0 +1,73 @@
+NAME
+    gcloud compute os-config troubleshoot - troubleshoot issues with the setup
+        of VM Manager on a specified VM instance
+
+SYNOPSIS
+    gcloud compute os-config troubleshoot INSTANCE_NAME [--zone=ZONE]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    gcloud compute os-config troubleshoot troubleshoots issues with the setup
+    of VM Manager on a specified VM instance
+
+    The troubleshoot command investigates the following settings or
+    configurations for your VM Manager setup:
+
+      ▪ Checks if the OS Config API is enabled in the project.
+      ▪ Checks if the required metadata is set up correctly in the VM
+        instance.
+      ▪ Checks if the latest version of the OS Config agent is running on the
+        VM instance.
+      ▪ Checks if a service account is attached to the VM instance.
+      ▪ Checks if the VM Manager service agent is enabled.
+      ▪ Checks if the VM instance has a public IP or Private Google Access.
+
+EXAMPLES
+    To troubleshoot an instance named my-instance in zone us-west1-a, run
+
+        $ gcloud compute os-config troubleshoot my-instance --zone=us-west1-a
+
+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
+     --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 variant is also available:
+
+        $ gcloud alpha compute os-config troubleshoot
+