- NAME
-
- gcloud compute instance-groups managed set-autoscaling - set autoscaling parameters of a managed instance group
- SYNOPSIS
-
-
gcloud compute instance-groups managed set-autoscaling
NAME
--max-num-replicas
=MAX_NUM_REPLICAS
[--cool-down-period
=COOL_DOWN_PERIOD
] [--cpu-utilization-predictive-method
=CPU_UTILIZATION_PREDICTIVE_METHOD
] [--custom-metric-utilization
=[metric
=METRIC
],[utilization-target
=UTILIZATION-TARGET
],[utilization-target-type
=UTILIZATION-TARGET-TYPE
]] [--description
=DESCRIPTION
] [--min-num-replicas
=MIN_NUM_REPLICAS
] [--mode
=MODE
] [--remove-stackdriver-metric
=METRIC
] [--scale-based-on-cpu
] [--scale-based-on-load-balancing
] [--scale-in-control
=[max-scaled-in-replicas
=MAX-SCALED-IN-REPLICAS
],[max-scaled-in-replicas-percent
=MAX-SCALED-IN-REPLICAS-PERCENT
],[time-window
=TIME-WINDOW
]] [--set-schedule
=SCHEDULE_NAME
] [--stackdriver-metric-filter
=FILTER
] [--stackdriver-metric-single-instance-assignment
=ASSIGNMENT
] [--stackdriver-metric-utilization-target
=TARGET
] [--stackdriver-metric-utilization-target-type
=TARGET_TYPE
] [--target-cpu-utilization
=TARGET_CPU_UTILIZATION
] [--target-load-balancing-utilization
=TARGET_LOAD_BALANCING_UTILIZATION
] [--update-stackdriver-metric
=METRIC
] [--region
=REGION
|--zone
=ZONE
] [--schedule-cron
=CRON_EXPRESSION
--schedule-description
=DESCRIPTION
--schedule-duration-sec
=DURATION
--schedule-min-required-replicas
=MIN_REQUIRED_REPLICAS
--schedule-time-zone
=TIME_ZONE
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
gcloud compute instance-groups managed set-autoscaling
sets autoscaling parameters of specified managed instance group.Autoscalers can use one or more autoscaling signals. Information on using multiple autoscaling signals can be found here: https://cloud.google.com/compute/docs/autoscaler/multiple-signals
- POSITIONAL ARGUMENTS
-
NAME
- Name of the managed instance group to operate on.
- REQUIRED FLAGS
-
--max-num-replicas
=MAX_NUM_REPLICAS
- Maximum number of replicas Autoscaler can set.
- OPTIONAL FLAGS
-
--cool-down-period
=COOL_DOWN_PERIOD
- The number of seconds that your application takes to initialize on a VM instance. This is referred to as the initialization period. Specifying an accurate initialization period improves autoscaler decisions. For example, when scaling out, the autoscaler ignores data from VMs that are still initializing because those VMs might not yet represent normal usage of your application. The default initialization period is 60 seconds. See $ gcloud topic datetimes for information on duration formats. Initialization periods might vary because of numerous factors. We recommend that you test how long your application may take to initialize. To do this, create a VM and time your application's startup process.
--cpu-utilization-predictive-method
=CPU_UTILIZATION_PREDICTIVE_METHOD
-
Indicates whether to use a predictive algorithm when scaling based on CPU.
CPU_UTILIZATION_PREDICTIVE_METHOD
must be one of:none
- (Default) No predictions are made when calculating the number of VM instances.
optimize-availability
- Predictive autoscaling predicts the future values of the scaling metric and scales the group in advance to ensure that new VM instances are ready in time to cover the predicted peak.
--custom-metric-utilization
=[metric
=METRIC
],[utilization-target
=UTILIZATION-TARGET
],[utilization-target-type
=UTILIZATION-TARGET-TYPE
]-
Adds a target metric value for the Autoscaler to use.
metric
- Protocol-free URL of a Google Cloud Monitoring metric.
utilization-target
- Value of the metric Autoscaler aims to maintain (greater than 0.0).
utilization-target-type
-
How target is expressed. Valid values: DELTA_PER_MINUTE, DELTA_PER_SECOND,
GAUGE.
Mutually exclusive with
--update-stackdriver-metric
.
--description
=DESCRIPTION
- Notes about Autoscaler.
--min-num-replicas
=MIN_NUM_REPLICAS
- Minimum number of replicas Autoscaler can set.
--mode
=MODE
-
Set the mode of an autoscaler for a managed instance group.
You can turn off or restrict a group's autoscaler activities without affecting your autoscaler configuration. The autoscaler configuration persists while the activities are turned off or restricted, and the activities resume when the autoscaler is turned on again or when the restrictions are lifted.
MODE
must be one of:off
- Turns off autoscaling, while keeping the new configuration.
on
- Permits autoscaling to scale out and in (default for new autoscalers).
only-scale-out
- Permits autoscaling to scale only out and not in.
only-up
-
(DEPRECATED) Permits autoscaling to scale only out and not in.
Value
only-up
is deprecated. Use--mode only-scale-out
instead.
--remove-stackdriver-metric
=METRIC
- Stackdriver metric to remove from autoscaling configuration. If the metric is the only input used for autoscaling the command will fail.
--scale-based-on-cpu
- Autoscaler will be based on CPU utilization.
--scale-based-on-load-balancing
- Use autoscaling based on load balancing utilization.
--scale-in-control
=[max-scaled-in-replicas
=MAX-SCALED-IN-REPLICAS
],[max-scaled-in-replicas-percent
=MAX-SCALED-IN-REPLICAS-PERCENT
],[time-window
=TIME-WINDOW
]-
Configuration that allows slower scale in so that even if Autoscaler recommends
an abrupt scale in of a managed instance group, it will be throttled as
specified by the parameters.
max-scaled-in-replicas
- Maximum allowed number of VMs that can be deducted from the peak recommendation during the window. Possibly all these VMs can be deleted at once so the application needs to be prepared to lose that many VMs in one step. Mutually exclusive with 'max-scaled-in-replicas-percent'.
max-scaled-in-replicas-percent
- Maximum allowed percent of VMs that can be deducted from the peak recommendation during the window. Possibly all these VMs can be deleted at once so the application needs to be prepared to lose that many VMs in one step. Mutually exclusive with 'max-scaled-in-replicas'.
time-window
- How long back autoscaling should look when computing recommendations. The autoscaler will not resize below the maximum allowed deduction subtracted from the peak size observed in this period. Measured in seconds.
--set-schedule
=SCHEDULE_NAME
- Unique name for the scaling schedule.
--stackdriver-metric-filter
=FILTER
- Expression for filtering samples used to autoscale, see https://cloud.google.com/monitoring/api/v3/filters.
--stackdriver-metric-single-instance-assignment
=ASSIGNMENT
-
Value that indicates the amount of work that each instance is expected to
handle. Autoscaler maintains enough VMs by dividing the available work by this
value. Mutually exclusive with
-stackdriver-metric-utilization-target-type
,-stackdriver-metric-utilization-target-type
, and--custom-metric-utilization
. --stackdriver-metric-utilization-target
=TARGET
-
Value of the metric Autoscaler aims to maintain. When specifying this flag you
must also provide
--stackdriver-metric-utilization-target-type
. Mutually exclusive with--stackdriver-metric-single-instance-assignment
and--custom-metric-utilization
. --stackdriver-metric-utilization-target-type
=TARGET_TYPE
-
Value of the metric Autoscaler aims to maintain. When specifying this flag you
must also provide
--stackdriver-metric-utilization-target
. Mutually exclusive with--stackdriver-metric-single-instance-assignment
and--custom-metric-utilization
.TARGET_TYPE
must be one of:delta-per-minute
,delta-per-second
,gauge
. --target-cpu-utilization
=TARGET_CPU_UTILIZATION
- Autoscaler aims to maintain CPU utilization at target level (0.0 to 1.0).
--target-load-balancing-utilization
=TARGET_LOAD_BALANCING_UTILIZATION
- Autoscaler aims to maintain the load balancing utilization level (greater than 0.0).
--update-stackdriver-metric
=METRIC
-
Stackdriver metric to use as an input for autoscaling. When using this flag, the
target value of the metric must also be specified by using the following flags:
--stackdriver-metric-single-instance-assignment
or--stackdriver-metric-utilization-target
and--stackdriver-metric-utilization-target-type
. Mutually exclusive with--custom-metric-utilization
. -
At most one of these can be specified:
--region
=REGION
-
Region of the managed instance group to operate on. If not specified, you might
be prompted to select a region (interactive mode only).
A list of regions can be fetched by running:
gcloud compute regions list
Overrides the default
compute/region
property value for this command invocation. --zone
=ZONE
-
Zone of the managed instance group to operate on. If not specified, you might be
prompted to select a zone (interactive mode only).
A list of zones can be fetched by running:
gcloud compute zones list
Overrides the default
compute/zone
property value for this command invocation.
--schedule-cron
=CRON_EXPRESSION
-
Start time of the scaling schedule in cron format.
This is when the autoscaler starts creating new VMs, if the group's current size is less than the minimum required instances. Set the start time to allow enough time for new VMs to boot and initialize. For example if your workload takes 10 minutes from VM creation to start serving then set the start time 10 minutes earlier than the time you need VMs to be ready.
--schedule-description
=DESCRIPTION
- A verbose description of the scaling schedule.
--schedule-duration-sec
=DURATION
-
How long should the scaling schedule be active, measured in seconds.
Minimum duration is 5 minutes. A scaling schedule is active from its start time and for its configured duration. During this time, the autoscaler scales the group to have at least as many VMs as defined by the minimum required instances. After the configured duration, if there is no need to maintain capacity, the autoscaler starts removing instances after the usual stabilization period and after scale-in controls (if configured). For more information, see Delays in scaling in and Scale-in controls. This ensures you don't accidentally lose capacity immediately after the scaling schedule ends.
--schedule-min-required-replicas
=MIN_REQUIRED_REPLICAS
-
How many VMs the autoscaler should provision for the duration of this scaling
schedule.
Autoscaler provides at least this number of instances when the scaling schedule is active. A managed instance group can have more VMs if there are other scaling schedules active with more required instances or if another signal (for example, scaling based on CPU) requires more instances to meet its target.
This configuration does not change autoscaling minimum and maximum instance limits which are always in effect. Autoscaler does not create more than the maximum number of instances configured for a group.
--schedule-time-zone
=TIME_ZONE
-
Name of the timezone that the scaling schedule's start time is in.
It should be provided as a name from the IANA tz database (for example Europe/Paris or UTC). It automatically adjusts for daylight savings time (DST). If no time zone is provided, UTC is used as a default.
See https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for the list of valid timezones.
- 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
-
These variants are also available:
gcloud alpha compute instance-groups managed set-autoscaling
gcloud beta compute instance-groups managed set-autoscaling
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-06-04 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
{
"last_modified": "Last updated 2024-06-04 UTC.",
"state": ""
}