2.3.2 Go

インストール

ログを取得したいアプリケーションにbuuurst_dev_goを追加します。

go get github.com/mxload/buuurst_dev_go

設定

アプリケーションのエントリーポイント（通常main.go）に以下の内容を追加します。現在Gin、go-chi、echoの3つのフレームワークに対応しています。

Gin

import (
    ...
+	buuurst_dev "github.com/mxload/buuurst_dev_go"
)

func main() {
  r := gin.Default()

+  r.Use(adapter.Wrap(buuurst_dev.MiddlewareFunc(
+	&buuurst_dev.BuuurstDevConfig{
+		Enabled:      true,
+		CollectorURL: "https://lambda-public.buuurst.dev/put-request-log",
+		ProjectID:    YOUR_PROJECT_ID,
+		ServiceKey:   "YOUR_SERVICE_KEY",
+		CustomHeaders: []string{
+			"Authorization",
+		},
+		IgnorePaths: []string{
+			"/ignored",
+		},
+	},
+  )))
    ...
}

go-chi

import (
    ...

+	buuurst_dev "github.com/mxload/buuurst_dev_go"
)

func main() {
    r := chi.NewRouter()

+	r.Use(buuurst_dev.MiddlewareFunc(
+		&buuurst_dev.BuuurstDevConfig{
+			Enabled:      true,
+			CollectorURL: "https://lambda-public.buuurst.dev/put-request-log",
+			ProjectID:    YOUR_PROJECT_ID,
+			ServiceKey:   "YOUR_SERVICE_KEY",
+			CustomHeaders: []string{
+				"Authorization",
+			},
+			IgnorePaths: []string{
+				"/ignored",
+			},
+		},
+	))

    ....
}

echo

import (
    ...

+	buuurst_dev "github.com/mxload/buuurst_dev_go"
)

func main() {
	e := echo.New()

+	e.Use(echo.WrapMiddleware(buuurst_dev.MiddlewareFunc(
+		&buuurst_dev.BuuurstDevConfig{
+			Enabled:      true,
+			CollectorURL: "https://lambda-public.buuurst.dev/put-request-log",
+			ProjectID:    YOUR_PROJECT_ID,
+			ServiceKey:   "YOUR_SERVICE_KEY",
+			CustomHeaders: []string{
+				"Authorization",
+			},
+			IgnorePaths: []string{
+				"/ignored",
+			},
+		},
+	)))
    ...
}

設定パラメータ

主な設定パラメータは以下になります。

Enabled
- 送信の有効/無効を切り替えます。デフォルトは false です。
ProjectID
- 作成したprojectのidを設定します。project_id はホーム・またはプロジェクト詳細から確認できます。
ServiceKey
- サービスキーの発行で作成したサービスキーを設定します。
CustomHeaders (オプション)
- ヘッダーの内容を記録する際に必要です。
- 例: "Content-Type": "application/json" を含めたい場合、CustomHeaders の値に Content-Type を追加します。
IgnorePaths (オプション)
- リクエストパスが IgnorePaths 内にある場合、リクエストログの送信を無視します。
- /health など、ヘルスチェックのパスを無効にしたい場合に設定します。

Mx.Loadに送信されるログパラメータは以下になります。

メソッド
リクエストパス
リクエストボディ
クエリパラメーター
リクエストヘッダ
クッキー