Application Real-Time Monitoring Service:NGINX Ingress Controller のトレーシング有効化

手順2：NGINX Ingress Controller での OpenTelemetry の有効化Managed Service for OpenTelemetry

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

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

3. [デプロイメント] ページで、[名前空間] を [kube-system] に設定します。nginx-ingress-controller デプロイメントを見つけ、[アクション] 列の [編集] をクリックします。

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

   タイプ	変数名	値	説明
   カスタム	OTEL_EXPORTER_OTLP_HEADERS	authentication=<認証トークン>	手順1 で取得した認証トークンを使用します。例: authentication=bfXXXXXXXe@7bXXXXXXX1_bXXXXXe@XXXXXXX1。

   追加が完了したら、編集 ページの右側にある 更新 をクリックし、表示されるダイアログボックスで 確定する をクリックします。

5. 左側のナビゲーションペインで、[設定] > [ConfigMap] を選択します。

6. [ConfigMap] ページで、[名前空間] を [kube-system] に設定します。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	サンプリングルール。	詳細については、「NGINX Ingress Controller のドキュメント」をご参照ください。	TraceIdRatioBased
   otel-sampler-ratio	サンプリングレート。	0.0 から 1.0 までの値で、小数点以下 2 桁まで指定できます。値 0.0 はサンプリングを無効にし、1.0 はすべてのトレースをサンプリングします。 詳細については、「NGINX Ingress Controller のドキュメント」をご参照ください。	0.1
   otel-sampler-parent-based	アップストリームサービスからサンプリングの決定を継承するかどうかを指定します。	false：(デフォルト) アップストリームのサンプリング決定を継承しません。otel-sampler と otel-sampler-ratio パラメーターが有効になります。 true：アップストリームのサンプリング決定を継承して再利用します。otel-sampler と otel-sampler-ratio パラメーターは有効になりません。 詳細については、「NGINX Ingress Controller のドキュメント」をご参照ください。	false

手順1：エンドポイント情報の取得

1. ARMS コンソールにログインします。左側のナビゲーションペインで、アクセスセンター をクリックします。

2. サーバーアプリケーション エリアで、[Zipkin] カードをクリックします。

   説明

   この例では Zipkin を使用します。

3. 表示される [Zipkin] パネルで、データをレポートするリージョンを選択します。

4. エンドポイント情報を記録します。[Connection Method] で [Alibaba Cloud イントラネット] を選択します。ページには、[v2 エンドポイント] と [v1 エンドポイント] の 2 つの VPC ネットワークエンドポイント URL が表示されます。後で使用するために、[v1 エンドポイント] の URL をコピーします。

   説明

   お使いの NGINX Ingress Controller が Managed Service for OpenTelemetry と同じ Alibaba Cloud リージョンにデプロイされている場合は、VPC ネットワークエンドポイントを使用します。それ以外の場合は、パブリックエンドポイントを使用します。

手順2：NGINX Ingress Controller での OpenTracing の有効化Managed Service for OpenTelemetry

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

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

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

4. 編集 パネルで 追加 をクリックして次のキーと値のペアを追加し、[OK] をクリックします。

   パラメーター	説明	値	例
   enable-opentracing	トレーシングを有効にするかどうかを指定します。	true：トレーシングを有効にします。 false：トレーシングを無効にします。	true
   zipkin-service-name	サービス名。	カスタム名。	nginx-ingress
   zipkin-collector-host	レポートエンドポイントのドメイン名。	手順1 で取得したエンドポイント URL を変更します。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 までの値です。値 0 はサンプリングなしを意味し、1 はすべてのデータがサンプリングされることを意味します。	0.1

手順 3: ARMS コンソールでトレースを表示する