Fleet Management¶

Note

This is a private preview feature. Please contact your Observe representative for more information or open Docs & Support → Contact Support in the product and let us know.

Fleet Management gives you a single place to understand the deployment and health of Observe Agents across your entire environment—Linux, Windows, MacOS and Kubernetes clusters. It is designed to help Observe users quickly diagnose common problems and gather the right information before contacting Support.

Problems Fleet Management Helps Solve¶

Fleet Management is designed to answer the two questions every user arrives with:

“Is the agent healthy?”¶

The Fleet Management surfaces:

Auth check status
Endpoint connectivity
Data flow health (logs, metrics, traces)
Configuration issues
Version drift
Workload readiness (Kubernetes)

If something is wrong, Fleet Management shows the symptom and the next likely cause.

“If not, what’s the next thing I should look at?”¶

Fleet Management guides users through a structured troubleshooting workflow:

Authentication Errors (401 / 403)
Endpoint Errors (400 / 404 / 500)
Data Flow Errors (logs, metrics, traces)
Configuration Issues (multiline, recombine, etc.)

Prerequisites¶

Observe Agent v2.10.1 or higher

Verify the installed version:

$ observe-agent version
observe-agent version: 2.10.1

If you haven’t installed the Observe Agent, please follow the installation instructions.

Setup¶

Kubernetes

1. Create fleet-values.yaml

agent:
  config:
    global:
      fleet:
        enabled: true
        interval: 10s
        configInterval: 10m

2. Redeploy the agent

helm upgrade --reuse-values observe-agent observe/agent -n observe --values fleet-values.yaml

3. Restart agent pods

kubectl rollout restart deployment -n observe
kubectl rollout restart daemonset -n observe

4. Verify in Fleet Management

Navigate to Data & Integrations → Fleet and confirm your Observe Agent instances appear.

Linux

1. Enable fleet configuration

Edit your agent configuration:

sudo vim /etc/observe-agent/observe-agent.yaml

Add or update:

self_monitoring:
  enabled: true
  fleet:
    enabled: true
    interval: 10m
    config_interval: 24h

2. Restart the agent

sudo systemctl restart observe-agent

3. Verify in Fleet Management

Navigate to Data & Integrations → Fleet and confirm your Observe Agent instances appear.

Windows

1. Enable fleet configuration

Edit your agent configuration in C:\Program Files\Observe\observe-agent\observe-agent.yaml.

Add or update:

self_monitoring:
  enabled: true
  fleet:
    enabled: true
    interval: 10m
    config_interval: 24h

2. Restart the agent

Restart-Service ObserveAgent

3. Verify in Fleet Management

Navigate to Data & Integrations → Fleet and confirm your Observe Agent instances appear.

MacOS

1. Enable fleet configuration

Edit your agent configuration:

sudo vim /usr/local/observe-agent/observe-agent.yaml

Add or update:

self_monitoring:
  enabled: true
  fleet:
    enabled: true
    interval: 10m
    config_interval: 24h

2. Restart the agent

sudo launchctl stop "com.observeinc.agent"

3. Verify in Fleet Management

Navigate to Data & Integrations → Fleet and confirm your Observe Agent instances appear.