Microsoft Azure

Sections

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

  • Hosts, including host attributes.

  • Microsoft Azure 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
Azure hosts pageDisplays summary information about host instances running in your Microsoft Azure 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 Azure hosts summary page. Additional attributes are also displayed on the Host details page.
AttributeFacet::attributeDescription
Created at azure_computeInstance::Created The date and time the resource was created.
Data disks azure_computeInstance::DataDisks The parameters used to add the data disk to the virtual machine.
ID azure_computeInstance::ID The resource ID.
Image azure_computeInstance::Image The virtual machine image.
Instance type azure_computeInstance::InstanceType The type of instance.
IP address host::privateIPv4 The private IP version 4 address.
Key name azure_computeInstance::KeyName The keypair name.
Last scanThe Last scan of the host represented by the data platform timestamp in UTC.
Location azure_computeInstance::Location The location of the resource.
MAC address azure_computeInstance::MacAddress The MAC address assigned to the resource.
Name host::name The name of the host.
Operating system computeHost::os The operating system running on the host.
OS disk azure_computeInstance::OSDisk The name of the operating system used by the virtual machine.
OS version computeHost::osVersion The version of the operating system running on the host.
Puppet version computeHost::puppetVersion The version of Puppet installed.
Resource group azure_computeInstance::ResourceGroup The name of the resource group.
Size azure_computeInstance::VMSize The size type of the virtual machine.
Status azure_computeInstance::Status The status of the virtual machine.
Subscription ID azure_computeInstance::SubscriptionID The subscription ID.
Tags azure_computeInstance::Tags A list of tags relevant to the content of the image.
Uptime computeHost::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

Discovered 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.