Configurar e implantar o gateway Controle de Pipeline

Configure e implante o gateway Controle de Pipeline para gerenciar o fluxo de dados da sua entidade monitorada para o New Relic.

Considerações sobre o uso do gateway

Ao integrar e usar o componente de gateway, aqui estão algumas considerações importantes que você deve ter 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 logs: O gateway não inclui a análise do Grok para logs. A análise Grok é um método usado para extrair dados estruturados de mensagens de log não estruturadas usando padrões predefinidos e expressões regulares.Você pode precisar de métodos alternativos para estruturar dados de log para consulta e visualização.
• Integração com o Prometheus: O gateway não oferece suporte à gravação remota do Prometheus para o Métrica, o que pode afetar sua integração com sistemas baseados no Prometheus.

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 agente coletor ou SDKs APM . Considere isso ao gerenciar suas licenças.
• 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 exige permissões de cluster-admin para os controladores do Flux gerenciarem o ciclo de vida do gateway (instalação, atualizações, escalonamento).

• 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.

Configurar gateway de Controle de Pipeline

Para configurar o gateway:

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 Full management (with Flux).

6. Configure o gateway:

   • Insira o nome do seu cluster.
   • Insira o namespace dedicado do Kubernetes onde a infraestrutura principal do gateway e os serviços do gerenciador residirão. O padrão é newrelic-agent-control.
   • Insira o namespace específico onde os agentes de coleta individuais serão executados. O padrão é newrelic.

7. Baixe o arquivo de configuração, values-newrelic-gateway.yaml para um diretório.

8. Execute o comando de instalação mostrado na tela:

   bash

   Copiar

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

   Dica

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

9. Clique em Continue.

10. 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.

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 na configuração do gateway.
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.