Connect Linux hosts

Linux hosts sensor

Supported Environments

We currently support running on eBPF-enabled linux machines (See more Kernel requirements for eBPF sensor)

Supported architectures: AMD64 + ARM64

For the following providers, we will fetch the machine metadata from the provider's API.

Provider
Supported

AWS

GCP

Azure

Linode

Sensor capabilities

  • Infrastructure Host metrics: CPU/Memory/Disk usage

  • Logs

  • Traces

    • Natively from docker containers running on the machine

  • APM metrics and insights from the traces

How to install?

Installation currently requires running a script on the machine.

The script will pull the latest sensor version and install it as a service: groundcover-sensor (requires privileges)

Install/Upgrade existing sensor:

Where:

  • {ingestion_Key} - A dedicated ingestion key, you can generate or find existing ones from Settings -> Access -> Ingestion Keys

    • Ingestion Key needs to be of Type Sensor

  • {inCloud_Site} - Your backend ingress address (Your inCloud public ingestion endpoint)

  • {selected_Env} - The Environment that will group those machines on the cluster drop down in the top right corner (We recommend setting a separate one for non k8s deployments)

Check installed sensor status:

  • Check service status: systemctl status groundcover-sensor

  • View sensor logs: journalctl -u groundcover-sensor

Initial data may take a few minutes to appear in the app after installation

Remove installed sensor:

Customize sensor configuration:

The sensor supports overriding its default configuration by writing to the file is located in:

/etc/opt/groundcover/overrides.yaml. After writing it you should restart the sensor service using:

systemctl restart groundcover-sensor

Example - override Docker max log line size:

Last updated