Docs

Torch Log Service

Host group

Host group overview

A host group is a virtual configuration unit in Torch log service (TLS). Each host group contains multiple servers. TLS distributes LogCollector collection configurations at the host group level and collects log data in batches from servers within the host group.

In TLS, a host group is a virtual group of servers. Each host group can include multiple servers. For unified configuration management, all servers that collect logs via LogCollector need be added to a host group. If an application or service is deployed on multiple machines and those machines share the same log file path, they can be grouped into a single host group. In this way, you only need to configure log collection rules in the console for once. Rules will be applied to every machine in the host group.

Notice

TLS supports adding both IPv4 and IPv6 servers to a host group.

Limits

Each Volcano Engine main account can create up to 200 host groups per region.

Currently, only Linux servers are supported.

Host group type

In TLS, a host group includes two types: IP address and host ID.

IP address

For host groups of IP address type, servers in the host group are identified by their IP addresses. After creating an IPaddress-based host group, you can add multiple servers to the group by filling in their IP addresses. TLS will collect logs from the hosts associated with those IP addresses

IPaddress-based host groups are particularly suitable for scenarios where host numbers are relatively small. In this case, it easier to obtain IP addresses and list all IPs within the host group.

Notice

If you use VolcanoEngine ECS servers, when creating an IP address-based host group, by default you can enter the ECS private IP address directly.

If your ECS instance was bound to a hostname or switched network types, you need to enter the server IP address acquired by LogCollector. This IP address is recorded in the agent_info.json file under the ip field on the server. For instructions on how to check the machine's IP address, see step 1 in Create host group (IP address) the referenced document.

Machine identification

For host groups of host identification type, TLS uses predefined custom identifiers to determine whether a machine belongs to the corresponding host group.

Compared to IPaddress-based host group, host group of host identification has the following advantages:

It is suitable for scenarios where the number of servers is large for its easier dynamic expansion and elastic scalability. For example, a system application may include multiple modules, and each module's host group can be identified by a fixed identifier. When expanding a host group for a specific module, you only need to add the corresponding machine identity to new servers and then new servers can be included in the host group.

Prevent private network IP address conflicts. In custom network environments such as VPC, IP addresses that come from multiple servers may conflict with each other. However, if you use host identities, this issue can be avoided.

Notice

When collecting container logs, we recommend that you use host identity-based host groups. Otherwise, heartbeat failures in host group may occur if a container's IP address changes after a restart.

Last updated: 2025.12.08 17:17:06