Container Service for Kubernetes:NGINX Ingress コントローラーのトレースの有効化

ステップ 1：Managed Service for OpenTelemetryのエンドポイントの取得

ステップ 2：Managed Service for OpenTelemetryの NGINX Ingress コントローラーの設定

1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、クラスターリスト をクリックします。

2. クラスターリスト ページで、クラスターの名前をクリックします。左側のナビゲーションウィンドウで、ワークロード > デプロイメント をクリックします。

3. [デプロイメント] ページで、[名前空間] を kube-system に設定します。nginx-ingress-controller を検索し、[編集] をクリックします。

4. 編集 ページの上部で [nginx-ingress-controller] コンテナを選択し、環境変数 タブで Add をクリックして、次の環境変数を設定します。

   タイプ	変数キー	値/値の取得元	説明
   カスタム	OTEL_EXPORTER_OTLP_HEADERS	authentication=<authentication token>	ステップ 1：エンドポイントの取得で取得した認証トークンを使用します。例：authentication=bfXXXXXXXe@7bXXXXXXX1_bXXXXXe@XXXXXXX1

   変数を追加した後、更新 ページの右側のパネルで 編集 をクリックします。表示されるダイアログボックスで、OK をクリックします。

5. 左側のナビゲーションウィンドウで、設定 > ConfigMap を選択します。

6. 構成 ページで、[名前空間] を kube-system に設定します。nginx-configuration を検索し、nginx-configuration ConfigMap の 編集 列の 操作 をクリックします。

7. 編集 パネルで 追加 をクリックし、次の設定を追加してから OK をクリックします。

   パラメーター	説明	値	例
   enable-opentelemetry	OpenTelemetry トレースを有効にします。	true：トレースを有効にします。 false：トレースを無効にします。	true
   main-snippet	-	env OTEL_EXPORTER_OTLP_HEADERS;	env OTEL_EXPORTER_OTLP_HEADERS;
   otel-service-name	サービス名。	カスタム。	nginx-ingress
   otlp-collector-host	gRPC レポートエンドポイントのドメイン名。	ステップ 1：エンドポイントの取得で取得した VPC エンドポイントを使用します。http:// プレフィックスとポート番号を削除します。例：tracing-analysis-XX-XX-XXXXX.aliyuncs.com	tracing-analysis-XX-XX-XXXXX.aliyuncs.com
   otlp-collector-port	gRPC レポートエンドポイントのポート。	実際の値を入力します。	8090
   opentelemetry-trust-incoming-span	他のサービスからの受信トレースを信頼するかどうかを指定します。	true：信頼が有効になります。 false：信頼が無効になります。	true
   opentelemetry-operation-name	トレーススパンのフォーマット。	HTTP $request_method $service_name $uri	HTTP $request_method $service_name $uri
   otel-sampler	サンプリング戦略。	パラメーターの詳細については、「opentelemetry」をご参照ください。	TraceIdRatioBased
   otel-sampler-ratio	サンプリングレート。	値は 0 から 1 の間で、小数点以下 2 桁まで指定できます。値 0 はリクエストがサンプリングされないことを意味し、1 はすべてのリクエストがサンプリングされることを意味します。 パラメーターの詳細については、「opentelemetry」をご参照ください。	0.1
   otel-sampler-parent-based	アップストリームサービスからサンプリング決定を継承するかどうかを指定します。	false (デフォルト)：アップストリームのサンプリング決定を継承しません。サンプリングは otel-sampler および otel-sampler-ratio パラメーターに基づきます。 true：アップストリームのサンプリング決定を継承します。otel-sampler および otel-sampler-ratio パラメーターは無視されます。 パラメーターの詳細については、「opentelemetry」をご参照ください。	false

ステップ 3：Managed Service for OpenTelemetryでのトレースデータの表示

1. OpenTelemetry 向けマネージドサービスコンソールにログインします。

2. 左側のナビゲーションウィンドウで、アプリケーションリスト をクリックします。

3. アプリケーションリスト ページの上部でリージョンを選択し、[nginx-ingress] アプリケーション名をクリックします。

4. • アプリケーション概要 タブで、リクエスト数やエラー数などのメトリックを確認できます。

   • 呼び出しチェーン分析 タブでは、呼び出し数、エラー数、平均持続時間などのチャート、およびトレースリストを表示できます。リストには、TraceId、インターフェイス名、アプリケーション名、持続時間、ステータス、開始時刻、ホストアドレスなどのフィールドが含まれます。

   • 呼び出しチェーン分析 タブで、トレース ID をクリックしてトレース詳細を表示します。

ステップ 2：Managed Service for OpenTelemetryの NGINX Ingress コントローラーの設定

1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、クラスターリスト をクリックします。

2. クラスターリスト ページで、クラスターの名前をクリックします。左側のナビゲーションウィンドウで、設定 > ConfigMap をクリックします。

3. 構成 ページで、[名前空間] を kube-system に設定します。nginx-configuration を検索し、nginx-configuration ConfigMap の 編集 列の 操作 をクリックします。

4. 編集 パネルで 追加 をクリックし、次の設定を追加してから [OK] をクリックします。

   パラメーター	説明	値	例
   enable-opentracing	トレースを有効にするかどうかを指定します。	true：トレースを有効にします。 false：トレースを無効にします。	true
   zipkin-service-name	サービス名。	カスタム。	nginx-ingress
   zipkin-collector-host	レポートエンドポイントのドメイン名。	ステップ 1：エンドポイントの取得で取得したエンドポイントを変更します。http:// プレフィックスを削除し、末尾に疑問符 ? を追加します。例： 元のエンドポイント：http://tracing-analysis-dc-hz-internal.aliyuncs.com/adapt_******_******/api/v1/spans 変更後の値：tracing-analysis-dc-hz-internal.aliyuncs.com/adapt_******_******/api/v1/spans?	tracing-analysis-dc-hz-internal.aliyuncs.com/adapt_******_******/api/v1/spans?
   opentracing-trust-incoming-span	他のサービスやシステムからのトレースを信頼するかどうかを指定します。	true：信頼が有効になります。 false：信頼が無効になります。	true
   zipkin-sample-rate	サンプリングレート。	値は 0 から 1 の間で、小数点以下 2 桁まで指定できます。値 0 はリクエストがサンプリングされないことを意味し、1 はすべてのリクエストがサンプリングされることを意味します。	0.1

ステップ 3：Managed Service for OpenTelemetryでのトレースデータの表示