Gerenciar testes de conectividade

MySQL   |  PostgreSQL   |  SQL Server

Os Testes de conectividade são uma ferramenta de diagnóstico que permite verificar a conectividade entre os endpoints da rede. Ele analisa a configuração e, em alguns casos, realiza uma análise de plano de dados em tempo real entre os endpoints. Um endpoint é uma origem ou destino do tráfego de rede, como uma instância do Cloud SQL.

Use a ferramenta Testes de conectividade para qualquer uma das seguintes finalidades:

• Para verificar a conectividade entre uma instância do Cloud SQL e outro recurso, como uma máquina virtual (VM), ou entre uma instância de réplica de leitura e uma instância principal.
• Para solucionar problemas de conectividade associados a diferentes tipos de configurações de origem e destino.
• Determinar se há um problema na sua rede VPC usada para os recursos relacionados ao Cloud SQL.

Os erros de configuração que a ferramenta pode diagnosticar incluem conectividade a uma instância do Cloud SQL bloqueada por:

• Regras de firewall da VPC, políticas hierárquicas de firewall e políticas de firewall da rede global
• Um problema de roteamento (por exemplo, uma rota incorreta para uma rede de destino é usada ou nenhuma rota dinâmica está disponível)
• Um problema associado ao peering da sua rede VPC e da rede gerenciada pelo Google
• A instância não está em execução
• Uma porta ou protocolo incorreto usado pelo proxy de autenticação do Cloud SQL para acessar a instância
• Uma falha que ocorre com as redes autorizadas configuradas para a instância

Para saber mais sobre os Testes, de conectividade, consulte Visão geral dos testes de conectividade.

Observação: a ferramenta Testes de conectividade é usada para resolver manualmente e depurar problemas de rede. Se você quiser uma solução de problemas de conectividade de rede automatizada, use o Network Analyzer. Para mais informações sobre o Network Analyzer, consulte Visão geral do Network Analyzer. Para mais informações sobre os insights associados ao Network Analyzer, consulte Insights de conectividade do Cloud SQL.

Os procedimentos nesta página explicam como usar o console do Google Cloud para gerenciar testes de conectividade. Você também pode gerenciar esses testes usando a CLI gcloud ou a API Cloud SQL Admin.

Antes de começar

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Ativar a API Network Management. Ative essa API para executar testes de conectividade.
7. Atribua o papel Administrador de gerenciamento de rede e as permissões associadas à sua conta de usuário.

   Acessar a página IAM

Criar um teste de conectividade

Para criar um teste de conectividade, siga estas etapas:

1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

   Acesse "Instâncias do Cloud SQL"

2. Clique na instância do Cloud SQL para criar um teste de conectividade.

   Se nenhuma instância aparecer na página, crie uma instância.

3. No menu de navegação lateral, clique em Conexões.
4. Clique na guia Testes de conectividade e, em seguida, clique em Criar.

5. No campo Nome do teste, insira um nome para o teste.

   O nome do teste pode conter apenas letras minúsculas, números e hifens.

6. Na lista Protocolo, selecione um protocolo para o teste.
7. Se essa instância do Cloud SQL for a origem do teste, faça o seguinte:
   1. Na região Origem, clique na opção Instância atual do Cloud SQL.
   2. Na região Destino, clique em Outro e especifique as informações sobre o endpoint do destino.
8. Se a instância for o destino do teste, faça o seguinte:
   1. Na região Origem, clique em Outro e especifique as informações sobre o endpoint da origem.
   2. Na região Destino, clique na opção Instância atual do Cloud SQL.
9. No campo Porta de destino, insira uma porta para o destino.
10. Clique em Criar.

Depois que o teste for concluído, a guia Testes de conectividade será carregada e exibirá uma lista de testes configurados.

Visualizar informações sobre um teste de conectividade

As informações gerais sobre um teste de conectividade que você pode ver incluem as seguintes:

• Nome, protocolo, origem e destino do teste.
• Projetos do Google Cloud associados à origem e ao destino.
• Porta reservada para o destino.
• Data e hora da última execução do teste.
• Resultado da verificação de análise do plano de dados que indica quantos pacotes de dados foram transmitidos da origem para o destino.
• Resultado da verificação de análise de configuração que indica se uma conexão pode ser estabelecida entre a origem e o destino, para que os pacotes de dados possam ser transferidos para o destino.
• Detalhes sobre o teste.

Além de ver informações de alto nível sobre um teste de conectividade, você pode clicar em um teste para ver mais informações sobre os resultados, incluindo as seguintes:

• Valores de latência unidirecional associados à verificação de análise do plano de dados em tempo real.
• Informações detalhadas sobre a verificação da análise de configuração. Essas informações incluem o status da verificação, a instância do Cloud SQL e assim por diante.
• Resposta da API REST para o teste de conectividade em execução.

Visualizar informações detalhadas e de alto nível

Para visualizar informações detalhadas e de alto nível de um teste de conectividade, siga estas etapas:

1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

   Acesse "Instâncias do Cloud SQL"

2. Clique na instância do Cloud SQL de que você quer ver informações sobre um teste de conectividade.

