Configuration

Enabling the saved search(es)

Prior to Broken Hosts 4.0, the majority of the app was contained in a search called “Broken Hosts Sanity Check.” This search was a slow, monolithic search that made customized alerting difficult. Beginning in Broken Hosts 4.0, the search has been broken into two pieces (for more details, see the Saved Searches documentation). The bh_stats_gen search is enabled by default and does not require configuration. Alerting, however, is done through a separate search.

Broken Hosts 4.0 ships with two example alerting searches, Broken Hosts Alert Search and Broken Hosts Alert - by contact. These searches are meant primarily to be examples of how to build alerting using the Broken Hosts data, and can easily be duplicated, tweaked, or replaced altogether depending on your requirements. If you’re new to Broken Hosts, we suggest starting with Broken Hosts Alert Search and customizing from there. If you’re upgrading from an older version of Broken Hosts and want to continue getting the alerts you’re used to, you can use Broken Hosts Alert - by contact.

Modifying the macros

There are a number of macros defined within the Broken Hosts app to allow users to customize the behavior of the stock searches without significant effort. Some of the macros apply to the stats collection search, while others are used within the alert searches.

For more information on the macros available for fine-tuning the Broken Hosts app, see the Macros documentation.