Obtenir des diagnostics

Les diagnostics de Cloud Interconnect vous permettent de résoudre les problèmes liés à vos connexions Cross-Cloud Interconnect pendant le provisionnement et après l'activation. Les diagnostics vous fournissent des informations techniques actualisées et détaillées sur le côté Google Cloud de votre connexion Cross-Cloud Interconnect.

Diagnostics en cours de pannes

Les résultats de diagnostic peuvent ne pas être disponibles en cas de panne mondiale, car les informations de connexion Cross-Cloud Interconnect sont fournies en tant que ressource globale. Une panne mondiale peut affecter la récupération des diagnostics de Cross-Cloud Interconnect. Cependant, ces pannes mondiales ne reflètent pas nécessairement l'état fonctionnel des interconnexions ou des rattachements.

Diagnostics en cours de provisionnement

Les diagnostics contiennent des données différentes en fonction de l'étape du processus de provisionnement. Votre connexion doit répondre aux exigences de chaque étape avant de pouvoir passer à la suivante.

Les étapes sont les suivantes :

  • Étape 1 : Connexion du circuit :

    • L'état de la puissance optique est OK.
    • bundleOperationalStatus est Down.
  • Étape 2 : Qualification du circuit (liens multiples) :

    • L'état de la puissance optique est OK.
    • bundleOperationalStatus est Down.
  • Étape 3 : Configuration de la production :

    • L'état de la puissance optique est OK.
    • bundleOperationalStatus est Up.

Utiliser des diagnostics

Pour interpréter les informations obtenues à partir de la console Google Cloud, de Google Cloud CLI ou de l'API, consultez la section Documentation de référence sur le résultat de la commande.

Console

  1. Dans Google Cloud Console, accédez à l'onglet Connexions physiques de Cloud Interconnect.

    Accéder à l'onglet "Connexions physiques"

  2. Sélectionnez le nom de votre connexion Cross-Cloud Interconnect.

  3. Examinez les champs suivants :

    • Pour les avertissements ou les erreurs, consultez le champ État dans l'angle supérieur gauche de la page.
    • Pour connaître la capacité provisionnée de la connexion Cloud Interconnect, consultez le champ Capacité provisionnée.
    • Si vous soupçonnez qu'il y a des problèmes au niveau de la connexion Cloud Interconnect, consultez la section Rattachements de VLAN pour obtenir des informations telles que la capacité effective de la connexion ou le nombre de liens inactifs.
    • Pour plus d'informations, sur les niveaux de luminosité par exemple, consultez la section Informations relatives aux circuits d'association.

gcloud

Exécutez la commande gcloud compute interconnects get-diagnostics :

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

Remplacez les éléments suivants :

  • NAME : nom de la connexion.
  • PROJECT_ID : ID du projet Google Cloud

Le résultat de la commande doit ressembler à ce qui suit :

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

Utilisez la méthode interconnects.getDiagnostics :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet Google Cloud
  • NAME : nom de votre connexion.

Si cette commande aboutit, elle renvoie le résultat InterconnectDiagnostics au format suivant.

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

Documentation de référence sur le résultat de la commande

Pour interpréter la sortie des diagnostics, consultez le tableau suivant.

Paramètre de sortie Description
macAddress Décrit l'adresse MAC du groupe de connexions Cloud Interconnect du côté Google Cloud.
arpCache Décrit les voisins individuels actuellement vus par le routeur Cloud Router dans le cache ARP pour la connexion Cloud Interconnect. Ce paramètre est vide lorsque la connexion Interconnect n'est pas regroupée.
arpCache[].macAddress Répertorie l'adresse MAC de ce voisin ARP.
arpCache[].ipAddress Répertorie l'adresse IP de ce voisin ARP.
links[] Décrit l'état de chaque lien sur la connexion Cloud Interconnect.
links[].circuitId Répertorie l'ID unique attribué par Google pour ce circuit, tel qu'attribué lors de la mise en service du circuit.
links[].googleDemarc Décrit la démarcation attribuée par Google, telle qu'attribuée lors de la mise en service du circuit.
links[].receivingOpticalPower Décrit la valeur et l'état actuels du niveau de luminosité reçu.
links[].receivingOpticalPower.value Répertorie la valeur actuelle du niveau de luminosité reçu, en dBm.
links[].receivingOpticalPower.state

État de la valeur actuelle par rapport aux niveaux d'avertissement et d'alarme de l'émetteur-récepteur de réception :

  • OK : la valeur n'a pas dépassé un seuil d'avertissement.
  • LOW_WARNING : la valeur est passée sous le seuil d'avertissement.
  • HIGH_WARNING : la valeur a dépassé le seuil d'avertissement.
  • LOW_ALARM : la valeur est passée sous le seuil d'alarme.
  • HIGH_ALARM : la valeur a dépassé le seuil d'alarme.
links[].transmittingOpticalPower Valeur et l'état actuels du niveau de luminosité transmis.
links[].transmittingOpticalPower.value Valeur actuelle du niveau de luminosité transmis, en dBm.
links[].transmittingOpticalPower.state

État de la valeur actuelle par rapport aux niveaux d'avertissement et d'alarme de l'émetteur-récepteur d'émission :

  • OK : la valeur n'a pas dépassé un seuil d'avertissement.
  • LOW_WARNING : la valeur est passée sous le seuil d'avertissement.
  • HIGH_WARNING : la valeur a dépassé le seuil d'avertissement.
  • LOW_ALARM : la valeur est passée sous le seuil d'alarme.
  • HIGH_ALARM : la valeur a dépassé le seuil d'alarme.
links[].lacpStatus Informations LACP du lien unique.
links[].lacpStatus.state
  • ACTIVE : le lien est configuré et actif dans le groupe.
  • DETACHED : le lien n'est pas configuré dans le groupe. cet état est utilisé lorsque bundleAggregationType est défini sur STATIC.
links[].lacpStatus.googleSystemId ID système du port côté Google Cloud de l'échange LACP.
links[].lacpStatus.neighborSystemId ID système du port côté cloud distant de l'échange LACP.
links[].arpCache[] Liste d'objets InterconnectDiagnostics.ARPEntry décrivant les entrées des voisins ARP affichées sur ce lien. Cette valeur est vide si le lien est regroupé.
links[].arpCache[].macAddress Adresse MAC du voisin ARP sur ce lien.
links[].arpCache[].ipAddress Adresse IP du voisin ARP sur ce lien.

Étapes suivantes

  • Pour en savoir plus sur la fonctionnalité Cross-Cloud Interconnect, consultez la page Présentation de Cross-Cloud Interconnect.

  • Pour en savoir plus sur les problèmes courants que vous pouvez rencontrer lors de l'utilisation de Cross-Cloud Interconnect, consultez la page Dépannage.