Docs: Note mobile online/offline heuristic on Get hosts summary - #52572
Merged
Conversation
Adds a paragraph under **Get hosts summary** in the REST API reference explaining that iOS/iPadOS/Android hosts derive `online`/`offline` from the most recent MDM check-in (`nano_enrollments.last_seen_at` for Apple; `detail_updated_at` for Android) within a 1-hour window, instead of the osquery check-in interval used by other platforms. Docs-only slice of parent story #50155. Sibling PRs deliver the backend (#52518) and frontend (#52483) that make this behavior real. Closes #52571
RachelElysia
temporarily deployed
to
Docker Hub
September 4, 2026 14:02 — with 
GitHub Actions
Inactive
GitHub Actions
Inactive
Previous version split "Apple uses nano_enrollments" vs "Android uses detail_updated_at" — but the actual chart predicate takes the GREATEST of host_seen_times.seen_time and nano_enrollments.last_seen_at (active enrollments only), then falls back to detail_updated_at, uniformly across all three mobile platforms. Window is 3660s (~1h), not exactly 1h.
RachelElysia
had a problem deploying
to
Docker Hub
September 4, 2026 14:10 — with
GitHub Actions
Error
GitHub Actions
Error
…llback Previous version implied all three signals compete in a max. The actual SQL does GREATEST(hst.seen_time, ne.last_seen_at) FALLING BACK to detail_updated_at only when both are NULL — not a peer in the greatest-of. Reads truer to the COALESCE(GREATEST(...), fallback) shape.
RachelElysia
temporarily deployed
to
Docker Hub
September 4, 2026 14:16 — with
GitHub Actions
Inactive
GitHub Actions
Inactive
2 tasks
RachelElysia
marked this pull request as ready for review
September 4, 2026 15:17
rachaelshaw
approved these changes
Sep 4, 2026
2 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Issue
Closes #52571 (sub-issue of parent story #50155)
Description
docs/REST API/rest-api.mdexplaining that iOS/iPadOS/Android hosts deriveonline/offlinefrom the most recent MDM check-in —nano_enrollments.last_seen_atfor Apple;detail_updated_atfor Android — within a 1-hour window, instead of the osquery check-in interval used by other platforms.docs-v4.93.0so the note ships with the 4.93 reference-docs cut.Screenrecording
Testing
docs-v4.93.0after merge and confirms the paragraph appears under Get hosts summary.