Simple Log Service:Tipos de red, parámetros de inicio y configuración de Logtail

Tipos de red y selección

Cuando install Logtail, elija un tipo de red según la ubicación de su servidor respecto a Simple Log Service (SLS). Elegir el tipo de red adecuado garantiza una transmisión de datos de registro más rápida y confiable.

1. Inicie sesión en la consola de Simple Log Service. En la página Project Overview del proyecto, localice Acceleration Endpoint en el área Endpoint y haga clic en Enable junto a él.

2. Lea el mensaje en el cuadro de diálogo y haga clic en Modify.

3. Configure la aceleración de transferencia para Logtail mediante uno de los siguientes métodos.

   Instalación con aceleración

   Si habilita la aceleración de transferencia antes de instalar Logtail, podrá seleccionar la opción de aceleración de transferencia durante la instalación. Para obtener más información, consulte Install Logtail.

   Modificación de la configuración

   Si instaló Logtail antes de habilitar la aceleración de transferencia, deberá modificar la configuración de Logtail.

   1. Detenga Logtail.

      • Linux

        Ejecute el comando sudo /etc/init.d/ilogtaild stop.

      • Windows

        1. Vaya a Start > Control Panel > Tools > Service.

        2. En el cuadro de diálogo Service, busque el servicio LogtailDaemon (para Logtail 1.0.0.0 y versiones posteriores) o el servicio LogtailWorker (para versiones 0.x.x.x de Logtail). Haga clic derecho sobre el servicio y seleccione Stop.

   2. Modifique el archivo de configuración de inicio de Logtail, ilogtail_config.json.

      En el parámetro data_server_list, cambie el endpoint a log-global.aliyuncs.com. Para consultar la ruta del archivo, vea Startup parameter configuration file (ilogtail_config.json).

   3. Inicie Logtail.

      • Linux

        Ejecute el comando sudo /etc/init.d/ilogtaild start.

      • Windows

        1. Vaya a Start > Control Panel > Tools > Service.

        2. En el cuadro de diálogo Service, busque el servicio LogtailDaemon (para Logtail 1.0.0.0 y versiones posteriores) o el servicio LogtailWorker (para versiones 0.x.x.x de Logtail). Haga clic derecho sobre el servicio y seleccione Start.

Para obtener más información, consulte Manage transfer acceleration.

Casos de uso

Valores recomendados para los parámetros

Las siguientes tablas muestran los valores recomendados para recolectar archivos de registro JSON estándar. El modo de expresión regular completa y el modo de delimitador tienen un rendimiento similar al modo JSON, mientras que el modo simple es aproximadamente cinco veces más rápido. La complejidad de los datos, las reglas de análisis sintáctico y la cantidad de directorios y archivos también afectan el consumo de CPU y memoria. Utilice estos valores como punto de partida y ajústelos según su carga de trabajo.

• Entorno de host

  Parámetro	Tasa de recolección predeterminada	Tasa de recolección > 10 MB/s	Tasa de recolección > 20 MB/s	Tasa de recolección > 40 MB/s
  cpu_usage_limit	0.4	1	2	4
  mem_usage_limit	384	1,024	2,048	4,096
  max_bytes_per_sec	20,971,520	209,715,200	209,715,200	209,715,200
  process_thread_count	1	2	4	8
  send_request_concurrency	15	20	40	80

• Entorno de contenedor o Kubernetes

  Parámetro	Tasa de recolección predeterminada	Tasa de recolección > 10 MB/s	Tasa de recolección > 20 MB/s	Tasa de recolección > 40 MB/s
  cpu_usage_limit	2	3	5	9
  mem_usage_limit	2,048	2,048	2,048	4,096
  max_bytes_per_sec	209,715,200	209,715,200	209,715,200	209,715,200
  process_thread_count	1	2	4	8
  send_request_concurrency	15	20	40	80
  resources.limits.cpu	500M	1,000M	2,000M	4,000M
  resources.limits.memory	2 Gi	2 Gi	3 Gi	5 Gi

  Para modificar los parámetros de inicio de Logtail en un entorno de contenedor o Kubernetes:

  • Si Logtail está desplegado en un clúster de Kubernetes de Alibaba Cloud y su versión es Logtail-ds 1.7.3 o posterior, modifique los parámetros en la consola de Container Service for Kubernetes. En la página Add-ons, modifique los parámetros correspondientes del complemento logtail-ds.

  • Si Logtail está desplegado en un entorno de contenedor o Kubernetes autogestionado y su versión es Logtail-ds 1.7.3 o posterior, modifique los parámetros de inicio de Logtail cambiando las variables de entorno en el DaemonSet. Algunos entornos hacen referencia a un ConfigMap. El ConfigMap referenciado es ConfigMap > kube-system > alibaba-log-configuration.

  • Para versiones de Logtail-ds anteriores a la 1.7.3, modifique los parámetros de inicio de Logtail cambiando las variables de entorno en el DaemonSet. En algunos entornos se hace referencia a un ConfigMap. El ConfigMap referenciado es ConfigMap > kube-system > alibaba-log-configuration. Además, ajuste los parámetros resources.limits.cpu y resources.limits.memory en DaemonSet > kube-system > logtail-ds para evitar que el contenedor exceda sus límites de recursos.

Con los valores de Tasa de recolección superior a 40 MB/s de las tablas anteriores, el rendimiento de recolección de Logtail se acerca a su límite. Aumentar aún más el número de hilos no genera mejoras significativas. La siguiente tabla muestra los límites de rendimiento de recolección.

