Getting Started

Getting Started

Getting Started

This path is the fastest way to verify that Astra behaves like an etcd replacement for basic control-plane operations.

Prerequisites

  • Docker Engine with the Compose plugin
  • Open local ports: 2379, 32391, 32392, 9000, 9001, 9090, 3000
  • Optional: etcdctl if you want a native etcd client instead of the bundled smoke commands

Start the local sandbox

./quickstart.sh

The sandbox starts:

  • a 3-node Astra cluster,
  • MinIO for object-tier experiments,
  • Prometheus and Grafana,
  • a traffic-generation container for local load tests.

Validate basic etcd compatibility

docker run --rm --network host quay.io/coreos/etcd:v3.6.8 \
  etcdctl --endpoints=http://127.0.0.1:2379 put /quickstart/hello astra

docker run --rm --network host quay.io/coreos/etcd:v3.6.8 \
  etcdctl --endpoints=http://127.0.0.1:2379 get /quickstart/hello

Inspect the runtime

  • Prometheus: http://127.0.0.1:9090
  • Grafana: http://127.0.0.1:3000

The most useful first metrics are:

  • queue-wait p99
  • quorum-ack p99
  • write latency
  • profile switches
  • watch and LIST behavior under load

Next steps