Install with Docker

Run the Sensobit agent as a container with host metrics and Docker socket access.

Use the official image when you already run Docker and want host plus container metrics without a host package.

Run the container

docker run -d --name sensobit-agent \
  --restart unless-stopped \
  -e SENSOBIT_API_KEY=YOUR_API_KEY \
  -e INGESTION_URL=https://ingest.sensobit.com \
  -e COLLECTOR_INTERVAL=10s \
  -e SENSOBIT_NAMESPACE=production \
  -v /proc:/host/proc:ro \
  -v /sys:/host/sys:ro \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /var/log:/var/log:ro \
  sensobit/agent:latest

The mounts let the agent read host CPU, memory, disk, and network from /host/proc and /host/sys, list containers through the Docker socket, and tail host logs.

Compose

services:
  sensobit-agent:
    image: sensobit/agent:latest
    container_name: sensobit-agent
    restart: unless-stopped
    environment:
      SENSOBIT_API_KEY: ${SENSOBIT_API_KEY}
      INGESTION_URL: https://ingest.sensobit.com
      COLLECTOR_INTERVAL: 10s
      HOSTNAME: ${HOSTNAME}
      COLLECT_APIS: "true"
      COLLECT_WEB_SECURITY: "false"
    volumes:
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /var/log:/var/log:ro

Start it with:

export SENSOBIT_API_KEY=YOUR_API_KEY
docker compose up -d
docker logs -f sensobit-agent

Environment variables

Variable	Required	Description
`SENSOBIT_API_KEY`	Yes	Console API key
`INGESTION_URL`	No	Defaults to `https://ingest.sensobit.com`
`SENSOBIT_NAMESPACE`	No	Override the key's default namespace
`HOSTNAME`	No	Reported host name
`COLLECTOR_INTERVAL`	No	Metrics interval, for example `10s`
`COLLECT_WEB_SECURITY`	No	Set `true` to parse access logs
`COLLECT_APIS`	No	Enable local API discovery

Verify

docker ps --filter name=sensobit-agent
curl -fsS https://ingest.sensobit.com/health

The host and its containers appear under Infrastructure in the console.

Run the container

Compose

Environment variables

Verify

On this page