Agent Install: Manual Linux Installation
Manual installation of the native Linux agent is recommended in the following cases:
Full control over the deployment process
Integration with configuration management tools
Custom kernel
Unsupported distribution (within Debian/Fedora flavors)
Otherwise, you may want to follow Agent Install: Non-Orchestrated
Note: If you are installing the Sysdig agent in an orchestrated infrastructure such as Kubernetes, Mesos/Marathon, use the respective Installation Guides:
Prerequisites
Review the Agent Installation Requirements.
Collect the configuration parameters:
ACCESS_KEY
: Your unique access key string. Inability to retrieve the key indicates that the administrator of your instance might have it turned off for non-admin users. Contact your Sysdig administrator to receive the key. If you still have issues please contact Sysdig Support.TAGS
: The optional parameter you can use to list one or more tags for this host. Tagging your hosts is highly recommended. Agent Tags allow you to sort nodes of your infrastructure into custom groups in Sysdig Monitor. Replace the [TAGS] parameter above with a comma-separated list ofTAG_NAME:TAG_VALUE
. For example:role:webserver,location:europe
COLLECTOR
: The collector URL for Sysdig Monitor or Sysdig Secure. This value is region-dependent in SaaS and is auto-completed on the Get Started page in the Monitor UI or the Data Sources page in Secure. It is a custom value in on-prem installations.SECURE
: Use a secure SSL/TLS connection to send metrics to the collector. This option is enabled by default.
Run the commands as root or with sudo.
Installation
Follow the instructions for the appropriate Linux distribution:
Debian, Ubuntu
Use the Sysdig Monitor GPG key, configure the apt repository, and update the package list:
curl -s https://download.sysdig.com/DRAIOS-GPG-KEY.public | apt-key add - curl -s -o /etc/apt/sources.list.d/draios.list http://download.sysdig.com/stable/deb/draios.list apt-get update
Install kernel development files.
Note: The following command might not work with every kernel. Ensure that you customize the name of the package properly.
apt-get -y install linux-headers-$(uname -r)
Install, configure, and restart the Sysdig agent.
apt-get -y install draios-agent echo customerid: ACCESS_KEY >> /opt/draios/etc/dragent.yaml echo tags: [TAGS] >> /opt/draios/etc/dragent.yaml echo collector: COLLECTOR_URL >> /opt/draios/etc/dragent.yaml echo ssl: true >> /opt/draios/etc/dragent.yaml service dragent restart
See Prerequisites for the configuration parameters required.
CentOS, RHEL, Fedora, Amazon AMI, Amazon Linux 2
Trust the Sysdig Monitor GPG key, configure the yum repository.
$ rpm --import https://download.sysdig.com/DRAIOS-GPG-KEY.public $ curl -s -o /etc/yum.repos.d/draios.repo http://download.sysdig.com/stable/rpm/draios.repo
Install the EPEL repository.
Note: The following command is required only if DKMS is not available in the distribution. You can verify if DKMS is available with
yum list dkms
.The command below contains a sample release number (for RHEL8); be sure to update with the correct release. See the EPEL quickstart for more information.
$ yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
Install kernel development files.
Note: The following command might not work with every kernel. Make sure to customize the name of the package properly.
$ yum -y install kernel-devel-$(uname -r)
Install, configure, and start the Sysdig agent.
$ yum -y install draios-agent $ echo customerid: ACCESS_KEY >> /opt/draios/etc/dragent.yaml $ echo tags: [TAGS] >> /opt/draios/etc/dragent.yaml $ echo collector: COLLECTOR_URL >> /opt/draios/etc/dragent.yaml $ echo ssl: true >> /opt/draios/etc/dragent.yaml $ echo secure: true >> /opt/draios/etc/dragent.yaml $ sudo systemctl enable dragent $ sudo systemctl start dragent
See Prerequisites for the configuration parameters required.
If you using a non-systemd Linux distribution, use the service command to start
dragent
.$ service dragent restart
Other Linux Distributions
The Sysdig agent is unsupported outside of the Debian, Fedora, and Amazon distributions.
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.