診断情報を取得する

Cloud Interconnect の診断を使用すると、プロビジョニング時およびアクティブ化後に Cross-Site Interconnect 接続をトラブルシューティングできます。

診断によって、Cross-Site Interconnect 接続のGoogle Cloud 側に関する最新の詳細な技術情報をオンデマンドで得ることができます。

サービス停止時の診断

グローバルな停止が発生した場合は、ネットワーク トラフィックのリダイレクト先を決める際に Cross-Site Interconnect 接続の診断結果を使用しないでください。

Cross-Site Interconnect 接続はグローバル リソースです。グローバルな停止により、Cloud Interconnect の診断が正常に機能しない場合があります。

プロビジョニング時の診断

診断情報を表示すると、オンプレミス ルーターの構成に関する問題のトラブルシューティングと修正に必要な情報を得ることができます。これは、Cross-Site Interconnect 接続でプロビジョニング プロセスの実行に失敗した場合に役立ちます。

Cross-Site Interconnect 接続がプロビジョニング プロセスのどのステージにあるかによって、診断結果に含まれるデータは異なります。主な手順と細かい手順は次のセクションで説明します。この診断情報により、プロビジョニング プロセスを問題なく進行させるために次に取るべきステップを把握できます。

診断コマンドの結果や Google Cloud コンソールで提供される情報の意味については、コマンド出力リファレンスをご覧ください。

プロビジョニングのステージ

Cross-Site Interconnect 接続のプロビジョニング プロセスは、複数のステージを経て実行されます。以下の要件を各ステージで満たした後で、次のステージに進んでください。

  • ステージ 1 - 回路接続:

    • 接続の各リンクの光強度の状態は OK です。

  • ステージ 2 - 回線の品質確認（複数のリンクを持つ接続のみ）:

    • 接続の各リンクの光強度の状態は OK です。
    • 各リンクには一時的な IP アドレスが割り当てられます。このアドレスは、ping テストで各リンクを個別に認定するために使用されます。
    • Address Resolution Protocol（ARP）エントリが存在します。

  • ステージ 3 - 本番環境の構成:

    • 接続の各リンクの光強度の状態は OK です。
    • 接続内のすべてのリンクが LACP バンドルに構成されています。
    • タグ付けされていないバンドル インターフェースに一時的な IP アドレスが割り当てられます。 Google Cloud は ping を介して接続を検証します。アクティブ化プロセスが完了すると、テスト IP アドレスは削除されます。
    • ARP エントリが存在します。

診断を使用する

Cross-Site Interconnect 接続の診断情報を表示するには、次の操作を行います。

コンソール

  1. Google Cloud コンソールで、Cloud Interconnect の [物理接続] タブに移動します。

    [物理接続] に移動

  2. Cross-Site Interconnect 接続の名前を選択します。

  3. 診断情報は、接続詳細ページの次の場所にあります。

    • 警告やエラーは、ページ左上の [ステータス] フィールドに表示されます。
    • Cross-Site Interconnect 接続のプロビジョニング容量は、[プロビジョニングされた容量] フィールドに表示されます。
    • リンク ステータスや光レベルなどの詳細は、[リンク回路の情報] セクションに表示されます。
    • 接続の有効な容量やワイヤグループのステータスなどの詳細については、ワイヤグループのセクションをご覧ください。

gcloud

gcloud beta compute interconnects get-diagnostics コマンドを使用します。

gcloud beta compute interconnects get-diagnostics NAME \
  --project=PROJECT_ID

次のように置き換えます。

  • NAME: プロジェクト内の Cross-Site Interconnect 接続の名前
  • PROJECT_ID: Google Cloud プロジェクトの ID

API

interconnects.getDiagnostics メソッドを使用します。

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/global/interconnects/NAME/getDiagnostics

次のように置き換えます。

  • PROJECT_ID: Google Cloud プロジェクトの ID
  • NAME: プロジェクト内の Cross-Site Interconnect 接続の名前

このコマンドが成功すると、InterconnectDiagnostics の出力が返されます。出力の意味については、コマンド出力リファレンスをご覧ください。

