Upgrade to v0.92.0 (QBv5 and Cobra Cli Migration)

Overview

SigNoz v0.92.0 introduces significant improvements that enhance both the user experience and system architecture:

Query Builder v5 (QBv5): Features expression-based querying with intelligent auto-completion, providing an improved user experience with a streamlined interface, better performance, and reliability. Complete documentation is available at the Query Builder v5 Guide
Cobra CLI Migration: SigNoz has migrated to a Cobra CLI structure that simplifies command organization, offers a better help system, and enhances maintainability and extensibility (related to GitHub issue #6805)
ClickHouse 25.5.6 Support: We now support ClickHouse 25.5.6 to enhance database performance and compatibility. To upgrade, just replace 24.1.2 with 25.5.6, and no special steps needed.

SigNoz is now a cobra command cli. Running signoz --help will give you the following output shown above.

OpenTelemetry-Native Logs, Metrics and Traces in a single pane
 
Usage:
  signoz [command]
 
Available Commands:
  help        Help about any command
  server      Run the SigNoz server
 
Flags:
  -h, --help      help for signoz
  -v, --version   version for signoz
 
Use "signoz [command] --help" for more information about a command.

Upgrade Instructions

For upgrading to v0.92.0 you don't need to run any migrations manually to update dashboards, alerts and saved views as there is already an automatic migration in place to take care of the migration process.

Docker Standalone

Follow the standard upgrade guide and use the image tag v0.92.0 for signoz. You can keep the other components, such as schema-migrator and signoz-otel-collector images, unchanged.

Docker Swarm

Follow the standard upgrade guide and use the image tag v0.92.0 for signoz. You can leave the other components such as schema-migrator and signoz-otel-collector images unchanged.

Kubernetes

Follow the standard upgrade guide and use the image tag v0.92.0 for signoz. You can leave other components such as schema-migrator and signoz-otel-collector images unchanged.

Linux Binary Installation

Since the Cobra CLI has been updated, the signoz binary now needs the server subcommand. Here's how to upgrade:

Step 1: Stop SigNoz Services

sudo systemctl stop signoz.service
sudo systemctl stop signoz-otel-collector.service

Step 2: Download Latest Binaries

The following commands automatically detect your system architecture:

# Download SigNoz binary
curl -L https://github.com/SigNoz/signoz/releases/latest/download/signoz_linux_$(uname -m | sed 's/x86_64/amd64/g' | sed 's/aarch64/arm64/g').tar.gz -o signoz.tar.gz
 
# Extract the archive
tar -xzf signoz.tar.gz

Step 3: Replace Binaries

# Install new binaries
sudo cp -r signoz_linux_$(uname -m | sed 's/x86_64/amd64/g' | sed 's/aarch64/arm64/g')/* /opt/signoz
 
# Fix file ownership
sudo chown -R signoz:signoz /opt/signoz

Step 4: Update systemd Service

Create the updated service file:

sudo bash -c 'cat <<EOF > /etc/systemd/system/signoz.service
[Unit]
Description=SigNoz
Documentation=https://signoz.io/docs
After=clickhouse-server.service
 
[Service]
User=signoz
Group=signoz
Type=simple
KillMode=mixed
Restart=on-failure
WorkingDirectory=/opt/signoz
EnvironmentFile=/opt/signoz/conf/systemd.env
ExecStart=/opt/signoz/bin/signoz server
 
[Install]
WantedBy=multi-user.target
EOF'

Step 5: Start and Verify Services

Reload systemd and start services:

sudo systemctl daemon-reload
sudo systemctl start signoz.service

Check service status:
```
sudo systemctl status signoz.service
```
The service should show active (running) status.
Verify application health:
```
curl -X GET http://localhost:8080/api/v1/health
```
Expected response: {"status":"ok"}
Test the UI: Open your SigNoz interface in a browser to ensure everything works correctly.

Getting Help

Need assistance? Reach out through these channels: