Instalar o gateway de Controle de Pipeline sem o Flux

Ao instalar o gateway do Controle de Pipeline no modo de apenas configuração, você pode continuar a gerenciar o ciclo de vida da configuração do seu pipeline (amostragem, filtragem, transformações) pela interface da New Relic enquanto gerencia a infraestrutura do gateway (escalonamento, versões) usando comandos do Kubernetes e do Helm.

Quando usar este modo de instalação

Escolha este modo de instalação se:

• Suas políticas de segurança restringem o acesso de cluster-admin.
• Você precisa de controle direto sobre o escalonamento e as atualizações da infraestrutura.
• Você se sente confortável gerenciando recursos do Kubernetes usando comandos do kubectl e do Helm.
• Você está implantando em ambientes orientados à conformidade.

O que você obtém:

• Gerenciamento da configuração do seu pipeline (amostragem, filtragem, transformações) pela interface.
• Menores requisitos de permissões. O New Relic só precisa de acesso ConfigMap (não cluster-admin) para implantar configurações de pipeline.
• Controle direto sobre o escalonamento e as versões do gateway.

O que você mesmo gerencia:

• Escalonamento da infraestrutura de gateway via Kubernetes Horizontal Pod Autoscaler (HPA)
• Atualizações de versão do Gateway via comandos Helm

Considerações sobre o uso do gateway

Ao integrar e usar o componente de gateway, tenha estas considerações em mente:

gerenciamento de atributos e dados

• Suporte a atributos: O gateway usa convenções semânticas do OpenTelemetry para atributos. Consulte a documentação do gateway para detalhes sobre os atributos suportados.
• Manipulação de dados/atributos: O gateway encaminha suas requests para descarte de dados ou atributos, rastreamento e rastreamento diretamente para o New Relic sem modificação.

Análise e integração de dados

• Análise de log: o gateway não inclui a análise do Grok para logs. Você pode precisar de métodos alternativos para estruturar dados de log para consulta e visualização.
• Integração do Prometheus: o gateway não oferece suporte ao remote write do Prometheus para métricas.

Licenciamento e conformidade

• Gerenciamento de chave de licença: o gateway não acomoda múltiplas chaves de licença de fontes nativas do OpenTelemetry Protocol (OTLP), como agentes coletores ou SDKs APM.
• Padrões de conformidade: O gateway não é compatível com FedRAMP, o que pode afetar seu uso se você precisar atender aos padrões de segurança federais.

Pré-requisitos

• Permissões do Kubernetes: este modo de instalação requer apenas permissões CREATE/UPDATE de ConfigMap (não cluster-admin).

• Ferramentas necessárias:

  • Helm v3.x ou superior (verifique com helm version)
  • kubectl CLI com acesso ao seu cluster do Kubernetes

• Agente de infraestrutura do New Relic (opcional): o gateway do Controle de Pipeline não inclui mais o agente de infraestrutura do New Relic. Para visualizar as métricas de saúde do cluster (uso de CPU, memória e região) no dashboard de saúde do gateway, instale o agente de infraestrutura separadamente. Consulte Instale a integração do Kubernetes para obter instruções de instalação.

O que acontece sem o agente de infraestrutura:

• A tabela de integridade do gateway exibirá "N/A" para: uso de CPU, uso de memória e região.
• A configuração do Pipeline e o processamento de dados continuam funcionando normalmente.

Instalar gateway de Controle de Pipeline

Para instalar o gateway de Controle de Pipeline sem o Flux:

1. Na sua conta New Relic , em integração e agente, clique em Set up Pipeline Control ou pesquise por gateway e selecione Pipeline Control gateway.

2. Certifique-se de que a conta selecionada é aquela que você deseja usar para o Controle de Pipeline. Caso contrário, clique em Select an account, selecione a conta de sua escolha e clique em Continue.

3. Para inserir suas credenciais, forneça uma chave de licença existente ou crie uma nova chave. Se você criar uma nova chave, copie a chave. Em seguida, clique em Continue.

4. Selecione ou crie uma frota de gateways:

   • Selecione uma frota existente se você deseja que seu novo gateway compartilhe uma configuração existente (regras de amostragem, filtragem e transformação) com outros gateways na sua organização.
   • Insira um nome exclusivo de frota de gateway se precisar de uma configuração nova e isolada para um ambiente específico ou unidade de negócios.

5. Selecione Configuration only (without Flux).

6. Configure o gateway:

   • Insira o nome do seu cluster.
   • Insira um namespace para as instalações de gateway e Controle do agente. O padrão é newrelic.

7. Instalar o Agent Control:

   bash

   Copiar

   $
   helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && helm upgrade --install agent-control-deployment newrelic/agent-control-deployment -n newrelic --create-namespace --values agent-control-deployment-values.yaml

   Dica

   O assistente da interface fornece o arquivo de valores completo (agent-control-deployment-values.yaml) com sua configuração específica. Baixe este arquivo e use-o com o comando Helm.

8. Verifique a instalação do controle do agente e, em seguida, clique em Continue.

