Push トラッキングを使用して Nacos サービスプッシュと構成変更のトラブルシューティング - MSE

サービスインスタンスリストが変更されたり、構成がリリースされたりすると、Nacos はサーバーからサブスクライブしているクライアントに更新をプッシュします。クライアントが最新のデータを反映していない場合は、プッシュが送信されたか、受信されたかを確認する必要があります。プッシュ追跡は、ご利用の Microservices Engine (MSE) Nacos インスタンス上のすべてのプッシュイベントを記録するため、配信をエンドツーエンドで追跡できます。

プッシュ追跡は、コンソールの異なるエリアからアクセスする 2 つの独立したモードで動作します：

モード	追跡対象	コンソールパス (インスタンス詳細から)
レジストリプッシュ追跡	サービス検出のプッシュ (インスタンスリストの更新)	サービス管理 > Push track
構成プッシュ追跡	構成変更のリリースと配信	Configuration Management > Push track

前提条件

開始する前に、以下が準備できていることを確認してください：

Nacos Professional Edition インスタンス。詳細については、「Nacos エンジンの作成」をご参照ください。
Nacos クライアントバージョン 2.0.0 以降

レジストリプッシュ追跡のクエリ

レジストリプッシュ追跡は、サービス検出の更新がサブスクライブしているクライアントに到達したかどうかを検証します。以下の状況で使用します：

クライアントがレジストリからサービスの更新を受信しない。
サービス間呼び出しで例外が発生し、サービスリストが正しくプッシュされたかを確認する必要がある。

レジストリプッシュ追跡ページの表示

MSE コンソールにログインし、上部のナビゲーションバーでリージョンを選択します。
左側のナビゲーションウィンドウで、[マイクロサービスレジストリ] > [インスタンス] を選択します。
[インスタンス] ページで、インスタンスの名前をクリックします。
左側のナビゲーションウィンドウで、サービス管理 > Push track を選択します。

サービスによるクエリ

特定のサービスに対するプッシュをどのクライアントが受信したか、そしてプッシュが成功したかどうかを検索します。

クエリディメンションのドロップダウンリストから Query Dimension: Service を選択します。
サービス名 フィールドにサービス名を入力し、グループ名 フィールドにグループ名を入力します。
時間範囲を選択します： Half an hour、1 hour、または Nearly 1 day。別の範囲を指定するには、Custom time を使用します。
Query をクリックします。

結果には、選択した時間範囲内で指定されたサービスのすべてのプッシュイベントが表示されます。

列	説明
Push Time	プッシュイベントのタイムスタンプです。
Push Client IP Address	プッシュを受信したクライアントの IP アドレスです。
Push service name	プッシュされたサービスの名前です。
Push Service Group	サービスが属するグループです。
Number of Instances	プッシュペイロードに含まれるインスタンス IP アドレスの数です。
Node name	Nacos ノードの名前です。

IP によるクエリ

サービス名に関係なく、特定のクライアントが受信したすべてのサービスプッシュを表示します。これにより、特定のクライアントに通知された内容の全体像を把握できます。

クエリディメンションのドロップダウンリストから、[クエリディメンション: IP] を選択します。
クライアントの IP アドレスを入力し、時間範囲を選択して Query をクリックします。

結果には、指定されたクライアント IP によって受信されたすべてのプッシュイベントが一覧表示されます。結果の列は、「サービスによるクエリ」で説明されているものと同じです。

構成プッシュ追跡のクエリ

構成プッシュ追跡は、構成変更のリリースを追跡し、変更がサブスクライブしているクライアントに到達したかどうかを検証します。以下の状況で使用します：

構成のリリースが失敗する。
構成の変更がマシンで有効にならない。

構成プッシュ追跡ページの表示

MSE コンソールにログインし、上部のナビゲーションバーでリージョンを選択します。
左側のナビゲーションウィンドウで、[マイクロサービスレジストリ] > [インスタンス] を選択します。
[インスタンス] ページで、インスタンスの名前をクリックします。
左側のナビゲーションウィンドウで、Configuration Management > Push track を選択します。

構成によるクエリ

特定の構成項目の変更とプッシュの完全な履歴を表示します。これには、各変更が発生した日時、コンテンツの MD5 チェックサム、およびプッシュを受信したクライアントが含まれます。

[クエリディメンション] のドロップダウンリストから [構成] を選択します。
[データ ID] フィールドにデータ ID を入力し、[グループ] フィールドにグループ名を入力します。
検索アイコンをクリックします。

結果は 2 つのセクションに分かれています：

セクション	表示内容
イベント変更	選択した時間範囲内の構成変更イベント。イベントをクリックすると、イベントの変更とプッシュセクションの詳細にジャンプし、変更されたコンテンツの MD5 チェックサムを表示できます。
イベントの変更とプッシュ	構成の変更とプッシュイベントのタイムライン。変更の場合、新しいコンテンツの MD5 チェックサムが表示されます。プッシュイベントの場合、プッシュ時間とクライアントの IP アドレスが表示されます。

IP によるクエリ

特定のクライアントによってモニターされているすべての構成と、それに関連する変更イベントを表示します。

［クエリディメンション: IP］を［クエリディメンション］ドロップダウンリストから選択します。
クライアントの IP アドレスを入力し、検索アイコンをクリックします。

結果には、指定されたクライアントに関連するすべての構成変更イベントが一覧表示されます。

列	説明
変更日時	構成変更のタイムスタンプ。
イベント変更	構成変更イベントのタイプ。
[DataId]	影響を受ける構成のデータ ID。
グループ	構成が属するグループ。
[詳細]	をクリックして変更の詳細を表示します。をクリックしてクエリディメンションを切り替え、指定した時点でのこの構成のプッシュイベントを追跡します。