Obtenir des diagnostics

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

Les diagnostics vous fournissent des informations techniques actuelles et détaillées sur le côtéGoogle Cloud des connexions interconnexion dédiée à la demande.

Diagnostics en cas de pannes

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

Contrairement au rattachement de VLAN, qui est une ressource régionale, une connexion Dedicated Interconnect est une ressource globale. Une panne globale peut empêcher les diagnostics Cloud Interconnect de fonctionner correctement.

Diagnostics pendant le processus 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 Dedicated 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 Dedicated 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 la console Google Cloud .

Étapes de provisionnement

Le processus de provisionnement de la connexion Dedicated Interconnect 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 Dedicated Interconnect, procédez comme suit.

Console

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

    Accéder à l'onglet "Connexions physiques"

  2. Sélectionnez le nom d'une connexion Dedicated Interconnect.

  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.
    • Pour connaître la capacité provisionnée de Dedicated Interconnect, consultez le champ Capacité provisionnée.
    • Si vous soupçonnez des problèmes au niveau de la connexion Dedicated 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 Dedicated Interconnect dans votre projet
  • PROJECT_ID : ID du projet Google Cloud

Le résultat ressemble à ce qui suit :

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 les éléments suivants :

  • PROJECT_ID : ID du projet Google Cloud
  • NAME : nom de la connexion Dedicated Interconnect 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"
        }
      ]
    }
  ]
}

Utiliser les diagnostics des groupes de connexions

Vous pouvez également obtenir des diagnostics agrégés pour toutes les connexions d'interconnexion d'un groupe de connexions d'interconnexion.

Console

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

    Accéder à l'onglet "Connexions physiques"

  2. Dans le tableau Groupes d'interconnexions, sélectionnez le nom d'un groupe de connexions interconnexion dédiée.

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

    • En haut de la page, vous pouvez consulter l'état et la description du groupe.
    • Sous l'état et la description, vous pouvez voir le nombre de vos connexions actives, le contrat de niveau de service prévu et si vous y êtes éligible.
    • Si des bloqueurs empêchent votre groupe de connexions de répondre aux exigences du SLA souhaité, ils s'affichent dans le champ Bloqueurs d'éligibilité au SLA de la section précédente.
    • Le tableau en bas de la page affiche des informations sur chaque connexion de votre groupe de connexions.

gcloud

Utilisez la commande gcloud compute interconnects groups get-operational-status, en remplaçant NAME par le nom de la connexion interconnexion dédiée que vous souhaitez vérifier :

gcloud compute interconnects groups get-operational-status NAME

Utiliser les diagnostics des groupes de rattachements de VLAN

Vous pouvez obtenir des diagnostics agrégés pour tous les rattachements de VLAN d'un groupe de rattachements de VLAN.

Console

  1. Dans la console Google Cloud , accédez à l'onglet Rattachements de VLAN de Cloud Interconnect.

    Accéder aux rattachements de VLAN

  2. Sélectionnez le groupe de rattachements de VLAN que vous souhaitez modifier.

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

    • En haut de la page, vous pouvez consulter l'état et la description du groupe.
    • Sous l'état et la description, vous pouvez voir le nombre de vos rattachements de VLAN opérationnels, le contrat de niveau de service prévu et si vous y êtes éligible.
    • Si des facteurs bloquants empêchent votre groupe de rattachements de VLAN de répondre aux exigences du contrat de niveau de service souhaité, ils s'affichent dans le champ Facteurs bloquant l'éligibilité au SLA de la section précédente.
    • Le tableau en bas de la page affiche des informations sur chaque rattachement de VLAN de votre groupe de rattachements de VLAN.

gcloud

Exécutez la commande gcloud compute interconnects attachments groups get-operational-status :

gcloud compute interconnects attachments groups get-operational-status NAME

Remplacez les éléments suivants :

  • NAME : nom du groupe de rattachements de VLAN dans votre projet.

Le résultat ressemble à ce qui suit :

result:
attachmentStatuses:
- adminEnabled: true
  attachment: https://www.googleapis.com/compute/v1/projects/equinix-gci-testing/regions/us-west2/interconnectAttachments/byohsm-lab-sfo-attachment3
  isActive: ACTIVE
  status: CONNECTION_UP
- adminEnabled: true
  attachment: https://www.googleapis.com/compute/v1/projects/equinix-gci-testing/regions/us-west2/interconnectAttachments/ccsw03-sfo05-z1-a1
  isActive: ACTIVE
  status: CONNECTION_UP
configured:
  availabilitySla:
    effectiveSla: PRODUCTION_NON_CRITICAL
groupStatus: FULLY_UP
intent:
  availabilitySla: PRODUCTION_NON_CRITICAL
operational:
  availabilitySla:
    effectiveSla: PRODUCTION_NON_CRITICAL

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 Google Cloud CLI et de l'API interconnects.getDiagnostics.

Paramètre de sortie Description
macAddress Décrit l'adresse MAC du groupe de connexions interconnexion dédiée du côté Google Cloud .
arpCache Décrit les voisins individuels vus par le routeur Cloud Router dans le cache ARP pour la connexion Dedicated 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 Dedicated 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[].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) 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 Dedicated Interconnect. 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 minimal d'avertissement.
  • HIGH_WARNING: la valeur a dépassé le seuil maximal d'avertissement.
  • LOW_ALARM: la valeur est passée sous le seuil minimal d'alarme.
  • HIGH_ALARM: la valeur a dépassé le seuil maximal 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 minimal d'avertissement.
  • HIGH_WARNING: la valeur a dépassé le seuil maximal d'avertissement.
  • LOW_ALARM: la valeur est passée sous le seuil minimal d'alarme.
  • HIGH_ALARM: la valeur a dépassé le seuil maximal 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