9. Configure as configurações do gateway (réplicas mínimas, réplicas máximas, limite de CPU). Essas configurações criam a configuração inicial do HPA do Kubernetes. Após a instalação, as alterações nessas configurações via interface não são aplicadas. Você deve gerenciar o escalonamento via HPA diretamente.

10. Instalar gateway:

    bash

    Copiar

    $
    helm upgrade --install newrelic-pcg newrelic/pipeline-control-gateway -n newrelic --create-namespace --values pipeline-control-gateway-values.yaml

    Dica

    O assistente da interface fornece o arquivo de valores completo (pipeline-control-gateway-values.yaml) com sua configuração específica. Baixe este arquivo e use-o com o comando Helm.

11. Clique em Continue.

12. Clique em Test connection e aguarde a conexão bem-sucedida.

Para ver detalhes da configuração do seu gateway, acesse New Relic Control e clique em Gateway.

Por que usar múltiplas frotas?

Imagine que uma corporação (The Corp) tenha duas divisões: OrgA (precisa de 100% dos dados por motivos de auditoria) e OrgB (precisa de 1% de amostragem para controlar custos de alto volume).

Com apenas uma frota, The Corp está presa. Se a OrgB aplicar 1% de amostragem para economizar dinheiro, a OrgA perderá 99% dos seus dados de desempenho. O controle de custos de uma equipe quebra o monitoramento de missão crítica da outra equipe.

Ao usar múltiplas frotas, a The Corp pode separar seus "cérebros":

• Frota de missão crítica: OrgA se junta a esta frota para obter 100% de retenção de dados.
• Frota de alto volume: OrgB se junta a esta frota para amostragem de 1% e ocultação de dados pessoais.

Como resultado, equipes separadas agora podem gerenciar regras exclusivas de amostragem, segurança e conformidade sem afetar o restante da organização.

Gerenciar o gateway após a instalação

Após a instalação, a página de configurações do gateway na interface do New Relic exibe:

• Versão do gateway - Exibida como somente leitura

• Dois botões de alternância editáveis:

  • Coletar logs de diagnóstico sobre o gateway - Habilitar/desabilitar o logging de diagnóstico
  • Ignorar regras de gateway se a CPU disponível ficar baixa - Alternar o desvio de regras durante restrições de recursos

Para gerenciar a infraestrutura de gateway (escalonamento e versões), use estas abordagens:

Alterar configurações de dimensionamento do gateway

Para modificar as réplicas mínimas/máximas ou os limites de CPU, atualize seu HPA do Kubernetes:

Opção 1: editar o HPA diretamente Use isso para testes rápidos ou ajustes temporários, resposta imediata a problemas de escalonamento ou quando nenhuma atualização do Helm for necessária.

1. Visualizar o HPA atual:

   bash

   Copiar

   $
   kubectl get hpa -n newrelic

   Este exemplo assume que o namespace é newrelic. Se você estiver usando um namespace diferente, altere-o de acordo aqui e nos comandos a seguir.

2. Editar HPA diretamente:

   bash

   Copiar

   $
   kubectl edit hpa pipeline-control-gateway-hpa -n newrelic

   Aqui, pipeline-control-gateway-hpa é o HPA que você está editando. Altere para o nome do seu HPA.

   No editor, modifique os campos necessários e, em seguida, salve e saia. Suas alterações são aplicadas imediatamente.

3. Verifique suas alterações:

   bash

   Copiar

   $
   kubectl get hpa pipeline-control-gateway-hpa -n newrelic

   Confirme se suas alterações foram aplicadas verificando se a saída mostra seus novos valores para as configurações que você modificou.

Opção 2: atualização via Helm

1. Edite seu arquivo pipeline-control-gateway-values.yaml .

2. Correr:

   bash

   Copiar

   $
   helm upgrade newrelic-pcg newrelic/pipeline-control-gateway -n newrelic --values pipeline-control-gateway-values.yaml

3. Verifique suas alterações:

   bash

   Copiar

   $
   kubectl get hpa -n newrelic

Atualizar a versão do gateway

Para atualizar a versão do gateway de Controle de Pipeline:

1. Atualize a versão do chart no seu comando Helm:

   bash

   Copiar

   $
   helm upgrade newrelic-pcg newrelic/pipeline-control-gateway --namespace newrelic --version <NEW_VERSION> --values pipeline-control-gateway-values.yaml

2. Verifique a atualização:

   bash

   Copiar

   $
   helm list -n newrelic
   $
   kubectl get pods -n newrelic

Alterações de configuração do Pipeline

Estes são tratados pela interface:

• Regras de amostragem
• Filtros de remoção
• Regras de transformação
• Amostragem condicional

As alterações na configuração do pipeline são implantadas automaticamente via atualizações do ConfigMap, mesmo neste modo.

Adicionar mais cluster

Para adicionar um novo cluster à configuração do seu gateway:

1. Abra o New Relic Control e selecione Gateway.
2. Na tabela de cluster, clique em Add a cluster.
3. Siga as instruções de instalação acima.
4. Volte para a página de resumo do gateway. Você deverá ver seu cluster recém-adicionado.

Após criar seus clusters de gateway, configure o processamento do pipeline usando a configuração YAML. Consulte Configuração do gateway.