HomeDocumentationAPI Reference
Log In
Documentation

Viewing Hosts

Once hosts are added to Sandfly, you can see a listing of them on the Hosts page. Sandfly will show you the first time this host was seen (e.g., when it was added), the last time it was successfully scanned, its hostname, and other details about authentication status, assigned credential, host tags, CPU load, and more.

Below you can see a list of active, inactive, and offline hosts. Active hosts are those that Sandfly was able to successfully authenticate to and inventory. Inactive hosts are those that had a problem authenticating or were unreachable for other reasons. Hosts marked offline were once active but have not been accessed by Sandfly in the last 24 hours. This offline state could be set for various reasons, so it is good to check as to why. Most typically, it is because the host is no longer in any scan schedule, or its schedule(s) may be deactivated or running in cycles greater than 24 hours.

A screenshot of the list of hosts

Host Listing

Viewing Host Details

Single-clicking a linked value or double-clicking a row of data, excluding the checkboxes and the buttons in the Actions column, will open the host's Details page, which contains all of the information available for the host.

A screenshot of the host Details page

Host Details Page

Tabs along the top of the Details page divide the selected host's data into the following groupings:

  • Summary - A dashboard overview with rolled-up information taken from the other tabs.
  • Triage - The host's alerting artifacts grouped by kind, worst first, with a summary card for the selected one. See Host Triage.
  • Detections - Shows the alerting artifacts for this host, one row for each artifact.
  • AI analysis - Lists the AI analyses of this host in the AI analysis workspace, with the newest one shown by default.
  • SSH - The host-centric view of its SSH data; the same display as found under SSH investigation > SSH hosts.
  • Hardware - Displays information on the CPU, memory, DMI info, mounts, and network interfaces.
  • Host info - Provides a sub-row of tabs which contain data obtained from various recon sandflies.
  • Operations - Provides a sub-row of tabs which contain operational information used by Sandfly.
  • Raw host data - Raw application data for this host provided in the JSON format.
A screenshot of the Raw host data tab

Raw Host Data Tab

Use the buttons above the JSON data to download it, copy all of it to the clipboard, or open it by itself in a new browser tab. You can also select and copy any desired portion of the textual data as needed.

Viewing Inactive Hosts

Hosts that could not be logged in to for whatever reason will show up with a yellow, slashed circle icon in the Status column and an "X" in the Active column. The Auth Status column contains information as to why the host is likely in this state.

A screenshot of inactive hosts

Inactive Hosts

Hosts Page Toolbar

The table toolbar on the Hosts page contains a quick search, quick filters, the Presets button, and the Filter button. The table's footer contains Export, Share (shares the current display via a URL), and Saved views. These buttons give you the ability to quickly narrow down your search on large host sets or gain access to additional data.

A screenshot of the Hosts page toolbar

Hosts Page Toolbar

Filtering

The Filter option allows you to quickly build detailed filters to narrow down the hosts that are displayed in the table. For instance, you could build a filter for hosts with an inactive (false) Auth Status, that start with a Target Address of 10., and are configured to use an SSH Port of 22 like in the image below. Use other combinations of these and other parameters as needed for displaying data as desired.

A screenshot of filtering down hosts

Filtering Down Hosts

Column Selector

The table on the Hosts page has many columns that can be displayed or hidden depending on your preference. To choose the columns, open the menu of any column header and select Manage columns.

A screenshot of the host's column selection

Host Column Selection

Export

You can select hosts and export the columns in the Comma Separated Values (CSV) format with the Export button in the table's footer. Visible column data will be prepared and downloaded via your browser.

Presets

Presets are predefined filters for common views of a table. On the Hosts page, the presets let you quickly see all active hosts or all inactive hosts. This can be used to quickly purge the system of hosts that are not responding.

Deleting Hosts

Hosts that are inactive or you do not want monitored any longer can be deleted.

Below, we used the Inactive Only preset filter to list all inactive hosts. Then we selected them all by clicking the checkbox in the header row of the table. The bulk actions bar over the column headers shows how many hosts are selected.

A screenshot of selecting inactive hosts

Selecting Inactive Hosts

To delete hosts, select them, and then click Delete in the bulk actions bar. It is important to note that all results data for any removed hosts that were active at some point will be scheduled for deletion in the background.

⚠️

WARNING: Deleting a Host Also Deletes All of its Results Data

All results data stored in Sandfly will also be removed when a host is deleted. Make a copy of any host data that you may want to store before deleting a host.


Did this page help you?