Parámetros de inicio

1. En el servidor donde está instalado Logtail, abra el archivo /usr/local/ilogtail/ilogtail_config.json.

   Este paso aplica a un entorno de host.

   En un entorno de contenedor o Kubernetes, debe modificar los parámetros de inicio de Logtail editando las variables de entorno del DaemonSet. Algunos entornos hacen referencia a un ConfigMap, cuya ruta es ConfigMap > kube-system > alibaba-log-configuration.

2. Configure los parámetros de inicio según sea necesario.

   A continuación se muestra un ejemplo de los parámetros de inicio:

   {
       ...
       "cpu_usage_limit" : 0.4,
       "mem_usage_limit" : 384,
       "max_bytes_per_sec" : 20971520,
       "process_thread_count" : 1,
       "send_request_concurrency" : 15,
       "buffer_file_num" : 25,
       "buffer_file_size" : 20971520,
       "buffer_file_path" : "",
       ...
   }

   Nota

   • La siguiente tabla solo enumera los parámetros de inicio comunes. Para los parámetros no listados, mantenga la configuración predeterminada.

   • Puede agregar o modificar parámetros según sea necesario.

   Tabla 1. Parámetros de inicio de Logtail

   Parámetro	Tipo	Descripción	Ejemplo
   cpu_usage_limit	double	Umbral de uso de CPU, calculado con base en un solo núcleo. Rango válido: de 0.1 al número de núcleos de CPU del servidor actual. Valor predeterminado: 0.4 Aviso El parámetro cpu_usage_limit es un límite flexible. El uso real de CPU por parte de Logtail puede superar este valor. Si el uso excede el límite durante más de 5 minutos, se activa el mecanismo de protección y Logtail se reinicia automáticamente. Por ejemplo, si establece este parámetro en 0.4, Logtail intentará limitar su uso de CPU al 40 % de un solo núcleo. Si el uso supera este límite, Logtail se reiniciará automáticamente. En la mayoría de los casos, un solo núcleo puede manejar una tasa de recolección de datos de aproximadamente 100 MB/s en modo simple y 20 MB/s en modo de expresión regular completa. Nota Si despliega Logtail-ds 1.7.3 o posterior en un clúster de Container Service for Kubernetes (ACK), le recomendamos configurar el umbral de uso de CPU en la consola de Container Service for Kubernetes. En la página Add-ons, modifique el parámetro LogtailDSLimitCPU del componente logtail-ds. Para obtener más información, consulte Manage components.	"cpu_usage_limit" : 0.4
   mem_usage_limit	int	Umbral de uso de memoria. Rango válido: de 128 MB a 8,192 MB Valor predeterminado: 384 MB (en un host), 2,048 MB (para un componente de ACK) Aviso El parámetro mem_usage_limit es un límite flexible. El uso real de memoria por parte de Logtail puede superar este valor. Si el uso excede el límite durante más de 5 minutos, se activa el mecanismo de protección y Logtail se reinicia automáticamente. La tasa de recolección, la cantidad de directorios y archivos monitoreados, y el grado de bloqueo de envío están relacionados con el parámetro mem_usage_limit. Para obtener más información, consulte Logtail limits. Nota Si despliega Logtail-ds 1.7.3 o posterior en un clúster de ACK, le recomendamos configurar el umbral de uso de memoria en la consola de Container Service for Kubernetes. En la página Add-ons, modifique el parámetro LogtailDSLimitMemory del componente logtail-ds. Para obtener más información, consulte Manage components.	"mem_usage_limit" : 384
   max_bytes_per_sec	int	Tasa máxima a la que Logtail envía datos sin procesar. Unidad: bytes/segundo. Rango válido: de 1,024 bytes/s a 52,428,800 bytes/s Valor predeterminado: 20,971,520 bytes/s Importante Si establece este parámetro en un valor superior a 20,971,520 (20 MB/s), la tasa de envío no estará limitada por este parámetro. Por ejemplo, si establece este parámetro en 2097152, Logtail enviará datos a una tasa de 2 MB/s. Nota Si despliega Logtail-ds 1.7.3 o posterior en un clúster de ACK, le recomendamos configurar el límite de tráfico en la consola de Container Service for Kubernetes. En la página Add-ons, modifique el parámetro LogtailDSMaxBytePerSec del componente logtail-ds. Para obtener más información, consulte Manage components.	"max_bytes_per_sec" : 2097152
   process_thread_count	int	Número de hilos que utiliza Logtail para procesar datos. Rango válido: de 1 a 64 Valor predeterminado: 1 En la mayoría de los casos, un solo hilo puede manejar una tasa de escritura de datos de 24 MB/s en modo simple o 12 MB/s en modo de expresión regular completa. Por lo general, no es necesario modificar el valor de este parámetro. Nota Si despliega Logtail-ds 1.7.3 o posterior en un clúster de ACK, le recomendamos configurar el número de hilos en la consola de Container Service for Kubernetes. En la página Add-ons, modifique el parámetro LogtailDSProcessThreadCount del componente logtail-ds. Para obtener más información, consulte Manage components.	"process_thread_count" : 1
   send_request_concurrency	int	Número de solicitudes simultáneas para enviar datos de forma asíncrona. Rango válido: de 15 a 80 Valor predeterminado: 15 Si las TPS de escritura son altas, puede aumentar este valor. Como regla general, una solicitud simultánea puede gestionar un throughput de red de 0.5 MB/s a 1 MB/s. El throughput real depende de la latencia de la red. Nota Establecer este valor demasiado alto puede provocar un uso excesivo de puertos de red, lo cual requiere ajustar los parámetros relacionados con TCP. Si despliega Logtail-ds 1.7.3 o posterior en un clúster de ACK, le recomendamos configurar el número de solicitudes simultáneas en la consola de Container Service for Kubernetes. En la página Add-ons, modifique el parámetro LogtailDSSendRequestConcurrency del componente logtail-ds. Para obtener más información, consulte Manage components.	"send_request_concurrency" : 4
   buffer_file_num	int	Número máximo de archivos de búfer. Rango válido: de 1 a 100 Valor predeterminado: 25 Si ocurre un error de red o se supera el límite de escritura, Logtail analiza los registros en tiempo real y los escribe en archivos de búfer locales dentro del directorio de instalación. Una vez resuelto el problema, Logtail reintenta el envío de los registros almacenados en el búfer.	"buffer_file_num" : 25
   buffer_file_size	int	Tamaño máximo de un solo archivo de búfer. Unidad: byte. Rango válido: de 1,048,576 bytes a 104,857,600 bytes Valor predeterminado: 20,971,520 Byte El espacio máximo en disco que pueden ocupar los archivos de búfer es buffer_file_size × buffer_file_num.	"buffer_file_size" : 20971520
   buffer_file_path	String	Directorio donde se almacenan los archivos de búfer. De forma predeterminada, este parámetro está vacío, lo que significa que los archivos de búfer se guardan en el directorio de instalación de Logtail: /usr/local/ilogtail. Después de configurar este parámetro, debe mover manualmente los archivos cuyos nombres comienzan con logtail\_buffer\_file_* del directorio original al nuevo directorio. Esto garantiza que Logtail pueda leer los archivos de búfer y eliminarlos tras su envío.	"buffer_file_path" : ""
   bind_interface	String	Nombre del controlador de interfaz de red (NIC) vinculado al servidor. De forma predeterminada, este parámetro está vacío, lo que significa que Logtail se vincula automáticamente a una NIC disponible. Si establece este parámetro en una NIC específica, como eth1, Logtail se verá obligado a usar esa NIC para cargar registros. Este parámetro solo es compatible con Linux.	"bind_interface" : ""
   check_point_filename	String	Ruta donde se guardan los archivos de punto de control de Logtail. Valor predeterminado: /tmp/logtail_check_point.	"check_point_filename" : "/tmp/logtail_check_point"
   check_point_dump_interval	int	Intervalo, en segundos, con el que Logtail actualiza los archivos de punto de control. Valor predeterminado: 900 (15 minutos). Este parámetro solo es compatible con Logtail 1.0.19 o posterior para Linux y Logtail 1.0.19.0 o posterior para Windows.	"check_point_dump_interval" : 900
   user_config_file_path	String	Ruta donde se guarda el archivo de configuración de Logtail. De forma predeterminada, el archivo se guarda en el directorio que contiene el binario del proceso. El nombre del archivo es user_log_config.json.	"user_config_file_path" : "user_log_config.json"
   docker_file_cache_path	String	Este archivo registra las asignaciones de rutas entre los archivos del contenedor y los archivos del host. La ruta predeterminada es /usr/local/ilogtail/docker_path_config.json. Este parámetro solo es compatible con Logtail 0.16.54 o posterior para Linux y Logtail 0.16.54.0 o posterior para Windows.	"docker_file_cache_path": "/usr/local/ilogtail/docker_path_config.json"
   discard_old_data	Boolean	Especifica si se deben descartar los registros históricos. Valor predeterminado: true, lo que significa que se descartan los registros generados hace más de 12 horas.	"discard_old_data" : true
   ilogtail_discard_interval	int	Umbral de tiempo para descartar registros históricos. Si la diferencia entre la marca de tiempo del registro y la hora actual supera este umbral, el registro se descarta. Valor predeterminado: 43,200 (12 horas). Unidad: segundos.	"ilogtail_discard_interval": 43200
   working_ip	String	De forma predeterminada, este parámetro está vacío, lo que significa que la dirección IP se obtiene automáticamente del servidor. Si establece un valor para este parámetro, Logtail reportará dicho valor como la dirección IP del servidor.	"working_ip" : ""
   working_hostname	String	Nombre de host que reporta Logtail para el servidor. De forma predeterminada, este parámetro está vacío, lo que significa que el nombre de host se obtiene automáticamente del servidor.	"working_hostname" : ""
   max_read_buffer_size	long	Tamaño máximo de una sola entrada de registro que puede leer Logtail. Valor predeterminado: 524,288 (512 KB). Valor máximo: 8,388,608 (8 MB). Unidad: byte. Si una sola entrada de registro supera los 524,288 bytes, debe aumentar este valor.	"max_read_buffer_size" : 524288
   oas_connect_timeout	long	Tiempo de espera para la fase de conexión de las solicitudes que inicia Logtail para obtener su configuración o un par de AccessKey. Valor predeterminado: 5. Unidad: segundos. Si establecer conexiones toma mucho tiempo debido a condiciones de red deficientes, puede aumentar este valor.	"oas_connect_timeout" : 5
   oas_request_timeout	long	Tiempo de espera total de la solicitud para obtener una configuración o un par de AccessKey. Valor predeterminado: 10. Unidad: segundos. Si completar las solicitudes toma mucho tiempo debido a condiciones de red deficientes, puede aumentar este valor.	"oas_request_timeout" : 10
   data_server_port	long	Si establece data_server_port en 443, Logtail transmitirá datos a SLS mediante HTTPS. Este parámetro solo es compatible con Logtail 1.0.10 o posterior para Linux y Logtail 1.0.10.0 o posterior para Windows.	"data_server_port": 443
   enable_log_time_auto_adjust	Boolean	Si establece enable_log_time_auto_adjust en true, las marcas de tiempo de los registros se adaptarán automáticamente a la hora local del servidor. Por motivos de seguridad, SLS valida la marca de tiempo en cada solicitud, incluidas las de Logtail. Si la marca de tiempo difiere de la hora del servidor SLS por más de 15 minutos, SLS rechazará la solicitud. Logtail utiliza la hora local del servidor en sus solicitudes. Si se modifica la hora local del servidor (por ejemplo, a una hora futura en un entorno de prueba), las solicitudes de Logtail serán rechazadas y fallará la escritura de datos. Puede usar este parámetro para adaptar las marcas de tiempo de los registros a la hora local del servidor. Este parámetro solo es compatible con Logtail 1.0.19 o posterior para Linux y Logtail 1.0.19.0 o posterior para Windows. Importante Cuando esta función está habilitada, Logtail suma la diferencia entre la hora del servidor SLS y la hora local del servidor a la marca de tiempo del registro. Esta diferencia solo se actualiza cuando SLS rechaza una solicitud. Como resultado, la marca de tiempo que observa en las consultas de SLS puede diferir de la hora real de escritura. Parte de la lógica de Logtail depende de una hora del sistema monótonamente creciente. Le recomendamos reiniciar Logtail cada vez que ajuste el reloj del servidor.	"enable_log_time_auto_adjust": true
   accept_multi_config	Boolean	Especifica si se permite que varias configuraciones de Logtail recolecten registros del mismo archivo. Valor predeterminado: false. De forma predeterminada, un archivo solo puede ser recolectado por una configuración de Logtail. Puede usar este parámetro para eliminar esta restricción. El procesamiento de cada configuración de Logtail es independiente. Si permite que varias configuraciones de Logtail recolecten registros del mismo archivo, el consumo de CPU y memoria aumentará proporcionalmente. Este parámetro solo es compatible con Logtail 0.16.26 o posterior para Linux y Logtail 0.16.26.0 o posterior para Windows.	"accept_multi_config": true
   enable_checkpoint_sync_write	Boolean	Especifica si se deben habilitar las escrituras síncronas para los puntos de control. Valor predeterminado: false. Esta función se utiliza principalmente junto con la función de escritura ExactlyOnce. Cuando ExactlyOnce está habilitado, Logtail registra información detallada de puntos de control a nivel de archivo en el disco local. Por razones de rendimiento, Logtail no ejecuta el comando sync para volcar datos al disco de forma predeterminada al escribir puntos de control. Si la máquina se reinicia antes de que los datos en búfer se escriban en el disco, la información del punto de control podría perderse. En este caso, puede establecer enable_checkpoint_sync_write en true para habilitar las escrituras síncronas. Para obtener más información, consulte Logtail configurations (legacy). Este parámetro solo es compatible con Logtail 1.0.20 o posterior para Linux y Logtail 1.0.20.0 o posterior para Windows.	"enable_checkpoint_sync_write": false
   enable_env_ref_in_config	Boolean	Especifica si se debe habilitar la sustitución de variables de entorno en las configuraciones de recolección. Valor predeterminado: false. Una vez habilitada esta función, puede usar ${xxx} como marcador de posición para la variable de entorno xxx en una configuración de recolección de Logtail desde la consola. Por ejemplo, si establece la ruta de recolección en /${xxx}/logs y define la variable de entorno como xxx=user, la ruta de recolección efectiva será /user/logs. Si necesita utilizar los caracteres literales ${ o } en su configuración, escríbalos usando $${ o $}. Este parámetro solo es compatible con Logtail 1.0.31 o posterior para Linux y Logtail 1.0.31.0 o posterior para Windows.	"enable_env_ref_in_config": false
   docker_config_update_interval	int	Intervalo mínimo con el que se actualizan las rutas de los contenedores. Este parámetro se usa junto con el parámetro max_docker_config_update_times. Si se alcanza el umbral de cualquiera de los dos parámetros, se detendrán las actualizaciones de rutas de contenedores. Para Logtail 1.0.32 o posterior para Linux y Logtail 1.0.32.0 o posterior para Windows, el valor predeterminado es 3. Unidad: segundos. Para versiones anteriores a Logtail 1.0.32 para Linux y Logtail 1.0.32.0 para Windows, el valor predeterminado es 10. Unidad: segundos.	"docker_config_update_interval": 3
   max_docker_config_update_times	int	Número máximo de actualizaciones de rutas de contenedores permitidas en un periodo de 3 minutos. De forma predeterminada, si el número de actualizaciones supera este límite dentro de 3 minutos, las actualizaciones de rutas de contenedores se detendrán hasta que finalice el periodo. Para Logtail 1.0.32 o posterior para Linux y Logtail 1.0.32.0 o posterior para Windows, el valor predeterminado es 10. Para versiones anteriores a Logtail 1.0.32 para Linux y Logtail 1.0.32.0 para Windows, el valor predeterminado es 3.	"max_docker_config_update_times": 10
   DOCKER_HOST	String	Dirección del socket utilizada para comunicarse con Docker. Debe configurarse como una variable de entorno. Valor predeterminado: una cadena vacía, lo que significa que se utiliza la dirección predeterminada unix:///var/run/docker.sock.	DOCKER_HOST=unix:///var/run/docker.sock
   CONTAINERD_SOCK_PATH	String	Dirección del socket utilizada para comunicarse con containerd. Debe configurarse como una variable de entorno. Valor predeterminado: una cadena vacía, lo que significa que se utiliza la dirección predeterminada unix:///run/containerd/containerd.sock. Si usa un clúster K3s, puede modificar el valor como se muestra en el ejemplo.	CONTAINERD_SOCK_PATH=/run/k3s/containerd/containerd.sock
   logreader_max_rotate_queue_size	Int	Longitud máxima de la cola de rotación de archivos. Valor predeterminado: 20. Si la recolección de registros se bloquea o retrasa, los archivos pendientes de recolección mantendrán sus manejadores de archivo abiertos y esperarán en esta cola. Si la recolección se retrasa y necesita controlar el uso máximo de disco, considere disminuir este valor. Aviso Cuando el número de archivos retrasados supera este valor, Logtail omite la recolección de nuevos archivos.	"logreader_max_rotate_queue_size" : 10
   force_release_deleted_file_fd_timeout	Int	Periodo de tiempo de espera para liberar un manejador de archivo después de que un contenedor sale o se elimina un archivo. Valor predeterminado: -1, que deshabilita esta función. Un valor de 0 indica que el manejador se libera inmediatamente. Unidad: segundos. Si desea controlar la latencia máxima de destrucción para contenedores containerd, puede configurar este parámetro. Aviso Si la recolección de registros se retrasa, los datos que superen el tiempo de espera configurado se perderán.	"force_release_deleted_file_fd_timeout" : 0
   data_endpoint_policy	string	Directiva de conmutación para que Logtail acceda a los endpoints de SLS. Valores válidos: Nota En el archivo ilogtail_config.json, puede comprobar si hay un endpoint predeterminado configurado en el parámetro data_server_list. Para obtener más información, consulte Startup parameter configuration file (ilogtail_config.json). designated_first (predeterminado) Si se especifica un endpoint predeterminado para una región y el endpoint está disponible, Logtail usará primero el endpoint predeterminado. Si se especifica un endpoint predeterminado para una región pero el endpoint no está disponible, Logtail seleccionará automáticamente un endpoint disponible. Si no se especifica ningún endpoint predeterminado para una región, Logtail seleccionará automáticamente un endpoint disponible. designated_locked Si se especifica un endpoint predeterminado para una región, Logtail usará únicamente el endpoint predeterminado, independientemente de su disponibilidad. Si no se especifica ningún endpoint predeterminado para una región, Logtail seleccionará automáticamente un endpoint disponible. Este parámetro solo es compatible con Logtail 1.5.0 o posterior para Linux y Logtail 1.5.0.0 o posterior para Windows.	"data_endpoint_policy" : "designated_first"
   inotify_black_list	Array<String>	Lista de bloqueados de monitoreo inotify. Este parámetro solo admite coincidencias exactas de ruta. Los directorios en esta lista no serán monitoreados por inotify.	"inotify_black_list": ["/tmp"]
   host_path_blacklist	String	Lista global de bloqueados de rutas de host. Este parámetro solo admite coincidencias de subcadenas. En servidores Linux, use dos puntos (:) para separar varias subcadenas. En servidores Windows, use punto y coma (;) para separar varias subcadenas. Por ejemplo, "host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-" impide que Logtail recolecte datos de montajes NAS. Este parámetro solo es compatible con Logtail 1.8.0 o posterior para Linux y Logtail 1.8.0.0 o posterior para Windows.	"host_path_blacklist" : "/volumes/kubernetes.io~csi/nas-"
   LOGTAIL_LOG_LEVEL	String	Nivel de registro para los registros internos de Logtail. Debe configurarse como una variable de entorno. De forma predeterminada, este parámetro está vacío, lo que corresponde al nivel INFO. Valores válidos: TRACE, DEBUG, INFO, WARNING, ERROR y FATAL. Este parámetro solo es compatible con Logtail 1.8.0 o posterior para Linux y Logtail 1.8.0.0 o posterior para Windows.	LOGTAIL_LOG_LEVEL=info
   FORCE_RELEASE_STOP_CONTAINER_FILE	Boolean	Método de configuración: Este parámetro solo puede configurarse mediante una variable de entorno. Descripción: Si este parámetro se establece en true, Logtail liberará inmediatamente los manejadores de archivos del contenedor cuando salga el contenedor de aplicación. Esto evita que un contenedor no pueda salir porque sus manejadores de archivos no se han liberado. Importante: En este caso, no se puede garantizar la integridad de los datos recolectados del contenedor. Para asegurar que los registros se recolecten por completo, agregue un retraso de unos segundos antes de que salga la aplicación. Versiones compatibles: Logtail 2.1.6 o posterior para Linux	"FORCE_RELEASE_STOP_CONTAINER_FILE" : "true"
   default_reader_flush_timeout	int	Periodo de tiempo de espera para determinar la integridad de la última línea de registro. Valor predeterminado: 60. Unidad: segundos. Este parámetro solo es compatible con Logtail 2.0.0 o posterior.	"default_reader_flush_timeout" : 1

