Visualizar registros e métricas

O Cloud Router envia informações de registro para o Cloud Logging e envia métricas de monitoramento para o Cloud Monitoring. Nesta página, mostramos como acessar os dois tipos de informação.

Registros

O Cloud Router envia informações de registro para o Cloud Logging, que registra os seguintes eventos:

  • Eventos do roteador relacionados ao Cloud Router
  • Eventos do BGP relacionados a uma configuração e sessão do BGP
  • Eventos de rota relacionados aos anúncios de rota entre os dois pares do BGP
  • Eventos de cota de rota relacionados às cotas de prefixo exclusivo do Cloud Router

Como visualizar registros

Console

  1. No console do Google Cloud , acesse a página Cloud Routers.

    Acesse o Cloud Routers

  2. Selecione o Cloud Router na lista de Cloud Routers.

  3. Na coluna Registros, clique em Visualizar.

    Os registros do Cloud Router têm os seguintes formatos:

    • Eventos de roteador, BGP e divulgação de rota: registros (compute.googleapis.com/router_events) associados ao recurso monitorado gce_router:

      [Event Type]: [Log Text]
      
    • Eventos de cota de rota: registros JSON (router.googleapis.com/route_quota_events) associados ao recurso monitorado gce_network_region. Para detalhes sobre a estrutura do payload, consulte Log de eventos de cota de rota.

  4. Para criar consultas na Análise de Registros, consulte Criar consultas na Análise de Registros.

Registro de informações

A tabela a seguir lista os eventos registrados no registro de informações do Logging.

Evento Descrição
Evento do Router Tarefa do Router ativada
Tarefa do Router desativada
Evento do BGP Configuração adicionada para peering: LIST_OF_PEERS
O peering do BGP com PEER surgiu há X segundos
O peering do BGP com PEER diminuiu com o motivo MESSAGE, em que MESSAGE fornece uma explicação como HOLD_TIMER_EXPIRED ou LINK_DOWN.
Para mais informações sobre LINK_DOWN, consulte a mensagem LINK_DOWN que aparece nos registros do Cloud Router.
O ID do roteador do BGP foi definido como BGP_ROUTER_ID
Evento de rota Prefixo de divulgação para peering: PREFIX
Remoção do prefixo de peering: PREFIX
Prefixo PREFIX próximos saltos LIST_OF_NEXTHOPS recebidos pelo Cloud Router
Prefixo PREFIX próximos saltos LIST_OF_NEXTHOPS excluídos do Cloud Router

Eventos comuns de geração de registros

Para ver eventos comuns do Logging para o Cloud Router, conforme listado na tabela a seguir, use as etapas para visualizar registros. Especifique um dos filtros avançados listados na tabela. Ajuste o período para a pesquisa no Logging conforme necessário.

Descrição do evento Filtro avançado de geração de registros
Como migrar ou reiniciar um processo do Cloud Router resource.type="gce_router"
"task activated"
Como adicionar rotas aprendidas resource.type="gce_router"
"recebido pelo Cloud Router"
Como remover rotas aprendidas resource.type="gce_router"
"excluído do Cloud Router"
Como exportar rotas anunciadas resource.type="gce_router"
("Route Event" AND "Advertising prefix")
O pareamento do BGP surgiu resource.type="gce_router"
("BGP peering" AND "came up")
O peering do BGP foi criado com a autenticação MD5 resource.type="gce_router"
(" Peering BGP" E "came up" E "autenticação MD5 ativada")
O peering do BGP caiu. resource.type="gce_router"
("BGP peering" AND "went down")
O peering do BGP diminuiu porque o link diminuiu no roteador de extremidade do peering do Google resource.type="gce_router"
("BGP peering" AND "went down" AND "LINK_DOWN")
Uma sessão do BGP foi encerrada devido a rotas recebidas em excesso resource.type="gce_router"
("NOTIFICATION 6/1")
severity="CRITICAL"
Uma cota de prefixo de rota dinâmica do Cloud Router foi excedida resource.type="gce_network_region"
("No more routes" AND "can be programmed")
severity="ERROR"
Uma rota foi perdida devido a um problema de cota resource.type="gce_network_region"
severity="ERROR"
jsonPayload.affectedResource.routes.nextHopIpAddresses="PEER_IP_ADDRESS"
Uma sessão BFD emparelhada resource.type="gce_router"
("BFD Event" E "bfd enabled, state [Init, NoDiagnostic]")
Uma sessão BFD foi criada resource.type="gce_router"
("BFD Even" E "o [Up, NoDiagnostic]")
Uma sessão BFD caiu (o timer Rx expirou) resource.type="gce_router"
("Evento BFD" E "to [Down, ControlDetectionTimeExpired]")
Uma sessão BFD caiu (o estado do par é Down ou AdminDown) resource.type="gce_router"
("BFD Event" AND "to [Down, NeighborSessionDown]")
Uma sessão BFD está desativada localmente resource.type="gce_router"
("BFD Event" E "bfd disabled")