3. No menu de navegação lateral, clique em Conexões.
4. Clique na guia Testes de conectividade. Informações de alto nível sobre todos os testes associados à instância são exibidas.

5. Clique em um teste para ver as informações detalhadas.

   A página Detalhes do teste de conectividade é exibida. Nesta página, é possível ver o resultado geral e os cards de resultados de cada recurso do Google Cloud no caminho de teste. É possível clicar em um link para a página de detalhes de alguns recursos do Google Cloud, como instâncias de VM ou rotas. Se o teste contiver vários traces, será possível selecionar um na lista Resultado do trace.

   Se o teste estiver qualificado para a análise do plano de dados, vai ser possível ver as métricas de perda de pacote e latência.

   Para interpretar os resultados do teste, consulte Estados de análise da configuração.

6. Para ver informações detalhadas sobre a verificação da análise de configuração, na seção Resultado da última análise de configuração, clique em Visualizar.
7. Para ver a resposta da API REST do teste, role até a parte de baixo da página e clique em REST equivalente.

Modificar um teste de conectividade

Para modificar um teste de conectividade, siga estas etapas:

1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

   Acesse "Instâncias do Cloud SQL"

2. Clique na instância do Cloud SQL em que você quer modificar um teste de conectividade.
3. No menu de navegação lateral, clique em Conexões.
4. Clique na guia Testes de conectividade.
5. Clique no teste que você quer modificar.
6. Na página Detalhes do teste de conectividade, clique em Editar.
7. Modifique o teste. É possível modificar o protocolo, os endpoints de origem e destino e a porta de destino.
8. Clique em Salvar.

Testar a conectividade

É possível testar a conectividade com uma instância do Cloud SQL com o Private Service Connect ativado. Para testar a conectividade de entrada com a instância, defina o endereço IP do endpoint do Private Service Connect usado para se conectar à instância como o endereço IP de destino.

gcloud

Use o comando gcloud network-management connectivity-tests create para criar um teste de conectividade para uma instância do Cloud SQL com o Private Service Connect ativado.

gcloud network-management connectivity-tests create CONNECTIVITY_TEST_NAME \
--source-instance=SOURCE_INSTANCE \
--destination-cloud-sql-instance=DESTINATION_CLOUD_SQL_INSTANCE \
--destination-network=DESTINATION_NETWORK \
--destination-port=DESTINATION_PORT \
--protocol=tcp

Faça as seguintes substituições:

• CONNECTIVITY_TEST_NAME: o nome do teste de conectividade.
• SOURCE_INSTANCE: o URI da instância do Compute Engine em que o endereço IP de origem está localizado (por exemplo, projects/myproject/zones/myzone/instances/myinstance).
• DESTINATION_CLOUD_SQL_INSTANCE: o URL da instância do Cloud SQL (por exemplo, projects/myproject/instances/myinstance).
• DESTINATION_NETWORK: o URI da rede VPC em que o endereço IP de destino está localizado (por exemplo, projects/myproject/global/networks/mynetwork).
• DESTINATION_PORT pelo número da porta reservada para a instância. Para instâncias do Cloud SQL para SQL Server, o número da porta é 1433.

Executar testes de conectividade novamente

Se você alterar a configuração de rede dos recursos associados a um teste de conectividade e quiser ver os resultados da configuração mais recente, poderá executar um teste novamente. É possível executar novamente um ou mais testes ao mesmo tempo.

Um teste de conectividade é baseado em um snapshot da configuração de rede no momento da execução do teste. A execução de um teste novamente substitui os resultados anteriores. Se você quiser manter os resultados mais antigos, crie um novo teste.

Para executar um ou mais testes de conectividade novamente, siga estas etapas:

1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

   Acesse "Instâncias do Cloud SQL"

2. Clique na instância do Cloud SQL em que você quer executar os testes de conectividade novamente.
3. No menu de navegação lateral, clique em Conexões.
4. Clique na guia Testes de conectividade.
5. Marque a caixa de seleção ao lado de cada teste que você quer executar novamente.
6. Clique em Executar novamente.
7. Na caixa de diálogo, clique em Executar novamente.

Excluir teste de conectividade

Se você não precisar mais de um teste de conectividade, exclua-o. É possível executar novamente um ou mais testes ao mesmo tempo.

Para excluir testes de conectividade, siga estas etapas:

1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

   Acesse "Instâncias do Cloud SQL"

2. Clique na instância do Cloud SQL em que você quer excluir os testes de conectividade.
3. No menu de navegação lateral, clique em Conexões.
4. Clique na guia Testes de conectividade.
5. Marque a caixa de seleção ao lado de cada teste que você quer excluir.
6. Clique em Excluir.
7. Na caixa de diálogo, clique em Excluir.

Ao excluir um teste de conectividade, ele não consome a cota, e você não será cobrado no futuro.

Resolver problemas

Para saber mais sobre a solução de problemas comuns com testes de conectividade, consulte Resolver problemas de testes de conectividade.

A seguir

• Visão geral do Connectivity Tests
• Insights de conectividade do Cloud SQL
• Crie e execute testes de conectividade
• Visão geral do Network Analyzer