Skip to main content

Docker Swarm

tip

The easiest way to run SigNoz is to use SigNoz Cloud - no installation, maintenance, or scaling needed.

New users get 30 days of unlimited access to all features. Click here to sign up.

Once you have successfully installed SigNoz on Docker Swarm, the following sections provide an overview of the activities that are required to successfully operate SigNoz.

Stop/Start SigNoz Cluster

To stop SigNoz cluster:

docker stack rm signoz

To start/resume SigNoz cluster:

docker stack deploy -c docker-swarm/clickhouse-setup/docker-compose.yaml signoz

*Note: The newly created SigNoz cluster should mount on the existing local path in the node.

Upgrade SigNoz Cluster

To upgrade, you can manually update the image tag for query-service, frontend and otel-collector. And run the command to start the cluster:

docker stack deploy -c docker-swarm/clickhouse-setup/docker-compose.yaml signoz

*Note:

  • Be careful! There might be configuration changes and version mismatch.
  • Before upgrading, checkout to the release tag: for example git checkout v0.6.1 and compare the Docker Compose YAML and config files.

Uninstall SigNoz Cluster

To delete/uninstall SigNoz cluster:

docker stack rm signoz

Scale Up SigNoz Cluster

SigNoz uses the OpenTelemetry Collector to ingest data. By default, the instructions in the Install SigNoz on Docker Swarm document create three replicas, and each replica can handle 50K spans per second. To handle an increased load, perform the following steps:

  1. Open the deploy/docker-swarm/clickhouse-setup/docker-compose.yaml file in a plain-text editor.

  2. In the services.otel-collector.deploy.replicas field, enter the number of replicas you wish to create. The following example creates four replicas:

    Open Telemetry Collector - Create four replicas

  3. Update the signoz stack by entering the following command:

    docker stack deploy -c docker-swarm/clickhouse-setup/docker-compose.yaml signoz