Receber diagnósticos

Com os diagnósticos do Cloud Interconnect, é possível solucionar problemas de conexões do Cloud Interconnect durante o provisionamento e após a ativação. Os diagnósticos fornecem informações técnicas atuais e detalhadas sobre o lado do Google Cloud da sua conexão do Cross-Cloud Interconnect.

Diagnósticos durante falhas temporárias

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

Diagnóstico durante o provisionamento

Os diagnósticos contêm dados diferentes, dependendo do estágio do processo de provisionamento. Sua conexão precisa atender aos requisitos de cada estágio antes de passar para o próximo.

As etapas são as seguintes:

• Estágio 1: conexão do circuito:

  • O estado de potência óptica é OK.
  • bundleOperationalStatus é Down.

• Estágio 2: qualificação do circuito (várias conexões):

  • O estado de potência óptica é OK.
  • bundleOperationalStatus é Down.

• Estágio 3: configuração de produção:

  • O estado de potência óptica é OK.
  • bundleOperationalStatus é Up.

Usar o diagnóstico

Para interpretar as informações recebidas do console do Google Cloud, da Google Cloud CLI ou da API, consulte a seção Referência de saída do comando.

Permissões exigidas para a tarefa

Para executar esta tarefa, são necessárias as seguintes permissões ou papéis de Identity and Access Management (IAM).

Permissões

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

Papéis

• roles/compute.networkAdmin

Console

1. No console do Google Cloud, acesse a guia Conexões físicas do Cloud Interconnect.

   Acessar Conexões físicas

2. Selecione o nome da sua conexão do Cloud Interconnect.

3. Verifique os seguintes campos:

   • Para avisos ou erros, consulte o campo Status no canto superior esquerdo da página.
   • Para ver a capacidade provisionada da conexão do Cloud Interconnect, consulte o campo Capacidade provisionada.
   • Se você suspeitar de problemas com a conexão do Cloud Interconnect, consulte a seção anexos da VLAN para ver informações como a capacidade efetiva da conexão ou o número de links desativados.
   • Para ver mais detalhes, como níveis de luz, consulte a seção Informações sobre o circuito do link.

gcloud

Use o comando gcloud compute interconnects get-diagnostics (em inglês).

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

Substitua:

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

A resposta ao comando precisa ser semelhante ao exemplo a seguir:

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:

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

Se esse comando for bem-sucedido, ele retornará a saída 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 da resposta ao comando

Para interpretar a saída do diagnóstico, consulte a tabela a seguir.

Observação: se você quiser criar um alerta para o valor da potência óptica de transmissão e recepção, poderá receber um bom valor óptico conhecido, dar a ele uma margem de 10% e criar alertas em relação a esse valor. Em geral, um aviso -7dBm e um alarme -11dBm são estimativas de valores ópticos para a maioria dos links.

Parâmetro de saída	Descrição
macAddress	Descreve o endereço MAC do pacote da conexão do Cloud Interconnect no Google Cloud.
arpCache	Descreve os vizinhos individuais vistos pelo Cloud Router. no cache do ARP para a conexão do Cloud Interconnect. Esse parâmetro fica vazio quando a conexão não está agrupada.
arpCache[].macAddress	Lista o endereço MAC deste vizinho do ARP.
arpCache[].ipAddress	Lista o endereço IP desse vizinho do ARP.
links[]	Descreve o status de cada link na conexão do Cloud Interconnect.
links[].circuitId	Lista o código exclusivo atribuído pelo Google a este circuito durante a ativação do circuito.
links[].googleDemarc	Descreve o demarcador atribuído pelo Google, conforme atribuído na ativação do circuito.
links[].receivingOpticalPower	Descreve o valor atual e o status do nível de luz recebido.
links[].receivingOpticalPower.value	Lista o valor atual do nível de luz recebido em dBm.
links[].receivingOpticalPower.state	O status do valor atual quando comparado aos níveis de aviso e alarme do transceptor receptor. OK: o valor não ultrapassou um limite de aviso. LOW_WARNING: o valor cruzou abaixo do limite de aviso inferior. HIGH_WARNING: o valor cruzou acima do limite de aviso inferior. LOW_ALARM: o valor cruzou abaixo do limite de alarme inferior. HIGH_ALARM: o valor cruzou abaixo do limite de alarme superior.
links[].transmittingOpticalPower	O valor atual e status para o 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 status do valor atual quando comparado aos níveis de aviso e alarme do transceptor transmissor: OK: o valor não ultrapassou um limite de aviso. LOW_WARNING: o valor cruzou abaixo do limite de aviso inferior. HIGH_WARNING: o valor cruzou acima do limite de aviso inferior. LOW_ALARM: o valor cruzou abaixo do limite de alarme inferior. HIGH_ALARM: o valor cruzou abaixo do limite de alarme superior.
links[].lacpStatus	As informações do LACP para o link único.
links[].lacpStatus.state	ATIVO: o link está configurado e ativo no pacote. SEPARADO: o link não está configurado no pacote. Esse estado é usado quando bundleAggregationType é STATIC.
links[].lacpStatus.googleSystemId	O ID do sistema da porta do Google Cloud da troca do LACP.
links[].lacpStatus.neighborSystemId	O ID do sistema da porta da nuvem remota da troca do LACP.
links[].arpCache[]	Uma lista de objetos InterconnectDiagnostics.ARPEntry, que descrevem as entradas vizinhas do ARP vistas neste link. Esse parâmetro fica vazio se o link está em um pacote.
links[].arpCache[].macAddress	O endereço MAC desse vizinho do ARP neste link.
links[].arpCache[].ipAddress	O endereço IP desse vizinho do ARP neste link.

A seguir

• Para saber mais sobre o Cross-Cloud Interconnect, consulte a visão geral dele.

• Para saber mais sobre problemas comuns que você pode encontrar ao usar o Cross-Cloud Interconnect, consulte Solução de problemas.