Métricas disponíveis por plano de serviço

As métricas de monitoramento suportadas incluem:

• Conexões ativas com o seu balanceador de carga em um determinado momento.
• Taxa de conexão ou uma análise de quando mais ou menos conexões são feitas com o seu balanceador de carga.

Essas métricas ajudam a rastrear os padrões de tráfego e de uso para o seu NLB e podem fornecer insight sobre horários de pico de tráfego, quedas de uso e padrões gerais de uso.

Cada métrica é composta pelos tipos de metadados a seguir:

• Nome da métrica - o nome para a métrica coletada.
• Tipo de métrica - o tipo de métrica determina se o valor da métrica é uma métrica de contador ou uma métrica de medidor. Cada uma dessas métricas é do tipo gauge, que representa um valor numérico único que pode flutuar arbitrariamente ao longo do tempo.
• Tipo de valor - uma unidade de medida para uma métrica específica. Exemplos incluem bytes ou contagens. Um tipo de valor de none significa que o valor da métrica representa as ocorrências individuais desse tipo de métrica.
• Segmento - Como você deseja dividir e exibir as métricas de monitoramento.

Segmentação de métrica

É possível dividir os dados que o IBM Cloud Monitoring apresenta em várias visualizações no painel, permitindo visualizações de diferentes métricas com base em suas preferências. Por exemplo, se você tiver diversos balanceadores de carga ou diversas contas com diferentes balanceadores de carga em cada uma delas, será possível se concentrar em uma determinada porta do listener.

Por exemplo, é possível segmentar as active connections por IBM Load Balancer for VPC listener port para mostrar quantos usuários ativos estão conectados ao balanceador de carga por meio de cada tipo de listener. Para ilustrar isso, vamos supor que o seu balanceador de carga de rede tenha o protocolo de listener TCP na porta 8080. O painel conteria diferentes linhas mostrando 10 usuários que estão conectados por meio de HTTP na Porta 80 em uma cor e 6 usuários conectados por meio do TCP na porta 8080 em outra cor.

Ativando o monitoramento de métricas

Para receber métricas de monitoramento, deve-se configurar o IBM Cloud Monitoring com uma instância de monitoramento.

Para fazer isso, siga estas etapas:

1. Navegue até o portal de monitoramento de métricas e clique em Criar uma instância de monitoramento.

2. Selecione uma região para a sua instância de monitoramento.

   Se você não tiver um balanceador de carga existente, consulte Criando um balanceador de carga de rede para provisionar um.

   A região deve corresponder ao local de seu balanceador de carga 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.

5. Opcionalmente, selecione um grupo de recursos. Um grupo de recursos é uma maneira de organizar recursos de conta em agrupamentos customizáveis. Qualquer recurso da conta gerenciado por meio do controle de acesso IBM Cloud® Identity and Access Management (IAM) pertence a um grupo de recursos dentro da sua conta.

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

   Se a sua conta tiver vários grupos de recursos, será possível escolher qual deles tem acesso a esta instância de monitoramento. Isso permite que você tenha métricas disponíveis para alguns grupos de recursos e não para outros.

6. Marque a caixa de seleção Ativar métricas de plataforma. Deve-se selecioná-la para receber métricas do balanceador de carga.

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 de monitoramento 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 de monitoramento, siga estas etapas:

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

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

   No primeiro acesso à instância de monitoramento, várias janelas são exibidas como parte da configuração interna. Deixe essas seleções com suas entradas padrão e clique nas páginas até chegar à página principal.

3. Selecione Painéis na barra lateral esquerda para abrir o painel de Métricas de monitoramento do IBM Load Balancer. Em seguida, clique em Painéis padrão > IBM > Métricas de monitoramento do balanceador de carga. O painel padrão não é editável.

4. Duas métricas principais no painel são mostradas: Conexões ativas e Taxa de conexão. Para modificar parâmetros e segmentar as métricas por ID de balanceador de carga ou porta de listener, deve-se criar um painel customizado.

   É possível escolher para qual espaço de tempo você gostaria de ver as suas métricas exibidas, usando a barra na parte inferior.

Criando um painel de métricas customizado

É possível criar o seu próprio painel para customizar as suas métricas de monitoramento, como visualizar informações sobre determinados balanceadores de carga ou apenas ver o tráfego que vem por meio de listeners específicos.

