
# 管理LTS主机组
主机组是为了便于分类管理、提升配置多个主机日志采集的效率，对主机进行虚拟分组的单位。云日志服务支持通过一个接入配置来采集多台主机上的日志，您可以将这些主机加入到同一个主机组，并将该主机组关联至对应的接入配置中，配置日志接入时以主机组为单位下发采集配置，方便您对多台主机日志进行采集。请参考[图1]。
- 当用户扩容主机时，只需在主机组中添加主机，该主机会自动继承关联的日志路径，无需为每台主机重复配置路径。
- 当用户修改多个主机采集路径时，只需修改对应的主机组关联的路径，无需为每台主机重复配置路径。
图1主机组   
![](https://support.huaweicloud.com/usermanual-lts/zh-cn_image_0000002010432741.png "点击放大")
支持创建IP类型或自定义标识类型主机组。
- [创建主机组（IP地址）]：创建主机组时，直接勾选同类型主机加入该主机组即可，操作简单。
- [创建主机组（自定义标识）]：创建主机组时，需要在主机组和主机上分别创建标识，若标识存在交集，则会自动将该主机加入主机组内，操作方法复杂。
  若有以下场景，可以选择使用自定义标识主机组：
  - VPC等自定义网络环境中，可能出现不同服务器IP地址冲突的问题，导致日志服务无法管理ICAgent。使用自定义标识可以避免此类情况的发生。
  
  - 多台服务器通过同一个自定义标识实现主机组弹性伸缩。您只需为新增的服务器配置相同的自定义标识，日志服务可自动识别，并将其添加至主机组中。
   
#### 创建主机组
LTS支持创建IP类型或自定义标识类型的主机组。
- [创建主机组（IP地址）]
  
  1. 登录管理控制台，选择"管理与部署 \> 云日志服务 LTS"，进入"日志管理"页面。
  
  2. 左侧导航栏选择"主机管理 \> 主机组"，进入"主机组"页面。
  
  3. 单击"新建主机组"。
  
  4. 在弹出的新建主机组页面，参考[表1]设置参数。
     
      表1新建主机组（IP地址） 
     | 参数    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 示例           |
     |:---|:---|:---|
     | 主机组名称 | 自定义设置。主机组名称只支持输入英文、数字、中文、中划线、下划线及小数点，且不能以小数点、下划线开头或以小数点结尾。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | testECS      |
     | 主机组类型 | 选择"IP"，创建IP地址的主机组类型。 在主机组中添加服务器的IP地址，通过IP地址识别服务器。                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | IP           |
     | 主机类型  | 支持Linux主机或Windows主机。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Linux主机      |
     | 备注    | 自定义填写主机组描述信息，字符长度0-1024个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | -            |
     | 添加主机  | 在主机列表下方选择勾选已安装ICAgent的主机。请以实际环境中的主机信息为准。 - 可以通过主机名称、企业项目、IPv4或IPv6对主机列表进行过滤，也可以单击"批量搜索主机IP"，并在弹出的搜索框中输入多个主机IP，进行批量搜索。  - 当列表中没有所需主机时，单击"安装ICAgent"，在弹出的页面安装指引完成主机安装，具体操作可参见[安装ICAgent（区域内主机）](https://support.huaweicloud.com/usermanual-lts/lts_02_0013.html)或[安装ICAgent（区域外主机）](https://support.huaweicloud.com/usermanual-lts/lts_02_0828.html)。   | ECS-test-dqy |
        
     图2创建IP地址主机组   
     ![](https://support.huaweicloud.com/usermanual-lts/zh-cn_image_0000002535416545.png "点击放大")
     
     
  
  5. 单击"确定"，主机组创建成功，在主机组列表下方即可生成一条主机组信息。 
     图3主机组信息（截图仅供参考）   
     ![](https://support.huaweicloud.com/usermanual-lts/zh-cn_image_0000002522809109.png "点击放大")
     
     
   
- [创建主机组（自定义标识）]
  
  选择自定义标识主机组类型时，需要提前规划好需要添加标识的主机，且主机已安装ICAgent。
  1. 单击"新建主机组"。
  
  2. 在弹出的新建主机组页面，参考[表2]设置参数。
     
      表2新建主机组（自定义标识） 
     | 参数    | 说明                                                                                                 | 示例           |
     |:---|:---|:---|
     | 主机组名称 | 自定义设置。主机组名称只支持输入英文、数字、中文、中划线、下划线及小数点，且不能以小数点、下划线开头或以小数点结尾。                                         | testECS      |
     | 主机组类型 | 选择"自定义标识"，创建自定义标识的主机组类型。 在主机组和主机上分别创建标识，若标识存在交集，则会自动将该主机加入主机组内，操作方法复杂。 | 自定义标识        |
     | 主机类型  | 支持Linux主机或Windows主机。                                                                               | Linux主机      |
     | 备注    | 自定义填写主机组描述信息，字符长度0-1024个字符。                                                                        | -            |
     | 添加主机  | 在主机列表下方选择勾选已安装ICAgent的主机。请以实际环境中的主机信息为准。                                                           | ECS-test-dqy |
        
     图4创建自定义标识主机组   
     ![](https://support.huaweicloud.com/usermanual-lts/zh-cn_image_0000002535536651.png "点击放大")
     
     
  
  3. 输入自定义标识信息，若需要添加更多标识，单击"添加"。 
     最多可添加10个自定义标识。
     
     
  
  4. 单击"确定"，自定义标识主机组创建完成后，在主机组列表下方即可生成一条主机组信息。请参考[5]将主机加入自定义标识主机组。
     
     图5自定义标识主机组（截图仅供参考）   
     ![](https://support.huaweicloud.com/usermanual-lts/zh-cn_image_0000002522810461.png "点击放大")
     
     
  
  5. 执行以下操作创建custom_tag文件，用来保存主机标签。
     
     1. 登录主机执行如下命令查看是否有/opt/cloud目录。
        ```
        cd /opt/cloud
        ```
        - 若提示没有/opt/cloud目录，执行如下命令创建/opt/cloud目录。
          ```
          mkdir /opt/cloud/
          ```
          
        
        - 若有/opt/cloud目录，在cloud目录下，执行如下命令创建lts目录。
          ```
          mkdir lts
          ```
          
         
     
     2. 继续执行如下命令，修改lts目录权限。
        ```
        chmod 750 lts
        ```
        
     
     3. 在lts目录下执行如下命令，创建custom_tag文件。
        ```
        cd lts
        touch custom_tag
        ```
        
     
     4. 继续执行如下命令，修改custom_tag权限并打开该文件。
        ```
        chmod 640 custom_tag;vi custom_tag
        ```
        
     
     5. 按i进入insert模式，键入自定义标识后，按ESC键，":wq!"保存退出即可。
        ```
        :wq!
        ```
        
     
     6. 支持以下两种方式将主机加入到自定义标识主机组： 为主机添加自定义标识时，必须确保该自定义标识对应的主机类型与主机组的主机类型相同，即Linux只能添加到Linux主机组，Windows只能添加到Windows主机组，不能跨主机类型添加。
        表3添加方式 
        | 类型        | 方式1（推荐使用）                                                                                                                                                                                                | 方式2                                                                                                                                                                                                                                                                                                                                                                                                |
        |:---|:---|:---|
        | Linux主机   | 在主机里***/opt/cloud/lts*** 目录下的**custom_tag** 文件中，查看该主机的标识，然后将该主机的标识，添加为主机组自定义标识，就可以将主机加入到该主机组下。例如：在主机里***/opt/cloud/lts*** 目录下的**custom_tag**文件中，查看该主机的标识为test1，创建主机组的自定义标识为test1，即将该主机加入到主机组下。           | - 在主机里***/opt/cloud/lts*** 目录下的**custom_tag** 文件中，添加主机组自定义标识，可以将主机加入到该主机组下。例如：主机组的自定义标识为test，则在**custom_tag**文件中填写test，就可以将主机加入到该主机组下。  - 当添加了多个自定义标识时，在主机里***/opt/cloud/lts*** 目录下的**custom_tag**文件中，任意填写一个自定义标识，就可以将主机加入到该主机组下。         |
        | Windows主机 | 在主机里***C:\\opt\\cloud\\lts*** 目录下的**custom_tag** 文件中，查看该主机的标识，然后将该主机的标识，添加为主机组自定义标识，就可以将主机加入到该主机组下。例如：在主机里***C:\\opt\\cloud\\lts*** 目录下的**custom_tag**文件中，查看该主机的标识为test1，创建主机组的自定义标识为test1，即将该主机加入到主机组下。 | - 在主机里***C:\\opt\\cloud\\lts*** 目录下的**custom_tag** 文件中，添加主机组自定义标识，可以将主机加入到该主机组下。例如：主机组的自定义标识为test，则在**custom_tag**文件中填写test，就可以将主机加入到该主机组下。  - 当添加了多个自定义标识时，在主机里***C:\\opt\\cloud\\lts*** 目录下的**custom_tag**文件中，任意填写一个自定义标识，就可以将主机加入到该主机组下。   |
           
        
     
     
     
     
   
#### 修改主机组
对于已创建的主机组可以对其名称进行修改，也可以对主机组进行添加主机、移除主机或者关联接入配置，具体操作参考如下[表4]。
 表4操作列表 
| 操作      | 具体步骤                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|
| 修改主机组名称 | 1. 在"主机组"页面，单击待修改的主机组所在行的操作列"修改"。  2. 在弹出的修改主机组页面，修改主机组名称、自定义标识等信息。  3. 单击"确定"，完成主机名称修改。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 添加主机    | **方式一：** 1. 在主机组列表，找到主机组类型为IP的主机组，单击主机组名称前的![](https://support.huaweicloud.com/usermanual-lts/zh-cn_image_0000001119882370.png)。  2. 在主机页签，单击"添加主机"。  3. 在弹出的添加主机页面，主机列表中显示该主机组所选主机类型下所有未选主机，选择需要加入该主机组的主机。 - 可以通过主机名称、企业项目、IPv4或IPv6对主机列表进行过滤，也可以单击"批量搜索主机IP"，并在弹出的搜索框中输入多个主机IP，进行批量搜索。 当用户将弹性云服务器切换虚拟私有云或修改主网卡的私有IP地址后，确实会导致该主机的IPV4和IPV6地址发生变化。这种变化通常需要一段时间来同步和更新，大约30分钟后，您可以在LTS的主机页面中看到更新后的IPV4和IPV6地址。   - 当列表中没有所需主机时，单击"安装ICAgent"，在弹出的页面安装指引完成主机安装，具体操作可参见[安装ICAgent](https://support.huaweicloud.com/usermanual-lts/lts_02_0013.html)。    4. 单击"确定"。   **方式二：** 1. 选择"主机管理 \> 主机"页面。  2. 在主机列表中勾选需要添加的主机，单击"添加到主机组"。  3. 在弹出的添加到主机组页面，勾选目标主机组。  4. 单击"确定"，完成主机的添加。   |
| 移除主机    | 1. 在主机组列表，单击待修改的主机组所在行前的![](https://support.huaweicloud.com/usermanual-lts/zh-cn_image_0000001166682183.png)。  2. 在主机页签，单击待移除主机所在行操作列的"移除"。  3. 在弹出的移除主机页面，单击"确定"，将该主机移除。自定义标识主机组下的主机不支持该操作。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 取消部署    | 1. 在主机组列表，单击待修改的主机组所在行前的![](https://support.huaweicloud.com/usermanual-lts/zh-cn_image_0000001119722456.png)。  2. 在主机页签，单击待移除主机所在行操作列的"取消部署"。  3. 在弹出的取消部署页面，单击"确定"，将该主机ICAgent卸载并移除。 - 自定义标识主机组下的主机不支持该操作。  - 主机取消部署后，其他主机组下的该主机也会被移除。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 批量移除    | 1. 在主机组列表，单击待修改的主机组所在行前的![](https://support.huaweicloud.com/usermanual-lts/zh-cn_image_0000001119882372.png)。  2. 在主机页签，勾选待移除的主机，单击"批量移除"。  3. 单击"确定"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 新增关联配置  | 1. 在主机组列表，单击待修改的主机组所在行前的![](https://support.huaweicloud.com/usermanual-lts/zh-cn_image_0000001166602145.png)。  2. 默认显示主机页签，单击"相关日志接入规则"。  3. 单击"新增关联配置"。  4. 在弹出的新增关联配置页面，勾选需要关联的接入配置。  5. 单击"确定"，配置完成后会将所选的接入配置显示在列表中。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 解除关联    | 1. 在"相关日志接入规则"页签，单击待解除配置所在行操作列的"解除关联"。  2. 单击"确定"，解除该主机组与该接入配置的关联。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 批量解除关联  | 1. 在主机组列表，单击待修改的主机组所在行前的![](https://support.huaweicloud.com/usermanual-lts/zh-cn_image_0000002339501700.png)。  2. 默认显示主机页签，在"相关日志接入规则"页签，勾选待解除的配置，单击"批量解除关联"。  3. 单击"确定"，解除该主机组与所勾选的接入配置的关联。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 复制主机组ID | 鼠标悬浮在主机组名称上，支持复制主机组ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 导出主机信息  | 1. 在"主机"页面的区域内主机、CCE集群或区域外主机下方，勾选需要导出的主机。  2. 单击"导出"，选择导出全部数据到XLSX或导出已选中数据到XLSX，即可将主机信息导出到本地进行查看。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   
#### 添加主机组标签
支持对已创建的主机组添加标签，每个标签由"标签键"和"标签值"组成，用于快速识别、检索和管理主机组。添加、修改、删除标签仅对当前主机组有效。
1. 左侧导航栏选择"主机管理 \> 主机组"，进入"主机组"页面。
2. 单击目标主机组操作列的"标签管理"。
3. 在弹出的编辑标签页面，单击"添加"，填写标签键和标签值。如需添加多个标签可重复该步骤，最多支持添加20个标签。 
   图6主机组编辑标签   
   ![](https://support.huaweicloud.com/usermanual-lts/zh-cn_image_0000002318268349.png "点击放大")
   **标签键key限制条件：**
   - 标签键可以包含任意语种的字母、数字和空格，以及_.:=+-@字符，但首尾不能包含空格，且不能以_sys_开头。
   
   - 标签键长度不能超过128个字符。
   
   - 标签键名称不可重复。
   
   
   **标签值value限制条件：**
   - 标签值可以包含任意语种的字母、数字和空格，以及_.:=+-@字符。
   
   - 标签值长度不能超过255个字符。
   
   
   **标签策略：**
   若您的组织已经设定云日志服务的相关标签策略，则需按照标签策略规则为日志组、日志流、日志接入、主机组添加标签。标签如果不符合标签策略的规则，则可能会导致日志组、日志流、日志接入、主机组创建失败，请联系组织管理员了解标签策略详情。标签策略详细介绍请参考[标签策略概述](https://support.huaweicloud.com/usermanual-organizations/org_03_0067.html)，标签管理详细介绍请参考[标签管理](https://support.huaweicloud.com/usermanual-organizations/org_03_0044.html)。
   **删除标签：**
   如需删除标签，在"编辑标签"页面单击标签操作列的"删除"。
   ![](https://support.huaweicloud.com/usermanual-lts/public_sys-resources/warning_3.0-zh-cn.png)
   如果配置转储时使用了该标签，删除标签后，请同步修改转储配置信息。
   
   
4. 单击"确定"，主机组标签添加完成。在主机组列表的"标签"列可以查看主机组已添加的标签。
 
#### 删除主机组
如果主机组不再需要使用，可以删除主机组。
![](https://support.huaweicloud.com/usermanual-lts/public_sys-resources/warning_3.0-zh-cn.png)
删除主机组会导致用户日志接入相关业务异常，主机组删除后无法恢复，请谨慎操作。
1. 左侧导航栏选择"主机管理 \> 主机组"，进入"主机组"页面。
2. 删除单个主机组。 
   1. 单击待删除的主机组所在行操作列的"删除"。
   
   2. 在弹出的"删除主机组"页面，单击"确定"，删除该主机组。 已删除的主机组不再显示在主机组列表中，表明主机组已成功删除。
      
   
   
   
   
3. 批量删除主机组。 
   1. 批量勾选待删除的主机组，单击列表左上方"批量删除"。
   
   2. 在弹出的"删除主机组"页面，单击"确定"，删除所勾选的主机组。 已删除的主机组不再显示在主机组列表中，表明主机组已成功删除。
      
   
   
   
   
 
#### 相关文档
LTS支持通过调用API接口实现创建主机组、修改主机组、删除主机组等，详细请参考[主机组管理](https://support.huaweicloud.com/api-lts/lts_api_1015.html)。
