:Instale e configure um exporter do NGINX

Informações básicas

• Os exporters do NGINX da versão anterior incluem o módulo nginx-module-vts instalado.

• A tabela a seguir descreve as métricas dos exporters do NGINX da versão anterior.

  Métrica	Tipo	Descrição
  nginx_server_requests	Server	Número de requisições ao servidor.
  nginx_server_bytes	Server	Número de bytes processados pelo servidor.
  nginx_server_cache	Server	Cache do servidor.
  nginx_filter_requests	Filter	Número de requisições de filtro.
  nginx_filter_bytes	Filter	Número de bytes processados pelo filtro.
  nginx__filter_responseMsec	Filter	Tempo de resposta do filtro.
  nginx_upstream_requests	Upstreams	Número de requisições upstream.
  nginx_upstream_bytes	Upstreams	Número de bytes upstream.
  nginx_upstream_responseMsec	Upstreams	Tempo de resposta das requisições upstream.

Pré-requisitos

O serviço NGINX deve estar instalado e em execução, e o módulo nginx-module-vts precisa estar instalado. Para instalar esse módulo, siga estas etapas:

1. Baixe o módulo nginx-module-vts.

   Nota

   git@github.com:vozlt/nginx-module-vts.git

2. Compile e instale o módulo nginx-module-vts.

   1. Adicione o módulo nginx-module-vts ao arquivo de configuração do NGINX.

      --add-module=/path/to/nginx-module-vts

   2. Baixe o pacote oficial do NGINX e compile-o com o módulo nginx-module-vts adicionado.

      ./configure --user=www --group=www --prefix=/usr/local/nginx --with-http_sysguard_module  --add-module=nginx-module-vts

3. Instale o módulo nginx-module-vts.

   make && make install

4. Configure o NGINX Conf. Modifique o arquivo de configuração do NGINX e adicione uma interface de monitoramento.

   http {
       vhost_traffic_status_zone;
           vhost_traffic_status_filter_by_host on;
   
       ...
   
       server {
   
           ...
   
           location /status {
               vhost_traffic_status_display;
               vhost_traffic_status_display_format html;
           }
       }
   }

   Recomendamos executar o comando a seguir para ativar a filtragem de vhost:

   vhost_traffic_status_filter_by_host on

   Nota

   Ao configurar vários nomes de servidor, ative a filtragem de vhost para garantir que o sistema colete estatísticas de tráfego separadas por nome. Sem essa filtragem, o sistema atribuirá todo o tráfego ao primeiro nome de servidor.

   Caso não seja necessário monitorar o tráfego por região, execute o comando a seguir para desativar a filtragem de vhost. As reticências (...) no comando abaixo indicam código omitido.

   server {
   ...
   vhost_traffic_status off;
   ...
   }

5. Verifique se o módulo nginx-module-vts está instalado.

   curl http://127.0.0.1/status

Pontos de entrada

Ponto de entrada 1

1. Faça login no console do ARMS.

2. No painel de navegação à esquerda, escolha Managed Service for Prometheus > Instances.

3. Faça login no console do Cloud Monitor.

4. No painel de navegação à esquerda, escolha Managed Service for Prometheus > Instances para abrir a lista de instâncias do Managed Service for Prometheus.

5. Clique em no nome da instância do Managed Service for Prometheus que deseja gerenciar para acessar a página Integration Center.

Ponto de entrada 2: Integration Center no console do ARMS

1. Faça login no console do Application Real-time Monitoring Service (ARMS).

2. No painel de navegação à esquerda, clique em Integration Center. Na seção Application Components, localize o componente Nginx (old) e clique em Add. No painel exibido, configure um exporter do Nginx (old) conforme as instruções.

Configure um exporter do NGINX

Esta seção descreve como configurar um exporter do NGINX na central de integração da instância do Prometheus. Siga estas etapas:

1. Configure um exporter do NGINX.

   • Se esta for a primeira instalação do componente NGINX, proceda da seguinte forma:

     Na seção Not Installed da página Integration Center, localize o componente NGINX e clique em Install.

   • Se o componente NGINX já estiver instalado, adicione-o novamente.

     Na seção Installed da página Integration Center, localize o componente NGINX e clique em Add.

2. Na aba Configuration, dentro da seção STEP2 do painel exibido, defina os parâmetros e clique em OK.

   Parâmetro	Descrição
   Exporter Name	Nome do exporter do NGINX. O nome deve atender aos seguintes requisitos: Deve conter apenas letras minúsculas, dígitos e hifens (-), sem começar ou terminar com hífen. Precisa ser único. Nota Se este parâmetro não for especificado, o sistema usará o nome padrão, composto pelo tipo de exporter e um sufixo numérico.
   NGINX (Old) URL	URL utilizada para acessar o servidor NGINX.
   NGINX (Old) Port	Número da porta do servidor NGINX. Exemplo: 80.

   Importante

   • Instale previamente o módulo de status de tráfego de host virtual do NGINX (nginx-module-vts). Esse módulo gera dados no formato JSON.

   • Visualize as métricas de monitoramento na aba Metrics, dentro da seção STEP2.

   O componente instalado aparece na página Integration Management do console do Managed Service for Prometheus. A página Integration Management contém as abas Integrated Environments, Integrated Addons e Query Dashboards, onde é possível visualizar informações como targets, métricas, painéis e alertas.