3. Reinicie Logtail para aplicar la nueva configuración.

   /etc/init.d/ilogtaild stop && /etc/init.d/ilogtaild start                        

   Después del reinicio, puede ejecutar el comando /etc/init.d/ilogtaild status para comprobar el estado de Logtail.

Variables de entorno

A continuación se muestra la relación entre las variables de entorno y los parámetros de inicio de Logtail.

Archivo de parámetros de inicio (ilogtail_config.json)

• Ruta del archivo

  • Entorno de servidor

    Sistema operativo	Logtail	Ruta
    Linux	Logtail (64 bits)	/usr/local/ilogtail/ilogtail_config.json
    Windows (64 bits)	Logtail (64 bits)	C:\Program Files\Alibaba\Logtail\ilogtail_config.json
    	Logtail (32 bits)	C:\Program Files (x86)\Alibaba\Logtail\ilogtail_config.json Nota En un sistema operativo Windows de 64 bits se pueden ejecutar aplicaciones de 32 y 64 bits. Por motivos de compatibilidad, Windows almacena las aplicaciones de 32 bits en un directorio x86 independiente.
    Windows (32 bits)	Logtail (32 bits)	C:\Program Files\Alibaba\Logtail\ilogtail_config.json

  • Entorno de contenedor

    El archivo ilogtail_config.json se almacena en el contenedor de Logtail. La ruta del archivo se configura en la variable de entorno ALIYUN_LOGTAIL_CONFIG, que puede consultar al ejecutar el comando docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_CONFIG. Por ejemplo: /etc/ilogtail/conf/cn-hangzhou/ilogtail_config.json.

