Repository navigation
Releases
Collimo 0.3.1
Before you upgrade
Nothing changes on its own, and there are no new variables. Business and MSP keys unlock what they did before.
New
- A Pro edition, for homelabs. It covers seeing and running your own lab: the assistant, alert tuning, local users and single sign-on through OIDC, the hub for two sites, Resilience and the topology map, cluster consistency, placement advice and UPS battery aging. Capacity planning and forecasts, LDAP, reports, evidence packs, S3 copies and the business alert channels stay in Business and MSP. Settings → License says which edition each locked feature needs. Editions
- License changes without a new key. A corrected name, an upgrade, more sites or a renewal now reaches your install by itself, within a day. The key you entered stays the same. Settings → License says when your terms were last updated. Offline keys still need a new key. License check and privacy
Changed
- Alert thresholds: a "Computer sleeps" override is kept when you click Save, a value you type counts without leaving the box first, and an override with nothing set says so. Alert thresholds
- The VMware exit report's line about VMs that need care reads as a sentence for every count. VMware exit report
Upgrading
Set COLLIMO_VERSION=0.3.1 and redeploy. Updating Collimo
Collimo 0.3.0.1
A fix for 0.3.0, and the docs caught up with it.
Fixed
- Capacity → Network and Cooling: a warning under a link, a switch or a rack lost its first letter behind the amber bar beside it ("ts 95th percentile is forecast…"). It now reads in full, starting with a capital.
Docs
Every screenshot on docs.collimo.dev is retaken, and each feature that arrived in 0.3.0 has one:
- Renewals
- Resilience, with the Power table, and the topology map
- Cluster consistency and placement advice
- UPS battery aging
- Network capacity and rack cooling
- Evidence packs and Intel AMT
Upgrading
Nothing to change but the version: set COLLIMO_VERSION=0.3.0.1 and redeploy.
Collimo 0.3.0
Before you upgrade
One change needs a look first.
- Allocation forecasts no longer raise alerts on their own. The runway for CPU, memory and disk allocated to VMs is now shown for planning only, and what is actually in use is what alerts. If you relied on an allocation alert, for example because you never overcommit memory, set
CAPACITY_ALLOC_ALERTS=alloc_mem(any ofalloc_cpu,alloc_mem,alloc_disk, comma-separated). Forecasts
Four new variables, all optional and empty by default: CERT_WATCH, DOMAINS_WATCH, CAPACITY_ALLOC_ALERTS and CAPACITY_WAN. Settings → Stack environment writes them for you. Variables
New
- A Renewals tab. Every certificate Collimo already sees (https sources, https up-checks and consoles), plus any you add in
CERT_WATCH, your domains over RDAP if you list them inDOMAINS_WATCH, and vCenter licenses, soonest first under a year planner. A certificate warns once a third of its own lifetime is left. Collimo reads the dates and never renews anything. Free in every edition. Renewals - Resilience: what goes down with it. What fails with each switch, UPS, PDU and host, biggest first, and the single points of failure, such as a host whose every power supply is on one UPS. It's built from what Collimo already reads: uplinks and LLDP, the switch port each host plugs into, and NetBox's power cables. A Power table lists what feeds every switch, PDU, host and server, and lets you set a feed by hand where NetBox doesn't say. Anything Collimo can't see is listed as not known, never guessed. Resilience
- A topology map of the same graph, drawn as rack units, on the Resilience tab. Pick a unit to see what fails with it. Topology map
- Cluster consistency, on the Virtualization tab: hosts in one cluster whose build, BIOS, BMC firmware, MTU or VLANs differ from the rest. Cluster consistency
- Placement advice, on the Virtualization tab: which VMs to move to even out a Proxmox VE cluster, or a vCenter cluster with DRS off, and why any are held. It's advice only; Collimo never moves a VM. Placement advice
- UPS battery aging: each battery's health, trend and age from its runtime at its load, with a warning before runtime falls under 10 minutes. UPS battery aging
- Network capacity, on the Capacity tab: uplinks and WANs at their 95th percentile, and PoE budgets. Set
CAPACITY_WANto judge a WAN against its contracted speed instead of its best speedtest. Network capacity - Rack cooling, on the Capacity tab: each rack's inlet air from its servers' intake sensors, hot racks, and the daily trend. Rack cooling
- Audit evidence packs, from Settings: a zip for an auditor, signed by your install's own key, which
collimo -verify-packchecks. Evidence packs - Intel AMT, a new source kind for machines without a BMC, so cluster consistency can compare their BIOS. Intel AMT
- Every section folds to its heading, on every tab, and a folded section opens again when a new alert shows up in it. Expand all and Collapse all are kept through a reload. First look
Changed
- Right-sizing says when a VM is too small as well as too big, and vCenter VMs are no longer sized on active memory. Reclaim
- VLANs are read for UniFi ports that follow a port profile, and for Custom ports.
- Hosts are placed on switch ports by LLDP neighbors the UniFi client list doesn't name.
- Fixes to the Balance panel, the planning colors, Cooling, notification groups and the diagnostics bundle.
Upgrading
Set COLLIMO_VERSION=0.3.0 and redeploy. Read Updating Collimo first if you haven't kept a copy of SETTINGS_KEY and BACKUP_KEY.
Collimo 0.2.0
Before you upgrade
Three changes need a look first.
- Synology is now read over SNMPv3. Collimo no longer signs in to DSM's web interface, so a line like
synology https://192.168.1.30:5001is refused after the upgrade, and Settings → Sources says why. Turn on SNMPv3 in DSM, change the line to the NAS's address withouthttps://and the port, setuser=to the SNMP user, and put both passwords in the secret as<authentication password>:<privacy password>. Then delete the old administrator account in DSM: Collimo no longer needs it. Synology HUB_ENROLis nowHUB_ENROLL. This only matters for a site that hasn't joined its hub yet; a site already enrolled needs neither. A 0.2.0 collector still enrolls with an older hub, and a 0.2.0 hub still accepts older collectors.- Ceph alerts moved to the Storage tab. Their source is now
storage, so aNOTIFY_RULESrule for storage now covers Ceph, and one for Proxmox no longer does.
VictoriaMetrics is now pinned to v1.155.0 in docker-compose.yml instead of following latest. Redeploying pulls that version, and your history is kept.
New
- Last backup for every VM. Each VM on vCenter, Proxmox VE and XCP-ng is matched to its newest backup on Proxmox Backup Server, Veeam or HYCU. Over two days warns, and over a week, or none at all, is critical. A VM that no backup server answers for says "not checked", never "no backup". Last backup per VM
- Veeam Backup & Replication 12 and 13, with only the Viewer role, and HYCU (preview) as sources, each with its own panel.
- Your racks on the LAN tab, placed from NetBox or set by hand. A 2U device says U10–11.
- A Tools tab: ping, DNS, TLS, HTTP, TCP, traceroute, mail checks (MX, SPF and its lookups, DMARC, STARTTLS on port 25), and a port scan of one private address or a range up to a /24, on ports 1–1023 and 8000–10000. Admins only, closed while sign-in is off, and every run is audited. Free in every edition.
- Drives that are getting worse. Bad sectors, reconnects and media errors warn for a week after they rise, not because an old count is above zero. Pending sectors warn while they wait.
- UPSes shared over NUT, read without logging in, and UniFi PDUs read from the console.
- The hub shows capacity forecasts across every site, and the setup wizard can add a Tailscale sidecar, so a site joins with no port opened.
- License alerts for a key that has expired, been withdrawn or is ending soon. They can't be silenced.
- Every table sorts by its header, and data tables download as CSV or HTML.
- The VMware exit report uses your currency, puts the price first, saves as PDF, and prints in light or dark.
- Archive copies now include capacity history and the hub's state. A hub's keys are included only when the copy is encrypted.
Changed
- An alert already active when Collimo starts is never sent as a notification, except a license alert.
- Capacity drops a renamed or removed source's rows at once.
- QNAP names a disk's maker once, QuTS hero included.
- Synology on DSM 7.2: volumes listed beside their pool are read correctly.
- Every word Collimo shows is now in US English.
Upgrading
Set COLLIMO_VERSION=0.2.0 and redeploy. Read Updating Collimo first if you haven't kept a copy of SETTINGS_KEY and BACKUP_KEY.
Collimo 0.1.2
New
- Proxmox VE failover: a Proxmox VE slot can list every node of the cluster, and Collimo reads through whichever one answers.
- The newest speedtest for each link, on the WAN panel.
- The assistant sees the backup server a cluster writes to.
Changed
- A Proxmox VE VM with no memory figure from inside the guest is never shown as using more than its size.
- Capacity on a fresh install shows every source from its first poll. Before, vCenter, Proxmox VE and PBS could be missing for the first 15 minutes.
- The docs look like collimo.dev, with fresh screenshots.
Upgrading
Set COLLIMO_VERSION=0.1.2 and redeploy.
Collimo 0.1.1
Merge pull request #58: the rest of v0.1.1, Proxmox memory (#45) and docs
Collimo 0.1.0
Merge pull request 'qa into main: Collimo, the rack UI, capacity planning, and up-to-date docs' (#44) from qa into main