Repolode
alibaba

alibaba/loongsuite-go

アプリケーションのコードを変更せず、`otel go build`でトレースとメトリクスを追加する、Go向けのコンパイル時OpenTelemetry計装ツール。

スター
907
フォーク
131
未解決の Issue
31
最終コミット
20 日前

これは何?

LoongSuite Go Agentは、コンパイル時にGoアプリケーションへOpenTelemetryによる可観測性を追加するツールです。ソースコードを編集する代わりに、`otel`を先頭に付けてプロジェクトをビルドすると(例:`otel go build`)、コンパイル時に対応ライブラリへ計装を挿入します。

net/http、gin、gorm、go-redis、grpc、Kafkaクライアント、openai-goやanthropic-sdk-goなど複数のLLM SDKを含む、幅広い一般的なGoライブラリに対応しています。公式には未対応のライブラリへ独自コードを挿入する方法も用意されており、zapによるロギング、SQLインジェクションの検出、Kafkaコンシューマーの監視に関するサンプルも含まれています。

Linux、macOS、Windows向けのビルド済みバイナリがあり、シェルのインストールスクリプトも提供されています。このツールと計装対象のアプリケーションのどちらにも、Go 1.25以降が必要です。本プロジェクトはOpenTelemetryコミュニティに寄贈され、opentelemetry-go-compile-instrumentationとしてインキュベーションされています。

主な機能

  • 01ソースコードを変更せず、`otel go build`コマンドでコンパイル時に計装を追加します。
  • 02HTTPフレームワーク、ORM、Redisクライアント、gRPC、メッセージキューなど、幅広いGoライブラリに対応しています。
  • 03openai-goやlangchaingoなど、複数のLLM SDK向けの計装が含まれています。
  • 04公式には未対応のライブラリにも独自コードを挿入できます。
  • 05Linux、macOS、Windows向けのビルド済みバイナリを提供しています。

ユースケース

  • 既存のGoサービスのコードに手を加えず、分散トレーシングを追加する。
  • GoマイクロサービスのHTTP、データベース、Redisの呼び出しを監視する。
  • Goアプリケーションから行われるLLM API呼び出しを可観測にする。
  • 計装を展開する前に、そのオーバーヘッドを測定する。

クイックスタート

  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 とは?
アプリケーションのコードを変更せず、`otel go build`でトレースとメトリクスを追加する、Go向けのコンパイル時OpenTelemetry計装ツール。 LoongSuite Go Agentは、コンパイル時にGoアプリケーションへOpenTelemetryによる可観測性を追加するツールです。ソースコードを編集する代わりに、`otel`を先頭に付けてプロジェクトをビルドすると(例:`otel go build`)、コンパイル時に対応ライブラリへ計装を挿入します。
loongsuite-go は無料で使えますか?ライセンスは?
loongsuite-go は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
loongsuite-go は今もメンテナンスされていますか?
活発にメンテナンス中。loongsuite-go の最終コミットは 2026年10月19日 です。
loongsuite-go は何に使えますか?
既存のGoサービスのコードに手を加えず、分散トレーシングを追加する。 GoマイクロサービスのHTTP、データベース、Redisの呼び出しを監視する。 Goアプリケーションから行われるLLM API呼び出しを可観測にする。 計装を展開する前に、そのオーバーヘッドを測定する。
loongsuite-go のインストール方法は?
お使いのプラットフォーム向けのビルド済み otel バイナリをリリースページからダウンロードします または、ソースからツールをビルドしてインストールします: make install ツールがインストールされていることを確認します: otel version otel をプレフィックスに付けてプロジェクトをビルドします: otel go build
loongsuite-go はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/alibaba/loongsuite-go

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト