O monitoramento de serviços do NGINX com o Elastic Stack pode ajudar a identificar problemas de infraestrutura, planejar a manutenção de rotina e inclusive impedir ataques de DDOS.

<p>Neste artigo, vamos analisar como podemos monitorar o NGINX usando os vários componentes do Elastic Stack. Vamos usar o Metricbeat e o Filebeat para coletar dados. Esses dados serão fornecidos e armazenados no Elasticsearch. Por fim, vamos visualizar esses dados com o Kibana.
</p><p>O Metricbeat coletará dados relacionados às conexões (ativas, manipuladas, aceitas etc.) e o número total de solicitações do cliente. O Filebeat coletará dados relacionados a logs de acesso e erro. A milhagem será variável entre diferentes instalações, mas para a maior parte podemos usar essas informações para deduzir determinadas situações, por exemplo:
</p><ul>
	<li>Um pico nos logs de erro para um recurso específico pode significar que excluímos um recurso que ainda é necessário.</li>
	<li>Os logs de acesso podem mostrar quando são os horários de pico de um serviço (e assim quando será mais conveniente executar operações como manutenção).</li>
	<li>Um pico repentino nas solicitações de cliente pode apontar alguma atividade maliciosa (como um ataque de DDoS).</li>
</ul><p>O principal foco deste artigo é a funcionalidade de monitoramento, por isso operações como a instalação do Elasticsearch serão breves. Eu uso um Mac e, por isso, usarei as distribuições do Elasticsearch, Metricbeat, Filebeat e Kibana para Mac. As distribuições para outras plataformas <a href="/downloads/">podem ser adquiridas na página de downloads</a>.
</p><h2>Instalação do Elasticsearch</h2><p>O <a href="/products/beats/metricbeat">Metricbeat</a> e o <a href="/products/beats/filebeat">Filebeat</a> (na realidade, todos os <a href="/products/beats/">Beats</a>) precisam de um cluster do Elasticsearch para armazenar dados. Vamos instalar localmente um cluster simples do Elasticsearch. Como não estamos expondo o Elasticsearch externamente, não desperdiçaremos tempo <a href="/blog/getting-started-with-elasticsearch-security">configurando a segurança</a>.
</p><h4>Etapa 1: fazer download do Elasticsearch</h4><pre class="prettyprint">curl -L -O https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.1.0-darwin-x86_64.tar.gz
</pre><h4>Etapa 2: extrair o arquivo</h4><pre class="prettyprint">tar -xvf elasticsearch-7.1.0-darwin-x86_64.tar.gz
</pre><h4>Etapa 3: alterar para o diretório bin</h4><pre class="prettyprint">cd elasticsearch-7.1.0/bin
</pre><h4>Etapa 4: iniciar nosso cluster de nó único</h4><pre class="prettyprint">./elasticsearch
</pre><p>Por padrão, o cluster será executado em <code>localhost:9200</code>.
</p><h2>Execução do NGINX</h2><p>Há muitas maneiras de executar o NGINX — de forma autônoma no host, via container do Docker, em uma instalação do Kubernetes etc. O Beats tem um recurso Autodiscover que pode ouvir eventos de API de container para rastrear nossos containers de servidor à medida que são executados ou removidos.
</p><p>Considerando a variedade de maneiras como o NGINX pode ser instalado e configurado, este artigo não faz muitas pressuposições e mostrará a configuração do host, além de exemplos de Autodiscover (Docker, neste caso).
</p><h2>Configuração do Metricbeat e do Filebeat</h2><p>Agora vamos configurar o Beats para começar a coletar e fornecer nossos dados.
</p><h3>Metricbeat</h3><p>Vamos usar o Metricbeat para coletar métricas.
</p><h4>Etapa 1: fazer download do Metricbeat:</h4><pre class="prettyprint">curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-7.1.0-darwin-x86_64.tar.gz
</pre><h4>Etapa 2: extrair o arquivo</h4><pre class="prettyprint">tar -xvf metricbeat-7.1.0-darwin-x86_64.tar.gz
</pre><h4>Etapa 3: alterar diretórios</h4><pre class="prettyprint">cd metricbeat-7.1.0-darwin-x86_64
</pre><p>É hora da configuração!
</p><p>Por padrão, nosso arquivo de configuração (metricbeat.yml) procurará um cluster do Elasticsearch em execução em localhost:9200, que é o que configuramos anteriormente.
</p><h4>Etapa 4: habilitar módulos relevantes do Metricbeat</h4><p>Por padrão, somente métricas de nível de sistema são coletadas:
</p><pre class="prettyprint">./metricbeat modules enable nginx
</pre><h4>Etapa 5: alterar propriedades de arquivo</h4><p>Precisamos alterar algumas propriedades de arquivo, porque executaremos o Metricbeat como raiz (como alternativa, é possível optar por usar a opção --strict.perms=false na linha de comando para desabilitar as verificações de permissão estritas):

