Repolode
alibaba

alibaba/loongsuite-go

Инструмент компиляционной OpenTelemetry-инструментации для Go: добавляет трассировки и метрики через команду `otel go build`, не требуя менять код приложения.

Звёзды
907
Форки
131
Открытые issues
31
Последний коммит
20 дней назад

Что это?

LoongSuite Go Agent добавляет OpenTelemetry-наблюдаемость в Go-приложения на этапе компиляции. Вместо правок исходного кода достаточно собрать проект с префиксом `otel` (например, `otel go build`), и инструмент внедрит инструментацию в поддерживаемые библиотеки во время компиляции.

Инструмент поддерживает широкий набор распространённых библиотек Go, включая net/http, gin, gorm, go-redis, grpc, клиенты Kafka и несколько LLM SDK, например openai-go и anthropic-sdk-go. Проект также позволяет внедрять пользовательский код в библиотеки, которые официально не поддерживаются, и содержит примеры логирования с zap, обнаружения SQL-инъекций и мониторинга потребителей Kafka.

Для Linux, macOS и Windows доступны готовые бинарные файлы, также предусмотрен shell-скрипт установки. Для инструмента и инструментируемого приложения требуется Go 1.25 или новее. Проект был передан сообществу OpenTelemetry и проходил инкубацию под названием opentelemetry-go-compile-instrumentation.

Ключевые возможности

  • 01Добавляет инструментацию на этапе компиляции с помощью команды `otel go build`, не требуя менять исходный код.
  • 02Поддерживает широкий набор библиотек Go, включая HTTP-фреймворки, ORM, Redis-клиенты, gRPC и очереди сообщений.
  • 03Включает инструментацию для нескольких LLM SDK, например openai-go и langchaingo.
  • 04Позволяет внедрять пользовательский код в библиотеки, которые официально не поддерживаются.
  • 05Предоставляет готовые бинарные файлы для Linux, macOS и Windows.

Сценарии использования

  • Добавление распределённой трассировки в существующий Go-сервис без изменения его кода.
  • Мониторинг HTTP-запросов, обращений к базам данных и Redis в Go-микросервисе.
  • Наблюдение за вызовами LLM API из Go-приложений.
  • Оценка накладных расходов от инструментации перед её внедрением.

Быстрый старт

  1. 1

    Скачайте готовый бинарный файл otel для вашей платформы со страницы релизов

  2. 2

    Или соберите и установите инструмент из исходного кода

    make install
  3. 3

    Убедитесь, что инструмент установлен

    otel version
  4. 4

    Соберите проект, используя otel в качестве префикса

    otel go build

Что важно знать

  • Для инструмента и инструментируемого приложения требуется Go 1.25 или новее.
  • Если go build выполняется успешно, а otel go build завершается с ошибкой, в README это считается вероятным багом.

В подборках

Темы

Частые вопросы

Что такое loongsuite-go?
Инструмент компиляционной OpenTelemetry-инструментации для Go: добавляет трассировки и метрики через команду `otel go build`, не требуя менять код приложения. LoongSuite Go Agent добавляет OpenTelemetry-наблюдаемость в Go-приложения на этапе компиляции. Вместо правок исходного кода достаточно собрать проект с префиксом `otel` (например, `otel go build`), и инструмент внедрит инструментацию в поддерживаемые библиотеки во время компиляции.
loongsuite-go можно использовать бесплатно? Какая у него лицензия?
loongsuite-go распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
loongsuite-go всё ещё поддерживается?
Активно поддерживается. Последний коммит в loongsuite-go — 19 окт. 2026 г..
Для чего можно использовать loongsuite-go?
Добавление распределённой трассировки в существующий Go-сервис без изменения его кода. Мониторинг HTTP-запросов, обращений к базам данных и Redis в Go-микросервисе. Наблюдение за вызовами LLM API из Go-приложений. Оценка накладных расходов от инструментации перед её внедрением.
Как установить loongsuite-go?
Скачайте готовый бинарный файл otel для вашей платформы со страницы релизов Или соберите и установите инструмент из исходного кода: make install Убедитесь, что инструмент установлен: otel version Соберите проект, используя otel в качестве префикса: otel go build
Где скачать loongsuite-go?
Исходный код и инструкции по установке — на GitHub: https://github.com/alibaba/loongsuite-go

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Платформа наблюдаемости с открытым исходным кодом и нативной поддержкой OpenTelemetry: логи, метрики, трейсы, алерты и дашборды в одном решении для самостоятельного размещения.

32,5 тыс.+60 за неделю2,6 тыс.TypeScriptOtherОбновлён 21 час назад