• Ejemplo de archivo

  $cat /usr/local/ilogtail/ilogtail_config.json
  {
      "config_server_address" : "http://logtail.cn-hangzhou-intranet.log.aliyuncs.com",
      "data_server_list" :
      [
          {
              "cluster" : "cn-hangzhou",
              "endpoint" : "cn-hangzhou-intranet.log.aliyuncs.com"
          }
      ],
      "cpu_usage_limit" : 0.4,
      "mem_usage_limit" : 100,
      "max_bytes_per_sec" : 2097152,
      "process_thread_count" : 1,
      "send_request_concurrency" : 15,
      "streamlog_open" : false
  }

Archivo de identificador de usuario

El archivo de identificador de usuario contiene el ID de una cuenta raíz de Alibaba Cloud. Este archivo autoriza a Logtail a acceder al servidor y recolectar registros para dicha cuenta. Para obtener más información, consulte Configure a user identifier.

• Ruta del archivo

  • Entorno de servidor

    • Linux: /etc/ilogtail/users/

    • Windows: C:\LogtailData\users\

  • Entorno de contenedor

    El identificador de usuario se almacena en la variable de entorno ALIYUN_LOGTAIL_USER_ID del contenedor de Logtail. Ejecute el comando docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_ID para consultarlo.

• Ejemplo de archivo

  $ls /etc/ilogtail/users/