</p><pre class="prettyprint">sudo chown root metricbeat.yml 
sudo chown root modules.d/system.yml 
sudo chown root modules.d/nginx.yml
</pre><h4>Etapa 6: habilitar conjuntos de métricas</h4><p>Se abrirmos nosso arquivo <code>modules.d/nginx.yml</code>, poderemos habilitar o conjunto de métricas <code>stubstatus</code>, que envolve retornar ao código-fonte o comentário deste trecho:
</p><pre class="prettyprint">#metricsets:
#  - stubstatus
</pre><p>Esse conjunto de métricas coleta dados do módulo <a href="https://nginx.org/en/docs/http/ngx_http_stub_status_module.html">ngx_http_stub_status</a> do NGINX; é importante que esse módulo do NGINX esteja configurado para que o conjunto de métricas funcione.
</p><p>Você também pode alterar os hosts sendo monitorados aqui; por padrão, <code>&lt;a href="http://127.0.0.1">http://127.0.0.1&lt;/a></code> é monitorado. Para instalações baseadas em host, isso é tudo o que é necessário.
</p><h4>Etapa 7: instalações de Autodiscover (alternativa)</h4><p>Com as instalações de <a href="/guide/en/beats/metricbeat/7.1/configuration-autodiscover.html">Autodiscover</a>, a configuração equivalente será variável entre os três provedores, a saber, Docker, Kubernetes e Jolokia. Um exemplo do Docker teria aparência semelhante a esta, em que adicionamos <code>metricbeat.autodiscover</code> à parte inferior do arquivo de configuração  <code>metricbeat.yml</code>.
</p><pre class="prettyprint">metricbeat.autodiscover:
  providers:
    - type: docker
      templates:
        - condition:
            contains:
              docker.container.image: nginx
          config:
            - module: nginx
              metricsets: ["stubstatus"]
              hosts: "${data.host}:${data.port}"
</pre><p>Com essa configuração, todos os containers do Docker que usam uma imagem com NGINX no nome (<a href="/guide/en/beats/metricbeat/7.1/defining-processors.html#conditions">containers executarão uma correspondência de subcadeia de caracteres, em vez de uma correspondência exata</a>) terão correspondência e usarão uma configuração que habilita o módulo do NGINX com o conjunto de métricas stubstatus.
</p><h4>Etapa 8: executar o Metricbeat</h4><p>Beleza! Agora que fizemos a configuração, podemos executar o Metricbeat com um sinalizador que envia os logs para stderr e desabilita a saída de syslog/file:
</p><pre class="prettyprint">sudo ./metricbeat -e
</pre><p>Se tudo tiver funcionado bem, você deverá ver alguma saída inicial, e depois mais saídas toda vez em que o Metricbeat postar de volta os dados no cluster.
</p><h3>Filebeat</h3><p>Vamos usar o Filebeat para coletar logs.
</p><h4>Etapa 1: fazer download do Filebeat</h4><pre class="prettyprint">curl -L -O https://artifacts.elastic.co/downloads/beats/filebeat/filebeat-7.1.0-darwin-x86_64.tar.gz
</pre><h4>Etapa 2: extrair o arquivo</h4><pre class="prettyprint">tar -xvf filebeat-7.1.0-darwin-x86_64.tar.gz
</pre><h4>Etapa 3: alterar diretórios</h4><pre class="prettyprint">cd filebeat-7.1.0-darwin-x86_64
</pre><h4>Etapa 4: habilitar o módulo do NGINX</h4><pre class="prettyprint">./filebeat modules enable nginx
</pre><p>Por padrão, logs de acesso e erro serão coletados. Em relação aos caminhos do arquivo de log, o Filebeat tentará determiná-los com base no sistema operacional; se precisar definir diferentes caminhos explicitamente, você poderá defini-los no arquivo de configuração modules.d/nginx.yml.
</p><h4>Etapa 5: alterar as propriedades de arquivo</h4><pre class="prettyprint">sudo chown root filebeat.yml
sudo chown root modules.d/nginx.yml
sudo chown root module/nginx/access/manifest.yml
sudo chown root module/nginx/error/manifest.yml
</pre><p>Para uma instalação baseada em host, isso é tudo o que é necessário.
</p><h4>Etapa 6: instalação de Autodiscover (alternativa)</h4><p>Como antes, a configuração adicional é necessária para usar o Autodiscover. Semelhante à seção anterior, o exemplo do Docker precisaria de uma seção de Autodiscover adicionada à configuração, e o arquivo filebeat.yml teria aparência semelhante a esta:
</p><pre class="prettyprint">filebeat.autodiscover:
 providers:
   - type: docker
     templates:
       - condition:
         contains:
           docker.container.image: nginx
         config:
           - module: nginx
             access:
               input:
                 type: docker
                 containers.ids:
                   - "${data.docker.container.id}"
             error:
               input:
                 type: docker
                 containers.ids:
                   - "${data.docker.container.id}"
</pre><p>Neste ponto, configuramos as opções de acesso e erro para usar uma <a href="/guide/en/beats/filebeat/7.1/filebeat-input-docker.html">entrada do Docker</a>. Uma entrada do Docker pesquisará logs de container sob o caminho (o caminho base em que os logs do Docker estão localizados; por padrão é este <code>/var/lib/docker/containers)</code>. Especificamos <code>containers.ids</code> usando o(s) <a href="/guide/en/beats/filebeat/7.1/configuration-autodiscover.html#_docker_2">id(s) dos containers que fizeram correspondência com a condição do nosso modelo</a>. Combinados, os logs (por padrão) terão como fonte <code>/var/lib/docker/containers/ac29b98ad83ca43bb4c15ae8f0d03aff8c7d57bf5dee9024124374b92b14b0f2/</code> (os ids serão diferentes).
</p><h4>Etapa 7: executar o Filebeat</h4><pre class="prettyprint">sudo ./filebeat -e
</pre><h2>instalação do Kibana</h2><p>Agora que temos o Metricbeat e o Filebeat fornecendo dados sobre nosso(s) servidor(es) NGINX, precisamos de uma maneira de visualizar esses dados, e é nessa hora que o Kibana entra.
</p><h4>Etapa 1: fazer download do Kibana</h4><pre class="prettyprint">curl -O https://artifacts.elastic.co/downloads/kibana/kibana-7.1.0-darwin-x86_64.tar.gz
</pre><h4>Etapa 2: extrair o arquivo e alterar o diretório</h4><pre class="prettyprint">tar -xzf kibana-7.1.0-darwin-x86_64.tar.gz
</pre><pre class="prettyprint">cd kibana-7.1.0-darwin-x86_64
</pre><h4>Etapa 3: executar o Kibana</h4><pre class="prettyprint">./bin/kibana
</pre><p>Por padrão, o Kibana usará um host do Elasticsearch de <code>http://localhost:9200</code> e estará acessível em <code>http://localhost:5601</code>.
</p><p>Se você navegar até <a href="http://localhost:5601"><code>http://localhost:5601</code></a>, deverá ser recebido por esta tela:
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/bltad0c6331722acdc1/5d2dba9c9f0a7673f0580236/nginx-monitoring-image1.png" data-sys-asset-uid="bltad0c6331722acdc1" alt="Tela de boas-vindas ao Kibana" style="display: block; margin: auto;" width="420" height="530">
</p><p>Outra opção é experimentar a amostra de dados, mas vamos apenas clicar em <strong>Explore on my own</strong> (Explorar por minha conta).
</p><h2>Visualização dos dados do NGINX no Kibana</h2><p>Depois vamos examinar como podemos usar o Kibana para visualizar e analisar nossos dados.
</p><h3>Infrastructure</h3><p>Se navegarmos até o aplicativo Infrastructure na barra lateral do Kibana, poderemos ver uma visualização de instantâneo (último minuto) da nossa infraestrutura. Dependendo da configuração que foi usada, os dados estarão acessíveis em Hosts para instalações não baseadas no Autodiscover; para instalações do Autodiscover, os botões Docker e Kubernetes (com base no provedor que foi usado) levarão você até o conjunto de dados correto:
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt1873b9142f8f4dc9/5d2d374e9f0a7673f057fe6c/nginx-monitoring-image2.png" data-sys-asset-uid="blt1873b9142f8f4dc9" alt="Botões Hosts, Kubernetes e Docker" style="display: block; margin: auto;" width="420" height="100">
</p><p>Como eu estava usando uma instalação baseada no Hosts, posso clicar no botão Hosts e ver os seguintes dados sendo fornecidos provenientes do Metricbeat:
</p><h2><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt2594e5bbb16134f9/5d2d37839f0a7673f057fe72/nginx-monitoring-image3.png" style="background-color: initial; font-family: proximaNovaRegular, Arial, Helvetica, sans-serif; font-size: 14px; color: rgb(116, 133, 144); display: block; margin: auto;" data-sys-asset-uid="blt2594e5bbb16134f9" alt="Clique no botão Hosts para ver os dados sendo fornecidos"></h2><p>Se selecionarmos um desses nós e escolhermos <strong>View Metrics</strong>, poderemos ver uma página com métricas detalhadas para esse único servidor do NGINX.
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt134bbe8e86663c4b/5d2d37bdae880b03aa40661e/nginx-monitoring-image4.png" data-sys-asset-uid="blt134bbe8e86663c4b" alt="Gráficos do Kibana mostrando métricas do servidor" style="display: block; margin: auto;">
</p><h3>Logs</h3><p>Se navegarmos até o aplicativo Logs, poderemos ver nossos logs de acesso e erro que foram fornecidos provenientes do Filebeat.
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt79961499be8a9f3b/5d2d3803ae880b03aa406624/nginx-monitoring-image5.jpg" data-sys-asset-uid="blt79961499be8a9f3b" alt="Aplicativo Logs do Kibana mostrando logs de erro e acesso" style="display: block; margin: auto;">
</p><h3>Painéis do NGINX pré-configurados</h3><p>Agora que temos uma instância do Kibana em execução e acessível, podemos carregar alguns painéis pré-criados.
</p><p>Para carregar os painéis do Metricbeat, execute este código no diretório do Metricbeat:
</p><pre class="prettyprint">sudo ./metricbeat setup --dashboards
</pre><p>E faça o mesmo para o Filebeat:
</p><pre class="prettyprint">sudo ./filebeat setup --dashboards
</pre><p>Agora, se navegarmos até a guia Dashboards (Painéis) no Kibana, deveremos ver esta tela:
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/bltf6e6bf414a9c13c8/5d2d383eb3c3b6032396a3d7/nginx-monitoring-image6.jpg" data-sys-asset-uid="bltf6e6bf414a9c13c8" alt="Página do Kibana mostrando os painéis disponíveis" style="display: block; margin: auto;">
</p><p>Se especificarmos que a pesquisa seja "nginx", teremos estes painéis disponíveis:
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/bltcf3ccffbb71a48aa/5d2d38bb2eb7167479193ecf/nginx-monitoring-image7.png" data-sys-asset-uid="bltcf3ccffbb71a48aa" alt="Página do Kibana mostrando os painéis do NGINX disponíveis" style="display: block; margin: auto;" width="720" height="390">
</p><p>O painel <em><strong>[Filebeat NGINX] Access and error logs ECS</strong></em> ([Filebeat NGINX] Logs de acesso e erro - ECS), como exemplo, tem aparência semelhante a esta:
</p><p><img src="https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt51e7d57d2a6b575d/5d2d38f88e6f797b0da30462/nginx-monitoring-image8.jpg" data-sys-asset-uid="blt51e7d57d2a6b575d" alt="Filebeat NGINX - logs de acesso e erro - ECS" style="display: block; margin: auto;">
</p><p>E assim aprendemos como usar o Elastic Stack para monitorar os servidores do NGINX. A partir deste ponto, existem várias opções disponíveis (por exemplo, diferentes opções de agrupamento e filtragem) até chegar às informações detalhadas que realmente importam para você.
</p><h2>Experimente</h2>Começar com o Elastic Stack é fácil— você pode baixar vários produtos por meio dos comandos curl fornecidos ou navegar até a nossa página de <a href="/downloads/">downloads</a> e obtê-los lá mesmo. Ou tem um jeito ainda mais fácil, que é executar uma avaliação gratuita por 14 dias do <a href="/cloud/elasticsearch-service/signup">Elasticsearch Service</a> e acessar dali. Se tiver qualquer dúvida, consulte os fóruns do <a href="https://discuss.elastic.co/">Discuss</a>.

