Diagnose abrufen

Mit dem Diagnosetool von Cloud Interconnect können Sie Probleme mit Dedicated Interconnect-Verbindungen während der Bereitstellung und nach der Aktivierung beheben.

Das Diagnosetool bietet Ihnen bei Bedarf aktuelle und ausführliche technische Informationen zur Google Cloud-Seite der Dedicated Interconnect-Verbindungen.

Diagnose bei Ausfällen

Verwenden Sie bei einem globalen Ausfall nicht die Diagnoseergebnisse Ihrer Dedicated Interconnect-Verbindung, um zu entscheiden, wohin Ihr Netzwerktraffic weitergeleitet werden soll.

Im Gegensatz zu einem VLAN-Anhang, der regional ist, ist eine Dedicated Interconnect-Verbindung eine globale Ressource. Ein globaler Ausfall kann verhindern, dass die Diagnose für Cloud Interconnect ordnungsgemäß funktioniert.

Diagnose bei der Bereitstellung

Das Diagnosetool stellt Informationen zur Behebung von Problemen in der Konfiguration Ihres lokalen Routers zur Verfügung. Diese Informationen können Ihnen weiterhelfen, wenn der Bereitstellungsvorgang für Dedicated Interconnect fehlschlägt.

Die Diagnoseergebnisse enthalten je nach der Phase des Bereitstellungsvorgangs, in der sich die Dedicated Interconnect-Verbindung befindet, unterschiedliche Daten. Die jeweiligen Haupt- und Nebenschritte sind im nächsten Abschnitt aufgeführt. Diese Diagnoseinformationen ermöglicht die Ausführung weiterer Schritte, um die Bereitstellung ohne weitere Probleme abzuschließen.

Die Referenz zur Befehlsausgabe hilft Ihnen beim Interpretieren der Ergebnisse der Diagnosebefehle bzw. der in der Google Cloud Console bereitgestellten Informationen.

Bereitstellungsphasen

Die Bereitstellung der Dedicated Interconnect-Verbindung erfolgt in mehreren Phasen. In jeder Phase müssen die im Folgenden aufgeführten Voraussetzungen erfüllt sein, bevor Sie zur nächsten Phase übergehen können:

  • Phase 1 – Schaltungsverbindung:

    • Der optische Leistungsstatus lautet OK für jede Verbindung in der Verbindung.
  • Phase 2 – Schaltungsfreigabe (nur für Verbindungen mit mehreren Verbindungen):

    • Der optische Leistungsstatus lautet OK für jede Verbindung in der Verbindung.
    • Jedem Link wird eine temporäre IP-Adresse zugewiesen. Die Adresse wird verwendet, um die einzelnen Verbindungen über einen Ping-Test zu qualifizieren.
    • ARP-Einträge (Address Resolution Protocol) sind vorhanden.
  • Phase 3 – Produktionskonfiguration:

    • Der optische Leistungsstatus lautet OK für jede Verbindung in der Verbindung.
    • Alle Verbindungen in der Verbindung werden in einem LACP-Bundle konfiguriert.
    • Der Schnittstelle ohne Tags wird eine temporäre IP-Adresse zugewiesen. Google Cloud prüft die Verbindung über einen Ping. Die Test-IP-Adresse wird entfernt, wenn der Aktivierungsvorgang abgeschlossen ist.
    • ARP-Einträge sind vorhanden.

Diagnosetool verwenden

Gehen Sie so vor, um Diagnoseinformationen zur Dedicated Interconnect-Verbindung aufzurufen.

Console

  1. Rufen Sie in der Google Cloud Console den Cloud Interconnect-Tab Physische Verbindungen auf.

    Zu „Physische Verbindungen“

  2. Wählen Sie den Namen einer Dedicated Interconnect-Verbindung aus.

  3. Die Diagnoseinformationen befinden sich an den folgenden Stellen auf der Seite mit den Verbindungsdetails:

    • Informationen zu Warnungen oder Fehlern finden Sie im Feld Status oben links auf der Seite.
    • Informationen zur bereitgestellten Kapazität von Dedicated Interconnect finden Sie im Feld Bereitgestellte Kapazität.
    • Wenn Sie Probleme mit der Dedicated Interconnect-Verbindung vermuten, lesen Sie im Abschnitt VLAN-Anhänge die Informationen zur effektiven Kapazität der Verbindung oder der Anzahl der Downlinks.
    • Weitere Details wie die Lichtpegel finden Sie im Abschnitt Informationen zur Verknüpfungsschaltung.

