create-cluster-diagnostic-data-job¶

Description¶

Creates a diagnostic job for the given cluster. The diagnostic data job is useful for troubleshooting purposes. The job collects logs and metrics (see –download-options to see available options) which are going to be bundled into a single file and will be available at the desired location (see –destination). General metadata about the diagnostics will also be included as the bundle-info.json file.

Synopsis¶

  create-cluster-diagnostic-data-job
--cluster-id <value>
--destination <value>
[--start-time <value>]
[--end-time <value>]
[--case-number <value>]
[--bundle-metadata <value>]
[--force | --no-force]
[--download-options <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton]

Options¶

--cluster-id (string)

ID of the Cluster.

--destination (string)

Destination of the diagnostics collection.

Possible values:

• UPLOAD_TO_CLOUDERA

• DOWNLOAD

--start-time (datetime)

The resulting bundle will contain logs/metrics after the specified start time. If not indicated, then 30 minutes ago from now is taken as the start time.

--end-time (datetime)

The resulting bundle will contain logs/metrics before the specified end time. If not indicated, then the current time is taken as the end time.

--case-number (string)

Optional support case number in case of UPLOAD_TO_CLOUDERA destination, otherwise only act as additional data.

--bundle-metadata (map)

Additional user-defined metadata information that is attached to the resulting bundle-info.json when posting the bundle.

Shorthand Syntax:

KeyName1=string,KeyName2=string

JSON Syntax:

{"string": "string"
  ...}

--force | --no-force (boolean)

Forced recreation of the diagnostic job.

--download-options (object)

Flags that denote which diagnostics to include for the cluster.

Shorthand Syntax:

includeClusterInfo=boolean,includeIstioSystem=boolean,includeSharedServices=boolean,includeKubeSystem=boolean

JSON Syntax:

{
  "includeClusterInfo": true|false,
  "includeIstioSystem": true|false,
  "includeSharedServices": true|false,
  "includeKubeSystem": true|false
}

Form Factors: public

--cli-input-json (string)

Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (boolean)

Prints a sample input JSON to standard output. Note the specified operation is not run if this argument is specified. The sample input can be used as an argument for --cli-input-json.

Output¶

id -> (string)

Identifier for each bundle collection.

status -> (string)

Status of the diagnostics collection request.

url -> (string)

This URL points to a download location if the destination is DOWNLOAD.

labels -> (map)

Additional key-value pair attributes associated with the Diagnostic Data Job.

key -> (string)

value -> (string)

Form Factors¶

public