HomeDocumentationAPI Reference
Log In
Documentation

Viewing Hosts

Once hosts are added to Sandfly, you can see a listing of them on the host view 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. Offline marked hosts 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.

Sandfly Host Listing

Sandfly Host Listing

Viewing Hosts Details

You can see details about the host by simply clicking on the linked value in the Target Address column or by double clicking anywhere on the row. A break out of the details will appear like in the image below.

Sandfly Host Details

Sandfly Host Details

Raw data about the host will have many more details. This JSON formatted data can be viewed by clicking on the Raw Host Data tab.

Sandfly Raw Host Data View

Sandfly Raw Host Data View

Viewing Inactive Hosts

Hosts that could not be logged into 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 could not be added to Sandfly.

Sandfly Inactive Hosts

Sandfly Inactive Hosts

Host View Toolbar

The toolbar for the host view contains Filters, filter Presets, custom Views, Columns selector, Export, and Share buttons. These buttons give you the ability to quickly narrow down your search on large host sets or get additional information.

Host View Top Bar

Host View Top Bar

Filtering

The Filters 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 a SSH Port of 22 like in the image below. Use other combinations of these and other parameters as needed for displaying data as desired.

Filtering Down Hosts

Filtering Down Hosts

Column Selector

The Hosts view has many columns that can be displayed or hidden depending on your preference. Simply toggle which columns that you want to see or not via the Columns' pop-up toggle boxes.

Host 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. Visible column data will be prepared and downloaded via your browser.

Presets

Presets have common options to use with a filter. In the Host view, the presets allow you to 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" filter preset to list all inactive hosts. Then we selected them all by clicking on the checkbox in the header row of the table. The quantity of selected entries is shown for your convenience at the bottom left corner of the table.

Selecting Inactive Hosts

Selecting Inactive Hosts

To delete hosts, simply click on the Delete button in the toolbar. 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.