Los registros de tiempo de ejecución del sistema de IA (eBPF) utilizan eBPF para recopilar los comportamientos en tiempo de ejecución de los agentes de IA en la capa del kernel de Linux. Esto incluye las interacciones con modelos, los procesos, los archivos y las actividades de red, sin necesidad de modificar el código de la aplicación del agente. En este tema se describe cómo configurar los registros de tiempo de ejecución del sistema de IA (eBPF) en el centro de integración y comprobar que los datos se escriben correctamente.
Escenarios
Los registros de tiempo de ejecución del sistema de IA (eBPF) son adecuados para a continuación escenarios:
Descubrir agentes de IA que se ejecutan en hosts Linux o en contenedores de forma no intrusiva.
Recopilar los comportamientos en tiempo de ejecución de agentes, framework de agentes y agentes personalizados que no están integrados con
LoongSuitePilot ni con sondas de lenguaje y framework.Correlacionar las interacciones con modelos con los procesos, el acceso a archivos, la ejecución de comandos y las actividades de red.
Actualizar el alcance de recopilación y las reglas de detección de
AgentSightsin reiniciar sus cargas de trabajo.
Alcance compatible
Los registros de tiempo de ejecución del sistema de IA (eBPF) admiten escenarios de hosts Linux, Docker y Kubernetes disponibles en el centro de integración. eBPF ofrece cobertura general para los tiempos de ejecución comunes de Linux. Sin embargo, la recopilación de cargas útiles de LLM puede ser limitada cuando el programa objetivo utiliza una implementación especial de TLS o un tiempo de ejecución que aún no es compatible.
eBPF podría no obtener directamente los identificadores nativos de Session, Turn y Step, ni los estados internos del framework. Para obtener este contexto, utilice además LoongSuite Pilot o las sondas de lenguaje y framework. Para más información sobre cómo seleccionar un método de integración, consulte Select an AI Agent integration method.
Requisitos previos
Antes de empezar, compruebe que se cumplen a continuación condiciones:
AgentLoopestá activado y se creó un espacio de agente.Los agentes de IA que desea recopilar están desplegados en los hosts Linux, contenedores o clústeres objetivo.
Cuenta con permisos para instalar o actualizar
LoongCollector, ejecutar comandos de integración y gestionar grupos de máquinas.El entorno objetivo cumple con los requisitos de sistema operativo, kernel y red que se muestran en la página de integración.
Para el escenario de DaemonSet de Kubernetes, el componente
LoongCollectoren ACK se actualizó a la versión 3.3.10 o posterior, y el interruptor eBPF Collection está habilitado en la página de configuración del componente.
Procedimiento de integración
Inicie sesión en AgentLoop. En el panel de navegación izquierdo, haga clic en Integration Center.
En la sección AI Node Integration, haga clic en AI System Runtime Logs.
Seleccione un escenario según el entorno de despliegue del agente, como host Linux, Docker o Kubernetes.
-
Configure el alcance de recopilación.
Parámetro
Descripción
Project
El proyecto de Simple Log Service (SLS) vinculado al espacio de agente actual. Es de solo lectura.
Logstore
El logstore donde se escriben los registros de tiempo de ejecución. Su valor es fijo:
ebpf-event. Es de solo lectura.Machine group
Seleccione o cree el grupo de máquinas objetivo para la recopilación.
Configure las reglas de detección de
AgentSight. Si no modifica la configuración, el sistema utiliza las reglas predeterminadas recomendadas. Cuando modifique alguna regla, la configuración actual sobrescribirá la regla predeterminada correspondiente. Para más detalles, consulte Configure AgentSight detection rules.Habilite el enmascaramiento de datos según lo requiera. Para más detalles, consulte Data masking.
Siga las instrucciones de la página para instalar o actualizar
LoongCollectory la configuración de recopilación en el entorno objetivo.
Configurar las reglas de detección de AgentSight
Lista de permitidos de línea de comandos
Por lo general, el recopilador de datos identifica automáticamente los agentes de IA y los incluye en el alcance de recopilación. Si el proceso objetivo no se identifica, agregue reglas a la lista de permitidos de línea de comandos. Cada regla contiene un tipo de agente y un patrón de argumento de línea de comandos. Los procesos que coinciden con una regla se etiquetan con el tipo de agente correspondiente.
Lista de denegados de línea de comandos
La lista de denegados de línea de comandos excluye los patrones de procesos que no necesitan recopilarse. Esta lista tiene prioridad sobre la lista de permitidos.
Lista de permitidos de dominios
La lista de permitidos de dominios determina qué actividades de red entran al alcance de recopilación candidato. Las reglas predeterminadas incluyen dominios comunes de servicios de modelos, como Model Studio, OpenAI y Anthropic. Cuando utilice otros proveedores de servicios de modelos o una puerta de enlace de IA personalizada, agregue los dominios correspondientes.
Que el tráfico entre al alcance de recopilación candidato no garantiza que su protocolo de carga útil se pueda analizar sintácticamente. Si observa actividades de red pero no ve interacciones completas con el modelo, compruebe que el protocolo y el tiempo de ejecución objetivo estén dentro del alcance compatible actual.
Recopilar tráfico HTTPS sin procesar
Cuando habilite Collect Https Raw Traffic, el tráfico que no se pueda analizar sintácticamente con semántica de LLM dejará de descartarse. Este incluye rutas de API desconocidas o cuerpos no estándar, y se reportará como HTTP sin procesar.
Esta función solo es compatible con LoongCollector 3.3.10 o versiones posteriores.
Enmascaramiento de datos
Los registros de tiempo de ejecución pueden contener información confidencial, como números de teléfono, direcciones de correo electrónico y claves de API. Según lo requiera, habilite el enmascaramiento de datos en el endpoint desde la configuración de integración. Los tipos de datos compatibles incluyen números de teléfono, números de identificación, direcciones de correo electrónico, direcciones IP, números de teléfono fijo y números de tarjetas bancarias.
El enmascaramiento de datos está deshabilitado de forma predeterminada. Una vez habilitado, los datos enmascarados conservan el contexto necesario para auditorías y solución de problemas.
Comprobar la integración
Una vez completada la integración, compruebe si el logstore ebpf-event en la consola de SLS contiene los datos más recientes de los hosts o contenedores objetivo. Si hay datos en el logstore, vaya a Audit management o Audit facts y compruebe que los nodos, agentes o procesos objetivo se puedan consultar dentro del rango de tiempo correspondiente.
Preguntas frecuentes
No hay datos en el logstore
Compruebe que
LoongCollectory la configuración de recopilación se instalaron o actualizaron correctamente.Compruebe que los hosts o contenedores objetivo pertenecen al grupo de máquinas seleccionado.
Compruebe que el rango de tiempo de la consulta abarca el periodo posterior a la integración.
Compruebe que el entorno objetivo cumple con los requisitos de sistema operativo, kernel y red que se muestran en la página.
El agente objetivo no se identifica
Primero, compruebe que el proceso objetivo se está ejecutando. Si el recopilador de datos no identifica el proceso automáticamente, agregue el tipo de agente y el patrón de argumento de línea de comandos a la lista de permitidos de línea de comandos.
Se recopilan procesos no deseados
Agregue los patrones de procesos que desea excluir a la lista de denegados de línea de comandos. Esta lista tiene prioridad sobre la lista de permitidos.
Se ven las actividades de red, pero no las interacciones completas con el modelo
Compruebe que el dominio del servicio de modelos está en la lista de permitidos de dominios. También verifique que el protocolo y el tiempo de ejecución del programa objetivo estén dentro del alcance compatible actual. La lista de permitidos de dominios solo modifica el alcance de recopilación candidato y no garantiza que la carga útil se pueda analizar sintácticamente. Si necesita conservar el tráfico que no se puede analizar sintácticamente, habilite Collect Https Raw Traffic para que se reporte como HTTP sin procesar. Esto requiere LoongCollector 3.3.10 o versiones posteriores.