第3章 サービスネットワークのトラブルシューティング
通常、このトラブルシューティングガイドを参照しなくても、サービスネットワークを作成できます。ただし、このガイドでは、サービスネットワークが期待どおりに機能しない場合のヒントをいくつか提供しています。
一般的なトラブルシューティングワークフローは、すべてのサイトをチェックし、デバッグ tar ファイルを作成することです。
3.1. サイトの確認 リンクのコピーリンクがクリップボードにコピーされました!
skupper コマンドラインインターフェイス (CLI) を使用すると、Application Interconnect のトラブルシューティングを簡単に開始できます。
手順
サイトのステータスを確認します。
$ skupper status --namespace west Skupper is enabled for namespace "west" in interior mode. It is connected to 2 other sites. It has 1 exposed services.出力には以下が表示されます。
- 指定された namespace にサイトが存在すること。
- 他の 2 つのサイトへのリンクがあること。
- サービスがサービスネットワークで公開されていて、この namespace からアクセスできること。
サービスネットワークを確認します。
$ skupper network status --namespace west Sites: ├─ [local] 05f8c38 - west │ URL: 10.110.15.54 │ mode: interior │ name: west │ namespace: west │ version: 1.0.2 │ ╰─ Services: │ ╰─ name: backend │ address: backend: 8080 │ protocol: tcp ╰─ [remote] 1537b82 - east URL: 10.97.26.100 name: east namespace: east sites linked to: 05f8c38-west version: 1.0.2 ╰─ Services: ╰─ name: backend address: backend: 8080 protocol: tcp ╰─ Targets: ├─ name: backend-77f8f45fc8-smckp ├─ name: backend-77f8f45fc8-gh6tp ╰─ name: backend-77f8f45fc8-m58tg注記出力が期待どおりでない場合は、続行する前に リンクを確認 することをお勧めします。
出力には以下が表示されます。
-
サービスネットワークに、
eastとwestの 2 つのサイトがあること。 - namespace 名など、各サイトの詳細。
-
公開されている元のサービス (ターゲット)。この場合は、
tcpプロトコルを使用して公開された 3 つのバックエンドサービス。 -
ポート番号を含む、サービスネットワークで利用可能なサービス。たとえば、
backend:8080です。
-
サービスネットワークに、
サービスネットワークで公開されているサービスのステータスを確認します。
$ skupper service status Services exposed through Skupper: ╰─ backend (tcp port 8080) ╰─ Targets: ╰─ app=backend name=backend出力には、
backendサービスとそのサービスの関連ターゲットが表示されます。注記サービスの関連ターゲットは、ターゲットが現在のクラスターで使用可能な場合にのみ表示されます。
サイトのイベントを一覧表示します。
$ skupper debug events NAME COUNT AGE GatewayQueryRequest 3 9m12s 3 gateway request 9m12s SiteQueryRequest 3 9m12s 3 site data request 9m12s ServiceControllerEvent 9 10m24s 2 service event for west/frontend 10m24s 1 service event for west/backend 10m26s 1 Checking service for: backend 10m26s 2 Service definitions have changed 10m26s 1 service event for west/skupper-router 11m4s DefinitionMonitorEvent 15 10m24s 2 service event for west/frontend 10m24s 1 service event for west/backend 10m26s 1 Service definitions have changed 10m26s 5 deployment event for west/frontend 10m34s 1 deployment event for west/skupper-service-controller 11m4s ServiceControllerUpdateEvent 1 10m26s 1 Updating skupper-internal 10m26s ServiceSyncEvent 3 10m26s 1 Service interface(s) added backend 10m26s 1 Service sync sender connection to 11m4s amqps://skupper-router-local.west.svc.cluster.local:5671 established 1 Service sync receiver connection to 11m4s amqps://skupper-router-local.west.svc.cluster.local:5671 established IpMappingEvent 5 10m34s 1 172.17.0.7 mapped to frontend-6b4688bf56-rp9hc 10m34s 2 mapped to frontend-6b4688bf56-rp9hc 10m54s 1 172.17.0.4 mapped to 11m4s skupper-service-controller-6c97c5cf5d-6nzph 1 172.17.0.3 mapped to skupper-router-547dffdcbf-l8pdc 11m4s TokenClaimVerification 1 10m59s 1 Claim for efe3a241-3e4f-11ed-95d0-482ae336eb38 succeeded 10m59s出力には、リンクされているサイトと、サービスネットワークで公開されているサービスが表示されます。ただし、この出力は、問題を報告するときに最も役立ち、Application Interconnect のデバッグ tar ファイルに含まれています。
追加情報