See remaining disk space for all of my hosts

[noahtalerman]

Problem

I'm an engineer managing thousands hosts and I'm overwhelmed with tracking the following goal:

• Make sure all hosts have enough remaining disk space to install operating system updates. These operating system updates include security fixes that are crucial for my organization.

This makes is hard to make progress on this goal because I don't know what hosts I need to take action on.

Goals

1. Add ability to see remaining disk space for all of my hosts.

• We'll accomplish this by adding a "Disk space available" column to the Hosts page.

2. Add ability to know which hosts don't have enough available disk space for operating system updates.

• We'll accomplish this by adding a "yellow" (less than 32.0 GB remaining) and "red" (less than 16.0 GB remaining) state to the disk space available items.
  • Yellow indicates "Not enough disk space available to install most large operating systems updates."
  • Red indicates "Not enough disk space available to install most small operating systems updates."

Figma

https://www.figma.com/file/hdALBDsrti77QuDNSzLdkx/%F0%9F%9A%A7-Fleet-EE-(dev-ready%2C-scratchpad)?node-id=7645%3A271765

Requirements

• [ ] User can see, and navigate to, a list of hosts filtered by macOS operating system version.
• [ ] On the Hosts page, user can see the remaining disk space available and an indicator that visually presents the percentage of disk space available for each host.
• The visual indicator is green when there is greater than 32.0 GB of remaining disk space. The user can view a tooltip that has unique copy for this green indicator.
• The visual indicator is yellow when there is 32.0 GB or less remaining disk space. The user can view a tooltip that has unique copy for this yellow indicator.
• The visual indicator is red when there is 16.0 GB or less remaining disk space. The user can view a tooltip that has unique copy for this red indicator.
• [ ] The "Disk space" column is turned on by default.
• [ ] The user can hide the "Disk space" column in the "Edit columns" modal.

Parent Epic

• #397

How?

Inform engineer which hosts have undesired amount of remaining disk space.

Child issues

Frontend:

1. Add "Disk space" column and tooltips to Hosts page.

• #6550

4. Update the "Disk space" element on the Host details page with new colors and tooltips.

• #6551

5. Add "View all hosts" button to the existing macOS Operating systems table.

• Covered by #6499

6. Add a macOS Operating system filter on the Hosts page

• Covered by #6499

Backend:

1. Add a new filter to the GET /hosts API

• #6475

2. Disk space data is already being provided in the GET /hosts API response:

{
  "gigs_disk_space_available": 378.87,
  "percent_disk_space_available": 75
}

[noahtalerman]

EDIT: I just realized the below would ideally include a breaking change to the GET /os_version API. I think we'll need to come back to this in the next major version (Fleet 5).

@lukeheath heads up, I updated the proposed UI changes to break the name column into separate name and version columns:

Reasoning is the same as breaking up Windows operating systems into separate name and version. This reasoning is here: https://github.com/fleetdm/fleet/issues/6428#issuecomment-1175416943

[noahtalerman]

@lukeheath I updated the dev note in the linked Figma to call out the new name_only and version API properties.

Linking to the dev note here: https://www.figma.com/file/hdALBDsrti77QuDNSzLdkx/%F0%9F%9A%A7-Fleet-EE-(dev-ready%2C-scratchpad)?node-id=7720%3A275916

[lukeheath]

@noahtalerman Now that this is spec'd and estimated I'm assigning the epic back to you as the epic DRI.

[noahtalerman]

5. Add "View all hosts" button to the existing macOS Operating systems table.

• Covered by https://github.com/fleetdm/fleet/issues/6499

6. Add a macOS Operating system filter on the Hosts page

• Covered by https://github.com/fleetdm/fleet/issues/6499

@lukeheath I don't see (5) and (6) above in #6499. Are these requirements covered in a separate issue? Or, should I add these to #6499 and let Gabe (assigned to #6499) know?

[lukeheath]

@noahtalerman Thanks for calling this out! Those items got missed in the spec. I've added them in. No need to let Gabe know because he has not started on this yet.

[lukeheath]

@noahtalerman This feature was released in 4.19.0. Would you please confirm and close out this epic when you are available? Thanks!

[noahtalerman]

This feature was released in 4.19.0.

Confirmed! Thanks for the reminder Luke.

No doc updates are required for this epic.