コマンド出力リファレンス

次の表に、gcloud コマンドと interconnects.getDiagnostics API の出力パラメータの定義を示します。

出力パラメータ 説明
macAddress Google Cloud 側の Cross-Site Interconnect 接続バンドルの MAC アドレスを表します。
arpCache Cross-Site Interconnect 接続の ARP キャッシュ内で、Cloud Router によって参照されている個々のネイバーを表します。接続がバンドルされていない場合は空になります。
arpCache[].macAddress この ARP ネイバーの MAC アドレスのリストです。
arpCache[].ipAddress この ARP ネイバーの IP アドレスのリストです。
links[] Cross-Site Interconnect 接続上の各リンクのステータスを表します。
links[].circuitId Google によってこの回線に割り当てられた一意の ID のリストです。この ID は回線の起動時に割り当てられます。
links[].googleDemarc Google によって割り当てられたデマークを表します。このデマークは回線の起動時に割り当てられ、Google によって LOA のお客様に提供されます。
links[].macsec リンクの MACsec 状態。MACsec が有効になっていない場合、このフィールドは省略されます。
links[].macsec.ckn 使用されている Connectivity Association Key Name（CKN）。MACsec が有効になっていない場合、このフィールドは省略されます。
links[].macsec.operational

リンクの MACsec 状態。MACsec が有効になっていない場合、このフィールドは省略されます。可能な値は次のとおりです。

  • TRUE: MACsec はリンクで動作しています。
  • FALSE: MACsec はリンクで動作していません。
links[].operationalState

この Cross-Site Interconnect リンクの動作状態。MACsec が有効になっていない場合、このフィールドは省略されます。可能な値は次のとおりです。

  • LINK_OPERATIONAL_STATUS_UP: リンクは動作しています。
  • LINK_OPERATIONAL_STATUS_DOWN: リンクは動作していません。

リンクの動作状態は、リンクの MACsec 状態の影響を受けません。
links[].receivingOpticalPower 受光レベルの現在の値とステータスを記述します。
links[].receivingOpticalPower.value 受光レベルの現在の値のリストです（単位は dBm）。
links[].receivingOpticalPower.state

現在の値のステータス。受信側トランシーバの警告レベルとアラームレベルとの比較で示されます。

  • OK: 値が警告しきい値を超えていません。
  • LOW_WARNING: 値が下限警告しきい値を超えています。
  • HIGH_WARNING: 値が上限警告しきい値を超えています。
  • LOW_ALARM: 値が下限アラームしきい値を超えています。
  • HIGH_ALARM: 値が上限アラームしきい値を超えています。
links[].transmittingOpticalPower 送信光レベルの現在の値とステータス。
links[].transmittingOpticalPower.value 送信光レベルの現在の値（単位は dBm）。
links[].transmittingOpticalPower.state

現在の値のステータス。送信側トランシーバにおける警告レベルとアラームレベルとの比較で示されます。

  • OK: 値が警告しきい値を超えていません。
  • LOW_WARNING: 値が下限警告しきい値を超えています。
  • HIGH_WARNING: 値が上限警告しきい値を超えています。
  • LOW_ALARM: 値が下限アラームしきい値を超えています。
  • HIGH_ALARM: 値が上限アラームしきい値を超えています。
links[].lacpStatus 単一リンクの LACP 情報。
links[].lacpStatus.state
  • ACTIVE: バンドル内でリンクが構成済みでありアクティブです。
  • DETACHED: バンドル内でリンクが構成されていません。
links[].lacpStatus.googleSystemId LACP 交換局における Google Cloud 側ポートのシステム ID。
links[].lacpStatus.neighborSystemId LACP 交換局におけるお客様側ポートのシステム ID。
links[].arpCache[] InterconnectDiagnostics.ARPEntry オブジェクトのリスト。このリンクで参照されている ARP ネイバーのエントリを表します。リンクがバンドルされている場合は空になります。
links[].arpCache[].macAddress このリンク上のこの ARP ネイバーの MAC アドレス。
links[].arpCache[].ipAddress このリンク上のこの ARP ネイバーの IP アドレス。

次のステップ