This topic describes the features and usage of configuration lists.
Configuration lists provide an easy method to manage the inventory of the required resources. After you specify the required resources and list types to be collected, you can obtain the latest inventory and overview of the specified resources. Configuration lists allow you to collect the details of ECS instances and the information of properties that belong to ECS instances. These properties include files, applications, services, and networks.
After a configuration list is configured, you can view various dashboards based on the collected data. For example, you can check the number of Windows instances or Linux instances, and the ratio of Windows instances to Linux instances. You can also check on which instances the version of an application is installed and whether the latest update is installed on an instance. For more information about the supported configuration list types and property types, see Metadata types that are supported by configuration lists.
A Cloud Assistant client is required to collect the information that is specified in a configuration list. To collect the information of an inventory, you must install a Cloud Assistant client of the latest version on the required ECS instance. By default, a Cloud Assistant client is installed on official images. This applies to most cases. If you want to check the version of the Cloud Assistant client that runs on the required instance, see How can I install a Cloud Assistant client?
You must use an Alibaba Cloud account that is granted the required permissions to manage Operation Orchestration Service (OOS). If you use an account with administrator permissions, ignore the preceding note. If you use an account that is not granted the required permissions to manage OOS, you must grant these permissions to the account. For more information, see Use RAM to control access at the account level.
Create a configuration list
Log on to the OOS console.
In the left-side navigation pane, click Configuration Lists.
Click Create Configuration List.
Select the required instances, set a data collection plan, and then set a data collection scope in sequence.
Select the required instances. Several selection methods are available. Set this parameter to Select All.
Set a data collection plan. The Task Recurrence parameter specifies the interval at which a client collects data. Set this parameter to 1 Hour.
Set the required list information. You can select one or more list types in the following list. Set this parameter to Application.
After the preceding settings are configured, you can view the details on the List Details tab.
After the configuration list takes effect, the client collects the data of the specified list types on the destination resources at the specified interval. Note: Only property information rather than content information is collected regardless of which list types are specified.
Click the List Overview. On the tab that appears, you can view the statistics of collected data. The supported list types include the applications that are installed, the distribution of versions for applications, the types of operating systems, and the versions and release types of operating systems.
At the bottom of the List Details tab, you can view the instances for which configuration lists are created and the statuses of clients that collect data.
If you have finer-grained requirements, you can specify the property of a list type and set the required filter condition on the List Details tab. You must specify a comparison operator for each filter condition. Valid comparison operators include equal to, not equal to, begin with, less than, and greater than. This topic provides an example of how to query instances on which the wget application is installed.
- Find the Property Name field.
Select a property name from the drop-down list. In this example, select ACS:Application and select Name
- In the Property Value field, enter wget. Then, the List Details tab shows statistics in several forms.
The preceding steps describe how to create a configuration list and how the collected data can be viewed. You may need to change the specified scope of destination resource or list types, or delete some configuration lists that are no longer required. In this case, perform the following steps to update or delete a configuration list.
Update a configuration list
On the List Details tab, click Edit next to the required configuration list. In the dialog box that appears, update the required settings.
Delete a configuration list
On the List Details tab, click Delete next to the required configuration list. Note: After a configuration list is deleted, the collection plan for the related destination resources is canceled. Another configuration list that is used may contain all the data or a part of data from the same destination resources. In this case, you can still view the information of these resources on the List Details tab. To address the preceding issue, a topic that provides more details will be released in the future.
This topic provides the required information about how to view the statistics of collected data and manage the information of properties on the required resources. These properties include private networks, applications, and files. You may have familiarized yourself with how to use configuration lists to collect data through this topic. More and more methods how you can efficiently create configuration lists will be provided in the future. These methods include how to select destination resources. For example, you can manually select resources, select resources by resource group or tag, and select all resources. If you group resources by tag, this provides added convenience and better management of resources. In addition, support for more list types and methods to view resource information with ease will be provided at the earliest opportunity.