Todos los productos
Search
Centro de documentos

Simple Log Service:Asociar grupos de máquinas con configuraciones de recopilación de LoongCollector

Última actualización: Sep 22, 2026

Después de instalar LoongCollector en un servidor, debe crear un grupo de máquinas para gestionar el servidor como un recurso en Simple Log Service (SLS). A continuación, cree una configuración de recopilación de LoongCollector para definir las reglas de recopilación de datos. Para aplicar estas reglas a un servidor, asigne la configuración de recopilación al grupo de máquinas del servidor.

Conceptos principales y sus relaciones

Qué es un grupo de máquinas

Un grupo de máquinas es una agrupación lógica de servidores que se gestiona como un único recurso dentro de un proyecto de SLS. SLS utiliza los grupos de máquinas para gestionar los servidores. Un servidor se asocia con un grupo de máquinas mediante heartbeats.

SLS proporciona los siguientes dos tipos de grupos de máquinas:

Grupo de máquinas basado en direcciones IP

Para usar un grupo de máquinas basado en direcciones IP, debe agregar las direcciones IP de sus servidores al grupo de máquinas.

  • Este tipo de grupo de máquinas es más fácil de crear y configurar.

  • Si ocurre un conflicto de direcciones IP o si una dirección IP cambia, el heartbeat puede fallar, lo cual afecta la recopilación de datos.

Grupo de máquinas basado en identificadores personalizados

Establezca la asociación mediante la configuración de una cadena personalizada como identificador en el grupo de máquinas y agregue esta cadena a un archivo de identificadores en el servidor. Puede agregar varios identificadores personalizados al archivo de identificadores de un servidor. Cada identificador debe colocarse en una línea nueva.

  • El proceso de configuración es más complejo que el de un grupo de máquinas basado en direcciones IP. Sin embargo, este método evita los fallos de recopilación de datos causados por conflictos de direcciones IP, los cuales pueden ocurrir en entornos de red personalizados como una VPC.

  • Este tipo de grupo de máquinas admite el escalado automático. Si configura nuevos servidores con el mismo identificador personalizado, SLS los detecta automáticamente y los agrega al grupo de máquinas. Por el contrario, si ya no necesita recopilar registros de un servidor, elimine su archivo de identificadores y el grupo de máquinas quitará el servidor automáticamente.

  • Un sistema empresarial suele constar de varios módulos, y cada módulo se puede escalar horizontalmente al agregar servidores. Para recopilar y clasificar los datos de registro de manera eficiente, se recomienda crear un grupo de máquinas independiente para cada módulo. Por ejemplo, un sitio web puede constar de un módulo de solicitudes HTTP, un módulo de lógica y un módulo de almacenamiento. Defina sus identificadores personalizados como http_module, logic_module y store_module.

Cómo crear un grupo de máquinas

Para establecer una asociación basada en heartbeats entre un grupo de máquinas y un servidor, primero debe instalar el agente de LoongCollector en el servidor. Se recomienda crear un grupo de máquinas cuando instale el agente. Para obtener más información, consulte Install LoongCollector o Installation and configuration.

Qué es una configuración de recopilación de LoongCollector

Una configuración de recopilación es un conjunto de reglas principales que definen cómo recopilar y procesar datos. Le permite configurar parámetros para recopilar, analizar sintácticamente, filtrar y procesar datos de manera eficiente. Una configuración de recopilación se adjunta a un grupo de máquinas para aplicar las reglas de recopilación a todos los servidores de ese grupo. El procesamiento se ejecuta en el propio servidor y consume recursos locales. Una configuración de recopilación consta de las siguientes tres partes:

  • Configuración global: incluye el nombre de la configuración de recopilación, el tema del registro y las etiquetas. Utilice los temas y las etiquetas para marcar y clasificar los registros recopilados.

  • Configuración de entrada: define el tipo de datos que se van a recopilar, como entrada de archivos, salida estándar del clúster, resultados de consultas SQL o entrada HTTP. También define información específica para cada tipo de datos, como la ruta y el origen de la recopilación.

  • Configuración de procesamiento: define las reglas para analizar sintácticamente los datos mediante una combinación de plugins. Esto le permite dar formato a los datos según sus necesidades mediante acciones como el filtrado, la desensibilización, la coincidencia con expresiones regulares o el análisis sintáctico de datos con formato JSON.

Cómo crear una configuración de recopilación

Una configuración de recopilación debe adjuntarse a un grupo de máquinas para aplicar sus reglas a los servidores de ese grupo. Por lo tanto, se recomienda crear la configuración de recopilación según el tipo de origen de datos y seguir el proceso completo de recopilación de datos. Para obtener más información, consulte Log data collection.

