October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk12 min

How to Monitor a Linux VPS with Sysdig (Agent Setup Guide)

A practical Sysdig Linux VPS monitoring guide covering prerequisites, Quick Start and package installation, eBPF versus kernel-module drivers, tags, firewall rules, verification, and troubleshooting.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To monitor a Linux VPS with Sysdig, create a Linux agent account in Sysdig Monitor, copy the generated installation script, and run it on the server. Before installing, confirm that you have an agent access key, a supported Linux distribution, kernel 3.10 or newer, and outbound TCP port 6443 open to Sysdig’s regional collector. On kernels 5.8 and newer, use the universal eBPF driver; on older kernels, use the kernel-module driver.

What you need before installing

The Sysdig agent is the component that collects host and process telemetry from your VPS and sends it to Sysdig Monitor. Installation changes the operating system, loads a kernel data-collection driver, and makes an outbound connection to Sysdig. Treat it as a privileged system service rather than a user-level monitoring script.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • A Sysdig account with administrator access. The setup flow is under the integrations area, and an agent access key is required.
  • A supported Linux distribution. The published examples include Debian 10 or later, Ubuntu 18 or later, CentOS 7 or later, and RHEL 7 or later. Other distributions may also be supported, so verify your exact release in the current installation screen.
  • Kernel 3.10 or later. Check the running kernel, not only the distribution version, because VPS images can use a provider-supplied kernel.
  • Outbound TCP port 6443. The agent must reach the regional collector. Check both the VPS firewall and any provider-level firewall or security-group rules.
  • Root or equivalent administrative privileges. The generated installer and packaged installation need to install files, configure a service, and select a kernel driver.

On the VPS, record the basic environment before making changes:

uname -r
cat /etc/os-release
id

uname -r confirms the active kernel, /etc/os-release identifies the distribution and release, and id shows whether the current shell has the privileges needed to install an agent. If you use a non-root account, run the generated command through sudo only when the command supplied by Sysdig explicitly supports it.

