Ativando o monitoramento de métricas

Para receber métricas de monitoramento, deve-se configurar a instância do IBM Cloud Monitoring.

Para receber as métricas de monitoramento, use as etapas a seguir:

1. Navegue até o portal de monitoramento de métricas e clique em Opções > Criar.

2. Selecione uma região para a sua instância do IBM Cloud Monitoring.

   Se você não tiver um gateway VPN existente, consulte Criando um gateway VPN para provisionar um.

   A região precisa corresponder ao local de seu gateway VPN existente.

3. Escolha o seu plano de precificação.

   Detalhes do plano de precificação são explicados na janela de seleção. Selecione o plano que melhor atenda aos seus requisitos.

4. Forneça um nome de serviço exclusivo para sua instância. O nome pode ser qualquer nome desejado. O nome não tem impacto na funcionalidade.

   Não forneça o mesmo nome a várias instâncias do IBM Cloud Monitoring.

5. Opcionalmente, selecione um grupo de recursos. Um grupo de recursos organiza recursos de conta em agrupamentos customizáveis. Qualquer recurso de conta que seja gerenciado usando o controle de acesso do IBM Cloud Identity and Access Management (IAM) pertence a um grupo de recursos dentro de sua conta.

   Se você não tiver nenhum grupo de recursos pré-configurado ou não tiver razão para compartilhar esse recurso de forma seletiva, use a seleção padrão.

   Se a sua conta tiver diversos grupos de recursos, será possível escolher qual grupo terá acesso a essa instância do IBM Cloud Monitoring. Ao usar esse acesso seletivo, as métricas podem estar disponíveis para alguns grupos de recursos e não para outros.

6. Selecione a caixa de seleção Ativar. Deve-se selecionar essa opção para receber métricas do gateway VPN.

7. Clique em Criar. Você é levado de volta para a página inicial de métricas de monitoramento.

Dentro de alguns minutos, sua nova instância do IBM Cloud Monitoring será exibida com várias configurações. Pode ser necessário atualizar seu navegador para vê-la.

Trabalhando com o painel do IBM Cloud Monitoring

Para visualizar e trabalhar com suas métricas do IBM Cloud Monitoring, siga estas etapas:

1. Navegue até o portal de monitoramento de métricas.

2. Clique em Abrir painel ao lado do nome de serviço da instância do IBM Cloud Monitoring com a qual você deseja trabalhar.

   No primeiro acesso à instância do IBM Cloud Monitoring, várias janelas são exibidas como parte da configuração interna. Mantenha as entradas padrão e clique nas páginas até chegar à página principal do IBM Cloud Monitoring.

3. Abra o painel do IBM VPN for VPC Monitoring Metrics, selecionando Painéis.

4. Clique em Biblioteca do painel> IBM > VPN do VPC O painel padrão não é editável.

5. As dez métricas principais no painel são mostradas. Essas métricas incluem Status de gateway/conexão, Entrada/saída de bytes de gateway/conexão e Entrada/saída de pacotes de gateway/conexão. Para modificar parâmetros e segmentar as métricas pelo nome do gateway VPN e pelo nome da conexão VPN, deve-se criar um painel customizado.

   É possível escolher em qual espaço de tempo você gostaria de ver suas métricas usando a barra de seleção de hora.

Criando um painel de métricas customizado

É possível criar seu próprio painel para customizar suas métricas de monitoramento, como visualizar informações sobre gateways VPN específicos ou ver o tráfego que vem somente por meio de uma conexão VPN.

Para customizar seu painel, use as etapas a seguir:

1. Navegue até o portal de monitoramento de métricas.

2. Clique em Abrir painel ao lado do nome de serviço da instância do IBM Cloud Monitoring com a qual você deseja trabalhar. Agora você vê o painel.

3. Selecione Painéis e clique no + no painel.

4. Selecione Painel em branco e selecione o tipo de representação visual que você deseja.

   O IBM Cloud Monitoring oferece oito visualizações diferentes para o seu painel. Leia a descrição para cada visualização e escolha aquela que melhor atenda aos seus requisitos.

   A linha Visualizar tendências ao longo do tempo é a opção selecionada com mais frequência. Os exemplos a seguir mostram uma visualização baseada em linha.

5. Configure o seu painel customizado.

   • No campo Metrics (Métricas ), digite ibm_is para exibir as dez IBM Cloud VPN métricas de VPC: ibm_is_vpn_gateway_status, ibm_is_vpn_connection_status, ibm_is_vpn_gateway_bytes_in, ibm_is_vpn_gateway_bytes_out, ibm_is_vpn_gateway_packets_in, ibm_is_vpn_gateway_packets_out, ibm_is_vpn_connection_bytes_in, ibm_is_vpn_connection_bytes_out, ibm_is_vpn_connection_packets_in, e ibm_is_vpn_connection_packets_out.

   • É possível escolher um escopo a ser exibido em seu painel clicando em Substituir escopo do painel. Por exemplo, é possível exibir as métricas para um gateway VPN específico.

   • Também é possível configurar um segmento para comparar métricas em todo o escopo definido. Por exemplo, é possível verificar o status da conexão para um gateway VPN específico que seja segmentado pelo nome do gateway e pelo nome da conexão.