monitor-nginx-blog-banner.jpg

monitor-nginx-blog-thumb.jpg

How to monitor NGINX web servers with the Elastic Stack

Como monitorar servidores web NGINX com o Elastic Stack

Start free trial

Blog Footer CTA

Sign up for Elastic Cloud free trial

Kerry Gallagher

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/elastic-cloud-account-terms" target="_self">Terms of Service</a>, and you agree to receive the <a href="/legal/privacy-statement#how-we-use-the-information" target="_self">selected communications</a> at the contact details you provided above. See <a href="/legal/privacy-statement/" target="_self">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p>

Communication Preferences - ONLY for /communication-preferences

<p>Ao enviar a confirmação, você reconhece que leu e concorda com nossos <a href="/pt/legal/elastic-cloud-account-terms" target="_self">Termos de Serviço</a> e também concorda em receber <a href="/pt/legal/privacy-statement#how-we-use-the-information" target="_self">comunicações especiais</a> por meio dos dados de contato que forneceu acima. Consulte a <a href="/pt/legal/privacy-statement/" target="_self">Declaração de Privacidade da Elastic</a> para saber mais detalhes ou para cancelar a qualquer momento.</p>

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/serverless-preview-terms" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p>

Serverless GDPR Text

<p>Ao enviar a confirmação, você reconhece que leu e concorda com nossos <a href="/pt/legal/serverless-preview-terms" target="_self">Termos de Serviço</a> e que a Elastic pode <a href="/pt/legal/privacy-statement#how-we-use-the-information" target="_self">entrar em contato com você</a> para divulgar nossos produtos e serviços relacionados usando os dados que você forneceu acima. Consulte a <a href="/pt/legal/privacy-statement/" target="_self">Declaração de Privacidade da Elastic</a> para saber mais detalhes ou para cancelar a qualquer momento.</p>