Para customizar o seu painel, siga estas etapas:

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

2. Clique em Abrir painel ao lado do nome do serviço da instância de monitoramento com a qual você deseja trabalhar. O painel é exibido.

3. Na barra lateral esquerda, selecione Painéis. Em seguida, clique no sinal verde + no painel.

4. Selecione Painel em branco e, em seguida, 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, em seguida, escolha aquela que melhor atenda aos seus requisitos.

   Linha ("Visualizar tendências ao longo do tempo") é a opção mais fácil e mais básica. Ela também é a opção mais frequentemente selecionada. Os exemplos neste tópico mostram uma Visualização baseada em linha.

5. Configure o seu painel customizado.

   • No campo Métricas, insira ibm_is para exibir as duas métricas do balanceador de carga: ibm_is_load_balancer_active_connections e ibm_is_load_balancer_connection_rate.

     É possível monitorar o tráfego da porta do listener ativando a métrica ibm_is_load_balancer_listener_port.

   • É 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 balanceador de carga específico.

   • Também é possível configurar um segmento para comparar métricas em todo o escopo que você definiu. Por exemplo, é possível verificar Conexões ativas para um balanceador de carga específico segmentado por porta do listener.

6. Clique em Salvar para que seu novo painel customizado seja acessível.

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

Para retornar ao painel padrão a qualquer momento, selecione Painéis > Painéis padrão > IBM > Métricas de monitoramento do balanceador de carga.

Trabalhando com o IBM Cloud Monitoring usando as APIs

Também é possível trabalhar com a instância de monitoramento usando as APIs de consulta de métrica. É possível fazer isso 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.

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 começar a trabalhar com a sua instância de monitoramento usando a API de consulta de métrica, siga estas etapas:

1. Acesse a página inicial do Monitoring e clique em Open Dashboard (Abrir painel) ao lado da instância com a qual você deseja trabalhar. Após a exibição do painel do IBM Cloud Monitoring, selecione seu ícone de Perfil da conta na barra lateral esquerda, em seguida, selecione Configurações. As suas configurações de conta são exibidas.

2. Seu token de API do Monitor é uma sequência alfanumérica que está localizada no campo Token da API do monitor. Clique no botão Copiar à direita da chave para transferi-la 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.

3. Para obter o terminal de sua instância do IBM Cloud Monitoring, navegue até o seu painel principal em seu navegador. Em seguida, selecione a URL para o painel, que aparece semelhante a:

   https://us-south.monitoring.cloud.ibm.com/#/default-dashboard/ibm_is_load_balancer?last=3600
   

   A primeira parte da URL (neste caso, us-south.monitoring.cloud.ibm.com) é o seu terminal. Tome nota disso.

4. 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. Esses parâmetros são:

   • O token da API do Monitor.

   • O terminal de sua instância de monitoramento.

   • O valor para ibm_resource (este é o ID do balanceador de carga para o qual você deseja ver métricas).

     Se você desejar ver essa métrica para todos os seus balanceadores de carga, 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_load_balancer_active_connections, mas ibm_is_load_balancer_connection_rate também é uma opção válida.

   • Os atributos from e to definem os horários para concentrar a varredura, configurada em Horário de época e em microssegundos.

   • Os atributos sampling e value configuram a granularidade de quais dados 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 com uma dada solicitação. Como resultado, os atributos sampling e value são importantes. Deixar essas duas linhas fora de sua solicitação retornará uma soma agregada durante esse período em vez disso.

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, isso significará que você receberá 4 dias de dados divididos em chunks de dez segundos. Esta não é uma amostragem útil devido à grande quantia de dados 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_resource = \"cfc851b1-f30b-4a06-b354-5b64526c0a69\"",
         "metrics": {
             "k0": "timestamp",
             “v1”: "ibm_is_load_balancer_active_connections"
         },
         "time": {
             "from": 1584396900000000,
             "to": 1584402600000000,
              “sampling”: 600000000
         },
         "group": {
             "by": [
                 {
                     "metric": "k0",
                     “value” : 600000000
                 }
             ],
             "aggregations": {
                 “v1”: "sum"
             },
             "groupAggregations": {
                 “v1”: "sum"
             }
         }
     }
 ]
}'