Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

第13章 サービスネットワークのトラブルシューティング

通常、このトラブルシューティングガイドを参照しなくても、サービスネットワークを作成できます。ただし、このガイドでは、サービスネットワークが期待どおりに機能しない場合のヒントをいくつか提供しています。

skupper CLI を使用して特定の問題が発生した場合は、「Resolving common problems」 を参照してください。

一般的なトラブルシューティングワークフローは、すべてのサイトをチェックし、デバッグ tar ファイルを作成することです。

13.1. Checking sites
リンクのコピー

skupper コマンドラインインターフェイス (CLI) を使用すると、Skupper のトラブルシューティングを簡単に開始できます。

手順

  1. サイトのステータスを確認します。 

    $ 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.
    Copy to Clipboard Toggle word wrap

    出力には以下が表示されます。

    • 指定された namespace にサイトが存在すること。
    • 他の 2 つのサイトへのリンクがあること。
    • サービスがサービスネットワークで公開されていて、この namespace からアクセスできること。

  2. サービスネットワークを確認します。 

    $ skupper network status
Sites:
├─ [local] a960b766-20bd-42c8-886d-741f3a9f6aa2(west)
│  │ namespace: west
│  │ site name: west
│  │ version: 1.5.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.5.1
│  ╰─ Linked sites:
│     ╰─ a960b766-20bd-42c8-886d-741f3a9f6aa2(west)
│        direction: incoming
╰─ [remote] 484cccc3-401c-4c30-a6ed-73382701b18a()
   │ site name: vm-user-c3d98
   │ version: 1.5.1
   ╰─ Linked sites:
      ╰─ a960b766-20bd-42c8-886d-741f3a9f6aa2(west)
         direction: outgoing
    Copy to Clipboard Toggle word wrap
    注記

    出力が期待どおりでない場合は、続行する前に リンクを確認 することを推奨します。

    出力には以下が表示されます。

    • サービスネットワークに、vm-user-c3d98、east、および west の 3 つのサイトがあります。
    • namespace 名など、各サイトの詳細。

  3. サービスネットワークで公開されているサービスのステータスを確認します (-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
    Copy to Clipboard Toggle word wrap

    出力には、backend サービスとそのサービスの関連ターゲットが表示されます。

    注記

    出力の一環として、各サイトはそのクラスターのポリシーシステムのステータスを報告します。

  4. サイトの 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
    Copy to Clipboard Toggle word wrap

    出力には、リンクされているサイトと、サービスネットワークで公開されているサービスが表示されます。ただし、この出力は、問題を報告するときに最も役立ち、Skupper デバッグ tar ファイルに含まれています。

  5. サイトの 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
    Copy to Clipboard Toggle word wrap

    出力には、Kubernetes リソースに関連するイベントが表示されます。

Additional information

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat