Obtenir des diagnostics

Les diagnostics de Cloud Interconnect vous permettent de résoudre les problèmes liés à vos connexions par interconnexion dédiée 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 vos connexions par interconnexion dédiée à la demande.

Diagnostics en cas de panne

En cas de panne globale, n'utilisez pas les résultats des diagnostics de votre connexion par interconnexion dédiée pour décider de la redirection de votre trafic réseau.

Contrairement au rattachement de VLAN, qui est une ressource régionale, une connexion par interconnexion dédiée est une ressource globale. Une panne globale peut empêcher le bon fonctionnement de 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 par interconnexion dédiée 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 par interconnexion dédiée. 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 la console Google Cloud.

Étapes de provisionnement

Le processus de provisionnement de la connexion par interconnexion dédiée s'effectue 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 défini sur OK pour chaque lien de la connexion.

  • Étape 2 : Qualification du circuit (seulement pour les connexions comportant plusieurs liens) :

    • L'état de la puissance optique est défini sur OK pour chaque lien de la connexion.
    • Une adresse IP temporaire est attribuée à chaque lien. L'adresse est utilisée pour qualifier chaque lien individuellement via un test ping.
    • Des entrées ARP (Address Resolution Protocol) sont présentes.

  • Étape 3 : Configuration de la production :

    • L'état de la puissance optique est défini sur OK pour chaque lien de la connexion.
    • Tous les liens de la connexion sont configurés dans un ensemble LACP.
    • Une adresse IP temporaire est attribuée à l'interface de l'ensemble sans tag. Google Cloud vérifie la connectivité via un test ping. L'adresse IP de test est supprimée une fois le processus d'activation terminé.
    • Des entrées ARP sont présentes.

Utiliser des diagnostics

Pour afficher les informations de diagnostic de la connexion par interconnexion dédiée, procédez comme suit.

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 d'une connexion par interconnexion dédiée.

  3. Les informations de diagnostic se trouvent aux emplacements suivants sur la page des détails de la connexion :

    • 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 l'interconnexion dédiée, consultez le champ Capacité provisionnée.
    • Si vous soupçonnez des problèmes au niveau de la connexion par interconnexion dédiée, 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 par interconnexion dédiée dans votre projet
  • PROJECT_ID : ID du projet Google Cloud

Le résultat de la commande doit ressembler à l'exemple suivant :

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

Utilisez la méthode interconnects.getDiagnostics :

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

Remplacez l'élément suivant :

  • PROJECT_ID : ID du projet Google Cloud
  • NAME : nom de la connexion par interconnexion dédiée dans votre projet

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

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

Le tableau suivant répertorie les définitions des paramètres de sortie des commandes gcloud et de l'API interconnects.getDiagnostics.

Paramètre de sortie Description
macAddress Décrit l'adresse MAC du groupe de connexions par interconnexion dédiée 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 par interconnexion dédiée. 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 par interconnexion dédiée.
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[].macsec État MACsec du lien. Ce champ est omis si vous n'avez pas activé MACsec.
links[].macsec.ckn Nom de clé d'association de connectivité (CKN) actuellement utilisé. Ce champ est omis si vous n'avez pas activé MACsec.
links[].macsec.operational

État MACsec du lien. Ce champ est omis si vous n'avez pas activé MACsec. Voici les valeurs possibles :

  • TRUE : MACsec est opérationnel sur le lien.
  • FALSE : MACsec n'est pas opérationnel sur le lien.
links[].operationalState

État opérationnel de cette liaison par interconnexion dédiée. Ce champ est omis si vous n'avez pas activé MACsec. Voici les valeurs possibles :

  • LINK_OPERATIONAL_STATUS_UP : le lien est opérationnel.
  • LINK_OPERATIONAL_STATUS_DOWN : le lien n'est pas opérationnel.

L'état de fonctionnement du lien n'est pas affecté par l'état MACsec du lien.
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.
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 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