Archivo de identificador personalizado (user_defined_id)

El archivo user_defined_id se utiliza para configurar un identificador personalizado. Para obtener más información, consulte Create a custom identifier-based machine group.

• Ruta del archivo

  • Entorno de host

    • Linux: /etc/ilogtail/user_defined_id.

    • Windows: C:\LogtailData\user_defined_id.

  • Entorno de contenedor

    El identificador personalizado se configura en la variable de entorno ALIYUN_LOGTAIL_USER_DEFINED_ID del contenedor de Logtail. Puede consultar el identificador al ejecutar el comando docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID.

• Ejemplo de archivo

  $cat /etc/ilogtail/user_defined_id
  aliyun-ecs-rs1e16355

Archivo de configuración de Logtail (user_log_config.json)

El archivo user_log_config.json es un archivo JSON que almacena la configuración de Logtail recibida desde Simple Log Service. Este archivo se actualiza cada vez que se modifica una configuración de Logtail. Puede revisar este archivo para comprobar que la configuración de Logtail se ha entregado correctamente al servidor. Si el archivo existe y su contenido coincide con la configuración de Logtail en Simple Log Service, significa que la configuración se entregó correctamente.

• Ruta del archivo

  • Entorno de host

    Sistema operativo	Logtail	Ruta
    Linux	Logtail (64 bits)	/usr/local/ilogtail/user_log_config.json
    Windows (64 bits)	Logtail (64 bits)	C:\Program Files\Alibaba\Logtail\user_log_config.json
    	Logtail (32 bits)	C:\Program Files (x86)\Alibaba\Logtail\user_log_config.json Nota En un sistema operativo Windows de 64 bits se pueden ejecutar aplicaciones de 32 y 64 bits. Por motivos de compatibilidad, Windows almacena las aplicaciones de 32 bits en un directorio x86 independiente.
    Windows (32 bits)	Logtail (32 bits)	C:\Program Files\Alibaba\Logtail\user_log_config.json

  • Entorno de contenedor

    El archivo user_log_config.json se almacena en el contenedor de Logtail en la ruta /usr/local/ilogtail/user_log_config.json.

