Container Service for Kubernetes:NGINX Ingress controller のトレーシングの有効化

手順1：エンドポイントの取得 Managed Service for OpenTelemetry

手順2：NGINX Ingress controller の設定 Managed Service for OpenTelemetry

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

2. [クラスター] ページで、管理するクラスターの名前をクリックします。 左側のウィンドウで、[ワークロード] > [デプロイ] を選択します。

3. [Deployments] ページで、[Namespace] を 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. 構成 ページで、[Namespace] を 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. Managed Service for OpenTelemetry コンソールにログインします。

2. 左側メニューで、アプリケーションリスト をクリックします。

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

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

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

   • 呼び出しチェーン分析 タブで Trace ID をクリックすると、トレースの詳細が表示されます。

手順2：NGINX Ingress controller の設定 Managed Service for OpenTelemetry

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

2. [クラスター] ページで、管理するクラスターの名前をクリックします。 左側のナビゲーションウィンドウで、[設定] > [設定] を選択します。

3. 構成 ページで、[Namespace] を 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