Direct Link 経路レポートの生成

直接リンクとその接続に認識されているすべての経路のレポートを生成できます。 このレポートでは、予期される経路を確認したり、どの仮想接続がどの経路を直接リンクに提供しているかを表示したり、受信した経路のネクスト・ホップ・アドレスの詳細を確認したりすることができます。 アカウント間 VPC リンク機能を使用している場合は、相互接続ルーターを介してルーティングされているプレフィックスまたはサブネットを確認することもできます。

UI、CLI、またはAPIを使用して、ルートレポートを取得できます。

ルート・レポートの考慮事項

ルート・レポートを処理する際には、以下の考慮事項を確認してください。

  • ルート・レポートは、 Direct Link または接続されたネットワークの設定変更を検証またはトラブルシューティングするときに生成されることを目的としています。 連続的あるいは自動的な生成には向いていない。 頻繁なリクエストや自動化されたリクエストは、制限またはブロックされる場合があります。
  • 新しい仮想接続 (VPC、クラシック・ゲートウェイ、または中継ゲートウェイ) が Active 状態になったら、直接リンクによって経路が確認されるまで 5 分待ちます。 すべての経路が確認される前に経路レポートを生成すると、部分経路レポートが作成されます。
  • オンプレミスの経路は、BGP が Established 状況に設定されてから約 5 分後まで表示されません。 ゲートウェイのプロビジョニングが完了するまで、ゲートウェイ経路は表示されません。
  • 接続が 0.0.0.0/0 のルートを公開している場合、重複する接頭部を計算する際にそのルートは無視されます。
  • 常に使用できるのは、ゲートウェイごとに 1 つのレポートのみです。 新しいレポートを生成すると、古いレポートは削除されます。
  • 接続を追加または削除すると、古いルート・レポートが不正確になる可能性があります。 そのため、これらの接続内のルートを更新した場合は、新しいルートレポートを生成することをお勧めします。

UI を使用してルートレポートを作成する

UI を使用してルート・レポートを生成するには、以下の手順を実行します。

  1. お使いのブラウザで、 IBM Cloud コンソールを開き、 アカウントにログインしてください。

  2. ナビゲーションメニューの メニューアイコンを 選択し、 インフラストラクチャ VPCアイコン ＞ ネットワーク ＞ 直接リンクをクリックします。

  3. Direct Link 表で、レポートを生成する Direct Link の名前をクリックします。

  4. 「詳細」ページで、 「BGP」 タブをクリックし、 「経路」 タブ付きビューまでスクロールダウンします。 次に、 「レポートの生成」 リンクをクリックします。

    あるいは、「概要」タブの 「経路レポート」 ショートカットを使用することもできます。

    ルートレポートの作成が開始されます。ダイレクトリンクの複雑さによっては、生成に数分かかる場合があります。 レポートの処理が完了するまで、または 「レポートのキャンセル」 をクリックしない限り、別のレポートを生成できないことに注意してください。

レポートが生成されると、経路レポート・テーブルに以下の列が表示されます。

  • Route-経路アドレスを指定します (例えば、 169.254.0.40/29)。

  • タイプ-経路タイプを指定します。

    • 接続-経路の発信元の特定の接続の名前 (または ID) を指定します。
    • ゲートウェイ- BGP を確立するために IBM ルーターでセットアップします。
    • オンプレミス - お客様のオンプレミスデータセンターから発信されます。

    「オンプレミス」行を展開して、AS パス、ネクスト・ホップ、および競合を表示できます。 接続タイプの場合は、行を展開して、AS パス、ローカル・プリフェッチ、ソース、およびすべての競合を表示します。

  • アドバタイズ-経路がアドバタイズされているか、確認されているか、またはアドバタイズされていないかを指定します。

    経路は、BGP が確立されている場合にのみ公示されます。

  • 競合-経路の競合があるかどうかを指定します。

「設定」アイコン 「設定」アイコン を選択して、表の行の高さを変更するか、列の設定を編集します。

ルートの競合

競合するルートは、**「ルート」ビューの「競合」**列に表示されます。 ダイレクトリンクを設定する際、経路の重複はよくある問題です。 複数の接続からのルートが重複すると、トラフィックが適切にルーティングされない可能性があります。 以下に例を示します。

経路報告書の表示
経路報告書の表示

複数の競合がある場合は、リンクをクリックすると、詳細情報を示すサイド・パネルが開きます。 競合を解決した後、新しいレポートを生成します。

CLI を使用したルート・レポートの生成と表示

CLI を使用してルート・レポートを生成および表示するには、以下のコマンドを実行します。

ibmcloud dl route-report-create|rrc GATEWAY_ID [--output format] [--help|-h]

ここで、

  • GATEWAY_ID はゲートウェイの ID です。
  • --output json は、出力を JSON でフォーマットします。
  • --help | -h は、このコマンドのヘルプを表示します。

たとえば、ダイレクトリンクのルートレポートを作成するには：

ibmcloud dl route-report-create a771366f-2c8c-49f6-a23b-9d49fad035a3

詳しくは、 ibmcloud dl route-report コマンドを参照してください。

API を使用したルート・レポートの生成と表示

API を使用してルート・レポートを生成および表示するには、以下の手順を実行します。

  1. 適切な変数を設定して API 環境をセットアップします。

  2. API コマンドで使用する追加の変数を格納します。次に例を示します。

    direct_link_id="11111111-b540-4766-a196-14368f328eb2"

  3. レポート作成を要求します。

    curl -X POST "$directlink_api_endpoint/v1/gateways/$direct_link_id/route_reports?version=$api_version" -H "Authorization: $iam_token"

    残りの呼び出しについては、新しく作成されたレポートの ID を確認する必要があります。 ID を変数に保存します。例えば、次のようにします。

    route_report="22222222-c540-4766-a196-14368f328eb2"

    変数が保存されたことを確認するには、echo $route_report を実行し、応答が空でないことを確認します。

  4. レポートがアクティブになるまで待機すると、その詳細が表示されます。

    curl -X GET "$directlink_api_endpointv1/gateways/$direct_link_id/route_reports/$route_report?version=$api_version" -H "Authorization: $iam_token"

    詳しくは、 ゲートウェイ経路レポート API を参照してください。