Obtenha diagnósticos

Os diagnósticos do Cloud Interconnect permitem-lhe resolver problemas das ligações do Cross-Cloud Interconnect durante o aprovisionamento e após a ativação. Os diagnósticos fornecem informações técnicas atuais e detalhadas sobre o Google Cloud lado da sua ligação Cross-Cloud Interconnect.

Diagnósticos durante indisponibilidades

Os resultados de diagnóstico podem não estar disponíveis durante uma interrupção global porque as informações de ligação do Cross-Cloud Interconnect são fornecidas como um recurso global. Uma indisponibilidade global pode afetar a obtenção dos diagnósticos do Cross-Cloud Interconnect. No entanto, estas interrupções globais não refletem necessariamente o estado funcional das interligações ou dos anexos.

Diagnósticos durante o aprovisionamento

Os diagnósticos contêm dados diferentes consoante a fase do processo de aprovisionamento. A sua ligação tem de cumprir os requisitos de cada fase antes de poder avançar para a seguinte.

As fases são as seguintes:

• Fase 1 – Ligação do circuito:

  • O estado de energia ótica é OK.
  • bundleOperationalStatus é Down.

• Fase 2: qualificação de circuito (vários links):

  • O estado de energia ótica é OK.
  • bundleOperationalStatus é Down.

• Fase 3: configuração de produção:

  • O estado de energia ótica é OK.
  • bundleOperationalStatus é Up.

Use diagnósticos

Para interpretar as informações que recebe da Google Cloud consola, da CLI Google Cloud ou da API, consulte a secção Referência de saída de comandos.

Autorizações necessárias para esta tarefa

Para realizar esta tarefa, tem de ter recebido as seguintes autorizações ou as seguintes funções de gestão de identidade e acesso (IAM).

Autorizações

• compute.interconnects.get
• compute.interconnects.use

Funções

• roles/compute.networkAdmin

Consola

1. Na Google Cloud consola, aceda ao separador Ligações físicas do Cloud Interconnect.

   Aceda a Ligações físicas

2. Selecione o nome da sua ligação do Cross-Cloud Interconnect.

3. Reveja os seguintes campos:

   • Para avisos ou erros, consulte o campo Estado no canto superior esquerdo da página.
   • Para a capacidade aprovisionada da ligação do Cloud Interconnect, consulte o campo Capacidade aprovisionada.
   • Se suspeitar de problemas com a ligação do Cloud Interconnect, consulte a secção Associações de VLANs para ver informações como a capacidade efetiva da ligação ou o número de ligações inativas.
   • Para mais detalhes, como os níveis de luz, consulte a secção Informações do circuito do link.

gcloud

Use o comando gcloud compute interconnects get-diagnostics:

gcloud compute interconnects get-diagnostics NAME \
    --project=PROJECT_ID

Substitua o seguinte:

• NAME: o nome da associação
• PROJECT_ID: o ID do Google Cloud projeto

O resultado do comando deve ser semelhante ao seguinte:

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

Use o método interconnects.getDiagnostics:

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

Substitua o seguinte:

• PROJECT_ID: o ID do Google Cloud projeto
• NAME: o nome da sua ligação

Se este comando for bem-sucedido, devolve o resultado InterconnectDiagnostics no seguinte formato.

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

Referência de saída de comandos

Para interpretar o resultado dos diagnósticos, consulte a seguinte tabela.

Nota: se quiser criar um alerta para o valor da potência ótica de transmissão e receção, pode usar um valor ótico conhecido, atribuir-lhe uma margem de 10% e criar alertas relativos a esse valor. Em geral, um -7dBm aviso e um -11dBm alarme são boas estimativas de valor óptico para a maioria dos elos.

Parâmetro de saída	Descrição
macAddress	Descreve o endereço MAC do conjunto de ligações do Cloud Interconnect no lado Google Cloud .
arpCache	Descreve os pares individuais vistos pelo Cloud Router na cache ARP para a ligação do Cloud Interconnect. Este elemento está vazio quando a associação não está agrupada.
arpCache[].macAddress	Indica o endereço MAC deste vizinho ARP.
arpCache[].ipAddress	Apresenta o endereço IP deste vizinho ARP.
links[]	Descreve o estado de cada link na ligação do Cloud Interconnect.
links[].circuitId	Apresenta o ID exclusivo atribuído pela Google a este circuito, conforme atribuído durante a ativação do circuito.
links[].googleDemarc	Descreve a demarcação atribuída pela Google, conforme atribuída na ativação do circuito.
links[].receivingOpticalPower	Descreve o valor e o estado atuais do nível de luz recebido.
links[].receivingOpticalPower.value	Apresenta o valor atual do nível de luz recebido, em dBm.
links[].receivingOpticalPower.state	O estado do valor atual quando comparado com os níveis de aviso e alarme do transrecetor de receção: OK: o valor não ultrapassou um limite de aviso. LOW_WARNING: o valor ultrapassou o limite de aviso inferior. HIGH_WARNING: o valor ultrapassou o limite de aviso elevado. LOW_ALARM: o valor ultrapassou o limite inferior do alarme. HIGH_ALARM: o valor ultrapassou o limite de alarme elevado.
links[].transmittingOpticalPower	O valor e o estado atuais do nível de luz de transmissão.
links[].transmittingOpticalPower.value	O valor atual do nível de luz de transmissão, em dBm.
links[].transmittingOpticalPower.state	O estado do valor atual quando comparado com os níveis de aviso e alarme do transrecetor de transmissão: OK: o valor não ultrapassou um limite de aviso. LOW_WARNING: o valor ultrapassou o limite de aviso inferior. HIGH_WARNING: o valor ultrapassou o limite de aviso elevado. LOW_ALARM: o valor ultrapassou o limite inferior do alarme. HIGH_ALARM: o valor ultrapassou o limite de alarme elevado.
links[].lacpStatus	As informações LACP para o link único.
links[].lacpStatus.state	ATIVO: o link está configurado e ativo no pacote. DESANEXADO: o link não está configurado no pacote. Este estado é usado quando bundleAggregationType é STATIC.
links[].lacpStatus.googleSystemId	O ID do sistema da porta no lado Google Cloud da troca LACP.
links[].lacpStatus.neighborSystemId	O ID do sistema da porta no lado da nuvem remota da troca LACP.
links[].arpCache[]	Uma lista de InterconnectDiagnostics.ARPEntry objetos que descrevem as entradas de vizinhos ARP vistas nesta associação. Este campo está vazio se o link estiver agrupado.
links[].arpCache[].macAddress	O endereço MAC deste vizinho ARP neste link.
links[].arpCache[].ipAddress	O endereço IP deste vizinho ARP neste link.

O que se segue?

• Para saber mais sobre o Cross-Cloud Interconnect, consulte a vista geral do Cross-Cloud Interconnect.

• Para saber mais acerca dos problemas comuns que pode encontrar quando usar o Cross-Cloud Interconnect, consulte a secção Resolução de problemas.