• Ejemplo de archivo

  $cat /usr/local/ilogtail/user_log_config.json
  {
     "metrics" : {
        "##1.0##k8s-log-c12ba2028*****939f0b$app-java" : {
           "aliuid" : "16542189*****50",
           "category" : "app-java",
           "create_time" : 1534739165,
           "defaultEndpoint" : "cn-hangzhou-intranet.log.aliyuncs.com",
           "delay_alarm_bytes" : 0,
           "enable" : true,
           "enable_tag" : true,
           "filter_keys" : [],
           "filter_regs" : [],
           "group_topic" : "",
           "local_storage" : true,
           "log_type" : "plugin",
           "log_tz" : "",
           "max_send_rate" : -1,
           "merge_type" : "topic",
           "plugin" : {
              "inputs" : [
                 {
                    "detail" : {
                       "IncludeEnv" : {
                          "aliyun_logs_app-java" : "stdout"
                       },
                       "IncludeLable" : {
                          "io.kubernetes.container.name" : "java-log-demo-2",
                          "io.kubernetes.pod.namespace" : "default"
                       },
                       "Stderr" : true,
                       "Stdout" : true
                    },
                    "type" : "service_docker_stdout"
                 }
              ]
           },
           "priority" : 0,
           "project_name" : "k8s-log-c12ba2028c*****ac1286939f0b",
           "raw_log" : false,
           "region" : "cn-hangzhou",
           "send_rate_expire" : 0,
           "sensitive_keys" : [],
           "tz_adjust" : false,
           "version" : 1
        }
     }
  }

