Fleet Utilities util-v0.1.2

This release contains the fleet-util CLI tool with monitoring and diagnostic capabilities for Fleet.

Installation

Download the appropriate binary for your platform and make it executable:

# Linux AMD64
wget https://github.com/manno/fleet/releases/download/util-v0.1.2/fleet-util-linux-amd64
chmod +x fleet-util-linux-amd64
sudo mv fleet-util-linux-amd64 /usr/local/bin/fleet-util

# macOS ARM64 (Apple Silicon)
wget https://github.com/manno/fleet/releases/download/util-v0.1.2/fleet-util-darwin-arm64
chmod +x fleet-util-darwin-arm64
sudo mv fleet-util-darwin-arm64 /usr/local/bin/fleet-util

Usage

See README-MONITOR.md for detailed documentation.

% zcat ~/Downloads/2025-10-31_1900.json.gz| fleet analyze --diff
...
Snapshot 12 → 13
Time: 2025-10-31T19:12:40Z → 2025-10-31T19:13:55Z

RESOURCE COUNTS:
  GitRepos:           94 → 94    →
  Bundles:            384 → 383  ↓
  BundleDeployments:  495 → 496  ↑
  Contents:           180 → 180  →
  Clusters:           2 → 2      →

DIAGNOSTICS CHANGES:
  Stuck BundleDeployments:      13 → 13  →
  GitRepo/Bundle Mismatches:    7 → 7    →
  Bundles with No Deployments:  17 → 15  ↓
  Agent Issues:                 2 → 2    →

BUNDLE SIZE CHANGES:
  fleet-default/cloudfund: 308KB → 310KB ⚠ GREW
  fleet-default/email-release: 382KB → 381KB ✓ SHRUNK
  fleet-default/infra-prod: 324KB → 322KB ✓ SHRUNK
  ...

% fleet analyze --compare 2025-10-31_1900.json 2025-10-31_1951.json

=== COMPARING SNAPSHOTS ===

Before: 2025-10-31_1951.json (2025-10-31T20:04:52Z)
After:  2025-10-31_1900.json (2025-10-31T19:20:51Z)

RESOURCE COUNTS:
  GitRepos:           94 → 94    →
  Bundles:            383 → 384  ↑
  BundleDeployments:  497 → 497  →
  Contents:           178 → 180  ↑
  Clusters:           2 → 2      →

DIAGNOSTICS CHANGES:
  Stuck BundleDeployments:      12 → 12  →
  GitRepo/Bundle Mismatches:    7 → 16   ↑
  Bundles with No Deployments:  14 → 15  ↑
  Agent Issues:                 2 → 2    →

BUNDLE SIZE CHANGES:
  fleet-default/cloudfund: 308KB → 310KB ⚠ GREW
  fleet-default/email-release: 382KB → 381KB ✓ SHRUNK
  fleet-default/infra-prod: 324KB → 322KB ✓ SHRUNK
  ...

% zcat ~/Downloads/taxhawk-fleet-monitor-2025-10-23_1723.json.gz| fleet analyze

=== FLEET MONITORING SUMMARY - 2025-10-31T20:04:52Z ===


RESOURCE COUNTS
  GitRepos:           94
  Bundles:            383  (Total Size: 107438KB)
  BundleDeployments:  497
  Contents:           178
  Clusters:           2
  ClusterGroups:      1

DIAGNOSTICS SUMMARY
  Stuck Resources:
    - Stuck BundleDeployments:                12
  Inconsistencies:                            8  ⚠
    - GitRepo/Bundle Mismatches:              7
    - Content Issues:                         1
  Target Matching:                            16  ⚠
    - Bundles with No Deployments:            14
    - GitRepos with No Bundles:               2
    - ClusterGroups with No Clusters:         0
  Ownership Issues:                           10  ⚠
    - Bundles with Missing GitRepo:           7
    - BundleDeployments with Missing Bundle:  3
    - Resources with Multiple Finalizers:     0
  Agent Issues:                               2   ⚠
  Performance Issues:                         13  ⚠
    - Large Bundles (>1MB):                   2
    - Bundles with Missing Content:           11
  Generation Mismatches:                      10  ⚠
    - GitRepos:                               0
    - Bundles:                                0
    - BundleDeployments (SyncGen):            10

Included Files

• fleet-util-*: CLI binaries for various platforms
• checksums.txt: SHA256 checksums for all files