CheckMK Integration

Place this script on the CheckMK monitoring host (or any host monitored by CheckMK). It queries FleetPilot and outputs CheckMK-compatible service lines.

1. Download the script: fleetpilot_check
2. Copy to CheckMK agent local directory:
   cp fleetpilot_check /usr/lib/check_mk_agent/local/
3. Make executable:
   chmod +x /usr/lib/check_mk_agent/local/fleetpilot_check
4. Run service discovery in CheckMK — FleetPilot services will appear automatically

#!/bin/bash
# FleetPilot CheckMK Local Check Script
# Generated by FleetPilot — place in /usr/lib/check_mk_agent/local/
# Make executable: chmod +x /usr/lib/check_mk_agent/local/fleetpilot_check
#
# This script queries the FleetPilot REST API and outputs
# CheckMK-compatible local check lines.
#
# Configuration:
FLEETPILOT_URL="https://fleetpilot.home"
FLEETPILOT_TOKEN="1cbd7e5fc564fed36d055b85a340c7eb662209a4d259f2dca035e3bdd6c775e2"
TIMEOUT=10

# Fetch data from FleetPilot
RESPONSE=$(curl -sf --max-time "$TIMEOUT" \
  -H "X-FleetPilot-Token: $FLEETPILOT_TOKEN" \
  "$FLEETPILOT_URL/api/checkmk/agent" 2>/dev/null)

if [ $? -ne 0 ] || [ -z "$RESPONSE" ]; then
  echo '2 "FleetPilot Agent" - FleetPilot API unreachable'
  exit 0
fi

# Output the agent data directly (already in <<<local>>> format)
echo "$RESPONSE"

Use this script to create piggyback data — each FleetPilot host appears as a separate host in CheckMK with its own services (updates, disks, etc.).

1. Download: fleetpilot_piggyback
2. cp fleetpilot_piggyback /usr/lib/check_mk_agent/local/
3. chmod +x /usr/lib/check_mk_agent/local/fleetpilot_piggyback
4. In CheckMK: enable Piggyback for the monitoring host
5. Run service discovery — each FleetPilot host gets its own CheckMK host

#!/bin/bash
# FleetPilot CheckMK Piggyback Script
# Outputs per-host piggyback data for all configured FleetPilot hosts.
# Place in /usr/lib/check_mk_agent/local/fleetpilot_piggyback
#
FLEETPILOT_URL="https://fleetpilot.home"
FLEETPILOT_TOKEN="1cbd7e5fc564fed36d055b85a340c7eb662209a4d259f2dca035e3bdd6c775e2"
TIMEOUT=10

# Fetch all host names
HOSTS=$(curl -sf --max-time "$TIMEOUT" \
  -H "X-FleetPilot-Token: $FLEETPILOT_TOKEN" \
  "$FLEETPILOT_URL/api/checkmk/hosts" 2>/dev/null | python3 -c "
import sys,json
data=json.load(sys.stdin)
print(' '.join(h['name'] for h in data.get('hosts',[])))
" 2>/dev/null)

for HOST in $HOSTS; do
  curl -sf --max-time "$TIMEOUT" \
    -H "X-FleetPilot-Token: $FLEETPILOT_TOKEN" \
    "$FLEETPILOT_URL/api/checkmk/host/$HOST" 2>/dev/null
done

Configure FleetPilot as a datasource program in CheckMK. CheckMK will call the URL directly instead of using an agent.

1. In CheckMK: Setup → Hosts → [your host] → Monitoring agents → Datasource programs
2. Set command to:
   curl -sf -H "X-FleetPilot-Token: 1cbd7e5fc564fed36d055b85a340c7eb662209a4d259f2dca035e3bdd6c775e2" https://fleetpilot.home/api/checkmk/agent
3. Activate changes and run service discovery

Use the JSON status API for Grafana dashboards, custom alerting, or integration with other monitoring tools.

Example: curl -H "X-FleetPilot-Token: 1cbd7e5fc564fed36d055b85a340c7eb662209a4d259f2dca035e3bdd6c775e2" https://fleetpilot.home/api/checkmk/status

Prometheus scrape config: authorization: {credentials: "<token>"} with metrics_path: /metrics.