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 Netzwerk-Traffic umgeleitet 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 jeden Link einzeln durch 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 sind in einem LACP-Bundle konfiguriert.
  • Der nicht getaggten Bundle-Schnittstelle wird eine temporäre IP-Adresse zugewiesen. Google Cloud prüft die Konnektivität über einen Ping. Die Test-IP-Adresse wird entfernt, wenn der Aktivierungsvorgang abgeschlossen ist.
  • ARP-Einträge sind vorhanden.

Diagnosetool verwenden

Führen Sie die folgenden Schritte aus, um Diagnoseinformationen zur Dedicated Interconnect-Verbindung aufzurufen:

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen oder die folgenden IAM-Rollen (Identity and Access Management).

Berechtigungen

• compute.interconnects.get
• compute.interconnects.use

Rollen

• roles/compute.networkAdmin

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: der 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: der 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.

Hinweis: Wenn Sie lokale Warnungen in Bezug auf den Wert der optischen Sende- und Empfangsleistung auslösen möchten, verwenden Sie einen als gut bekannten optischen Wert, addieren einen Puffer von 10 % und legen dann das Auslösen von Warnungen relativ zu diesem Wert fest. Im Allgemeinen sind die Warnung -7dBm und der Alarm -11dBm gute optische Wertschätzungen für die meisten Verbindungen.

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 MACsec nicht aktiviert ist.
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

• Informationen zum Erstellen einer Dedicated Interconnect-Verbindung finden Sie in der Bereitstellung mit Dedicated Interconnect – Übersicht.

• Weitere Informationen zu den Cloud Interconnect-Optionen finden Sie unter Cloud Interconnect – Übersicht.

• Informationen zur Behebung häufiger Probleme bei der Verwendung von Cloud Interconnect finden Sie unter Fehlerbehebung.