Kubernetes

💡 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.

Upgrade SigNoz

✅ Info

Replace <release-name> and <namespace> from the instructions below with appropriate release name and namespace respectively.

Use the steps below to upgrade to the latest version:

Fetch the latest chart information from the Helm repositories
```
helm repo update
```

Upgrade to the latest available version of the chart

helm -n <namespace> upgrade <release-name> signoz/signoz

✅ Info

To override values in a Helm chart, you can also use the values/-f flag. See the Helm Upgrade page of the Helm documentation for more details.

In case you wish to upgrade the SigNoz cluster to a specific version, follow the steps below:

List the available SigNoz Helm charts with their version and supported app version.

helm search repo signoz --versions

The output should look similar to the following:

NAME               	CHART VERSION	APP VERSION	DESCRIPTION
signoz/signoz      	0.2.5        	0.10.2     	SigNoz Observability Platform Helm Chart
signoz/signoz      	0.2.3        	0.10.1     	SigNoz Observability Platform Helm Chart
signoz/signoz      	0.2.2        	0.10.0     	SigNoz Observability Platform Helm Chart
signoz/signoz      	0.2.1        	0.10.0     	SigNoz Observability Platform Helm Chart
signoz/signoz      	0.2.0        	0.10.0     	SigNoz Observability Platform Helm Chart
signoz/signoz      	0.1.4        	0.9.2      	SigNoz Observability Platform Helm Chart
signoz/clickhouse  	23.4.0       	22.4.5     	A Helm chart for ClickHouse
signoz/clickhouse  	23.3.3       	22.4.5     	A Helm chart for ClickHouse

Run the following command to install the chart version 0.2.5 running SigNoz version 0.10.2 with the release name <release-name> and namespace <namespace>:
```
helm -n <namespace> upgrade <release-name> signoz/signoz --version 0.2.5
```

See the Helm docs for documentation on the helm upgrade command.

⚠️ Warning

Be careful with breaking changes across versions!
There might be misconfiguration caused by version mismatch.

Uninstall SigNoz

To uninstall/delete the <release-name> resources:

helm -n <namespace> uninstall "<release-name>"

See the Helm docs for documentation on the helm uninstall command.

The command above removes all the Kubernetes components associated with the chart and deletes the release except for ClickHouse CRD resources. To delete resources accociated with the ClickHouseInstallations CRD:

kubectl -n <namespace> patch \
  clickhouseinstallations.clickhouse.altinity.com/<release-name>-clickhouse \
  -p '{"metadata":{"finalizers":[]}}' --type=merge

Deletion of the StatefulSet doesn't cascade to deleting associated PVCs. To delete them:

kubectl -n <namespace>  delete pvc -l app.kubernetes.io/instance=<release-name>

Delete the namespace:

kubectl delete namespace <namespace>

Was this page helpful?

Docker Swarm

Best Practices for Production

On this page

Upgrade SigNoz

Uninstall SigNoz