5.3. The Host Overview Page

⁠5.3. The Host Overview Page

The host overview page displays information about a given host and the connection between the host and the installer. You can view the host overview page for a host by clicking Hosts → All hosts, and clicking the name of a host.

Note

The information displayed in the host overview page is based on facts and reports collected from the host. For more information on facts and reports, see Chapter 7, Monitoring Hosts.

⁠

Figure 5.3. The host overview page

The Details Bar

The details bar contains a row of buttons that provide shortcuts to more information about the host, and tabs that display summaries of important details and events.

Audits: Displays a page containing audit entries for the current host, if any.
Facts: Displays the Facts page, and applies a filter so that only the facts for the current host are displayed. This button is only available after the installer has collected facts from the host.
Reports: Displays the Reports page, and applies a filter so that only the reports for the current host are displayed. This button is only available after the installer has collected reports from the host.
YAML: Displays a page containing details about the host in YAML format, such as its IP address, MAC address, and the name and values of parameters that have been applied to the host.
Properties: A list of general details about the host, such as its IP address, MAC address, and the operating system entry that has been applied to the host.
Metrics: A table displaying a summary of all events reported for the host.
Templates: A list of all provisioning templates currently accessible by the host. The provisioning templates include in this list are automatically configured in accordance with the operating system entry applied to the host.

Host Actions

In addition to displaying information about the host, the host overview page also provides a number of buttons for performing common actions on the host.

Edit: Opens the host details page for the host and allows you to configure settings for the host. However, in principle, the installer configures all the details required for provisioning the host, and no manual configuration is required.
Build: Flags the host to be provisioned the next time it is restarted. After you click this button, the label changes to Cancel build, which allows you to cancel the provisioning operation. The button reverts to Build after provisioning is complete. However, in principle, the installer manages all aspects of the provisioning process, and you do not need to manually provision hosts.
Run puppet: Executes a Puppet run on the host. This button is disabled by default, and must be manually enabled by setting the value of the puppetrun option to true in the Puppet tab of the Settings page accessed by clicking Administer → Settings.
Delete: Deletes the host from the user interface.

Host Graphs

The host overview page contains two graphs that display the status of recent Puppet runs executed on the host.

Runtime: This graph tracks two data points: Config Retrieval, and Runtime. The Config Retrieval data point represents the amount of time taken to collect information about the host during a given Puppet run, and the Runtime data point represents the amount of time required to execute the Puppet run. Both data points are measured in seconds.
Resources: This graph tracks the number of actions performed on the host during a Puppet run. The categories displayed in this graph are identical to those displayed in the Reports page, and are measured using the number of actions in each category.