Archivo de registro AppInfo (app_info.json)

El archivo app_info.json registra información sobre Logtail, como su hora de inicio, dirección IP y nombre de host.

• Ruta del archivo

  • Entorno de host

    Sistema operativo	Logtail	Ruta del archivo app_info.json
    Linux	Logtail (64 bits)	/usr/local/ilogtail/app_info.json
    Windows (64 bits)	Logtail (64 bits)	C:\Program Files\Alibaba\Logtail\app_info.json
    	Logtail (32 bits)	C:\Program Files (x86)\Alibaba\Logtail\app_info.json Nota Un sistema operativo Windows de 64 bits puede ejecutar aplicaciones de 32 y 64 bits. Por motivos de compatibilidad, el sistema operativo almacena las aplicaciones de 32 bits en un directorio x86 independiente.
    Windows (32 bits)	Logtail (32 bits)	C:\Program Files\Alibaba\Logtail\app_info.json

  • Entorno de contenedor

    El archivo app_info.json se almacena en el contenedor de Logtail en /usr/local/ilogtail/app_info.json.

• Ejemplo de archivo

  $cat /usr/local/ilogtail/app_info.json
  {
     "UUID" : "",
     "hostname" : "logtail-ds-slpn8",
     "instance_id" : "E5F93BC6-B024-11E8-8831-0A58AC14039E_1**.***.***.***_1536053315",
     "ip" : "1**.***.***.***",
     "logtail_version" : "0.16.13",
     "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64",
     "update_time" : "2018-09-04 09:28:36"
  }

  Campo	Descripción
  UUID	El número de serie del servidor.
  hostname	El nombre de host.
  instance_id	Un identificador único generado aleatoriamente para Logtail.
  ip	La dirección IP que obtiene Logtail. Si este campo está vacío, Logtail no pudo obtener una dirección IP y no puede ejecutarse. Establezca una dirección IP para el servidor y reinicie Logtail. Nota Si crea un grupo de máquinas basado en direcciones IP, asegúrese de que la dirección IP configurada en el grupo de máquinas coincida con la dirección IP que se muestra aquí. Si no coinciden, confirme la dirección IP correcta del host. Luego, modifique la dirección IP en el grupo de máquinas desde la consola de Simple Log Service, o modifique el valor del parámetro working_ip en Set Logtail startup parameters.
  logtail_version	La versión del cliente Logtail.
  os	La versión del sistema operativo.
  update_time	La hora en que Logtail se inició por última vez.

Registro operativo de Logtail (ilogtail.LOG)

El archivo ilogtail.LOG registra los registros operativos de Logtail. Los niveles de registro son INFO, WARN y ERROR, en orden ascendente de gravedad. Por lo general, los registros de nivel INFO pueden ignorarse.

• Ruta del archivo

  • Entorno de servidor

    Sistema operativo	Logtail	Ruta
    Linux	Logtail (64 bits)	/usr/local/ilogtail/ilogtail.LOG
    Windows (64 bits)	Logtail (64 bits)	C:\Program Files\Alibaba\Logtail\ilogtail.LOG
    	Logtail (32 bits)	C:\Program Files (x86)\Alibaba\Logtail\ilogtail.LOG Nota Un sistema operativo Windows de 64 bits puede ejecutar aplicaciones de 32 y 64 bits. Por motivos de compatibilidad, Windows almacena las aplicaciones de 32 bits en un directorio x86 independiente.
    Windows (32 bits)	Logtail (32 bits)	C:\Program Files\Alibaba\Logtail\ilogtail.LOG

  • Entorno de contenedor

    El archivo ilogtail.LOG se almacena en el contenedor de Logtail en /usr/local/ilogtail/ilogtail.LOG.

