Encontre e corrija problemas em endpoints de API com o módulo certificado da Akita para NGINX Plus

NGINX | 31 de maio de 2023

Se você é responsável por um serviço em produção com qualquer número de usuários, provavelmente entende a frustração de os clientes encontrarem problemas antes de você. Na Akita, queremos resolver esse problema — por isso criamos nosso novo módulo certificado para NGINX Plus.

Neste blog, abordaremos os principais aspectos do módulo, incluindo por que é importante ter uma visão mais ampla do que apenas os logs, maneiras de encontrar e corrigir rapidamente problemas em todo o seu sistema e como o novo módulo da Akita torna essa funcionalidade facilmente acessível aos usuários do NGINX.

Ampliando a visão: dos logs aos endpoints de API

Hoje, inúmeros desenvolvedores se encontram em uma situação lamentável, na qual seus clientes acabaram se tornando, na prática, seu sistema de monitoramento.

Não é que as equipes de software não estejam registrando os erros. Por exemplo, se você usa o NGINX como proxy reverso, recebe todo tipo de informação nos logs do NGINX: data e hora, tamanho e tempo de processamento das solicitações e código de status da resposta. Se você tiver tempo e paciência para procurar, as informações estarão lá.

No entanto, em sistemas com muitas solicitações e respostas diferentes, é fácil se perder em um mar de logs! A menos que você tenha configurado proativamente painéis ou outro tipo de ferramenta para analisar os logs, talvez precise vasculhar milhares — ou até milhões — de linhas de log, tentando identificar possíveis problemas e onde eles começaram. Porém, configurar os métodos adequados de visualização em painéis e monitoramento pode levar semanas, meses ou até trimestres. Além disso, muitas vezes é necessário atualizá-los junto com o código.

Na Akita, acreditamos que é fundamental ampliar a perspectiva, indo dos logs aos endpoints de API. Isso permite que as equipes de software tenham rapidamente uma visão geral dos problemas e pontos críticos, sem perder o nível de detalhamento necessário para identificar a causa. Estamos solucionando a sobrecarga de informações no monitoramento com uma solução de métricas totalmente pronta para uso, que monitora automaticamente métricas de latência e erros — sem exigir alterações no código nem a criação de dashboards. Nossa solução observa passivamente o tráfego da API e o analisa de forma automática para oferecer monitoramento e alertas por endpoint. E o melhor: os usuários podem começar a usá-la em até 15 minutos após o cadastro.

Apresentamos o módulo certificado NGINX Plus da Akita

Temos o prazer de apresentar o módulo Akita, agora disponível para usuários do NGINX. Se você usa o NGINX como servidor de aplicações web, proxy reverso ou gateway de API, agora pode enviar o tráfego da sua API para análise no Akita. Crie uma conta gratuita no Akita, instale o módulo e o agente do Akita e faça uma pequena alteração no arquivo de configuração do NGINX.

Em poucos minutos, você poderá acessar o console da Akita para ver os endpoints da sua API, identificar o que está lento e o que está gerando erros.

Visão geral do console do Akita

O módulo certificado NGINX Plus da Akita oferece aos usuários do NGINX os diversos benefícios da Akita como uma extensão da sua configuração atual do NGINX. A Akita captura o tráfego de uma solicitação HTTP e mede a latência e os erros, ao mesmo tempo que mostra o que está acontecendo no ambiente de produção por meio de painéis predefinidos.

Como funciona o módulo certificado NGINX Plus da Akita

Vamos analisar em detalhes a funcionalidade do módulo e em que momento ele entra em ação. Primeiro, as solicitações são processadas pelo NGINX em várias “fases”, começando pela leitura da solicitação na rede, passando por reescritas e verificações de controle de acesso e terminando com a geração da resposta e de eventuais registros de log. O módulo certificado da Akita para NGINX Plus entra em ação mais adiante nesse processo (na pré-conteúdo fase, após recursos como a reescrita de cabeçalhos), para que possa visualizar a solicitação em um formato o mais semelhante possível ao que o aplicativo recebe. A Akita verifica cada solicitação recebida para determinar se ela está marcada para monitoramento, com base no servidor e no local definidos na configuração do NGINX.

Observação: assim como outros recursos e módulos do NGINX, você pode habilitar o Akita apenas para uma parte do seu serviço web ou configurá-lo por padrão para tudo o que o NGINX disponibiliza.

Na fase seguinte, o módulo registra o corpo da solicitação e o envia ao agente Akita assim que a solicitação é recebida por completo. Esse comportamento é semelhante ao do módulo ngx_http_mirror, pois os mesmos dados são enviados em paralelo tanto para a aplicação quanto para o agente Akita.

