Repolode
inspektor-gadget

inspektor-gadget/inspektor-gadget

Kit de herramientas que empaqueta programas eBPF como Gadgets en imágenes OCI para recopilar e inspeccionar datos del sistema en clústeres de Kubernetes y hosts Linux.

Estrellas
2,942
Forks
381
Issues abiertos
417
Último commit
ayer

¿Qué es?

Inspektor Gadget es un conjunto de herramientas y un framework para recopilar datos e inspeccionar sistemas en clústeres de Kubernetes y hosts Linux mediante eBPF. Se encarga del empaquetado, el despliegue y la ejecución de Gadgets, programas eBPF distribuidos como imágenes OCI que se pueden almacenar y compartir en registros de contenedores.

Una característica clave es el enriquecimiento: los eventos a nivel de kernel se asocian automáticamente con conceptos de alto nivel, como pods de Kubernetes, nombres de contenedores y nombres DNS. Los filtros funcionan de la misma manera, de modo que los usuarios pueden seleccionar datos por pod o contenedor en lugar de usar identificadores de bajo nivel del kernel. Los Gadgets se pueden ejecutar desde el plugin kubectl-gadget, la CLI independiente ig, un daemon cliente-servidor o una biblioteca Go integrada.

Los datos se pueden exportar a herramientas de observabilidad mediante un comando o una configuración declarativa. Los administradores pueden restringir qué Gadgets se pueden ejecutar, y los módulos WebAssembly pueden procesar los resultados. Los Gadgets requieren Linux 5.10 o posterior con BTF habilitado.

Funciones clave

  • 01Empaqueta programas eBPF como Gadgets en imágenes OCI que se pueden almacenar y compartir en registros.
  • 02Asocia automáticamente los eventos del kernel con pods de Kubernetes, contenedores y nombres DNS.
  • 03Filtra datos por recursos de alto nivel, como pods y contenedores.
  • 04Exporta los datos recopilados a herramientas de observabilidad mediante la CLI o una configuración declarativa.
  • 05Permite que los administradores restrinjan qué Gadgets se pueden ejecutar.
  • 06Admite módulos WebAssembly para procesar datos posteriormente.

Casos de uso

  • Solucionar problemas de red o DNS entre pods de un clúster de Kubernetes.
  • Rastrear aperturas de archivos, actividad de procesos o llamadas al sistema en un host Linux sin modificar las aplicaciones.
  • Enviar métricas obtenidas con eBPF a Prometheus u otras canalizaciones de observabilidad.
  • Depurar nodos con kubectl debug mediante el binario ig.

Inicio rápido

  1. 1

    Instala el gestor de plugins krew

  2. 2

    Instala kubectl gadget y despliégalo en el clúster

    kubectl krew install gadget kubectl gadget deploy
  3. 3

    Ejecuta el Gadget trace_open

    kubectl gadget run trace_open:latest

Antes de usarlo

  • Los Gadgets requieren un kernel de Linux 5.10 o posterior con BTF habilitado.
  • macOS y Windows solo pueden controlar un daemon ig que se esté ejecutando en una máquina Linux.
  • Las ejecuciones locales y en contenedores necesitan acceso root o privilegiado en el host.

Temas

Preguntas frecuentes

¿Qué es inspektor-gadget?
Kit de herramientas que empaqueta programas eBPF como Gadgets en imágenes OCI para recopilar e inspeccionar datos del sistema en clústeres de Kubernetes y hosts Linux. Inspektor Gadget es un conjunto de herramientas y un framework para recopilar datos e inspeccionar sistemas en clústeres de Kubernetes y hosts Linux mediante eBPF. Se encarga del empaquetado, el despliegue y la ejecución de Gadgets, programas eBPF distribuidos como imágenes OCI que se pueden almacenar y compartir en registros de contenedores.
¿inspektor-gadget es gratuito? ¿Qué licencia tiene?
inspektor-gadget es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿inspektor-gadget sigue mantenido?
Mantenimiento activo. El último commit de inspektor-gadget fue el 19 oct 2026.
¿Para qué puedo usar inspektor-gadget?
Solucionar problemas de red o DNS entre pods de un clúster de Kubernetes. Rastrear aperturas de archivos, actividad de procesos o llamadas al sistema en un host Linux sin modificar las aplicaciones. Enviar métricas obtenidas con eBPF a Prometheus u otras canalizaciones de observabilidad. Depurar nodos con kubectl debug mediante el binario ig.
¿Cómo se instala inspektor-gadget?
Instala el gestor de plugins krew Instala kubectl gadget y despliégalo en el clúster: kubectl krew install gadget kubectl gadget deploy Ejecuta el Gadget trace_open: kubectl gadget run trace_open:latest
¿Dónde consigo inspektor-gadget?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/inspektor-gadget/inspektor-gadget

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados