.TH "GCLOUD_DATAPROC_CLUSTERS_DIAGNOSE" 1



.SH "NAME"
.HP
gcloud dataproc clusters diagnose \- run a detailed diagnostic on a cluster



.SH "SYNOPSIS"
.HP
\f5gcloud dataproc clusters diagnose\fR (\fICLUSTER\fR\ :\ \fB\-\-region\fR=\fIREGION\fR) [\fB\-\-end\-time\fR=\fIEND_TIME\fR] [\fB\-\-job\-ids\fR=\fIJOB_IDS\fR] [\fB\-\-start\-time\fR=\fISTART_TIME\fR] [\fB\-\-tarball\-access\fR=\fITARBALL_ACCESS\fR] [\fB\-\-tarball\-gcs\-dir\fR=\fITARBALL_GCS_DIR\fR] [\fB\-\-yarn\-application\-ids\fR=\fIYARN_APPLICATION_IDS\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Run a detailed diagnostic on a cluster.



.SH "EXAMPLES"

To diagnose a cluster, run:

.RS 2m
$ gcloud dataproc clusters diagnose my\-cluster \-\-region=us\-central1
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Cluster resource \- The name of the cluster to diagnose. The arguments in this
group can be used to specify the attributes of this resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5cluster\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fICLUSTER\fR

ID of the cluster or fully qualified identifier for the cluster.

To set the \f5cluster\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5cluster\fR on the command line.
.RE
.sp

This positional argument must be specified if any of the other arguments in this
group are specified.

.TP 2m
\fB\-\-region\fR=\fIREGION\fR

Dataproc region for the cluster. Each Dataproc region constitutes an independent
resource namespace constrained to deploying instances into Compute Engine zones
inside the region. Overrides the default \f5dataproc/region\fR property value
for this command invocation.

To set the \f5region\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5cluster\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-region\fR on the command line;
.IP "\(bu" 2m
set the property \f5dataproc/region\fR.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-end\-time\fR=\fIEND_TIME\fR

Time instant to stop the diagnosis at (in %Y\-%m\-%dT%H:%M:%S.%fZ format).

.TP 2m
\fB\-\-job\-ids\fR=\fIJOB_IDS\fR

A list of jobs on which to perform the diagnosis.

.TP 2m
\fB\-\-start\-time\fR=\fISTART_TIME\fR

Time instant to start the diagnosis from (in %Y\-%m\-%dT%H:%M:%S.%fZ format).

.TP 2m
\fB\-\-tarball\-access\fR=\fITARBALL_ACCESS\fR

Target access privileges for diagnostic tarball. \fITARBALL_ACCESS\fR must be
one of: \fBGOOGLE_CLOUD_SUPPORT\fR, \fBGOOGLE_DATAPROC_DIAGNOSE\fR.

.TP 2m
\fB\-\-tarball\-gcs\-dir\fR=\fITARBALL_GCS_DIR\fR

The output Cloud Storage directory for the diagnostic tarball. If not specified,
a task\-specific directory in the cluster's staging bucket will be used.

.TP 2m
\fB\-\-yarn\-application\-ids\fR=\fIYARN_APPLICATION_IDS\fR

A list of yarn applications on which to perform the diagnosis.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha dataproc clusters diagnose
.RE

.RS 2m
$ gcloud beta dataproc clusters diagnose
.RE