locally chaos

Preview

During Public Preview you can use the Team plan for free, and get an early-adopter discount at GA. Sign in

locally chaos

This page is part of the CLI Reference and is generated from the CLI's own help output, so it matches what locally chaos --help prints.

For more information see Chaos Engineering.

locally chaos

Simulate transient failures in Locally.

Simulate transient failures in Locally's control plane (ARM), directory
(Microsoft Graph), identity (sign-in and tokens) or a data-plane service.

Each fault has a rate, plus optional rules that override it for one location,
plugin or resource name. Requests that match no rule use the fault's rate, so
"everywhere except one place" is a rate of 100 plus a rule at 0.

Most faults act on single requests. Scheduled faults, such as incident, freeze
or restart, take --interval and act on the services in scope that often; on
drop-connection and latency, --interval also cuts or delays connections that
are already open, on the services that keep them.

'locally chaos enable' switches the control plane and data-plane services on
or off; 'locally chaos directory enable' does the same for the directory and
identity. Setting a fault switches its surface on.

Examples:
# Inject 500s on 10% of ARM requests
  locally chaos control-plane 500 --percentage 10

  # An outage in one location, for one plugin only
  locally chaos control-plane outage --percentage 100 --location london --plugin Microsoft.Storage

  # Throttle everywhere EXCEPT one location
  locally chaos storage 429 --percentage 100
  locally chaos storage 429 --percentage 0 --location london

  # Slow one storage account by up to 800 milliseconds
  locally chaos storage latency --percentage 100 --millis 800 --name acct1

  # Throttle Microsoft Graph, asking clients to retry after 5 seconds
  locally chaos directory 429 --percentage 50 --retry-after 5s

  # Take Event Hubs down in one location, leaving the others running
  locally chaos eventhub outage --percentage 100 --location london

  # Every 30 seconds, maybe freeze a container group for 5 to 20 seconds
  locally chaos containerinstances freeze --percentage 50 --seconds 5-20 --interval 30s

  # Stop every sign-in from getting a token
  locally chaos identity outage --percentage 100

  # Put one rule back, then everything back
  locally chaos storage 429 reset --location london
  locally chaos storage reset

  # See what is configured
  locally chaos show
  locally chaos control-plane show

Usage

locally chaos [flags]
  locally chaos [command]

Flags

-h, --help[=true|false]   help for chaos

Subcommands

locally chaos disable

Turn chaos OFF for the control plane and data-plane services.

Turn chaos OFF for the control plane and data-plane services.

Disabling keeps every fault's configuration, so a later enable restores it.

Usage

locally chaos disable [flags]

Flags

-h, --help[=true|false]     help for disable
      --subscription string   Subscription UUID (defaults to the configured default)

locally chaos enable

Turn chaos ON for the control plane and data-plane services.

Turn chaos ON for the control plane and data-plane services.

Disabling keeps every fault's configuration, so a later enable restores it.

Usage

locally chaos enable [flags]

Flags

-h, --help[=true|false]     help for enable
      --subscription string   Subscription UUID (defaults to the configured default)

locally chaos show

Print the chaos configuration for every subscription-scoped surface.

Print the chaos configuration for every subscription-scoped surface.

Examples:
locally chaos show

Usage

locally chaos show [flags]

Flags

-h, --help[=true|false]     help for show
      --subscription string   Subscription UUID (defaults to the configured default)
Preview

During Public Preview you can use the Team plan for free, and get an early-adopter discount at GA. Sign in

A local cloud for you and your AI agents.

Your Azure infrastructure, running on your machine. Deploy in seconds, break things freely, and ship to Azure when you're ready.