<p>By submitting you agree to <a href="/agreements/global/cloud-services-monthly" rel="nofollow">Elastic Cloud Terms of Service</a>. Your personal data will be processed in accordance with <a href="/legal/privacy-statement">Elastic's Privacy Statement</a>.</p>

Cloud Trial GDPR Text

<p>Ao enviar, você concorda com os <a href="/pt/agreements/global/cloud-services-monthly" rel="nofollow">Termos de Serviço do Elastic Cloud</a>. Seus dados pessoais serão tratados de acordo com a <a href="/pt/legal/privacy-statement">Declaração de Privacidade da Elastic</a>.
</p>

<p>By submitting you acknowledge that you've read and agree to our <a href="/legal/terms-of-use" target="_blank">Terms of Service</a>, and that Elastic may <a href="/legal/privacy-statement#how-we-use-the-information" target="_blank">contact you</a> about our related products and services, using the details you provide above. See <a href="/legal/privacy-statement/" target="_blank">Elastic’s Privacy Statement</a> for more details or to opt-out at any time.</p>

Newsletter GDPR Text

<p>Ao enviar a confirmação, você reconhece que leu e concorda com nossos <a href="/pt/legal/terms-of-use" target="_self">Termos de Serviço</a> e que a Elastic pode <a href="/pt/legal/privacy-statement#how-we-use-the-information" target="_self">entrar em contato com você</a> para divulgar nossos produtos e serviços relacionados usando os dados que você forneceu acima. Consulte a <a href="/pt/legal/privacy-statement/" target="_self">Declaração de Privacidade da Elastic</a> para saber mais detalhes ou para cancelar a qualquer momento.</p>

Explore similar demos

Explore outras demonstrações semelhantes

Overview

Load More

Speakers

Close

See more insights

The content on this page is not available in the selected language. As Elastic grows globally, we continue to support content in multiple languages.

The content on this page is not available in the selected language.

O conteúdo desta página não está disponível no idioma selecionado. A Elastic está trabalhando para garantir que o conteúdo esteja disponível em vários idiomas.Agradecemos a compreensão.

Author

Articles by

Learn more

Watch now (no PT)

Watch now

See all top stories

All (no PT translation)

Contact information

Press Release

Share on Reddit

Share this story

Share by Email

Thank you for your interest!

Contact Info

Follow us on Youtube

Share on LinkedIn

Follow us on LinkedIn

Search Integrations

All Solutions

Video for

Follow us on Twitter

See when this webinar starts in my time zone

Consultar a hora de início do webinar no meu fuso horário

Register to Watch

Register now

See All Posts

Can't make it? Register and we'll send you the recording. You'll also receive an email with related content

Não vai conseguir participar? Inscreva-se e nós lhe enviaremos a gravação. Você também receberá um email com conteúdo relacionado.

Author

Articles by Kerry Gallagher

Como monitorar servidores web NGINX com o Elastic Stack

Sign up for Elastic Cloud free trial