診断情報を取得する

Cloud Interconnect の診断を使用すると、プロビジョニング時およびアクティブ化後に Cross-Cloud Interconnect 接続をトラブルシューティングできます。診断では、Cross-Cloud Interconnect 接続の Google Cloud 側に関する現在の詳細な技術情報が提供されます。

サービス停止時の診断

Cross-Cloud Interconnect の接続情報はグローバル リソースとして提供されるため、グローバルな停止中は診断結果が得られないことがあります。グローバルな停止が Cross-Cloud Interconnect の診断情報の取得に影響する可能性があります。ただし、これらのグローバルな停止は、必ずしも相互接続またはアタッチメントの機能状態を反映しているわけではありません。

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

診断には、プロビジョニング プロセスの段階に応じて異なるデータが含まれます。各ステージの接続要件を満たしてから、次のステージに進んでください。

ステージは次のとおりです。

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

    • 光強度の状態が OK であること。
    • bundleOperationalStatus が Down であること。

  • ステージ 2: 回線の品質確認（複数のリンク）:

    • 光強度の状態が OK であること。
    • bundleOperationalStatus が Down であること。

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

    • 光強度の状態が OK であること。
    • bundleOperationalStatus が Up であること。

診断を使用する

Google Cloud コンソール、Google Cloud CLI、または API から取得した情報を解釈する方法については、コマンド出力リファレンスをご覧ください。

コンソール

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

    [物理接続] に移動

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

  3. 次のフィールドを確認します。

    • 警告やエラーは、ページ左上の [ステータス] フィールドに表示されます。
    • Cloud Interconnect 接続のプロビジョニング容量は、[プロビジョニングされた容量] フィールドに表示されます。
    • Cloud Interconnect 接続に問題があると思われる場合は、[VLAN アタッチメント] のセクションで、接続の有効な容量やダウンリンクの数などの情報を確認してください。
    • 光レベルなどの詳細は、[リンク回路の情報] セクションに表示されます。

gcloud

gcloud compute interconnects get-diagnostics コマンドを実行します。

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

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

  • NAME: 接続の名前
  • PROJECT_ID: Google Cloud プロジェクトの ID

コマンド出力は次のようになります。

result:
bundleAggregationType: BUNDLE_AGGREGATION_TYPE_LACP
bundleOperationalStatus: BUNDLE_OPERATIONAL_STATUS_UP
links:
- circuitId: GCP-00112
googleDemarc: MARKL:MMR A/ 4th floor Cab 04.105.004.704 FP 4 Port 3 Fibers 77,78
  -LC
lacpStatus:
  googleSystemId: 9c:e1:76:7a:40:de
  neighborSystemId: ec:ce:13:e2:99:07
  state: ACTIVE
operationalStatus: LINK_OPERATIONAL_STATUS_UP
receivingOpticalPower:
  state: OK
  value: -2.94
transmittingOpticalPower:
  state: OK
  value: -1.66
macAddress: 9c:e1:76:7a:40:e3

API

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

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

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

  • PROJECT_ID: Google Cloud プロジェクトの ID
  • NAME: 接続の名前

このコマンドが成功すると、InterconnectDiagnostics の出力が次の形式で返されます。

{
"result": {
"macAddress": "9c:e1:76:7a:40:e3",
"links": [
  {
    "circuitId": "GCP-00112",
    "googleDemarc": "MARKL:MMR A/ 4th floor Cab 04.105.004.704 FP 4 Port 3 Fibers 77,78 -LC",
    "receivingOpticalPower": {
      "value": -2.97,
      "state": "OK"
    },
    "transmittingOpticalPower": {
      "value": -1.67,
      "state": "OK"
    },
    "lacpStatus": {
      "state": "ACTIVE",
      "googleSystemId": "9c:e1:76:7a:40:de",
      "neighborSystemId": "ec:ce:13:e2:99:07"
    },
    "operationalStatus": "LINK_OPERATIONAL_STATUS_UP"
  }
],
"bundleOperationalStatus": "BUNDLE_OPERATIONAL_STATUS_UP",
"bundleAggregationType": "BUNDLE_AGGREGATION_TYPE_LACP"
}
}

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

診断出力の意味については、次の表をご覧ください。

出力パラメータ 説明
macAddress Google Cloud 側の Cloud Interconnect 接続バンドルの MAC アドレスを表します。
arpCache Cloud Interconnect 接続の ARP キャッシュ内で、Cloud Router によって参照されている個々のネイバーを表します。接続がバンドルされていない場合は空になります。
arpCache[].macAddress この ARP ネイバーの MAC アドレスのリストです。
arpCache[].ipAddress この ARP ネイバーの IP アドレスのリストです。
links[] Cloud Interconnect 接続上の各リンクのステータスを表します。
links[].circuitId Google によってこの回線に割り当てられた一意の ID のリストです。この ID は回線の起動時に割り当てられます。
links[].googleDemarc Google が割り当てたデマークを記述します（この値は回線のターンアップ時に割り当てられます）。
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: リンクがバンドル内に構成されていません。この状態は、bundleAggregationType が STATIC の場合に使用されます。
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 アドレス。

次のステップ