Log de eventos de cota de rota

O Cloud Router grava eventos de cota de rota no Cloud Logging em router.googleapis.com/route_quota_events por meio do recurso monitorado gce_network_region. Esses registros ajudam a monitorar o uso de prefixos de rota em relação às suas cotas e identificar rotas descartadas.

Os eventos de cota de rota são registrados nos seguintes níveis de gravidade:

  • WARNING: o uso da rota se aproxima do limite da cota (o uso atinge ou excede 75% do limite regional ou global).
  • ERROR: o uso da rota atinge ou excede 100% do limite. As rotas em excesso não podem ser programadas e são descartadas. Se as rotas forem descartadas devido ao esgotamento da cota, a entrada de registro incluirá detalhes sobre as rotas descartadas no campo jsonPayload.affectedResource.routes.

Campos de evento de cota de rota

As entradas de registro de cota de rota contêm um payload JSON estruturado (jsonPayload) com os seguintes campos:

Campo Descrição
eventTime O carimbo de data/hora de quando o evento de cota ocorreu.
routeQuotaEvent.helperMessage Uma mensagem que descreve o estado da cota. Por exemplo, um aviso quando o uso de uma cota de prefixo exclusivo do Cloud Router está se aproximando ou excedeu o limite.
routeQuotaEvent.regionalRouteCount O uso da cota de prefixos de rota dinâmica do Cloud Router exclusivos da própria região para cada região por rede VPC. O uso representa o número de prefixos de rota exclusivos, processados pelo plano de controle de rota dinâmica em uma determinada região de uma rede VPC, recebidos de todas as sessões do BGP do Cloud Router nessa mesma região e rede.
routeQuotaEvent.regionalRouteLimit O limite da cota de prefixos de rota dinâmica do Cloud Router exclusivos da própria região para cada região por rede VPC. O limite representa o número máximo de prefixos de rota exclusivos que podem ser processados pelo plano de controle de rota dinâmica em uma determinada região de uma rede VPC, recebidos de todas as sessões do BGP do Cloud Router nessa mesma região e rede.
routeQuotaEvent.globalRouteCount O uso da cota de prefixos de rota dinâmica do Cloud Router exclusivos de outras regiões para cada região por rede VPC. O uso representa o número de prefixos de rota exclusivos, processados pelo plano de controle de rota dinâmica em uma determinada região de uma rede VPC, recebidos de todas as sessões do BGP do Cloud Router em outras regiões da mesma rede.
routeQuotaEvent.globalRouteLimit O limite da cota de prefixos de rota dinâmica do Cloud Router exclusivos de outras regiões para cada região por rede VPC. O limite representa o número máximo de prefixos de rota exclusivos que podem ser processados pelo plano de controle de rota dinâmica em uma determinada região de uma rede VPC, recebidos de todas as sessões do BGP do Cloud Router em outras regiões da mesma rede.
affectedResource.routes[] Uma entrada que contém atributos para prefixos descartados que não resultaram na criação de rotas dinâmicas quando o uso de uma cota de prefixo exclusivo do Cloud Router excede o limite (presente em eventos de gravidade ERROR). Cada entrada inclui estes atributos:
  • ipPrefix: o prefixo (destino) no formato CIDR.
  • nextHopIpAddresses: os endereços IP do BGP das sessões do BGP do Cloud Router que aprenderam o prefixo.
  • medValue: o atributo MED.
  • srcRouterIds: os IDs do Cloud Router que gerenciam as sessões do BGP.

