Host status in orcharhino

In orcharhino, each host has a global status that indicates which hosts need attention. Each host also has sub-statuses that represent status of a particular feature. With any change of a sub-status, the global status is recalculated and the result is determined by statuses of all sub-statuses.

Host global status overview

The global status represents the overall status of a particular host. The status can have one of three possible values: OK, Warning, or Error. You can find global status on the Hosts Overview page. The status displays a small icon next to host name and has a color that corresponds with the status. Hovering over the icon renders a tooltip with sub-status information to quickly find out more details. To view the global status for a host, in the orcharhino management UI, navigate to Hosts > All Hosts.

OK

No errors were reported by any sub-status. This status is highlighted with the color green.

Warning

While no error was detected, some sub-status raised a warning. For example, there are no configuration management reports for the host even though the host is configured to send reports. It is a good practice to investigate any warnings to ensure that your deployment remains healthy. This status is highlighted with the color yellow.

Error

Some sub-status reports a failure. For example, a run contains some failed resources. This status is highlighted with the color red.

Search syntax

If you want to search for hosts according to their status, use the syntax for searching in orcharhino that is outlined in the Searching and Bookmarking in Administering orcharhino, and then build your searches out using the following status-related examples:

To search for hosts that have an OK status:

global_status = ok

To search for all hosts that deserve attention:

global_status = error or global_status = warning

Host sub-status overview

A sub-status monitors only a part of a host’s capabilities.

To view the sub-statuses of a host, in the orcharhino management UI, navigate to Hosts > All Hosts and click on the host whose full status you want to inspect. You can view the global host status next to the name of the host and the host sub-statuses on the Host status card.

Each sub-status has its own set of possible values that are mapped to the three global status values.

Below are listed sub-statuses that orcharhino contains.

Configuration

This sub-status is only relevant if orcharhino uses a configuration management system like Ansible, Puppet, or Salt.

Possible values:

Label Global host status

Alerts disabled

OK

Active

OK

Pending

OK

No changes

OK

No reports

OK / Warning

Out of sync

Warning

Error

Error

Additional information about the values of this sub-status:

  • Active: During the last configuration, some resources were applied.

  • Pending: During the last configuration, some resources would be applied but your configuration management integration was configured to run in noop mode.

  • No changes: During the last configuration, nothing changed.

  • No reports: This can be both a Warning or OK status. When there are no reports but the host uses an associated orcharhino Proxy for configuration management or the always_show_configuration_status setting is set to true, it maps to Warning. Otherwise it maps to OK.

  • Error: This indicates an error during configuration. For example, a configuration run failed to install a package.

  • Out of sync: A configuration report was not received within the expected interval, based on the outofsync_interval setting. Reports are identified by an origin and can have different intervals based upon it.

Build

This sub-status is only relevant for hosts provisioned from orcharhino or hosts registered through global registration.

Possible values:

Label Global host status Number value

Installed

OK

0

Pending installation

OK

1

Token expired

Error

2

Installation error

Error

3

Compliance

Indicates if the host is compliant with OpenSCAP policies.

Possible values:

Label Global host status Number value

Compliant

OK

0

Inconclusive

Warning

1

At least one incompliant

Error

2

OVAL scan

Indicates if there are any vulnerabilities found on the host

Possible values:

Label Global host status Number value

No vulnerabilities found

OK

0

Vulnerabilities found

Warning

1

Vulnerabilities with available patch found

Error

2

Execution

Status of the last completed remote execution job.

Possible values:

Label Global host status Number value

Last execution succeeded / No execution finished yet

OK

0

Last execution failed

Error

1

Unknown execution status

OK

2 or 3

Last execution cancelled

OK

4

Inventory

Indicates if the host is synchronized to Red Hat Hybrid Cloud Console. orcharhino Server performs the synchronization itself but only uploads basic information to Red Hat Hybrid Cloud Console.

Only applies if you have the Red Hat Cloud plugin installed.

Possible values:

Label Global host status Number value

Host was not uploaded to your RH cloud inventory

Warning

0

Successfully uploaded to your RH cloud inventory

OK

1

Insights

Indicates if the host is synchronized to Red Hat Hybrid Cloud Console. This synchronization is performed by the host. The host uploads more information than the orcharhino Server.

Possible values:

Label Global host status Number value

Reporting

OK

0

Not reporting

Error

1

Errata

Indicates if Errata is available on the host.

Possible values:

Label Global host status Number value

Up to date

OK

0

Unknown

Warning

1

Needed errata

Error

2

Needed security errata

Error

3

Subscription

Indicates if the host has a valid RHEL subscription.

Possible values:

Label Global host status Number value

Fully entitled

OK

0

Partially entitled

Warning

1

Unentitled

Error

2

Unknown

Warning

3

Unsubscribed hypervisor

Warning

4

SCA enabled

OK

5

Service level

Indicates if a subscription matching your specified Service level syspurpose value can be attached.

Possible values:

Label Global host status Number value

Unknown

OK

0

Mismatched

Warning

1

Matched

OK

2

Not specified

OK

3

Role

Indicates if a subscription matching your specified Role syspurpose value can be attached.

Possible values:

Label Global host status Number value

Unknown

OK

0

Mismatched

Warning

1

Matched

OK

2

Not specified

OK

3

Usage

Indicates if a subscription matching your specified Usage syspurpose value can be attached.

Possible values:

Label Global host status Number value

Unknown

OK

0

Mismatched

Warning

1

Matched

OK

2

Not specified

OK

3

Addons

Indicates if a subscription matching your specified Addons syspurpose value can be attached.

Possible values:

Label Global host status Number value

Unknown

OK

0

Mismatched

Warning

1

Matched

OK

2

Not specified

OK

3

System purpose

Indicates if a subscription matching your specified syspurpose values can be attached.

Possible values:

Label Global host status Number value

Unknown

OK

0

Mismatched

Warning

1

Matched

OK

2

Not specified

OK

3

RHEL Lifecycle

Indicates the current state of the Red Hat Enterprise Linux operating system installed on the host.

Possible values:

Label Global host status Number value

Unknown

OK

0

Full support

OK

1

Maintenance support

OK

2

Approaching end of maintenance support

Warning

3

Extended support

OK

4

Approaching end of support

Warning

5

Support ended

Error

6

Traces

Indicates if the host needs a reboot or a process restart.

Possible values:

Label Global host status Number value

Unknown

Warning

-1

Up to date

OK

0

Required process restart

Error

1

Required reboot

Error

2

Search syntax

If you want to search for hosts according to their sub-status, use the syntax for searching in orcharhino that is outlined in the Searching and Bookmarking chapter of the Administering orcharhino guide, and then build your searches out using the following status-related examples:

You search for hosts' configuration sub-statuses based on their last reported state.

For example, to find hosts that have at least one pending resource:

status.pending > 0

To find hosts that restarted some service during last run:

status.restarted > 0

To find hosts that have an interesting last run that might indicate something has happened:

status.interesting = true

The text and illustrations on this page are licensed by ATIX AG under a Creative Commons Attribution Share Alike 4.0 International ("CC BY-SA 4.0") license. This page also contains text from the official Foreman documentation which uses the same license ("CC BY-SA 4.0").