Simple Log Service:Recopilación de registros de observability de agentes de IA (AgentSight)

Requisitos previos

• La versión del kernel del sistema operativo del servidor debe ser Linux 5.10 o posterior.

  El plugin depende de eBPF para la observación a nivel de sistema. Los kernels anteriores a la versión 5.10 no admiten las funciones de eBPF necesarias y no pueden ejecutar la recopilación.

  Los entornos compatibles verificados son a continuación:

  • Alibaba Cloud Linux 3

  • Ubuntu 22.04

  • Ubuntu 24.04

  Ejecute el siguiente comando para comprobar la versión actual de su kernel:

  uname -r

• LoongCollector v3.3.9 o posterior está instalado en el servidor.

  La capacidad de recopilación de AgentSight requiere una versión reciente de LoongCollector. Actualice a la última versión antes de configurar este plugin.

• El agente de IA de destino (como OpenClaw o Hermes) está desplegado y ejecutándose en el servidor.

• Entorno de contenedores de ACK: Para recopilar registros de LLM desde pods de agentes en un clúster de Container Service for Kubernetes (ACK), compruebe que se cumplen a continuación requisitos:

  • LoongCollector está actualizado a la versión v3.3.10 o posterior.

  • El interruptor enableEBPF está habilitado en la página Component Management de la consola de ACK.

  Una vez cumplidos estos requisitos, cree una configuración de recopilación de Logtail de AgentSight en Simple Log Service para recopilar los registros de LLM del agente. Esta configuración se aplica al mismo grupo de máquinas que las demás configuraciones de LoongCollector.

Funcionamiento

La instrumentación tradicional de aplicaciones no puede seguir el ritmo de la rápida iteración ni la naturaleza altamente personalizada de los agentes de IA. Tampoco permite rastrear las cadenas de llamadas a herramientas para identificar el comportamiento real del agente. El plugin input_agentsight adjunta sondas SSL/TLS y observadores de procesos a nivel de kernel mediante eBPF. Así, captura las solicitudes y respuestas cifradas con TLS entre los procesos del agente y los servicios de LLM. Esto logra una observability de extremo a extremo sin modificar el código del agente.

Funciones

• Recopila datos completos de interacción entre los agentes de IA y los LLM: mensajes de solicitud, mensajes de respuesta, nombre del modelo, uso de tokens, latencia, códigos de estado, entre otros.

• Identifica los procesos que acceden a las API de LLM mediante una lista blanca de dominios que incluye de forma predeterminada los dominios comunes de API de LLM.

Procedimiento

1. Inicie sesión en la consola de Simple Log Service.

2. En la sección Data Import, seleccione la entrada de configuración de recopilación de LoongCollector y luego elija el Project y el logstore de destino.

3. En la página Machine Group Configuration, configure y aplique el grupo de máquinas de destino.

   Importante

   Si aplica el grupo de máquinas inmediatamente después de crearlo, es posible que el estado del heartbeat se muestre como FAIL porque la conexión aún no ha surtido efecto. Haga clic en Automatic Retry para resolver este problema.

