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.

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

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.

Remarque : Si vous souhaitez créer une alerte pour la valeur de la puissance optique d'émission et de réception, vous pouvez lui attribuer une valeur optique considérée comme correcte, lui donner une marge de 10 %, et crée des alertes par rapport à cette valeur. En général, un avertissement de -7dBm et une alarme de -11dBm sont de bonnes estimations de la valeur optique pour la plupart des liaisons.

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.