Help Center/ Log Tank Service/ User Guide/ Log Ingestion/ Using ICAgent to Collect Logs/ Managing Host Groups
Updated on 2024-12-05 GMT+08:00
View PDF
Share

Managing Host Groups

Host groups allow you to configure host log ingestion efficiently. You can add multiple hosts to a host group and associate the host group with log ingestion configurations. The ingestion configurations will then be applied to all the hosts in the host group. For details, see Figure 1.

  • 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.
Figure 1 Host groups

You can create host groups of the IP address and custom identifier types.

  • Creating a Host Group (IP Address): Select hosts of the IP address type and add them to the host group.
  • Creating a Host Group (Custom Identifier): You need to create identifiers for each host group and host. Hosts with an identifier will automatically be included in the corresponding host group sharing that identifier.

    Host groups with custom identifiers are suitable for the following scenarios:

    • In custom network environments like VPCs, potential IP address conflicts among hosts may impede ICAgent management in LTS. Using custom identifiers can resolve this issue.
    • Multiple servers using the same custom identifier enable auto scaling of host groups. Simply assign a custom identifier for a new host; LTS will then automatically identify the host and add it to corresponding host group with the same identifier.

Creating a Host Group (IP Address)

  1. Log in to the LTS console and choose Host Management > Host Groups in the navigation pane.
  2. Click Create Host Group in the upper right corner.
  3. In the displayed slide-out panel, enter a host group name, select IP for Host Group Type, and select a host OS (Linux or Windows).

    Figure 2 Creating an IP address host group

  4. 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 (Intra-Region Hosts) or Installing ICAgent (Extra-Region Hosts).

Creating a Host Group (Custom Identifier)

To create a host group of the custom identifier type, you need to plan the hosts to be identified in advance.

  1. Click Create Host Group in the upper right corner.
  2. In the displayed slide-out panel, enter a host group name, select Custom Identifier for Host Group Type, and select a host OS (Linux or Windows).
  3. Click and enter a custom identifier.

    Up to 10 custom identifiers can be added.

  4. Click OK. After the host group is created, go to 5 to add hosts to it.
  5. Perform the following operations to create the custom_tag file to save host tags:

    1. Log in to the host and run the cd /opt/cloud command. If the system indicates that the /opt/cloud directory does not exist, run the mkdir /opt/cloud/ command to create it. If the /opt/cloud directory already exists, navigate to it and run the mkdir lts command to create the lts directory in it.
    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.
    6. Use either of the following methods to add a host to the custom identifier host group:
      Table 1 Methods

      Type

      Method 1 (Recommended)

      Method 2

      Linux host

      View the host's identifier in the custom_tag file of the /opt/cloud/lts directory on the host. Then, add the identifier to the host group to include the host within it. For example, if the custom_tag file in the /opt/cloud/lts directory shows the host's identifier as test1, simply add test1 to the group's custom identifiers.
      • Add the host group's custom identifier to the custom_tag file in the /opt/cloud/lts directory on the host to include the host within the host group. For example, if the group's custom identifier is test, enter test into the custom_tag file.
      • If the group has multiple custom identifiers, simply enter any one of them into the custom_tag file of the /opt/cloud/lts directory on the host.

      Windows host

      View the host's identifier in the custom_tag file of the C:\opt\cloud\lts directory on the host. Then, add the identifier to the host group to include the host within it. For example, if the custom_tag file in the C:\opt\cloud\lts directory shows the host's identifier as test1, simply add test1 to the group's custom identifiers.
      • Add the host group's custom identifier to the custom_tag file in the C:\opt\cloud\lts directory on the host to include the host within the host group. For example, if the group's custom identifier is test, enter test into the custom_tag file.
      • If the group has multiple custom identifiers, simply enter any one of them into the custom_tag file of the C:\opt\cloud\lts directory on the host.

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. For details, see Table 2.

Table 2 Operations on host groups

Operation

Procedure

Changing a host group name
  1. Go to the Host Groups page.
  2. In the host group list, click the modification button in the Operation column of 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. In the host group list, click in the row containing the target host group whose type is IP.
  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. Choose Host Management > Hosts in the navigation pane..
  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. In the host group list, 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. In the host group list, 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. In the host group list, 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. In the host group list, 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.

Copying a host group ID

Hover your cursor over a host group name to copy the host group ID.

Exporting host information
  1. On the Hosts page, switch to the Intra-Region Hosts, CCE Cluster, or Extra-Region Hosts tab and select the desired hosts.
  2. Click Export to export the information of the selected hosts to the local PC.

Deleting Host Groups

  1. Choose Host Management > Host Groups in the navigation pane.
  2. Delete a host group:

    1. Click the deletion icon in the Operation column of the row containing the target host group.
    2. In the displayed dialog box, click OK.

  3. Delete host groups in batches:

    1. Select host groups to be deleted and click Delete above the list.
    2. In the displayed dialog box, click OK.