Diagnose abrufen

Mit dem Diagnosetool von Cloud Interconnect können Sie Probleme mit Cross-Cloud Interconnect-Verbindungen während der Bereitstellung und nach der Aktivierung beheben. Das Diagnosetool bietet Ihnen aktuelle und ausführliche technische Informationen zur Google Cloud-Seite der Cross-Cloud Interconnect-Verbindung.

Diagnose bei Ausfällen

Diagnoseergebnisse sind möglicherweise während eines globalen Ausfalls nicht verfügbar, da die Cross-Cloud Interconnect-Verbindungsinformationen als globale Ressource bereitgestellt werden. Ein globaler Ausfall kann sich auf Abruf der Diagnose von Cross-Cloud Interconnect auswirken. Diese globalen Ausfälle spiegeln jedoch nicht unbedingt den funktionalen Zustand der Interconnect-Verbindungen oder Anhänge wider.

Diagnose bei der Bereitstellung

Diagnosedaten enthalten je nach Phase des Bereitstellungsprozesses. Ihre Verbindung muss die Anforderungen der einzelnen Phasen erfüllen, bevor sie zur nächsten Phase übergehen kann.

Die Phasen:

Phase 1 – Schaltungsverbindung:
- Der optische Leistungsstatus lautet OK.
- BundleOperationalStatus ist Down.
Phase 2 – Schaltungsfreigabe (mehrere Verbindungen):
- Der optische Leistungsstatus lautet OK.
- BundleOperationalStatus ist Down.
Phase 3 – Produktionskonfiguration:
- Der optische Leistungsstatus lautet OK.
- BundleOperationalStatus ist Up.

Diagnosetool verwenden

Informationen zum Interpretieren von Informationen, die Sie von der Google Cloud Console, der Google Cloud CLI oder der API erhalten, finden Sie im Abschnitt Referenz zur Befehlsausgabe.

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

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

Zu „Physische Verbindungen“
Wählen Sie den Namen Ihrer Cross-Cloud Interconnect-Verbindung.
Prüfen Sie die folgenden Felder:
- Informationen zu Warnungen oder Fehlern finden Sie im Feld Status oben links auf der Seite.
- Informationen zur bereitgestellten Kapazität der Cloud Interconnect-Verbindung finden Sie im Feld Bereitgestellte Kapazität.
- Wenn Sie Probleme mit der Cloud Interconnect-Verbindung vermuten, finden Sie im Abschnitt VLAN-Anhänge 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

Dabei gilt:

NAME ist der Name der Verbindung
PROJECT_ID ist die ID des Google Cloud-Projekts

Die Befehlsausgabe sollte in etwa so aussehen:

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

Verwenden Sie die Methode interconnects.getDiagnostics:

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

Dabei gilt:

PROJECT_ID ist die ID des Google Cloud-Projekts
NAME ist der Name Ihrer Verbindung

Bei erfolgreicher Ausführung gibt dieser Befehl InterconnectDiagnostics-Diagnoseinformationen im nachfolgend dargestellten Format aus.

{
"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"
}
}

Befehlsausgabenreferenz

Informationen zur Interpretation der Diagnoseausgabe finden Sie in der folgenden Tabelle.

Ausgabeparameter	Beschreibung
`macAddress`	Gibt die MAC-Adresse des Cloud Interconnect-Verbindungspakets auf der Google Cloud-Seite an.
`arpCache`	Gibt einzelne Nachbarn an, die aktuell vom Cloud Router im ARP-Cache der Cloud 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 Cloud 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.
`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. Dieser Status wird verwendet, wenn der `bundleAggregationType` `STATIC` ist.
`links[].lacpStatus.googleSystemId`	Die System-ID des Ports auf der Google Cloud-Seite des LACP-Austauschs.
`links[].lacpStatus.neighborSystemId`	Die System-ID des Ports auf der Google Cloud-Seite des LACP-Austauschs.
`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

Weitere Informationen zu Cross-Cloud Interconnect finden Sie in der Übersicht zu Cross-Cloud Interconnect.
Informationen zu häufigen Problemen bei der Verwendung von Cross-Cloud Interconnect finden Sie unter Fehlerbehebung.