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 no momento pelo Cloud Router no cache do ARP da 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.