6. Clique em Salvar.

   Por padrão, o painel é denominado "painel em branco". Você pode alterar o nome selecionando Dashboards na barra lateral e clicando no ícone Editar ao lado do nome.

Para retornar ao painel padrão do IBM Cloud Monitoring a qualquer momento, selecione Painéis > Painéis padrão > IBM > VPC VPN.

Trabalhando com o IBM Cloud Monitoring usando APIs

Também é possível trabalhar com a instância do IBM Cloud Monitoring usando APIs de consulta de métrica. É possível usar APIs quando são necessários pontos de dados brutos ou quando se deseja consumir as métricas por meio de uma interface da linha de comandos em vez de por meio do painel do IBM Cloud Monitoring.

Após a criação da instância do IBM Cloud Monitoring, deve-se coletar as duas informações a seguir.

• O token da API do Monitor
• O terminal de sua instância do IBM Cloud Monitoring

Para coletar essas informações e trabalhar com a sua instância do IBM Cloud Monitoring usando API de consulta de métrica, siga estas etapas:

1. Acesse a Página inicial de monitoramento.

2. Clique em Abrir painel ao lado da instância com a qual você deseja trabalhar.

3. Após o painel do IBM Cloud Monitoring ser exibido, selecione seu ícone Perfil da conta na barra lateral e selecione Configurações. Agora você vê suas configurações de conta.

4. Seu token da API do Monitor é uma sequência alfanumérica localizada no campo Token da API do Sysdig Monitor. Clique no botão Copiar para copiar o token para a sua área de transferência.

   Não compartilhe este token da API. Qualquer um que tiver esse token da API terá acesso total às suas métricas.

5. O terminal da instância do IBM Cloud Monitoring é por região. Por exemplo, se sua instância do IBM Cloud Monitoring existir no us-south, seu terminal será:

   https://us-south.monitoring.cloud.ibm.com/api/data/batch
   

6. Depois de ter tanto o token da API quanto o terminal, será possível formatar a sua solicitação de POST. A solicitação de POST a seguir é um exemplo, com todos os parâmetros que é possível modificar. A seguir estão os parâmetros:

   • O token da API do Monitor.
   • O terminal de sua instância do IBM Cloud Monitoring.
   • O valor para ibm_is_vpn_gateway_name (o nome do gateway VPN para o qual você deseja ver as métricas).

   Para ver essa métrica para todos os gateways VPN, não insira um valor para o atributo scope. Por exemplo, use "scope" : "".

   • O tipo de métrica para o qual você deseja ver os resultados. Este exemplo usa ibm_is_vpn_gateway_status.
   • Os atributos from e to definem o intervalo de tempo para focar a varredura, configurado no horário de época e em microssegundos.
   • Os atributos sampling e value configuram a granularidade dos dados que são retornados na solicitação de POST.

   Como um grande volume de dados é armazenado no IBM Cloud Monitoring, a escolha do nível específico de granularidade é importante. O IBM Cloud Monitoring pode retornar somente 600 pontos de dados de cada vez por solicitação. Como resultado, os atributos sampling e value são importantes. Deixar essas duas linhas fora de sua solicitação retorna uma soma agregada durante esse período de tempo como alternativa.

   Se o intervalo de tempo especificado por from e to for grande (por exemplo, 4 dias), mas você definir uma sampling e um value de 10 segundos, receberá 4 dias de dados divididos em chunks de 10 segundos. Essa amostra não é útil por causa da grande quantia de dados que são retornados. A especificação de um chunk maior é recomendada (por exemplo, 1 hora em vez de 10 segundos).

      curl \
      -H 'Authorization: Bearer <API_TOKEN>’ \
      -H 'Content-Type: application/json' \
      https://us-south.monitoring.cloud.ibm.com/api/data/batch  \
      -d '{
        "requests": [
            {
                "format": {
                    "type": "data"
                },
                "scope": "ibm_is_vpn_gateway_name = \"test-001\"",
                "metrics": {
                    "k0": "timestamp",
                    "v1": "ibm_is_vpn_gateway_status"
                },
                "time": {
                    "from": 1589877054000000,
                    "to": 1589877114000000,
                    "sampling": 60000000
                },
                "group": {
                    "by": [
                        {
                           "metric": "k0",
                            "value" : 60000000
                        }
                    ],
                    "aggregations": {
                        "v1": "avg"
                    },
                    "groupAggregations": {
                        "v1": "avg"
                    }
                }
            }
        ]
    }'
   

Trabalhando com o IBM Cloud Monitoring usando a IU do VPN for VPC

É possível visualizar métricas individuais do gateway de VPN e ativar o painel IBM Cloud Monitoring por meio da IU da VPN.

1. Navegue até a UI VPN.

2. Clique em um nome de gateway VPN cujas métricas do IBM Cloud Monitoring você deseja visualizar e acesse a sua página Visão geral.

   O painel Visualização de monitoramento exibe a soma de cada métrica ao longo da última hora.

   É possível clicar em Iniciar monitoramento para iniciar o painel padrão IBM Cloud Monitoring do gateway da VPN.

3. Abra a página Monitoramento do gateway da VPN. A página exibe o rendimento de um gateway VPN e os pacotes em um intervalo de tempo.

   Da mesma forma, também é possível iniciar o painel padrão IBM Cloud Monitoring do gateway da VPN clicando em Iniciar monitoramento.