gcloud alpha mldiagnostics profiler-session capture

NAME
gcloud alpha mldiagnostics profiler-session capture - create profiler sessions
SYNOPSIS
gcloud alpha mldiagnostics profiler-session capture PROFILER_SESSION --duration=DURATION [--async] [--device-tracer-level=DEVICE_TRACER_LEVEL; default="device-tracer-level-enabled"] [--host-tracer-level=HOST_TRACER_LEVEL; default="host-tracer-level-info"] [--is-trace-enabled] [--location=LOCATION] [--machine-learning-run=MACHINE_LEARNING_RUN] [--python-tracer-level=PYTHON_TRACER_LEVEL; default="python-tracer-level-disabled"] [--targets=[TARGETS,…]] [GCLOUD_WIDE_FLAG …]
DESCRIPTION
(ALPHA) Create a profiler session
EXAMPLES
To create the profiler session, run: 
gcloud alpha mldiagnostics profiler-session capture --location=us-central1 --machine-learning-run=my-ml-run --targets=my-target-1
POSITIONAL ARGUMENTS
ProfilerSession resource - Identifier. The name of the profiler session. Format: projects/{project}/locations/{location}/machineLearningRuns/{machine_learning_run}/profilerSessions/{profiler_session} This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

To set the project attribute:

  • provide the argument profiler_session on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

To set the location attribute:

  • provide the argument profiler_session on the command line with a fully specified name;
  • provide the argument --location on the command line;
  • set the property compute/region.

To set the machine-learning-run attribute:

  • provide the argument profiler_session on the command line with a fully specified name;
  • provide the argument --machine-learning-run on the command line.

This must be specified.

PROFILER_SESSION
ID of the profilerSession or fully qualified identifier for the profilerSession.

To set the profiler_session attribute:

  • provide the argument profiler_session on the command line.
REQUIRED FLAGS
--duration=DURATION
Duration for the profiler session.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--device-tracer-level=DEVICE_TRACER_LEVEL; default="device-tracer-level-enabled"
Device tracer level for the session. If the field is not set or unspecified, the default is DEVICE_TRACER_LEVEL_ENABLED. DEVICE_TRACER_LEVEL must be one of:
device-tracer-level-disabled
Tracer level is disabled.
device-tracer-level-enabled
Tracer level is enabled.
--host-tracer-level=HOST_TRACER_LEVEL; default="host-tracer-level-info"
Host tracer level for the session. If the field is not set or unspecified, the default is HOST_TRACER_LEVEL_INFO. HOST_TRACER_LEVEL must be one of:
host-tracer-level-critical
Tracer level is critical.
host-tracer-level-disabled
Tracer level is disabled.
host-tracer-level-info
Tracer level is info.
host-tracer-level-verbose
Tracer level is verbose.
--is-trace-enabled
Customer setting to enable trace level details for the session.
--location=LOCATION
For resources [profiler_session, targets], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value.
--machine-learning-run=MACHINE_LEARNING_RUN
For resources [profiler_session, targets], provides fallback value for resource machine-learning-run attribute. When the resource's full URI path is not provided, machine-learning-run will fallback to this flag value.
--python-tracer-level=PYTHON_TRACER_LEVEL; default="python-tracer-level-disabled"
Python tracer level for the session. If the field is not set or unspecified, the default is PYTHON_TRACER_LEVEL_DISABLED. PYTHON_TRACER_LEVEL must be one of:
python-tracer-level-disabled
Tracer level is disabled.
python-tracer-level-enabled
Tracer level is enabled.
ProfilerTarget resource - List of profiler targets. Targets on which profiler session to be started. If empty, control plan shall start profiler session on all the targets associated with ML Run. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

To set the project attribute:

  • provide the argument --targets on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

To set the location attribute:

  • provide the argument --targets on the command line with a fully specified name;
  • provide the argument --location on the command line;
  • set the property compute/region.

To set the machine-learning-run attribute:

  • provide the argument --targets on the command line with a fully specified name;
  • provide the argument --machine-learning-run on the command line.
--targets=[TARGETS,…]
IDs of the profilerTargets or fully qualified identifiers for the profilerTargets.

To set the profiler-target attribute:

  • provide the argument --targets on the command line.
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.

API REFERENCE
This command uses the hypercomputecluster/v1alpha API. The full documentation for this API can be found at: https://docs.cloud.google.com/cluster-director/docs
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.