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 repo​

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/install Sensor artifacts​

sudo apt install levo-ebpf-sensor=0.45.4

4. Start the Sensor​

Please take a look at the Running the Sensor as a Systemd Service section for further 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 the desired host:port value, and set the LEVO_ORG_ID to the Organization ID fetched from the Levo Dashboard. Set LEVO_ENV to the desired environment name in which you wish to see you applications on the Levo Dashboard.

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

Additional sensor configs are present in the file /etc/levo/sensor/config.yaml

A Sensor restart is required for the config changes to take effect.

Start Sensor​

# Note: The default config file is located at: '/etc/levo/sensor/config.yaml'
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​

Please refer to Sensor Configuration, and Applying Configuration Changes.