Application Real-Time Monitoring Service:NGINX Ingress Controllerのトレースを有効にする

ステップ2：NGINX Ingress Controllerに対してManaged Service for OpenTelemetryを有効にする

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

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

3. ページの上部にある[名前空間]ドロップダウンリストからkube-systemを選択します。次に、検索ボックスにnginx-ingress-controllerと入力し、検索アイコンをクリックします。NGINX Ingress Controllerを見つけて、[アクション]列の編集をクリックします。

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

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

   

   環境変数を追加した後、編集ページの右側にある更新をクリックします。表示されるメッセージで、確認をクリックします。

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

6. ConfigMapページの上部にある[名前空間]ドロップダウンリストからkube-systemを選択します。次に、[名前]検索ボックスにnginx-configurationと入力し、検索アイコンをクリックします。nginx-configurationを見つけて、[アクション]列の編集をクリックします。アクション

7. 編集パネルで、追加をクリックして次の構成を追加し、OKをクリックします。

   項目	説明	例
   enable-opentelemetry	マネージドサービス for OpenTelemetryを有効にするかどうかを指定します。	true：マネージドサービス for OpenTelemetryを有効にします。
   main-snippet	-	env OTEL_EXPORTER_OTLP_HEADERS;
   otel-service-name	カスタムサービス名。	nginx-ingress
   otlp-collector-host	gRPC 経由でデータをインポートするために使用されるドメイン名。 ステップ 1 で取得した VPC エンドポイントから http:// とポート番号を削除します。	tracing-analysis-XX-XX-XXXXX.aliyuncs.com
   otlp-collector-port	gRPC経由でデータをインポートするために使用されるポート。	8090
   opentelemetry-trust-incoming-span	他のサービスまたはシステムのトレースを信頼するかどうかを指定します。	true：他のサービスまたはシステムのトレースを信頼します。
   opentelemetry-operation-name	スパン形式。	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 true

ステップ1：エンドポイント情報の取得

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

2. 統合センターページで、サーバーサイドアプリケーションセクションのZipkinカードをクリックします。

   説明

   データを収集するために使用されるクライアントのエンドポイントを取得します。この例では、Zipkinクライアントが使用されます。

3. Zipkinパネルで、データのレポート元のリージョンを選択します。

4. エンドポイントを記録します。

   説明

   この例では、NGINX Ingress ControllerはManaged Service for OpenTelemetryエージェントと同じリージョンにデプロイされているため、仮想プライベートクラウド（VPC）エンドポイントを使用することをお勧めします。NGINX Ingress Controllerとエージェントが異なるリージョンにデプロイされている場合は、パブリックエンドポイントを使用してください。

ステップ2：NGINX Ingress Controllerに対してManaged Service for OpenTelemetryを有効にする

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

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

3. ConfigMapページの上部にある[名前空間]ドロップダウンリストからkube-systemを選択します。次に、[名前]検索ボックスにnginx-configurationと入力し、検索アイコンをクリックします。nginx-configurationを見つけて、アクション列の編集をクリックします。

4. トレースデータを収集するクライアントとしてZipkinを構成します。

   編集パネルで、編集追加をクリックします。Zipkinコレクターホスト名前フィールドにステップ 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?

5. トレースを有効にします。

   追加をクリックします。OpenTracing を有効にする名前フィールドにenable-opentracingと入力し、値フィールドにtrueと入力します。次に、OKをクリックします。

   

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