Relación entre los grupos de máquinas y las configuraciones de recopilación

SLS admite una relación de muchos a muchos entre las configuraciones de recopilación y los grupos de máquinas: una sola configuración de recopilación se puede aplicar a varios grupos de máquinas, y un solo grupo de máquinas puede usar varias configuraciones de recopilación. Dado que las configuraciones de recopilación se adjuntan a los grupos de máquinas, si agrega o quita un servidor de un grupo de máquinas, las configuraciones de recopilación correspondientes se aplican o se eliminan automáticamente de ese servidor. Este diseño desacopla los servidores de las configuraciones de recopilación. Tenga en cuenta que todos los servidores dentro de un mismo grupo de máquinas deben usar el mismo sistema operativo.

image

Casos de uso para asociar grupos de máquinas con configuraciones de recopilación

Recopilar registros de varios directorios

Requisito: necesita recopilar registros de /var/log/messages y /opt/app/logs/*.log, y enviarlos al mismo logstore.

Solución:

  1. Cree dos configuraciones de recopilación en el logstore de destino. Establezca la ruta de una configuración en /var/log/messages y la ruta de la otra en /opt/app/logs/*.log.

  2. Aplique las dos configuraciones de recopilación al mismo grupo de máquinas.

  3. SLS recopila datos de las rutas /var/log/messages y /opt/app/logs/*.log en todos los servidores del grupo de máquinas, y envía los datos al logstore de destino.

Cargar registros del mismo servidor en varios logstores

Requisito: necesita enviar varios tipos de registros de distintos directorios de un solo servidor a diferentes logstores.

Solución:

  1. Cree distintas configuraciones de recopilación en diferentes logstores.

    Si varias configuraciones recopilan datos del mismo archivo, debe habilitar Allow a file to be collected multiple times en la configuración de entrada. Para obtener más información, consulte Multiple log collections .
  2. Aplique estas configuraciones de recopilación al mismo grupo de máquinas.

  3. SLS carga los distintos registros de los servidores del grupo de máquinas en los logstores correspondientes, según las configuraciones de recopilación.

Centralizar registros de distintos servidores

Requisito: necesita recopilar un tipo específico de registro de varios servidores que están en distintos grupos de máquinas y guardar los registros en el mismo logstore.

Solución:

  1. Cree una configuración de recopilación en el logstore de destino.

  2. Aplique esta configuración de recopilación a los distintos grupos de máquinas que contienen los servidores.

  3. SLS recopila los registros de los servidores en los grupos de máquinas especificados y los envía al logstore de destino.

Cambiar las reglas de recopilación en un servidor

Requisito 1: las reglas de una configuración de recopilación aplicada están obsoletas o ya no satisfacen sus necesidades, y desea usar una configuración de recopilación diferente.

Solución:

  1. Inicie sesión en la consola de Simple Log Service. En la lista Projects, haga clic en el proyecto de destino. En el panel de navegación izquierdo, elija Resources > Machine Groups. En la página Machine Groups, seleccione el grupo de máquinas que desea modificar. Luego, en la página Machine Group Configurations, haga clic en Modify.

  2. En el panel Manage Configuration, consulte la lista de configuraciones de recopilación disponibles a la izquierda. Seleccione las configuraciones obligatorias y muévalas a la lista de configuraciones aplicadas a la derecha.

Requisito 2: necesita aplicar una configuración de recopilación existente cuando agrega un nuevo servidor, o bien dejar de recopilar registros de un servidor existente.

Solución:

  1. Inicie sesión en la consola de Simple Log Service. En la lista Projects, haga clic en el proyecto de destino. En el panel de navegación izquierdo, elija Resources > Machine Groups. En la página Machine Groups, seleccione el grupo de máquinas que desea modificar y luego modifique su configuración en la página Machine Group Configurations.

  2. Modifique los servidores del grupo de máquinas para aplicar o quitar la configuración de recopilación:

    1. Para un grupo de máquinas basado en direcciones IP, agregue o elimine direcciones IP en el campo IP Address. Separe varias direcciones IP con saltos de línea.

      La dirección IP debe coincidir con el valor del campo ip en el archivo /usr/local/ilogtail/app_info.json del servidor.
    2. Para un grupo de máquinas basado en identificadores personalizados, configure el mismo Custom Identifier en el nuevo servidor. Este método habilita el escalado automático. Los servidores nuevos con el identificador se agregan automáticamente, mientras que los servidores a los que se les elimina el archivo de identificadores se dan de baja automáticamente.

    Nota

    Agregar un servidor a un grupo de máquinas no instala LoongCollector automáticamente. Primero debe instalar LoongCollector en el nuevo servidor.