Métricas

O Cloud Router publica métricas para o Cloud Monitoring. Para uma lista de métricas publicadas para o Cloud Router, consulte Métricas de monitoramento para o Cloud Router.

Todas as métricas do Cloud Router abrangem o tráfego IPv4 e IPv6.

Ver métricas usando a API

Essas métricas podem ser acessadas usando a API Cloud Monitoring. Saiba mais em Como ler dados de métricas.

Ver métricas usando os painéis do Monitoring

Também é possível criar um painel personalizado no Cloud Monitoring para ajudar a analisar essas métricas. Para mais informações, consulte Gerenciar painéis personalizados.

Para criar um painel personalizado, siga estas etapas:

Console

  1. No console do Google Cloud , acesse a página Monitoring.

    Acessar Monitoring

  2. Selecione Painéis e, na página Visão geral de painéis, clique em Criar painel.

  3. Opcional: atualize o título do painel com um nome descritivo.

  4. Na Biblioteca de gráficos, selecione o gráfico que você quer adicionar. Por exemplo, para adicionar um gráfico de Linha ao painel, clique ou arraste essa entrada da Biblioteca de gráficos para a área do gráfico.

  5. Em Título do gráfico, altere o título ou use o título sugerido.

  6. Em Quais dados você quer visualizar?, faça o seguinte:

    1. Em Tipo de recurso, clique no campo Tipo para filtrar e digite Cloud Router.
    2. Em Métrica, adicione uma métrica do Cloud Router.
  7. Use os controles de Filtro para restringir a visualização somente a determinados roteadores ou sessões.

  8. Para adicionar outra métrica, clique em Adicionar outra métrica.

Algumas métricas estão relacionadas ao Cloud Router, e outras referem-se a uma sessão do BGP em um determinado roteador do Cloud. As métricas do Cloud Router são exibidas como router-name, enquanto as métricas da sessão do BGP são mostradas como router-name(bgp-name).

Métricas de monitoramento para Cloud Router

As strings "tipo de métrica" nesta tabela precisam ser prefixadas com router.googleapis.com/. Esse prefixo foi omitido das entradas na tabela. Ao consultar um rótulo, use o prefixo metric.labels.. por exemplo, metric.labels.LABEL="VALUE".

