Updated on 2024-02-28 GMT+08:00

Managing Host Groups

Host groups allow you to configure host log ingestion efficiently. You can sort multiple hosts to a host group and associate the host group with log ingestion configurations. The ingestion configurations will be applied to all the hosts in the host group, saving you the trouble of configuring the hosts individually.

  • When there is a new host, simply add it to a host group and the host will automatically inherit the log ingestion configurations associated with the host group.
  • You can also use host groups to modify the log collection paths for multiple hosts at one go.

Creating a Host Group (IP Address)

  1. Log in to the LTS console, and choose Host Management in the navigation pane on the left. On the displayed page, click Create Host Group in the upper right corner.
  2. In the displayed slide-out panel, enter a host group name and select a host OS (Linux).

    Figure 1 Creating an IP address host group
  3. In the host list, select one or more hosts to add to the group and click OK.
    • You can filter hosts by host name or host IP address. You can also click and enter multiple host IP addresses in the displayed search box to search for matches.
    • If your desired hosts are not in the list, click Install ICAgent. On the displayed page, install ICAgent on the hosts as prompted. For details, see Installing ICAgent.

Creating a Host Group (Custom Identifier)

  1. On the Host Management page, click Create Host Group in the upper right corner.
  2. On the displayed Create Host Group page, enter a host group name in the Host Group field and set Host Group OS to Custom Identifier.

    Figure 2 Creating a custom identifier host group
    • A host group with a custom ID supports only Linux hosts.
    • You can click Learn about the rules for filling in the collection path to learn how to configure paths.
  3. Click to add a custom identifier.

    Up to 10 custom identifiers can be added.

  4. Click OK.
  5. Run the following commands to create the custom_tag file:
    1. Run the cd /opt/cloud command. In the cloud directory, run the mkdir lts command to create the lts directory.
    2. Run the chmod 750 lts command to modify the permission on the lts directory.
    3. Run the touch custom_tag command in the lts directory to create the custom_tag file.
    4. Run the chmod 640 custom_tag;vi custom_tag command to modify the custom_tag permission and open the file.
    5. Press i to enter the insert mode, enter a custom identifier, press Esc, enter :wq!, save the modification and exit.

    After 5, you can use either of the following methods to add hosts to a custom host group:

    Method 1 (recommended):

    Linux

    In the custom_tag file of the /opt/cloud/lts directory on the host, view the host identifier and add it to the custom host group identifiers to add the host to the host group. For example, in the custom_tag file of the /opt/cloud/lts directory on the host, the identifier of the host is test1, and the custom identifier of the host group is test1. That is, the host is added to the host group.

    Method 2:

    Linux

    • To add a host to a host group, add the custom host group identifier to the custom_tag file in the /opt/cloud/lts directory on the host. For example, if the custom identifier of the host group is test, enter test in the custom_tag file to add the host to the host group.
    • If multiple custom identifiers are added, enter any custom identifier in the custom_tag file of the /opt/cloud/lts directory on the host to add the host to the host group.

Modifying a Host Group

You can change the name of a host group, add hosts to or remove hosts from a host group, or associate a host group with log ingestion configurations.

Table 1 Operations on host groups

Operation

Procedure

Changing a host group name

  1. On the Host Management page, the Host Groups tab is displayed by default.
  2. On the Host Groups tab page, click the modify button in the Operation column of the row containing the target host group.
  3. On the displayed dialog box, modify the information such as the host group name and custom identifier.
  4. Click OK.

Adding hosts to a host group

Method 1:

  1. On the Host Management page, click the Host Groups tab, and click in the row containing the target host group.
  2. Click Add Host.
  3. In the displayed slide-out panel, all hosts that are not in the host group and run the selected OS type are displayed. Select the hosts to be added to the host group.
    • You can filter hosts by host name or host IP address. You can also click and enter multiple host IP addresses in the displayed search box to search for matches.
    • If your desired hosts are not in the list, click Install ICAgent. On the displayed page, install ICAgent on the hosts as prompted. For details, see Installing ICAgent.
  4. Click OK.

Method 2:

  1. On the Host Management page, click the Hosts tab.
  2. In the host list, select the target hosts and click Add to Host Group.
  3. In the displayed slide-out panel, select the target host group.
  4. Click OK.

Removing a host from a host group

  1. On the Host Management page, click the Host Groups tab, and click in the row containing the target host group.
  2. In the host list, click Remove in the Operation column of the row containing the host to be removed.
  3. In the displayed dialog box, click OK.
NOTE:

This operation is not supported for hosts in the custom identifier host group.

Uninstalling ICAgent from a host

  1. On the Host Management page, click the Host Groups tab, and click in the row containing the target host group.
  2. In the host list, click Uninstall ICAgent in the Operation column of the row containing the target host.
  3. In the displayed dialog box, click OK to uninstall ICAgent from the host and remove the host from the host group.
    NOTE:
    • This operation is not supported for hosts in the custom identifier host group.
    • If the host has also been added to other host groups, it will be removed from those groups as well.

Removing hosts from a host group

  1. On the Host Management page, click the Host Groups tab, and click in the row containing the target host group.
  2. In the host list, select the target hosts and click the Remove button above the list.
  3. Click OK.

Associating a host group with an ingestion configuration

  1. On the Host Management page, click the Host Groups tab, and click in the row containing the target host group.
  2. Click the Associated Ingestion Configuration tab.
  3. Click Associate.
  4. In the displayed slide-out panel, select the target ingestion configuration.
  5. Click OK. The associated ingestion configuration is displayed in the list.

Disassociating a host group from an ingestion configuration

  1. On the Associated Ingestion Configuration tab, click Disassociate in the Operation column of the row containing the target ingestion configuration.
  2. Click OK.

Disassociating a host group from multiple ingestion configurations

  1. On the Associated Ingestion Configuration tab, select the target ingestion configurations and click the Disassociate button above the list.
  2. Click OK.

Deleting Host Groups

Deleting a single host group

  1. On the Host Management page, the Host Groups tab is displayed by default.
  2. On the Host Groups tab, click the deletion icon in the Operation column of the row containing the target host group.
    Figure 3 Deleting a host group
  3. In the displayed dialog box, click OK.

Deleting host groups in batches

  1. On the Host Groups tab, select multiple host groups to be deleted and click Delete above the list.
  2. In the displayed dialog box, click OK.