OpenStack

Sections

To discover host instances running on your OpenStack account, including host attributes, add your OpenStack 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.

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
  • OpenStack source.

  • Hosts, including host attributes.

  • OpenStack source.

  • 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
OpenStack hosts pageDisplays summary information about host instances running in your OpenStack account.
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.

Note: Listed below are the attributes that you can show or hide on the OpenStack hosts summary page. Additional attributes are also displayed on the Host details page.
AttributeFacet::attributeDescription
Server ID os_compute::ServerID The UUID of the server.
Name host::hostname
IP address host::privateIPv4 The private IP version 4 address.
Operating system computeHost::os The operating system running on the host.
OS version computeHost::osVersion The version of the operating system running on the host.
Uptime computeHost::uptime The uptime for the host, in seconds.
Last scanThe Last scan of the host represented by the data platform timestamp in UTC.
Puppet version computeHost::puppetVersionThe version of Puppet installed.
Created on os_compute::ServerCreated The date and time the resource was created.
Server Name os_compute::ServerName The server name.
Flavor os_compute::FlavorName The display name of the flavor.
Image name os_compute::ImageName The display name of the image.
Status os_compute::ServerStatus The current server state.
Security groups os_compute::security_groups The security group names.
VCPUs os_compute::vcpus The number of virtual CPUs in use.
RAM (MB) os_compute::ram The RAM (MB) on the virtual machine.
Disk (GB) os_compute::disk The disk size (GB) on the virtual machine.
Key name os_compute::key_name The keypair name.
IP addresses os_compute::ServerAddresses The IP addresses assigned to the virtual machine.
Metadata os_compute::ServerMetadata Custom server metadata at server launch time.

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.