Tipo de métrica Etapa do lançamento (níveis da hierarquia de recursos)
Nome de exibição
Classe, Tipo, Unidade
Recursos monitorados
Descrição
Rótulos
best_received_routes_count GA  (projeto)
Contagem de rotas recebidas
GAUGE, INT64, 1
gce_router
Número atual das melhores rotas recebidas pelo roteador. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
bfd/control/receive_intervals GA  (projeto)
Os pacotes de controle do BFD recebem intervalos
GAUGE, INT64, ms
gce_router
Os pacotes de controle do BFD recebem intervalos. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
peer_ip: O IP de peering da sessão BFD.
bfd/control/received_packets_count GA  (projeto)
Pacotes de controle recebidos
DELTA, INT64, 1
gce_router
Número de pacotes de controle recebidos desta sessão BFD. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
peer_ip: O IP de peering da sessão BFD.
bfd/control/rejected_packets_count GA  (projeto)
Pacotes de controle recusados
DELTA, INT64, 1
gce_router
Número de pacotes de controle recusados desta sessão BFD. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
peer_ip: O IP de peering da sessão BFD.
bfd/control/transmit_intervals GA  (projeto)
Os pacotes de controle do BFD transmitem intervalos
GAUGE, INT64, ms
gce_router
Os pacotes de controle do BFD transmitem intervalos. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
peer_ip: O IP de peering da sessão BFD.
bfd/control/transmitted_packets_count GA  (projeto)
Pacotes de controle transmitidos
DELTA, INT64, 1
gce_router
Número de pacotes de controle transmitidos desta sessão do BFD. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
peer_ip: O IP de peering da sessão BFD.
bfd/session_flap_events_count GA  (projeto)
Oscilação da sessão BFD
DELTA, INT64, 1
gce_router
Número de cada oscilação de evento BFD desta sessão do BFD. Uma oscilação de evento de sessão se refere à transição do estado superior. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
peer_ip: O IP de peering da sessão BFD.
event_type: O motivo da oscilação de BFD, como "AdminDown" ou "ControlDetectionTimeExpired".
bfd/session_up GA  (projeto)
Status da sessão BFD
GAUGE, INT64, 1
gce_router
Indicador do estabelecimento bem-sucedido da sessão BFD. O valor 1 indica que a sessão já terminou. O valor 0 indica que a sessão está inativa. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
peer_ip: O IP de peering da sessão BFD.
bgp/received_routes_count GA  (projeto)
Contagem de rotas recebidas do BGP
GAUGE, INT64, 1
gce_router
Número atual de rotas recebidas em uma sessão do BGP. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
bgp_peer_name: o nome da sessão do BGP.
bgp/sent_routes_count GA  (projeto)
Contagem de rotas enviadas do BGP
GAUGE, INT64, 1
gce_router
Número atual de rotas enviadas em uma sessão do BGP. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
bgp_peer_name: o nome da sessão do BGP.
bgp/session_up GA  (projeto)
Status da sessão do BGP
GAUGE, INT64, 1
gce_router
Indicador do estabelecimento bem-sucedido da sessão do BGP. O valor 1 indica que a sessão já terminou. O valor 0 indica que a sessão está inativa. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
bgp_peer_name: o nome da sessão do BGP.
bgp_sessions_down_count GA  (projeto)
Contagem regressiva de sessões do BGP
GAUGE, INT64, 1
gce_router
Número de sessões do BGP no roteador que estão inativas. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
bgp_sessions_up_count GA  (projeto)
Contagem de sessões do BGP ativas
GAUGE, INT64, 1
gce_router
Número de sessões do BGP no roteador que estão ativas. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
dynamic_routes/learned_routes/any_dropped_unique_destinations BETA  (projeto)
Todos os destinos únicos foram descartados
GAUGE, BOOL, 1
gce_network_region
Uma métrica booleana que indica se há destinos únicos descartados em uma região de rede devido à cota excedida. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 60 segundos.
routing_mode: Modo "Roteamento" da rota, um de ["global": aprendido com regiões remotas; "regional" é aprendido com as regiões locais]
dynamic_routes/learned_routes/dropped_unique_destinations BETA  (projeto)
Destinos únicos foram descartados
GAUGE, INT64, 1
gce_network_region
O número de destinos exclusivos caiu em uma região de rede devido a uma cota maior. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 60 segundos.
routing_mode: Modo "Roteamento" da rota, um de ["global": aprendido com regiões remotas; "regional" é aprendido com as regiões locais]
dynamic_routes/learned_routes/unique_destinations_limit BETA  (projeto)
Limite de destinos únicos
GAUGE, INT64, 1
gce_network_region
O número máximo de destinos exclusivos permitidos pela cota de rota para esta região de rede. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 60 segundos.
routing_mode: Modo "Roteamento" da rota, um de ["global": aprendido com regiões remotas; "regional" é aprendido com as regiões locais]
dynamic_routes/learned_routes/used_unique_destinations BETA  (projeto)
Destinos únicos usados
GAUGE, INT64, 1
gce_network_region
Número de destinos exclusivos usados por rotas aprendidas para esta região de rede. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 60 segundos.
routing_mode: Modo "Roteamento" da rota, um de ["global": aprendido com regiões remotas; "regional" é aprendido com as regiões locais]
nat/allocated_ports GA  (projeto)
Portas alocadas
GAUGE, INT64, {port}
nat_gateway
Número de portas alocadas para todas as VMs pelo gateway NAT. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 225 segundos.
nat_ip: IP NAT das portas.
nat/closed_connections_count GA  (projetos)
Contagem de conexões fechadas
DELTA, INT64, {connection}
nat_gateway
Contagem de conexões fechadas no gateway NAT. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 225 segundos.
ip_protocol: o protocolo da conexão. Pode ser TCP, UDP ou ICMP.
nat/dropped_received_packets_count GA  (projetos)
Contagem de pacotes recebidos descartados
DELTA, INT64, {packet}
nat_gateway
Contagem de pacotes recebidos descartada pelo gateway NAT. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 225 segundos.
ip_protocol: o protocolo da conexão. Pode ser TCP, UDP ou ICMP.
nat/dropped_sent_packets_count GA  (projetos)
Contagem de pacotes enviados descartados
DELTA, INT64, {packet}
nat_gateway
Contagem de pacotes enviados descartada pelo gateway NAT. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 225 segundos.
ip_protocol: o protocolo da conexão. Pode ser TCP, UDP ou ICMP.
reason: o motivo do descarte do pacote. Os valores possíveis são OUT_OF_RESOURCES, ENDPOINT_INDEPENDENCE_CONFLICT.
nat/nat_allocation_failed GA  (projetos)
Falha na alocação de NAT
GAUGE, BOOL, 
nat_gateway
Indica se há uma falha na alocação de IPs NAT para qualquer VM no gateway NAT. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
nat/new_connections_count GA  (projeto)
Contagem de novas conexões
DELTA, INT64, {connection}
nat_gateway
Contagem de novas conexões criadas no gateway NAT. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 225 segundos.
ip_protocol: o protocolo da conexão. Pode ser TCP, UDP ou ICMP.
nat/open_connections GA  (projetos)
Conexões abertas
GAUGE, INT64, {connection}
nat_gateway
Número de conexões abertas atualmente no gateway NAT. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 225 segundos.
ip_protocol: o protocolo da conexão. Pode ser TCP, UDP ou ICMP.
nat/port_usage GA  (projeto)
Uso da porta
GAUGE, INT64, {port}
nat_gateway
Número máximo de conexões de uma VM para um único endpoint da Internet (IP:port). Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 225 segundos.
ip_protocol: o protocolo da conexão. Pode ser TCP, UDP ou ICMP.
nat/received_bytes_count GA  (projeto)
Contagem de bytes recebidos
DELTA, INT64, By
nat_gateway
Contagem de bytes recebidos (destino -> VMs) por meio do gateway NAT. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 225 segundos.
ip_protocol: o protocolo da conexão. Pode ser TCP, UDP ou ICMP.
nat/received_packets_count GA  (projeto)
Contagem de pacotes recebidos
DELTA, INT64, {packet}
nat_gateway
Contagem de pacotes recebidos (destino -> VMs) por meio do gateway NAT. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 225 segundos.
ip_protocol: o protocolo da conexão. Pode ser TCP, UDP ou ICMP.
nat/rule/nat_allocation_failed GA  (projeto)
Falha na alocação de NAT por regra
GAUGE, BOOL, 
nat_gateway
Indica se há uma falha na alocação de IPs NAT para qualquer VM no gateway NAT para uma regra NAT específica. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 120 segundos.
nat_rule_priority: O número de prioridade da regra NAT associada ao erro.
nat/sent_bytes_count GA  (projeto)
Contagem de bytes enviados
DELTA, INT64, By
nat_gateway
Contagem de bytes enviados (VMs -> destino) pelo gateway NAT. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 225 segundos.
ip_protocol: o protocolo da conexão. Pode ser TCP, UDP ou ICMP.
nat/sent_packets_count GA  (projeto)
Contagem de pacotes enviados
DELTA, INT64, {packet}
nat_gateway
Contagem de pacotes enviados (VMs -> destino) por meio do gateway NAT. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 225 segundos.
ip_protocol: o protocolo da conexão. Pode ser TCP, UDP ou ICMP.
router_up GA  (projeto)
Router tasks up
GAUGE, INT64, 1
gce_router
Número de tarefas de software do roteador que estão sendo executadas com sucesso. Um valor maior ou igual a 1 indica que o roteador está ativo, embora nem todas as tarefas de software possam estar em execução. Compare o número retornado com o número esperado de tarefas de software para o roteador. Um valor de 0 indica que o roteador está inativo. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.
sent_routes_count GA  (projeto)
Contagem de rotas enviadas
GAUGE, INT64, 1
gce_router
Número atual de rotas enviadas pelo roteador. Amostras coletadas a cada 60 segundos. Após a amostragem, os dados não são visíveis por até 180 segundos.

Tabela gerada em 29/10/2026 às 23:33:54 UTC.

A seguir