gcloud

Führen Sie den Befehl gcloud compute interconnects get-diagnostics aus:

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

Ersetzen Sie Folgendes:

  • NAME: Name der Dedicated Interconnect-Verbindung in Ihrem Projekt
  • PROJECT_ID: die ID des Google Cloud-Projekts

Die Befehlsausgabe sollte in etwa wie das folgende Beispiel aussehen:

macAddress: "00:11:22:33:44:55"
arpCache:
  macAddress: "55:44:33:22:11:00"
  ipAddress: "1.2.3.4"
links:
  - circuitId: "circuit-id-1"
    receivingOpticalPower:
      value: 0.4
      state: OK
    lacpStatus:
      state: ACTIVE
      googleSystemId: "00:11:22:33:44:55"
      neighborSystemId: "55:44:33:22:11:00"
     macsec:
      ckn: 0101010189abcdef...0123456789abcdef
      operational: true
  - circuitId: "circuit-id-2"
    receivingOpticalPower:
      value: 0.4
      state: OK
    lacpStatus:
      state: DETACHED
    macsec:
      ckn: 0101010189abcdef...0123456789abcdef
      operational: false
    arpCache:
      macAddress: "01:23:45:67:89:0a"
      ipAddress: "2.3.4.5"

API

Verwenden Sie die Methode interconnects.getDiagnostics:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Google Cloud-Projekts
  • NAME: Name der Dedicated Interconnect-Verbindung in Ihrem Projekt

Bei erfolgreicher Ausführung gibt dieser Befehl InterconnectDiagnostics-Diagnoseinformationen im nachfolgend dargestellten Format aus. Informationen zur Interpretation der Ausgabe finden Sie in der Referenz zur Befehlsausgabe.

{
  "macAddress": "00:11:22:33:44:55",
  "arpCache": [
    {
      "macAddress": "55:44:33:22:11:00",
      "ipAddress": "1.2.3.4"
    }
  ],
  "links": [
    {
      "circuitId": "circuit-id",
      "receivingOpticalPower": {
        "value": 0.4,
        "state": OK,
      },
      "lacpStatus": {
        "state": ACTIVE,
        "googleSystemId": "00:11:22:33:44:55",
        "neighborSystemId": "55:44:33:22:11:00"
      }
    },
    {
      "circuitId": "circuit-id",
      "receivingOpticalPower": {
        "value": 0.4,
        "state": OK,
      },
      "lacpStatus": {
        "state": DETACHED
      },
      "arpCache": [
        {
          "macAddress": "01:23:45:67:89:0a",
          "ipAddress": "2.3.4.5"
        }
      ]
    }
  ]
}

Befehlsausgabenreferenz

Die Definitionen für die Ausgabeparameter für die gcloud-Befehle und die interconnects.getDiagnostics API sind in der folgenden Tabelle aufgeführt.

Ausgabeparameter Beschreibung
macAddress Gibt die MAC-Adresse des Dedicated Interconnect-Verbindungspakets auf der Google Cloud-Seite an.
arpCache Gibt einzelne Nachbarn an, die aktuell vom Cloud Router im ARP-Cache der Dedicated Interconnect-Verbindung ermittelt werden. Das Feld ist leer, wenn die Verbindung nicht gebündelt ist.
arpCache[].macAddress Listet die MAC-Adresse dieses ARP-Nachbarn auf.
arpCache[].ipAddress Listet die IP-Adresse dieses ARP-Nachbarn auf.
links[] Beschreibt den Status jedes Links in der Dedicated Interconnect-Verbindung.
links[].circuitId Listet die von Google bei der Inbetriebnahme der Schaltung zugewiesene eindeutige ID für diese Schaltung auf.
links[].googleDemarc Gibt den von Google bei der Inbetriebnahme der Schaltung zugewiesenen Abgrenzungspunkt an, der für den Kunden in der LOA von Google bereitgestellt wird.
links[].macsec Der MACsec-Status des Links. Dieses Feld wird weggelassen, wenn MACsec nicht aktiviert ist.
links[].macsec.ckn Der aktuell verwendete Name des Verbindungsschlüssels (CKN, Connectivity Association Key). Dieses Feld wird weggelassen, wenn Sie MACsec nicht aktiviert haben.
links[].macsec.operational

