Agent Upgrade

The steps to upgrade an agent differ depending on whether the agent was originally installed as a container or as a service.

Follow the upgrade best practices for a smooth upgrade and to maximize the value of Sysdig applications:

  • Keep upgrades current

  • Upgrade progressively without skipping versions

  • Test upgrades in a non-mission-critical or staging environment before rolling in to production.

This section describes how to check the current version of the installed agents, and then how to upgrade them.

Agent Version Check

Kubernetes installation

If the agent is installed in a Kubernetes environment, run:

kubectl get pods -n sysdig-agent -o=jsonpath='{.items[0].spec.containers[:1].image}'

Container/Docker Installation

If the agent is installed as container, run:

docker exec sysdig-agent /opt/draios/bin/dragent --version

Service Installation

If the agent is installed as a service, run:

/opt/draios/bin/dragent --version

The agent version can also be found in the agent log file: /opt/draios/logs/draios.log.

Look for the “Agent starting” message, which is logged whenever the agent restarts.

Update Agent

Update the containerized agent version as you normally update any container; the basic steps are below.

Use the full run command as shown in the Settings > Agent Installation tab of your account.

Containerized Agent

To see which agent versions are available see tags.


  1. Update the chart:

    helm repo update
  2. Do one of the following:

  • If you have deployed the chart with a values.yaml file, modify or add (if it’s missing) the agent.image.tag field and run:
    helm upgrade --namespace sysdig-agent sysdig-agent -f values.yaml sysdig/sysdig-deploy
  • If you have deployed the chart by setting the values as CLI parameters, run:
    helm upgrade --namespace sysdig-agent --set agent.image.tag=<latest_version> --reuse-values sysdig-agent sysdig/sysdig-deploy
    Replace <latest_version> with the latest version number of Sysdig agent.

For more information on using Helm, see Helm Charts.


Check whether .yaml files must be updated:

Updating the agent image does not overwrite the daemonset.yaml and sysdig-agent-configmap.yaml on your local system. Check the Sysdig Agent Release Notes to see if you need to download the latest .yaml files from GitHub.

Perform update:

kubectl set image ds/sysdig-agent sysdig-agent=sysdig/agent:<tag>

Watch update status:

kubectl rollout status ds/sysdig-agent


Basic Steps: stop the agent, remove it, pull the new agent, and install it.

The exact Docker command can also be found in the Sysdig Settings > Agent Installation menu.

docker stop sysdig-agent
docker rm sysdig-agent
docker pull sysdig/agent
docker run . . .

Service Agent

For service (non-containerized) agent installations, updates are installed as part of the normal system upgrade available with apt-get or yum.

Debian, Ubuntu

apt-get update
apt-get -y install draios-agent

CentOS, RHEL, Fedora, Amazon AMI, Amazon Linux 2

yum clean expire-cache
yum -y install draios-agent