第16章 サービスネットワークのトラブルシューティング
通常、このトラブルシューティングガイドを参照しなくても、サービスネットワークを作成できます。ただし、このガイドでは、サービスネットワークが期待どおりに機能しない場合のヒントをいくつか提供しています。
skupper CLI を使用して特定の問題が発生した場合は、「Resolving common problems」 を参照してください。
一般的なトラブルシューティングワークフローは、すべてのサイトをチェックし、デバッグ tar ファイルを作成することです。
16.1. Checking sites
skupper コマンドラインインターフェイス (CLI) を使用すると、Skupper のトラブルシューティングを簡単に開始できます。
手順
サイトのステータスを確認します。
$ 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 Sites: ├─ [local] a960b766-20bd-42c8-886d-741f3a9f6aa2(west) │ │ namespace: west │ │ site name: west │ │ version: 1.8.1 │ ╰─ Linked sites: │ ├─ 496ca1de-0c80-4e70-bbb4-d0d6ec2a09c0(east) │ │ direction: outgoing │ ╰─ 484cccc3-401c-4c30-a6ed-73382701b18a() │ direction: incoming ├─ [remote] 496ca1de-0c80-4e70-bbb4-d0d6ec2a09c0(east) │ │ namespace: east │ │ site name: east │ │ version: 1.8.1 │ ╰─ Linked sites: │ ╰─ a960b766-20bd-42c8-886d-741f3a9f6aa2(west) │ direction: incoming ╰─ [remote] 484cccc3-401c-4c30-a6ed-73382701b18a() │ site name: vm-user-c3d98 │ version: 1.8.1 ╰─ Linked sites: ╰─ a960b766-20bd-42c8-886d-741f3a9f6aa2(west) direction: outgoing注記出力が期待どおりでない場合は、続行する前に リンクを確認 することを推奨します。
出力には以下が表示されます。
-
サービスネットワークに、
vm-user-c3d98、east、およびwestの 3 つのサイトがあります。 - namespace 名など、各サイトの詳細。
-
サービスネットワークに、
サービスネットワークで公開されているサービスのステータスを確認します (
-vは Kubernetes でのみ使用可能)。$ skupper service status -v Services exposed through Skupper: ╰─ backend:8080 (tcp) ╰─ Sites: ├─ 4d80f485-52fb-4d84-b10b-326b96e723b2(west) │ policy: disabled ╰─ 316fbe31-299b-490b-9391-7b46507d76f1(east) │ policy: disabled ╰─ Targets: ╰─ backend:8080 name=backend-9d84544df-rbzjx出力には、
backendサービスとそのサービスの関連ターゲットが表示されます。注記出力の一環として、各サイトはそのクラスターのポリシーシステムのステータスを報告します。
サイトの Skupper イベントをリスト表示します。
$ 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出力には、リンクされているサイトと、サービスネットワークで公開されているサービスが表示されます。ただし、この出力は、問題を報告するときに最も役立ち、Skupper デバッグ tar ファイルに含まれています。
サイトの Kubernetes イベントをリスト表示します。
kubectl get events | grep "deployment/skupper-service-controller" 10m Normal ServiceSyncEvent deployment/skupper-service-controller Service sync receiver connection to amqps://skupper-router-local.private1.svc.cluster.local:5671 established 10m Normal ServiceSyncEvent deployment/skupper-service-controller Service sync sender connection to amqps://skupper-router-local.private1.svc.cluster.local:5671 established 10m Normal ServiceControllerCreateEvent deployment/skupper-service-controller Creating service productcatalogservice 7m59s Normal TokenHandler deployment/skupper-service-controller Connecting using token link1 7m54s Normal TokenHandler deployment/skupper-service-controller Connecting using token link2
出力には、Kubernetes リソースに関連するイベントが表示されます。
関連情報
