go-redis、Upstash、OpenTelemetryを使用した分散トレース

このチュートリアルでは、go-redisクライアントを使用してUpstash Redisデータベースに接続し、分散トレースを使用してアプリのパフォーマンスを監視する方法を学習します。

go-redisとは何ですか？

go-redisは、Golangで人気のあるRedisクライアントです。箱から出して、Redisサーバー、Sentinel、およびクラスターをサポートします。

Upstash Redisデータベースに接続するには、次のコードを使用します。

package main

import (
	"context"
	"fmt"

	"github.com/go-redis/redis/v8"
)

func main() {
	ctx := context.Background()

	opt, _ := redis.ParseURL("<connection-string-from-Upstash>")
	client := redis.NewClient(opt)

	if err := client.Set(ctx, "foo", "bar", 0); err != nil {
		panic(err)
	}
	fmt.Println(client.Get(ctx, "foo").Result())
}

任意のコマンドを実行するには、別のAPIを使用することもできます：

val, err := rdb.Do(ctx, "get", "key").Result()
if err != nil {
	if err == redis.Nil {
		fmt.Println("key does not exists")
		return
	}
	panic(err)
}

go-redisを使用して、APIへのデータまたはレート制限リクエストをキャッシュできます。クライアントの詳細については、RedisGolangのドキュメントを参照してください。

分散トレースとは何ですか？

分散トレースを使用すると、分散システム、特にマイクロサービスアーキテクチャを使用して構築されたシステムを介して伝播するリクエストを監視できます。

トレースにより、リクエストが分散システムを通過するときにリクエストを追跡できます。何が違うのか、何が壊れているのか、どのログとエラーが関連しているのかについての完全なコンテキストを取得します。

OpenTelemetryとは何ですか？

OpenTelemetryは、トレース、ログ、およびメトリックを収集およびエクスポートできるベンダー中立の標準です。

Otelを使用すると、開発者はベンダーに依存しない方法でテレメトリデータを収集およびエクスポートできます。 OpenTelemetryを使用すると、アプリケーションを一度インストルメント化してから、インストルメンテーションを変更せずにベンダーを追加または変更できます。たとえば、OpenTelemetryをサポートする人気のあるDataDogの代替案のリストを次に示します。

OpenTelemetryは、ほとんどのプログラミング言語で利用可能であり、さまざまな言語や環境間での相互運用性を提供します。

go get github.com/go-redis/redis/extra/redisotel/v8

import (
    "github.com/go-redis/redis/v8"
    "github.com/go-redis/redis/extra/redisotel/v8"
)

rdb := redis.NewClient(&redis.Options{...})

rdb.AddHook(redisotel.NewTracingHook())

ctx := req.Context()
val, err := rdb.Get(ctx, "key").Result()