NAME

gcloud alpha spanner samples workload - generate gRPC traffic for a given sample app's backend service

SYNOPSIS

gcloud alpha spanner samples workload APPNAME [--duration=DURATION; default="1h"] [--port=PORT] [--target-qps=TARGET_QPS] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(ALPHA) Before sending traffic to the backend service, create the database and start the service with:

$ gcloud alpha spanner samples init APPNAME --instance-id=INSTANCE_ID $ gcloud alpha spanner samples backend APPNAME \ --instance-id=INSTANCE_ID

To run all three steps together, use:

$ gcloud alpha spanner samples run APPNAME --instance-id=INSTANCE_ID

EXAMPLES

To generate traffic for the 'finance' sample app, run:

$ gcloud alpha spanner samples workload finance

POSITIONAL ARGUMENTS

APPNAME

The sample app name, e.g. "finance".

FLAGS

--duration=DURATION; default="1h"

Duration of time allowed to run before stopping the workload.

--port=PORT

Port of the running backend service.

--target-qps=TARGET_QPS

Target requests per second.

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 spanner samples workload

$ gcloud beta spanner samples workload