Repolode
alibaba

alibaba/loongsuite-go

Herramienta de instrumentación de OpenTelemetry para Go en tiempo de compilación, que añade trazas y métricas con el prefijo `otel go build`, sin modificar el código de la aplicación.

Estrellas
907
Forks
131
Issues abiertos
31
Último commit
hace 19 días

¿Qué es?

LoongSuite Go Agent es una herramienta que añade observabilidad de OpenTelemetry a aplicaciones Go en tiempo de compilación. En lugar de editar el código fuente, compilas el proyecto con el prefijo `otel` (por ejemplo, `otel go build`) y la herramienta inyecta instrumentación en las bibliotecas compatibles durante la compilación.

Cubre una amplia variedad de bibliotecas Go de uso común, como net/http, gin, gorm, go-redis, grpc, clientes de Kafka y varios SDK de LLM, como openai-go y anthropic-sdk-go. El proyecto también permite inyectar código personalizado en bibliotecas que no admite oficialmente e incluye ejemplos de logging con zap, detección de inyecciones SQL y monitorización de consumidores de Kafka.

Hay binarios precompilados para Linux, macOS y Windows, además de un script de instalación para shell. Tanto la herramienta como la aplicación instrumentada requieren Go 1.25 o posterior. El proyecto se aportó a la comunidad de OpenTelemetry y se incorporó al programa de incubación como opentelemetry-go-compile-instrumentation.

Funciones clave

  • 01Añade instrumentación en tiempo de compilación mediante el comando `otel go build`, sin modificar el código fuente.
  • 02Es compatible con una amplia variedad de bibliotecas Go, incluidos frameworks HTTP, ORM, clientes de Redis, gRPC y colas de mensajes.
  • 03Incluye instrumentación para varios SDK de LLM, como openai-go y langchaingo.
  • 04Permite inyectar código personalizado en bibliotecas que no admite oficialmente.
  • 05Ofrece binarios precompilados para Linux, macOS y Windows.

Casos de uso

  • Añadir trazas distribuidas a un servicio Go existente sin modificar su código.
  • Monitorizar llamadas HTTP, a bases de datos y a Redis en un microservicio Go.
  • Observar las llamadas a API de LLM realizadas desde aplicaciones Go.
  • Medir la sobrecarga de la instrumentación antes de implementarla.

Inicio rápido

  1. 1

    Descarga un binario de otel precompilado para tu plataforma desde la página de versiones

  2. 2

    O compila e instala la herramienta desde el código fuente

    make install
  3. 3

    Comprueba que la herramienta esté instalada

    otel version
  4. 4

    Compila tu proyecto con el prefijo otel

    otel go build

Antes de usarlo

  • Tanto la herramienta como la aplicación instrumentada requieren Go 1.25 o posterior.
  • Si go build se ejecuta correctamente, pero otel go build falla, el README indica que probablemente se trate de un error.

En colecciones

Temas

Preguntas frecuentes

¿Qué es loongsuite-go?
Herramienta de instrumentación de OpenTelemetry para Go en tiempo de compilación, que añade trazas y métricas con el prefijo `otel go build`, sin modificar el código de la aplicación. LoongSuite Go Agent es una herramienta que añade observabilidad de OpenTelemetry a aplicaciones Go en tiempo de compilación. En lugar de editar el código fuente, compilas el proyecto con el prefijo `otel` (por ejemplo, `otel go build`) y la herramienta inyecta instrumentación en las bibliotecas compatibles durante la compilación.
¿loongsuite-go es gratuito? ¿Qué licencia tiene?
loongsuite-go es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿loongsuite-go sigue mantenido?
Mantenimiento activo. El último commit de loongsuite-go fue el 19 oct 2026.
¿Para qué puedo usar loongsuite-go?
Añadir trazas distribuidas a un servicio Go existente sin modificar su código. Monitorizar llamadas HTTP, a bases de datos y a Redis en un microservicio Go. Observar las llamadas a API de LLM realizadas desde aplicaciones Go. Medir la sobrecarga de la instrumentación antes de implementarla.
¿Cómo se instala loongsuite-go?
Descarga un binario de otel precompilado para tu plataforma desde la página de versiones O compila e instala la herramienta desde el código fuente: make install Comprueba que la herramienta esté instalada: otel version Compila tu proyecto con el prefijo otel: otel go build
¿Dónde consigo loongsuite-go?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/alibaba/loongsuite-go

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

Proyectos relacionados