Obtenir des diagnostics Cloud Interconnect

beta

Les diagnostics de Cloud Interconnect vous permettent de résoudre les problèmes liés à Cloud Interconnect pendant le provisionnement et après l'activation.

Les diagnostics fournissent à la demande des informations techniques actualisées et détaillées sur le côté Google Cloud d'une connexion Cloud Interconnect.

Diagnostics en cours de provisionnement

L'affichage des diagnostics fournit les informations nécessaires pour résoudre les problèmes liés à la configuration du routeur sur site. Cela peut être utile si la connexion Cloud Interconnect ne parvient pas à progresser dans le processus de provisionnement.

Les résultats des diagnostics contiennent des données différentes en fonction de l'étape du processus de provisionnement à laquelle se trouve la connexion Cloud Interconnect. Les étapes majeures et mineures sont énumérées dans la section suivante. Ces informations de diagnostics vous indiquent les prochaines étapes que vous pourriez effectuer pour garantir le bon déroulement du processus de provisionnement.

Utilisez la documentation de référence sur le résultat de la commande pour interpréter les résultats des commandes de diagnostic ou les informations fournies dans Google Cloud Console.

Étapes de provisionnement

Le processus de provisionnement de Cloud Interconnect se déroule en plusieurs étapes. Vous devez répondre aux exigences suivantes de chaque étape avant de pouvoir passer à la suivante :

  • Étape 1 : Connexion du circuit :

    • L'état de la puissance optique est OK
    • Le protocole LACP est détaché
    • Les entrées ARP sont présentes sur le(s) circuit(s)
  • Étape 2 : Qualification du circuit (liens multiples) :

    • L'état de la puissance optique est OK
    • Le protocole LACP est détaché
    • Les entrées ARP sont présentes sur le(s) circuit(s)
  • Étape 3 : Configuration de la production :

    • L'état de la puissance optique est OK
    • Le protocole LACP est actif
    • Les entrées ARP sont présentes sur le service Cloud Interconnect

Utiliser des diagnostics

Console

  1. Dans Google Cloud Console, accédez à l'onglet "Connexions physiques" de Cloud Interconnect.
    Accéder à l'onglet Connexions physiques
  2. Cliquez sur le nom d'une connexion Cloud Interconnect.
  3. Sur la page "Détails de la connexion Cloud Interconnect", les informations de diagnostics se trouvent aux emplacements suivants sur l'écran :

    • Pour les avertissements ou les erreurs, consultez le champ État en haut à gauche de l'écran.
    • Pour connaître la capacité provisionnée de la connexion Cloud Interconnect, consultez le champ Capacité.
    • Si vous suspectez des problèmes avec la connexion Cloud Interconnect, regardez à droite du champ Capacités pour trouver des informations, telles que la capacité effective de la connexion Cloud Interconnect, le nombre de liens inactifs, etc.

    Pour plus d'informations, telles que les niveaux de luminosité, utilisez l'interface de ligne de commande ou l'API gcloud.

gcloud

Saisissez la commande suivante pour afficher les informations de diagnostics de la connexion Cloud Interconnect.

  • Remplacez [NAME] par le nom de la connexion Cloud Interconnect dans le projet.
  • Remplacez [PROJECT_ID] par l'ID du projet Google Cloud.
    gcloud beta compute interconnects get-diagnostics [NAME] --project=[PROJECT_ID]
    

Le résultat de la commande devrait ressembler à l'exemple ci-dessous :

    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"
    

api

Obtenez la méthode de diagnostics interconnects.getDiagnostics, où [NAME] correspond au nom de la connexion Cloud Interconnect.

     GET https://www.googleapis.com/compute/projects/[PROJECT_ID]/global/interconnects/[NAME]/diagnostics
    

Si cette commande aboutit, elle renvoie le résultat InterconnectDiagnostics au format suivant. Consultez la documentation de référence sur le résultat de la commande pour interpréter le résultat.

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

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

Les paramètres de sortie des commandes gcloud et de l'API interconnects.getDiagnostics ont la signification indiquée dans le tableau suivant.

Paramètre de sortie Description
macAddress Décrit l'adresse MAC du groupe Cloud Interconnect côté Google Cloud.
arpCache Décrit les voisins individuels actuellement vus par le routeur cloud dans le cache ARP pour la connexion Cloud Interconnect. Ce paramètre est vide lorsque la connexion Cloud 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 et fournie au client par Google dans le mandat.
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 é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.
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é client de l'échange LACP.
links[].arpCache[] Liste d'objets InterconnectDiagnostics.ARPEntry, décrivant les entrées ARP voisines 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.