4. En la pestaña Data Source Settings, especifique un Configuration Name e introduzca la configuración del plugin. El tipo de plugin es fijo: input_agentsight.

   Elija un patrón de configuración según su escenario:

   • Utilice la configuración mínima cuando su agente y proveedor de LLM estén cubiertos por los valores predeterminados integrados.

   • Aplique la lista blanca de dominios personalizada cuando su agente se conecte a un endpoint de LLM distinto al predeterminado.

   • Recurra a la lista blanca de líneas de comandos personalizada cuando las reglas integradas no coincidan con el proceso de su agente.

   • Opte por el reporte de tráfico HTTP sin procesar cuando necesite inspeccionar tráfico que AgentSight no pueda analizar sintácticamente con semántica GenAI.

   Configuración mínima

   Configuración mínima: Especifique únicamente el tipo de plugin. Todos los ajustes usan valores predeterminados (se inyectan la lista blanca de líneas de comandos y la lista de dominios predeterminadas integradas).

   {
       "inputs": [
           {
               "type": "input_agentsight"
           }
       ]
   }

   Lista blanca de dominios personalizada: Especifique los dominios HTTPS personalizados que desea supervisar.

   {
       "inputs": [
           {
               "detail": {
                   "ProbeConfig": {
                       "Https": [
                           "api.openai.com",
                           "api.anthropic.com",
                           "dashscope-intl.aliyuncs.com",
                           "dashscope.aliyuncs.com"
                       ]
                   }
               },
               "type": "input_agentsight"
           }
       ]
   }

   Lista blanca de líneas de comandos personalizada: Filtre los agentes de destino por la línea de comandos del proceso y etiquete su tipo.

   {
       "inputs": [
           {
               "detail": {
                   "ProbeConfig": {
                       "CmdlineWhitelist": [
                           {
                               "AgentType": "openclaw",
                               "Args": ["node*", "*openclaw*"]
                           },
                           {
                               "AgentType": "claude-code",
                               "Args": ["node*", "*claude*"]
                           }
                       ]
                   }
               },
               "type": "input_agentsight"
           }
       ]
   }

   Reportar protocolos desconocidos como tráfico HTTP sin procesar: Cuando se habilita ProbeConfig.RawHttpsFallback, el tráfico que AgentSight no puede analizar sintácticamente con semántica GenAI (rutas de API desconocidas o cuerpos no estándar) ya no se descarta. En su lugar, se reporta como tráfico HTTP sin procesar. Cree un índice de campo para los eventos HTTP sin procesar y luego use la función de consulta y análisis del logstore para inspeccionarlos.

   {
       "inputs": [
           {
               "detail": {
                   "ProbeConfig": {
                       "RawHttpsFallback": true
                   }
               },
               "type": "input_agentsight"
           }
       ]
   }

   Nota

   Tenga en cuenta el siguiente comportamiento:

   • Los registros HTTP sin procesar generados por RawHttpsFallback: true se producen solo cuando AgentSight no puede resolver el tráfico con semántica GenAI. Son mutuamente excluyentes con los registros gen_ai.*: una sola solicitud produce como máximo uno de los dos tipos.

   • El tráfico HTTP sin procesar se reporta con los nombres de evento event.name=http.request y event.name=http.response.

   • Esta función solo es compatible con LoongCollector v3.3.10 y versiones posteriores.

5. Cree índices y obtenga una vista previa de los datos. Puede crear manualmente índices de campo basados en los campos recopilados o hacer clic en Auto Generate Index.

6. Una vez completada la configuración, espere aproximadamente 1 minuto para que el índice surta efecto. Después podrá consultar los registros recopilados en la página de consulta y análisis del logstore.

   Debería ver entradas de registro que contienen campos como gen_ai.agent.type, gen_ai.model.request y gen_ai.model.response. La presencia de estos campos confirma que la recopilación funciona correctamente.

Parámetros de configuración

Límites y solución de problemas

• No hay datos en la página de vista previa o de consulta: Compruebe que la versión del kernel del servidor sea 5.10 o posterior (uname -r) y que LoongCollector esté actualizado a la versión v3.3.9 o posterior. Luego, verifique que la línea de comandos del proceso de destino coincida con una regla de CmdlineWhitelist o que los dominios a los que accede estén en la lista Https. Ejecute el siguiente comando en el servidor para ver la línea de comandos real de un proceso antes de escribir las reglas glob:

  tr '\0' ' ' < /proc/<PID>/cmdline; echo

  Consulte Technical appendix para conocer los límites de compatibilidad de los hook de eBPF que podrían impedir la recopilación en ciertos binarios de agentes.

• Para obtener más instrucciones sobre la solución de problemas, consulte Troubleshoot Logtail log collection failures.

• Esta función se encuentra actualmente en versión canary y está disponible en a continuación regiones: US (Virginia), US (Silicon Valley), Malaysia (Kuala Lumpur), Indonesia (Jakarta), South Korea (Seoul), entre otras.

Apéndice técnico

El plugin input_agentsight usa eBPF para la recopilación. Su capacidad para capturar tráfico cifrado HTTPS de un agente determinado depende de si eBPF puede localizar las funciones de envío y recepción SSL en el archivo ejecutable del agente. Use la siguiente tabla para determinar la compatibilidad: