Skip to main content

Sensor via APT Package

Install on Debian-Based Linux via apt​

1. Install curl and gnupg​

sudo apt install gnupg

sudo apt install curl

2. Configure Linux Host to Access Levo APT Repository​

curl -fsSL https://us-apt.pkg.dev/doc/repo-signing-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/us-apt-repo-signing-key.gpg
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/us-apt-repo-signing-key.gpg] \
 https://us-apt.pkg.dev/projects/levoai apt-levo main" \
| sudo tee -a /etc/apt/sources.list.d/artifact-registry.list > /dev/null
sudo apt update

3. Download and Install Sensor Artifacts​

sudo apt install levo-ebpf-sensor=0.48.2

4. Start the Sensor​

Refer to the Running the Sensor as a Systemd Service section for detailed instructions.

Sensor Lifecycle Management​

Configure Satellite Address, Organization ID, and Environment​

The Satellite address is configured in /etc/default/levo-ebpf-sensor. The default Satellite URL is https://collector.levo.ai.

Edit /etc/default/levo-ebpf-sensor, set the LEVO_SATELLITE_URL variable to your desired host:port value, and set LEVO_ORG_ID and LEVO_WORKSPACE_ID to the Organization ID and Workspace ID retrieved from the Levo Dashboard.

Set LEVO_ENV to the desired environment name where you want to see your applications on the Levo Dashboard.

...
LEVO_ENV="your-env"
LEVO_SATELLITE_URL="your-satellite-url"
LEVO_ORG_ID="your-org-id"
LEVO_WORKSPACE_ID="your-workspace-id"
...

Additional sensor configurations are located in /etc/levo/sensor/config.yaml.

A Sensor restart is required for configuration changes to take effect.

Enable and Start Sensor​

# Note: The default config file is located at: '/etc/levo/sensor/config.yaml'
sudo systemctl enable levo-ebpf-sensor
sudo systemctl start levo-ebpf-sensor

Get Sensor Status​

sudo systemctl status levo-ebpf-sensor

Stop Sensor​

sudo systemctl stop levo-ebpf-sensor

Check Sensor Logs​

journalctl -u levo-ebpf-sensor.service -b -f --since "15min ago"

# If journalctl isn't providing logs, you can alternatively:
sudo cat syslog | grep 'levo-ebpf-sensor'

Show Sensor Config​

cat /etc/levo/sensor/config.yaml

Show Sensor Environment file​

cat /etc/default/levo-ebpf-sensor

Uninstall Sensor​

sudo apt remove --purge levo-ebpf-sensor
sudo apt clean

Manage Sensor Configuration​

Refer to Sensor Configuration and Applying Configuration Changes for detailed instructions.