Search

Chapter 13. Host Status in Satellite

download PDF

In Satellite, 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.

13.1. 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 Satellite web 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 Satellite that is outlined in the Searching and Bookmarking in Administering Red Hat Satellite, 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

13.2. 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 Satellite web 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 Satellite contains.

Configuration

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

Possible values:

LabelGlobal 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 Capsule 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 Satellite or hosts registered through global registration.

Possible values:

LabelGlobal host statusNumber 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:

LabelGlobal host statusNumber 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:

LabelGlobal host statusNumber 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:

LabelGlobal host statusNumber 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. Satellite Server performs the synchronization itself but only uploads basic information to Red Hat Hybrid Cloud Console.

Possible values:

LabelGlobal host statusNumber 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 Satellite Server.

Possible values:

LabelGlobal host statusNumber value

Reporting

OK

0

Not reporting

Error

1

Errata

Indicates if Errata is available on the host.

Possible values:

LabelGlobal host statusNumber 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:

LabelGlobal host statusNumber 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:

LabelGlobal host statusNumber 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:

LabelGlobal host statusNumber 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:

LabelGlobal host statusNumber 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:

LabelGlobal host statusNumber 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:

LabelGlobal host statusNumber value

Unknown

OK

0

Mismatched

Warning

1

Matched

OK

2

Not specified

OK

3

Traces

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

Possible values:

LabelGlobal host statusNumber 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 Satellite that is outlined in the Searching and Bookmarking chapter of the Administering Satellite 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
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.