Cette page a été traduite par l'API Cloud Translation.

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 actualisées et détaillées sur le côté Google Cloud des connexions Dedicated Interconnect à 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.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez avoir reçu les autorisations suivantes ou les rôles Identity and Access Management (IAM) suivants :

Autorisations

compute.interconnects.get
compute.interconnects.use

Rôles

roles/compute.networkAdmin

Console

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

Accéder à l'onglet "Connexions physiques"
Sélectionnez le nom d'une connexion Dedicated Interconnect.
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 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 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 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"
        }
      ]
    }
  ]
}

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 Dedicated Interconnect 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

Pour créer une connexion Dedicated Interconnect, consultez la page Présentation du provisionnement de Dedicated Interconnect.
Pour en savoir plus sur les options de Cloud Interconnect, consultez la page Présentation de Cloud Interconnect.
Pour vous aider à résoudre les problèmes courants que vous pouvez rencontrer lors de l'utilisation de Cloud Interconnect, consultez la page Dépannage.