Network hosts

Sections

To discover host instances running on your network, including host attributes, add your IP address source. In addition to this, add your host credentials and Puppet Discovery discovers each host instance's attributes, the system services, the users and groups belonging to each instance, along with packages, tags, and containers.

Important: The ICMP protocol is required for discovering hosts using the network based (IP) discovery.

What resources can I discover?

Depending on the level of credentials you enter, this table lists the depth of resources that you can discover.

CredentialsDiscovered resources
  • IP address source.

  • Hosts, including host attributes.

  • IP address range.

  • SSH or WinRM host credentials.

  • Hosts, including host attributes.

  • Services

  • Users

  • Groups

  • Tags

  • Packages, including package attributes.

  • Container images, including container attributes.

This table lists the pages where you can view the discovered resources.

UI pageDescription
Hosts summary pagesDepending on which dashboard card you select, each page displays summary information about host instances across your entire infrastructure.
Host details pageLists the host instance's attributes, the system services, the users and groups belonging to each instance, along with packages, tags, and containers.
Packages summary page.Accessed by selecting the packages dashboard card, view a list of packages in use across your infrastructure.
Package details page.Lists various types of information about a package instance; its attributes, along with a list of hosts and containers it's installed on.
Containers summary page.Accessed by selecting the containers dashboard card, view a list of container instances running on your infrastructure.
Container details page.Lists various types of information about a container image; it's attributes, packages in use, and it's label information.

Hosts

Puppet Discovery considers each host as a network accessible resource, whether it's physical or virtual, and discovers attributes that define the host's state and properties.

Important: To discover resources running on an Unknown host, you must enter the host credentials.

Attributes

Puppet Discovery groups attributes into a number of different facets to give you even more insights into each host. A facet represents a set of related attributes, each one independently maintained, that describe a certain aspect of a discovered resource.

AttributeDescription
dnsName The private DNS name.
hostname The name of the host.
name The resource name.
os The operating system running on the host.
osKernel The type of kernel running in the operating system: Linux or Windows.
osVersion The version of the operating system running on the host.
privateIPv4 The private IP version 4 address.
privateIPv6 The private IP version 6 address.
publicDnsName Fully qualified public DNS hostname.
publicIPv4 The IP version 4 address.
puppetInstalled The indicator on whether Puppet is installed.
puppetVersion The version of Puppet installed.
uptime The uptime for the host, in seconds.

Services

Discover services on the host, and their state:
  • Service - the name of the service, derived from the name attribute.

  • State - the current state of the service derived from the state attribute: running, stopped, or failed.

Important: To stop or start a system service, run the manage services task on your Linux or Windows hosts. For more information, see running tasks on target hosts.

To find a specific service, filter the list by the service name.

Users

Discover users associated with the host, and their home directory:
  • User - the name of the user, derived from the name attribute.

  • Home - the home directory of the user, derived from the home attribute.

To find a specific user, filter the list by the user name.

Groups

Discover user groups associated with the host. The Group name is derived from the name attribute.

To find a specific group, filter the list by the group name.

Tags

Discover tags relating to the host:
  • Name - the tag name, derived from the name attribute.

  • Value - the tag value, derived from the value attribute.

To find a specific tag, filter the list by the tag name.

Packages

Discover various types of information about a package instance, its attributes, along with a list of hosts and containers it's installed on.

Attributes

Discover attributes that describe the characteristics of the package. The UI queries the data platform to discover the name, version, and packageManager attributes.

AttributeDescription
name The package name.
version The package version.
packageManager The name of the package manager:
  • apk

  • Chocolatey

  • dpkg

  • rpm

  • msi

Important: To manage packages, run the manage package task on your Linux or Windows hosts. For more information, see running tasks on target hosts.

Container images

Discover various types of information about a container image; it's attributes, packages in use, and it's label information.

Attributes

Discover attributes that describe the characteristics of the container. The UI queries the data platform for the discovered container facet.

AttributeDescription
name The container name for processes running inside the container.
dockerAPIVersion The version of the Docker Engine API.
dockerMinAPIVersion The minimum version of the Docker Engine API.
dockerVersion The version of Docker.
id The Docker container ID for processes running inside the container.
imageName The Docker image name for processes running inside the container.
Important: To discover containers, your Linux credentials must be for the root account or an account that is a member of the Docker group. For more information, see managing Docker.

Labels

Discover the container label names and values:
  • Label - the label name, derived from the name attribute.

  • Value - the label value, derived from the value attribute.

How helpful was this page?
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.