• Ejemplo de archivo

  $tail /usr/local/ilogtail/ilogtail.LOG
  [2018-09-13 01:13:59.024679]    [INFO]    [3155]    [build/release64/sls/ilogtail/elogtail.cpp:123]    change working dir:/usr/local/ilogtail/
  [2018-09-13 01:13:59.025443]    [INFO]    [3155]    [build/release64/sls/ilogtail/AppConfig.cpp:175]    load logtail config file, path:/etc/ilogtail/conf/ap-southeast-1/ilogtail_config.json
  [2018-09-13 01:13:59.025460]    [INFO]    [3155]    [build/release64/sls/ilogtail/AppConfig.cpp:176]    load logtail config file, detail:{
     "config_server_address" : "http://logtail.ap-southeast-1-intranet.log.aliyuncs.com",
     "data_server_list" : [
        {
           "cluster" : "ap-southeast-1",
           "endpoint" : "ap-southeast-1-intranet.log.aliyuncs.com"
        }
  ]

Registro del plugin de Logtail (logtail_plugin.LOG)

El archivo logtail_plugin.LOG registra los registros operativos del plugin de Logtail. Los niveles de registro, en orden creciente de gravedad, son INFO, WARN y ERROR. Puede ignorar sin problemas los registros de nivel INFO.

Para solucionar errores de recolección como CANAL_RUNTIME_ALARM, revise el archivo logtail_plugin.LOG.

• Ruta del archivo

  • Entorno de host

    Sistema operativo	Logtail	Ruta del archivo logtail_plugin.LOG
    Linux	Logtail (64 bits)	/usr/local/ilogtail/logtail_plugin.LOG
    Windows (sistema operativo de 64 bits)	Logtail (64 bits)	C:\Program Files\Alibaba\Logtail\logtail_plugin.LOG
    	Logtail (32 bits)	C:\Program Files (x86)\Alibaba\Logtail\logtail_plugin.LOG Nota Un sistema operativo Windows de 64 bits puede ejecutar aplicaciones de 32 y 64 bits. Por motivos de compatibilidad, Windows almacena las aplicaciones de 32 bits en un directorio x86 independiente.
    Windows (sistema operativo de 32 bits)	Logtail (32 bits)	C:\Program Files\Alibaba\Logtail\logtail_plugin.LOG

  • Entorno de contenedor

    El archivo logtail_plugin.LOG se almacena en el contenedor de Logtail en /usr/local/ilogtail/logtail_plugin.LOG.

• Ejemplo

  $tail /usr/local/ilogtail/logtail_plugin.LOG
  2018-09-13 02:55:30 [INF] [docker_center.go:525] [func1] docker fetch all:start
  2018-09-13 02:55:30 [INF] [docker_center.go:529] [func1] docker fetch all:stop
  2018-09-13 03:00:30 [INF] [docker_center.go:525] [func1] docker fetch all:start
  2018-09-13 03:00:30 [INF] [docker_center.go:529] [func1] docker fetch all:stop
  2018-09-13 03:03:26 [INF] [log_file_reader.go:221] [ReadOpen] [##1.0##sls-zc-test-hz-pub$docker-stdout-config,k8s-stdout]    open file for read, file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379573    status:794354-64769-40379963
  2018-09-13 03:03:26 [INF] [log_file_reader.go:221] [ReadOpen] [##1.0##k8s-log-c12ba2028cfb444238cd9ac1286939f0b$docker-stdout-config,k8s-stdout]    open file for read, file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379573    status:794354-64769-40379963
  2018-09-13 03:04:26 [INF] [log_file_reader.go:308] [CloseFile] [##1.0##sls-zc-test-hz-pub$docker-stdout-config,k8s-stdout]    close file, reason:no read timeout    file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379963    status:794354-64769-40379963
  2018-09-13 03:04:27 [INF] [log_file_reader.go:308] [CloseFile] [##1.0##k8s-log-c12ba2028cfb444238cd9ac1286939f0b$docker-stdout-config,k8s-stdout]    close file, reason:no read timeout    file:/logtail_host/var/lib/docker/containers/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624/7f46afec6a14de39b59ee9cdfbfa8a70c2fa26f1148b2e2f31bd3410f5b2d624-json.log    offset:40379963    status:794354-64769-40379963
  2018-09-13 03:05:30 [INF] [docker_center.go:525] [func1] docker fetch all:start
  2018-09-13 03:05:30 [INF] [docker_center.go:529] [func1] docker fetch all:stop

Asignación de rutas de contenedor (docker_path_config.json)

El archivo docker_path_config.json es un archivo JSON que se crea únicamente cuando se recolectan registros de contenedor. Registra las asignaciones de rutas entre los archivos del contenedor y del host.

Si ocurre el error DOCKER_FILE_MAPPING_ALARM al diagnosticar errores de recolección, esto indica que la asignación de rutas de archivos de Docker ha fallado. Revise el archivo docker_path_config.json para solucionar el problema.

• Ruta del archivo

  /usr/local/ilogtail/docker_path_config.json

• Ejemplo

  $cat /usr/local/ilogtail/docker_path_config.json
  {
     "detail" : [
        {
           "config_name" : "##1.0##k8s-log-c12ba2028cfb444238cd9ac1286939f0b$nginx",
           "container_id" : "df19c06e854a0725ea7fca7e0378b0450f7bd3122f94fe3e754d8483fd330d10",
           "params" : "{\n   \"ID\" : \"df19c06e854a0725ea7fca7e0378b0450f7bd3122f94fe3e754d8483fd330d10\",\n   \"Path\" : \"/logtail_host/var/lib/docker/overlay2/947db346695a1f65e63e582ecfd10ae1f57019a1b99260b6c83d00fcd1892874/diff/var/log\",\n   \"Tags\" : [\n      \"nginx-type\",\n      \"access-log\",\n      \"_image_name_\",\n      \"registry.cn-hangzhou.aliyuncs.com/log-service/docker-log-test:latest\",\n      \"_container_name_\",\n      \"nginx-log-demo\",\n      \"_pod_name_\",\n      \"nginx-log-demo-h2lzc\",\n      \"_namespace_\",\n      \"default\",\n      \"_pod_uid_\",\n      \"87e56ac3-b65b-11e8-b172-00163f008685\",\n      \"_container_ip_\",\n      \"172.20.4.224\",\n      \"purpose\",\n      \"test\"\n   ]\n}\n"
        } 
     ],
     "version" : "0.1.0"
  }