Hosts
The Hosts interface provides a comprehensive view of all endpoints running Santa across your organization. This centralized dashboard allows administrators to monitor, manage, and troubleshoot Santa deployments at scale.
Overview
The Hosts dashboard displays information about each endpoint:
- Hostname: The hostname of the endpoint
- Mode: Current mode of the Santa agent (learn more about modes)
- OS Version: Operating system version information with indicators for outdated versions
- Santa Version: Version of the Santa agent
- Last Sync: Time of last communication with the sync server
Host Details
Clicking on an individual host provides detailed information:
- Host Details: Hostname, UUID, primary user, hardware model, serial number, OS version/build, and Santa version with update indicators
- Client Mode: Current enforcement mode (Monitor, Lockdown, or Standalone) with ability to change settings
- Sync Information: Last sync time, rule sync time, last preflight and postflight times
- Sync Controls: Options to trigger immediate sync or perform a clean sync
- OS Updates: Indicators when updates are available for the operating system
- Santa Updates: Indicators when newer Santa versions are available
Changing Client Modes
To change the mode of a host, click the "Change Mode" button and select the desired mode.
Changing the mode of a host will immediately impact the behavior of the Santa agent on that host. This can cause disruption to users if not done carefully.
Syncing Hosts
Hosts can be synced manually or automatically.
- Manual Sync: Click the "Sync Now" button to force a sync of the host
- Clean Sync: Click the "Clean Sync" button to force a clean sync of the host.
A clean sync will take a long time to complete and should only be done when necessary.
Deleting Hosts
Hosts can be manually deleted. This will immediately delete all data about this host from the database but will leave events for that host in the events table.