Receber diagnósticos

Com os diagnósticos do Cloud Interconnect, é possível solucionar problemas de conexão da Interconexão dedicada 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 das conexões da Interconexão dedicada sob demanda.

Diagnósticos durante falhas temporárias

No caso de uma interrupção temporária global, não use os resultados de diagnóstico da sua conexão de Interconexão dedicada para tomar decisões sobre para onde redirecionar o tráfego de rede.

Ao contrário de um anexo da VLAN, que é regional, uma conexão de Interconexão dedicada é um recurso global. Uma interrupção global pode impedir que os diagnósticos do Cloud Interconnect funcionem corretamente.

Diagnóstico durante o provisionamento

A visualização de diagnósticos fornece as informações necessárias para solucionar e corrigir problemas na configuração do roteador local. Isso pode ser útil se a conexão da Interconexão dedicada falhar no processo de provisionamento.

Os resultados de diagnóstico apresentam dados diferentes, dependendo do estágio em que está a conexão da Interconexão dedicada. As etapas principais e secundárias estão listadas na próxima seção. Com essas informações de diagnóstico, é possível ver as próximas etapas para garantir que o processo de provisionamento progrida sem mais problemas.

Use a referência de resposta ao comando para interpretar os resultados do comando de diagnóstico ou as informações fornecidas no console do Google Cloud.

Estágios de provisionamento

O processo de provisionamento da conexão da Interconexão dedicada ocorre em vários estágios. É preciso atender aos seguintes requisitos em cada estágio antes avançar para a próxima fase:

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

    • O estado de potência óptica é OK para cada link na conexão.
  • Estágio 2: qualificação do circuito (somente para conexões com vários links):

    • O estado de potência óptica é OK para cada link na conexão.
    • Cada link recebe um endereço IP temporário. O endereço é usado para qualificar cada link individualmente por meio de um teste ping.
    • As entradas do protocolo de resolução de endereços (ARP, na sigla em inglês) estão presentes.
  • Estágio 3: configuração de produção:

    • O estado de potência óptica é OK para cada link na conexão.
    • Todos os links na conexão são configurados em um pacote LACP.
    • Um endereço IP temporário é atribuído à interface de pacote sem tag. O Google Cloud verifica a conectividade com um ping. O endereço IP de teste é removido quando o processo de ativação é concluído.
    • Há entradas ARP.

Usar o diagnóstico

Para ver informações de diagnóstico da conexão da Interconexão dedicada, siga estas etapas.

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 de uma conexão de Interconexão dedicada.

  3. As informações de diagnóstico estão nos seguintes locais da página de detalhes da conexão:

    • Para avisos ou erros, consulte o campo Status no canto superior esquerdo da página.
    • Para saber a capacidade provisionada da Interconexão dedicada, consulte o campo Capacidade provisionada.
    • Se você suspeitar de problemas com a conexão da Interconexão dedicada, 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:

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

Substitua:

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

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

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

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 da Interconexão dedicada no projeto

Se esse comando for bem-sucedido, ele retornará a saída InterconnectDiagnostics no seguinte formato. Para interpretar a saída, consulte a referência de resposta ao comando.

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

Referência da resposta ao comando

As definições dos parâmetros de saída para os comandos gcloud e a API interconnects.getDiagnostics estão listadas na tabela a seguir.

Parâmetro de saída Descrição
macAddress Descreve o endereço MAC do pacote da conexão da Interconexão dedicada no Google Cloud.
arpCache Descreve os vizinhos individuais vistos no momento pelo Cloud Router no cache do ARP da conexão da Interconexão dedicada. 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 da Interconexão dedicada.
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 no momento da ativação do circuito e fornecido pelo Google ao cliente na LOA.
links[].macsec O estado MACsec do link. Esse campo será omitido se o MACsec não estiver ativado.
links[].macsec.ckn O nome da chave de associação de conectividade (CKN) atualmente em uso. Esse campo será omitido se o MACsec não estiver ativado.
links[].macsec.operational

O estado MACsec do link. Esse campo será omitido se o MACsec não estiver ativado. Veja a seguir os valores possíveis:

  • VERDADEIRO: o MACsec está operacional no link.
  • FALSO: o MACsec não está operacional no link.
links[].operationalState

O estado operacional deste link da Interconexão dedicada. Esse campo será omitido se o MACsec não estiver ativado. Veja a seguir os valores possíveis:

  • LINK_OPERATIONAL_STATUS_UP: o link está operacional.
  • LINK_OPERATIONAL_STATUS_DOWN: o link não está operacional.

O estado operacional do link não é afetado pelo estado MACsec do link.

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.
  • DETACHED: o link não está configurado no pacote.
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 do cliente 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