Der MACsec-Status des Links. Dieses Feld wird weggelassen, wenn MACsec nicht aktiviert ist. Folgende Werte sind möglich:

  • TRUE: MACsec ist für den Link betriebsbereit.
  • FALSE: MACsec ist für den Link nicht betriebsbereit.
links[].operationalState

Der Betriebsstatus dieses Dedicated Interconnect-Links. Dieses Feld wird weggelassen, wenn MACsec nicht aktiviert ist. Folgende Werte sind möglich:

  • LINK_OPERATIONAL_STATUS_UP: Der Link ist funktionsfähig.
  • LINK_OPERATIONAL_STATUS_DOWN: Der Link ist nicht funktionsfähig.

Der operative Status des Links ist nicht vom MACsec-Status des Links betroffen.

links[].receivingOpticalPower Gibt den aktuellen Wert und Status für den empfangenen Lichtpegel an.
links[].receivingOpticalPower.value Listet den aktuellen Wert des empfangenen Lichtpegels in dBm auf.
links[].receivingOpticalPower.state

Gibt den Status des aktuellen Werts in Bezug auf die Warn- und Alarmwerte für den empfangenden Transceiver an:

  • OK: Der Wert hat keine Warnschwelle über-/unterschritten.
  • LOW_WARNING: Der Wert hat die untere Warnschwelle unterschritten.
  • HIGH_WARNING: Der Wert hat die obere Warnschwelle überschritten.
  • LOW_ALARM: Der Wert hat die untere Alarmschwelle unterschritten.
  • HIGH_ALARM: Der Wert hat die obere Alarmschwelle überschritten.
links[].transmittingOpticalPower Gibt den aktuellen Wert und Status des Sendelichtpegels an.
links[].transmittingOpticalPower.value Gibt den aktuellen Wert des Sendelichtpegels in dBm an.
links[].transmittingOpticalPower.state

Gibt den Status des aktuellen Werts in Bezug auf die Warn- und Alarmwerte für den sendenden Transceiver an.

  • OK: Der Wert hat keine Warnschwelle über-/unterschritten.
  • LOW_WARNING: Der Wert hat die untere Warnschwelle unterschritten.
  • HIGH_WARNING: Der Wert hat die obere Warnschwelle überschritten.
  • LOW_ALARM: Der Wert hat die untere Alarmschwelle unterschritten.
  • HIGH_ALARM: Der Wert hat die obere Alarmschwelle überschritten.
links[].lacpStatus Gibt die LACP-Informationen für die einzelne Verbindung an.
links[].lacpStatus.state
  • ACTIVE: Die Verbindung ist innerhalb des Bundles konfiguriert und aktiviert.
  • DETACHED: Die Verbindung ist nicht innerhalb des Bundles konfiguriert.
links[].lacpStatus.googleSystemId Die System-ID des Ports auf der Google Cloud-Seite des LACP-Austauschs.
links[].lacpStatus.neighborSystemId Gibt die System-ID des Ports auf der Kundenseite des LACP-Austauschs an.
links[].arpCache[] Eine Liste mit InterconnectDiagnostics.ARPEntry-Objekten, die die bei diesem Link vorhandenen ARP-Nachbareinträge angeben. Dieser Parameter ist leer, wenn die Verbindung Teil eines Bundles ist.
links[].arpCache[].macAddress Gibt die MAC-Adresse dieses ARP-Nachbarn auf dieser Verbindung an.
links[].arpCache[].ipAddress Gibt die IP-Adresse dieses ARP-Nachbarn auf dieser Verbindung an.

Nächste Schritte