#1 Best Overall
Sale
UGREEN NAS DH2300 2-Bay for Beginners & Personal Users, Phone Backup | AI Album, Private Cloud/Remote Access, File Sharing, Multi-Device Backup, Home Entertainment, 4GB RAM on Board (Diskless)
  • Entry-level NAS Personal Storage:UGREEN NAS DH2300 is your first and best NAS made easy. It is designed for beginners who want a simple, private way to store videos, photos and personal files, which is intuitive for users moving from cloud storage or external drives and move away from scattered date across devices. This entry-level NAS 2-bay perfect for personal entertainment, photo storage, and easy data backup (doesn't support Docker or virtual machines).
  • Set Your Devices Free, Expand Your Digital World: This unified storage hub supports massive capacity up to 64TB.*Storage drives not included. Stop Deleting, Start Storing. You can store 22 million 3MB images, or 2 million 30MB songs, or 43K 1.5GB movies or 67 million 1MB documents! UGREEN NAS is a better way to free up storage across all your devices such as phones, computers, tablets and also does automatic backups across devices regardless of the operating system—Window, iOS, Android or macOS.
  • The Smarter Long-term Way to Store: Unlike cloud storage with recurring monthly fees, a UGREEN NAS enclosure requires only a one-time purchase for long-term use. For example, you only need to pay $459.98 for a NAS, while for cloud storage, you need to pay $719.88 per year, $2,159.64 for 3 years, $3,599.40 for 5 years. You will save $6,738.82 over 10 years with UGREEN NAS! *NAS cost based on DH2300 + 12TB HDD; cloud cost based on 12TB plan (e.g. $59.99/month).
  • Blazing Speed, Minimal Power: Equipped with a high-performance processor, 1GbE port, and 4GB RAM on Board, this NAS handles multiple tasks with ease. File transfers reach up to 125MB/s—a 1GB file takes only 8 seconds. Don't let slow clouds hold you back; they often need over 100 seconds for the same task. The difference is clear.
  • Let AI Better Organize Your Memories: UGREEN NAS uses AI to tag faces, locations, texts, and objects—so you can effortlessly find any photo by searching for who or what's in it in seconds. It also automatically finds and deletes similar or duplicate photo, backs up live photos and allows you to share them with your friends or family with just one tap. Everything stays effortlessly organized, powered by intelligent tagging and recognition.

Choose an installation method

Sysdig exposes more than one deployment route. For a single Linux VPS, the Quick Start wizard is usually the shortest path. A package installation is preferable when you need to control repository management, driver settings, or configuration through your normal operating-system tooling. Standalone binaries, containers, and a Kubernetes DaemonSet are aimed at other deployment patterns, including Host Shield, rather than a straightforward one-host VPS install.

Method Best for Effort Customisation Kernel considerations
Quick Start wizard One VPS or a small number of manually managed hosts Lowest; the console generates the command Tags and account selection are entered in the console The generated installer detects or configures the supported driver; still verify the kernel requirement first
Package installation Repeatable builds, configuration management, and Debian/Ubuntu administration Higher; headers, signing key, repository, package, and driver settings are separate steps Highest; driver selection and package lifecycle are explicit Install matching kernel headers and choose eBPF or the kernel module in /etc/default/dragent
Standalone binary, container, or Kubernetes DaemonSet Specialized deployments and Host Shield workflows Variable Depends on the deployment format Follow the current Host Shield instructions for the supported driver and runtime

Console terminology is not perfectly consistent across documentation. Some pages refer to the classic agent, while others use Host Shield. If your account displays a slightly different label, look for the Linux host-agent integration rather than assuming the feature is missing.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install through the Sysdig Monitor Quick Start wizard

This route is the most direct way to put one Linux VPS under monitoring. It avoids manually reconstructing repository URLs or package names and gives you a command tied to your Sysdig account.

  1. Sign in as an administrator. Open Sysdig Monitor with an account allowed to create or manage integrations.
  2. Open the integration. Go to Integrations, choose Sysdig Agent, and select the Linux option. The exact wording can change as the console is updated.
  3. Create or select an agent account. The wizard associates the host with your Sysdig account and exposes the access key needed by the installer.
  4. Enter host tags. Add the labels you will use to find the VPS later. Common examples follow a key:value pattern such as role:webserver or location:europe. Confirm the current validation rules in the wizard before relying on punctuation, capitalization, or multiple values.
  5. Copy the generated snippet exactly. Do not retype the access key or replace the regional settings. Treat the snippet as a secret-bearing command and keep it out of public tickets, shell history shared with other users, and source repositories.
  6. Connect to the VPS. Use an administrative shell on the intended server, confirm the distribution and kernel, and run the snippet supplied for Linux.
  7. Wait for registration. Return to the integration or host view and look for the new machine. Initial inventory and metrics may take a short interval to appear; do not run the installer repeatedly while waiting.
  8. Record the host identity. Use the tags and the VPS hostname to distinguish this machine from similarly named servers, especially if you install the agent on a template image.

Inspect a generated script before execution when your organization requires change review. The important checks are that it targets the expected distribution, uses the intended account, and does not contain a key copied from a different environment. If the script is truncated, wrapped by a terminal, or copied with an extra prompt character, return to the wizard and copy it again instead of repairing it by guesswork.

Install with Debian or Ubuntu packages

The packaged route gives you more control but requires more decisions. The exact repository address, signing-key procedure, and package name can change, so use the commands shown by the current Sysdig Linux instructions rather than copying an old blog post.

Rank #2
Sale
UGREEN NAS DXP2800 2-Bay for Advanced Home Users, Remote Workers & Creators | Home Media & Data Center, Docker & VM, Plex, Fast File Transfer, Intel N100, 8GB DDR5, 2.5GbE, 2x M.2 NVMe, 4K HDMI(Diskless)
  • 【Advanced Home Data & Media Hub】For advanced home users who need phone backup, file storage, and centralized data management. Centralize family photos, 4K videos, movies, computer backups, and personal files in one place while running multiple apps for home entertainment and everyday data management. Suitable for households with growing digital libraries and multiple NAS use cases.
  • 【Built for Creators, Media Servers & Advanced Apps】Powered by the Intel N100 Quad-Core CPU, 8GB DDR5 RAM, 2.5GbE networking, and dual M.2 NVMe slots, DXP2800 handles large files and heavier workloads with ease. Run Docker, virtual machines, and media server applications compatible with Plex—ideal for content creators, tech enthusiasts, and advanced home users managing 4K videos, RAW photos, personal media libraries, and multiple NAS apps.
  • 【Up to 80TB for Growing Digital Libraries】 Supports up to 80TB of storage using two HDD bays and two M.2 NVMe SSD slots for family photos, movies, RAW photos, 4K videos, work files, and device backups. AI photo management supports recognition of people, objects, scenes, and locations, album organization, and duplicate photo detection. HDDs and SSDs are not included.
  • 【AI-powered Home Surveillance】Turn DXP2800 into a centralized home surveillance hub by connecting compatible network cameras and storing recordings locally on your NAS. AI-powered features include Face Recognition, People Detection, and Pet Detection, helping advanced home users review important events more efficiently while managing home surveillance and personal data in one place.
  • 【One data Center Across Your Devices】Keep files from desktops, laptops, phones, tablets, and other devices together instead of scattered across cloud accounts and external drives. Access, back up, organize, and share data across Windows, macOS, Android, iOS, web browsers, and compatible smart TVs—ideal for creators and advanced home users working across multiple devices.

1. Install matching kernel headers

The driver needs headers that correspond to the running kernel. On Debian or Ubuntu, install the header package for the kernel reported by uname -r, then confirm that the package manager completed without unresolved dependencies. A provider’s custom kernel may not have a matching header package in the distribution repository; in that case, choose a supported kernel or use the driver path documented for that VPS image.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
uname -r
sudo apt update
sudo apt install linux-headers-$(uname -r)

The final command is a conventional Debian/Ubuntu example, not a substitute for the current Sysdig prerequisites. If your image uses a different package naming scheme, follow that distribution’s header instructions.

2. Trust the repository and add the package source

Import Sysdig’s current GPG key using the vendor’s documented method, verify that the key is associated with the expected repository, and add the repository for your exact Debian or Ubuntu release. Avoid downloading a key or repository definition from an unrelated script repository. A package source for the wrong release can install incompatible dependencies even when the agent package itself appears to install correctly.

3. Install the agent package

Refresh package metadata and install the agent package named in the live Sysdig instructions. Keep the package manager’s output: it identifies missing libraries, blocked post-install scripts, and driver-build failures that are otherwise difficult to diagnose.

4. Select the driver in /etc/default/dragent

The driver choice is configured in /etc/default/dragent. Use the universal eBPF driver when the VPS runs Linux kernel 5.8 or newer and the current agent supports it. Use the kernel-module driver on older kernels. Do not select eBPF solely because the distribution is new; the running kernel version is the relevant test.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Synology 2-Bay DiskStation DS223j (Diskless)
  • Secure private cloud - Enjoy 100% data ownership and multi-platform access from anywhere
  • Easy sharing and syncing - Safely access and share files and media from anywhere, and keep clients, colleagues and collaborators on the same page
  • Automated Backup Protection - Set-and-forget backups for Macs, PCs and mobile devices to multiple destinations including cloud and external drives
  • Home Security System - Record and monitor your property 24/7 with support for multiple IP cameras and remote viewing
  • 2-Year Warranty - Reliable hardware backed by Synology's expert customer support team and ongoing software updates

5. Start and verify the service

Enable and start the service using the service-management commands appropriate to your distribution, then inspect its status and recent logs. The package documentation supplies the service name and any required post-install command. A running process alone is not proof of successful monitoring: the host must also register in Sysdig Monitor and begin reporting telemetry.

Choose between eBPF and the kernel-module driver

Driver selection determines how the agent obtains low-level Linux events. The documented recommendation is the universal eBPF driver for kernel 5.8 and above, with the kernel-module driver recommended for older kernels.

Running kernel Recommended choice What to check
5.8 or newer Universal eBPF driver Confirm that the VPS provider has not disabled required kernel capabilities and that the installed agent version supports the kernel
3.10 through 5.7 Kernel-module driver Install matching headers and ensure the module can build or load on the provider’s kernel

VPS providers sometimes restrict kernel features, module loading, or privileged operations. If a supported kernel still fails driver initialization, check the agent log for the specific capability or module error before changing kernels. Switching drivers without reading the log can turn a solvable header problem into a longer outage.

Configure useful host tags

Tags make a VPS findable when you have more than one host or when dashboards and alerts are grouped by role. The examples shown in Sysdig’s setup material use a key-and-value form, including role:webserver and location:europe. Treat those as examples: confirm the current console’s accepted syntax and whether tag values are case-sensitive.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Role: identify the workload, such as a web server, database server, queue worker, or reverse proxy.
  • Location: record a region or site name that matches your own naming scheme.
  • Environment: distinguish production, staging, and development hosts.
  • Ownership: identify the team responsible for responding to alerts.

Use stable values rather than transient details such as an automatically assigned public IP. If a VPS is rebuilt, retaining the same role and environment tags makes dashboards easier to maintain, while the hostname and instance identity can still distinguish the replacement host.

Rank #4
UGREEN NAS DXP4800 Pro 4-Bay for IT Professionals, Developers & Power Users | Small-Team File Server, VMs&Self-Hosted App, i3-1315U, 8GB DDR5, Built-in 128GB SSD, 10GbE+2.5GbE, 2x M.2NVMe Slots, Diskless
  • Pro-Performance NAS Engineered for Demanding Workflows: This NAS is built for offices, businesses, and power users who need serious performance. Powered by a pro-performance Intel processor, it serves as a versatile private workstation that delivers smooth performance for running virtual machines and Docker containers. It functions as an IT hub for video editors, developers, virtualization tasks, and growing teams with advanced workflows
  • Pro-Grade Core Hardware Performance: Features the Intel Core i3-1315U Processor (6 Cores, 8 Threads, up to 4.5GHz Turbo), offering a significant performance lead. It's paired with 8GB of high-speed DDR5 RAM (expandable to 96GB) and 13th Gen Intel UHD Graphics for smooth multitasking. Dual high-speed network ports (10GbE + 2.5GbE) enable blazing-fast transfers, reaching up to 1.25GB/s
  • Ultimate Flexibility with Docker, VMs & Smart AI: It offers comprehensive support for Docker and Virtual Machines, unlocking endless possibilities to run personal websites, smart home hubs, or private development environments. The local AI-powered Photo Album automatically recognizes faces, scenes, and content. All AI processing happens on-device, ensuring your privacy while managing massive photo libraries effortlessly
  • Massive Storage & Intuitive All-in-One System: It supports a colossal 144TB capacity (4x HDD + 2x M.2 SSD), enough for approximately 4.2 million 35MB RAW photos, 3.6K 40GB 4K movies, 5 million 30MB lossless music, or 150 million 1MB files. Dual M.2 PCIe 4.0 SSD slots can be used as a high-speed cache or storage pool to eliminate HDD bottlenecks. The intuitive UGOS Pro operating system integrates a media center, photo management, cloud sync, downloads, and more for a one-stop experience
  • Enterprise-Grade Data Security & Privacy: Provides multiple RAID configuration options (0, 1, 5, 10) for flexibility between capacity, speed, and protection. Features granular user permission controls (supporting up to 2048 accounts). The Data Vault offers an extra layer of security by hiding and encrypting sensitive files. Certified for strong privacy and data protection by TV SD (ETSI EN 303 645) and TRUSTe

Open the network path to Sysdig

The agent needs outbound TCP port 6443 to Sysdig’s regional collector. “Outbound” matters: many VPS firewalls allow incoming SSH while denying new egress connections. Check every control point that can filter traffic:

  • The operating-system firewall, such as UFW, firewalld, nftables, or a provider image’s custom rules.
  • The VPS provider’s security group, network ACL, or egress policy.
  • An enterprise NAT gateway or proxy between the VPS and the public internet.
  • DNS resolution and routing, if the collector hostname supplied by the agent cannot be resolved.

Permit outbound TCP 6443 to the regional collector specified by your Sysdig account rather than opening all inbound ports. If your organization uses an egress allowlist, obtain the current collector destinations from the Sysdig console or live documentation; collector addresses can vary by region and may change.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

An older third-party repository references TCP port 6666. Do not use that value to override the current Linux-agent requirement: the documented port for this setup is 6443. Copying firewall rules from an old or unofficial guide is a common cause of an agent that installs successfully but never appears online.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Verify that monitoring is actually working

Verification should cover the operating system, the agent process, the network path, and the Sysdig UI.

  1. Check the service state. Confirm that the agent service is active and has not exited after a driver or configuration error.
  2. Read recent logs. Look for access-key errors, collector connection failures, TLS or DNS errors, and driver initialization messages. Capture the first error after startup; later retries often obscure the original cause.
  3. Confirm the driver. Ensure the selected eBPF or kernel-module mode matches the running kernel and that the required headers or capabilities are present.
  4. Check egress policy. Verify that TCP 6443 is permitted through both local and provider firewalls and that the VPS can resolve the collector endpoint shown in its configuration.
  5. Find the host in Sysdig Monitor. Search by hostname and tags, then confirm that current CPU, memory, process, and network data are advancing rather than showing a one-time inventory.
  6. Test a harmless change. Generate normal activity, such as opening a new shell or checking a service status, and confirm that the host view updates. Do not create artificial load merely to prove the agent is alive.

If the service is active but no host appears, prioritize the access key, collector region, DNS, and outbound policy. If the host appears but low-level events are missing, prioritize the driver and kernel checks.

Best Value
Synology DS225+ Private Cloud Media Server - Stream, Back Up Photos & Share Files, Intel CPU for Hardware Transcoding (2-Bay Diskless NAS)
  • Your Personal Streaming Server - Build your own Netflix-style media library and stream 4K movies, shows and photos to any device without monthly fees
  • Create Your Own Cloud - Store your entire photo, video and music collection; access from anywhere with fast 282 MB/s transfer speeds
  • Creator-Grade Backup Solution - Protect your irreplaceable content with automated backups to cloud services, external drives and remote NAS
  • Multi-Layered Data Protection - Combine RAID redundancy, automated backups and snapshot technology to prevent data loss from any cause
  • Smart Home Surveillance - Support up to 30 IP cameras with AI detection, instant alerts and secure remote monitoring

Troubleshoot common installation failures

Symptom Likely cause Action
The installer refuses the operating system The release is outside the supported examples or the script cannot identify a custom image Confirm the exact distribution release in the current Sysdig support list; do not force a package for a different release
Kernel requirement failure The running kernel is older than 3.10 Move the VPS to a supported kernel or image before installing; changing only the user-space distribution does not change the active kernel
Header package cannot be found The provider uses a custom kernel or the package source is incomplete Check uname -r, enable the correct distribution repository, and ask the provider for matching headers or a supported kernel
eBPF initialization fails The kernel is older than 5.8, lacks required capabilities, or the agent cannot use eBPF in the VPS environment Use the kernel-module driver where appropriate, or follow the current compatibility guidance for the provider’s kernel
Module build or load fails Missing or mismatched headers, restricted module loading, or an incompatible kernel configuration Match headers to the active kernel, inspect the first module error, and check provider restrictions before reinstalling
Agent is running but offline in the console Outbound TCP 6443, DNS, proxy, or collector-region problem Check local and provider egress rules and compare the configured regional endpoint with the account’s current instructions
Access-key authentication fails Key was copied incorrectly, revoked, or associated with another account Generate or copy a fresh key from the administrator integration flow and protect it as a credential
Two hosts appear indistinguishable Identical hostnames or missing tags Assign stable role, environment, and location tags and verify the hostname presented by each VPS

Operate the agent safely after installation

Protect the access key

The access key authorizes agent registration. Do not publish the generated command in a public issue, paste site, image, or shared shell transcript. If you believe the key was exposed, rotate it through the administrator integration workflow and update affected hosts using the current Sysdig procedure.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Keep the driver aligned with kernel changes

A VPS kernel upgrade can change driver compatibility even when the distribution release remains the same. After a planned kernel update, check the new uname -r, confirm matching headers, and verify that the agent starts and reports after reboot. Do not assume that a previously working kernel module will load unchanged on a new provider kernel.

Use change control for package updates

For packaged installations, keep the repository definition, signing-key change, package version, and driver setting in your configuration-management records. Test updates on a non-production VPS when possible, especially if the update changes driver behavior.

Review tags as infrastructure changes

When a VPS changes role, update its tags so alerts continue to route to the right dashboards and team. Avoid encoding secrets, customer data, or full command lines in tag values; tags are metadata intended for identification and filtering.

Costs, editions, and naming

The installation material establishes the account and access-key prerequisites but does not establish a universal price or license allowance. Availability, retention, and feature limits depend on the Sysdig plan and account configuration. Check the current Sysdig pricing and contract terms before budgeting a rollout; do not infer cost from the installer itself.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Documentation may call the monitored component a classic agent, while the console may present Linux Agent or Host Shield labels. Those names describe related but not always identical workflows. Follow the option that explicitly targets Linux host monitoring, and confirm the generated command’s destination before running it on a production VPS.

A repeatable checklist for each VPS

  • Administrator access and a valid Sysdig agent access key are available.
  • The distribution release is supported and the running kernel is 3.10 or newer.
  • Matching kernel headers are installed when the selected driver requires them.
  • The driver matches the kernel: universal eBPF for 5.8 or newer when supported, kernel module for older kernels.
  • Outbound TCP 6443 to the correct regional collector is allowed through local and provider firewalls.
  • Tags use the current console’s accepted key-and-value syntax.
  • The service is active, logs show successful initialization, and the host appears with current telemetry in Sysdig Monitor.
  • The access key and generated installer command are not exposed in shared logs or repositories.

Following that sequence gives you a monitored host without relying on an unofficial port number or an installer built for a different Linux release.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.