Integração do controlador de entrada NGINX

O NGINX Ingress Controller é um balanceador de carga especializado para ambientes Kubernetes (e outros ambientes em contêineres). Um controlador Ingress abstrai a complexidade do roteamento de tráfego do aplicativo Kubernetes e fornece uma ponte entre os serviços Kubernetes e os externos.

O controlador de ingresso NGINX expõe métricas que podem ser coletadas por um servidor ou agente Prometheus. Essas métricas informam sobre conexões de processo em andamento e a carga de entrada atual que seu sistema está manipulando. Essas métricas também informam sobre recarregamentos de configuração de entrada e capacitam a condição do alerta sobre erros de recarregamento de configuração ou alterações inesperadas de configuração.

Use New Relic para aumentar a visibilidade do desempenho do controlador de ingresso NGINX e alertar sobre possíveis erros de configuração. Com New Relic você pode monitor:

• Configuração de monitoramento de reload (erros e última recarga bem sucedida)
• Taxas de transferência facetadas por classes de ingresso
• Insights de solicitação e resposta sobre tamanho da carga e tempo de resposta
• Estatísticas de CPU e memória

Habilite a integração

Siga estas etapas para ativar a integração.

1. Siga a documentação do NGINX Ingress Controller para Prometheus para descobrir o endpoint métrico.

2. Configure o monitoramento do Prometheus. A métrica do Prometheus precisa ser integrada ao New Relic, você pode usar o agente do Prometheus ou a integração Remote Write, veja como enviar a métrica do Prometheus.

   Importante

   O agente Prometheus apenas extrai métricas por padrão de um conjunto de integração.

   Nesse caso, você deve identificar seu pod ou endpoint com um destes rótulos app.kubernetes.io/name, app.newrelic.io/name, k8s-app contendo a string nginx.

3. Use a seguinte consulta para confirmar que as métricas estão sendo ingeridas conforme esperado:

   FROM Metric SELECT count(*) WHERE metricName LIKE 'nginx_%' FACET metricName LIMIT MAX

   Copiar

4. Instale o início rápido do NGINX Ingress Controller para acessar dashboardse alertas integrados.

   Depois de importar, você pode editar ou clonar os ativos para adaptá-los aos seus requisitos específicos.

   Importante

   Alguns gráficos do dashboard incluem consulta de condições que exigem a identificação do seu pod ou endpoint com um destes rótulos app.kubernetes.io/name, app.newrelic.io/name, k8s-app contendo a string nginx.

Encontre e use os dados

Métrica

As métricas do Prometheus são armazenadas como métricas dimensionais. Você pode consultar usando NRQL ou usar o Data Explorer para navegar pelas métricas, facetas disponíveis e filtrar pelas dimensões associadas.

Os diferentes conjuntos de métricas expostos por esta integração estão definidos na documentação do NGINX Ingress Controller.

Use a seguinte consulta NRQL para entender a métrica que está sendo ingerida no New Relic:

• Liste nomes de métricas exclusivos:

  FROM Metric SELECT uniques(metricName) WHERE metricName LIKE 'nginx_%' LIMIT MAX

  Copiar

• Contar o número de atualizações métricas:

  FROM Metric SELECT datapointcount() WHERE metricName LIKE 'nginx_%' LIMIT MAX

  Copiar

• Estimar a ingestão de dados (ingestão diária, em bytes):

  FROM Metric SELECT bytecountestimate() WHERE metricName LIKE 'nginx_%' SINCE 1 day ago

  Copiar

Resolução de problemas

Siga as dicas de resolução de problemas da documentação do NGINX Ingress Controller para garantir que as métricas estejam configuradas conforme esperado em seu cluster.

Você também pode verificar as diretrizes específicas de resolução de problemas para integração do Prometheus.