Amazon Web Services

Sections

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

Sources and credentialsDiscovered resources
  • Amazon Web Services source.

  • Hosts, including host attributes.

  • Amazon Web Services source.

  • SSH or WinRM 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
AWS hosts pageDisplays summary information about host instances running in your AWS 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.

Attributes

Puppet Discovery groups attributes into a number of different facets to give you even more insights into each instance. 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 AWS hosts summary page. Additional attributes are also displayed on the Host details page.
AttributeFacet::attributeDescription
AMI Name aws_ec2Instance::name The name of the Amazon Machine Image (AMI).
Availability zone aws_ec2Instance::Placement_AvailabilityZone The availability zone of the instance.
Creation Date aws_ec2Instance::CreationDate The date and time the resource was created.
Description aws_ec2Instance::Description The description of the image.
Image type aws_ec2Instance::imageType The type of image:
  • machine

  • kernel

  • ramdisk

Instance type aws_ec2Instance::InstanceType The instance type.
Key name aws_ec2Instance::KeyName The name of the key pair.
Last scanThe Last scan of the host represented by the data platform timestamp in UTC.
Launch time aws_ec2Instance::LaunchTime The date and time the resource was launched.
Name host::name The name of the host.
Operating system computeHost::os The operating system running on the instance.
OS version computeHost::osVersion The version of the operating system running on the instance.
Owner ID aws_ec2Instance::OwnerId The account ID of the image owner.
Private DNS Name aws_ec2Instance::PrivateDnsName The private DNS name.
Private IP address aws_ec2Instance::PrivateIpAddress The private IP version 4 address.
Public DNS Name aws_ec2Instance::PublicDnsName Fully qualified public DNS hostname.
Public IP address aws_ec2Instance::PublicIpAddress The public IP version 4 address.
Region cloudResource::region The region where the instance exists.
Security groups aws_ec2Instance::SecurityGroups The security group associated with the instance.
State aws_ec2Instance::Monitoring_State Indicates whether monitoring is enabled:
  • disabled

  • disabling

  • enabled

  • pending

Status cloudResource_status The current status of the instance.
State transition reason aws_ec2Instance::StateTransitionReason Describes the state change.
Subnet ID aws_ec2Instance::SubnetId The ID of the subnet.
Tags tags::name


                                        tags::value
                                    

The tag assigned to the AWS resource.
Uptime computeHost::uptime  The uptime for the instance, in seconds.
VM Image vm::image The image identification number.
VM key name vm::keyName The unique identifier for the file in storage.
VM virtualization type vm::virtualizationType The virtualization type:
  • pv

  • hvm

VPC ID aws_ec2Instance::VpcId The identification for the Virtual Private Cloud (VPC).

Services

Discover services on each 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.

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.

Groups

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

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.

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.