Quando o NGINX ou um servidor upstream tem uma resposta pronta, o módulo Akita registra essa resposta (até 1 MB) enquanto ela é transmitida de volta ao cliente. A resposta não sofre atrasos devido a esse armazenamento em buffer, que ocorre em um “filtro de conteúdo” do NGINX capaz de processar cada parte do corpo da resposta à medida que ela fica disponível.

Assim que o tempo de resposta do servidor é conhecido e a resposta é bem-sucedida, ela é espelhada para o agente Akita. O agente associa a solicitação à resposta e, em seguida, tenta analisar o conteúdo do corpo de ambas. Esses dados são ofuscados localmente pelo agente antes de serem enviados à Akita para análise. Isso significa que a Akita vê a estrutura do tráfego da sua API, mas não os valores específicos enviados pelos seus usuários ou a eles.

O módulo certificado da Akita para NGINX Plus identifica automaticamente seus endpoints com base nesse rastreamento do tráfego da aplicação, criando um modelo navegável e disponível para download da sua API e exibindo automaticamente informações sobre latência e erros. Ele permite configurar alertas para a taxa de erros por endpoint, a alta latência de um endpoint específico ou até mesmo um volume inesperadamente alto de chamadas.

Para cada endpoint, o módulo certificado NGINX Plus da Akita permite visualizar:

  • O número de chamadas de API
  • Distribuição dos códigos de resposta HTTP
  • Quanto tempo seu servidor levou para responder

Mais informações sobre como configurar o módulo certificado NGINX Plus da Akita podem ser encontradas aqui.

Comece a usar o módulo certificado NGINX Plus da Akita

A Akita está atualmente em beta aberto. Você pode se inscrever para participar do beta e obter resultados em menos de 30 minutos.


Compartilhar
Tags: API, F5 NGINX, News

Publicações relacionadas no blog

Como o F5 NGINX One aprimora o gerenciamento e a observabilidade
NGINX | 10/10/2024

Como o F5 NGINX One aprimora o gerenciamento e a observabilidade

Descubra como o F5 NGINX One aprimora o gerenciamento e a observabilidade de ambientes híbridos e multicloud ao oferecer um console web centralizado baseado em SaaS, com insights em tempo real, conformidade automatizada e gerenciamento simplificado de configurações.

Do OpenAPI ao NGINX como gateway de API usando uma API declarativa
NGINX | 17/06/2024

Do OpenAPI ao NGINX como gateway de API usando uma API declarativa

Descubra como transformar uma definição de esquema OpenAPI em uma configuração NGINX totalmente funcional, operando como um API Gateway com a segurança de um Web Application Firewall e um Portal do Desenvolvedor, usando uma abordagem declarativa de API.

Como gerenciar picos repentinos de tráfego e sobrecarga do servidor
NGINX | 14/07/2021

Como gerenciar picos repentinos de tráfego e sobrecarga do servidor

Picos de tráfego e sobrecarga de servidores são preocupações sérias para varejistas online em qualquer época, mas especialmente durante a “Cyber Season” de compras de fim de ano. Detalhamos como você pode aproveitar as soluções de entrega de aplicações de nível de produção da NGINX para se preparar para aumentos repentinos de tráfego.

Distribuição segura de chaves privadas SSL com o NGINX
NGINX | 02/04/2019

Distribuição segura de chaves privadas SSL com o NGINX

Descrevemos três maneiras progressivamente mais seguras de proteger chaves privadas SSL ao configurar o NGINX para processar tráfego HTTPS: permitir acesso de leitura apenas ao usuário root, criptografar as chaves com senhas armazenadas separadamente e distribuir as senhas a partir de um repositório central.

Agrupando solicitações de API em lotes com NGINX Plus e o módulo JavaScript do NGINX
NGINX | 24/05/2018

Agrupando solicitações de API em lotes com NGINX Plus e o módulo JavaScript do NGINX

O módulo JavaScript do NGINX lançado com o NGINX Plus R15 oferece suporte a subsolicitações, possibilitando uma classe totalmente nova de casos de uso para o NGINX Plus. Este exemplo completo também usa a API do NGINX Plus e os módulos de chave-valor para converter solicitações de API dos clientes em solicitações separadas para as APIs dos microsserviços que compõem um aplicativo.

Como superar o esgotamento de portas efêmeras no NGINX e no NGINX Plus
NGINX | 19/04/2016

Como superar o esgotamento de portas efêmeras no NGINX e no NGINX Plus

Confira dicas para evitar o esgotamento de portas efêmeras com ajustes no kernel do Linux, conexões keepalive e conexões vinculadas dinamicamente a endereços IP locais.