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

• Kubernetes permissions: This installation mode requires cluster-admin permissions for Flux controllers to manage gateway lifecycle (installation, upgrades, scaling).

• Required tools:

  • Helm v3.x or higher (verify with helm version)
  • kubectl CLI with access to your Kubernetes cluster

• New Relic infrastructure agent (optional): Pipeline Control gateway no longer bundles the New Relic infrastructure agent. To view cluster health metrics (CPU usage, memory, and region) in the gateway health dashboard, install the infrastructure agent separately. Refer to Install the Kubernetes integration for installation instructions.

What happens without infrastructure agent:

• Gateway health table will show "N/A" for: CPU usage, memory usage, and region.
• Pipeline configuration and data processing continues to work normally.

Configurar gateway de Controle de Pipeline

To set up 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. Select Full management (with Flux).

6. Configure the gateway:

   • Enter your cluster name.
   • Enter the dedicated Kubernetes namespace where the core gateway infrastructure and manager services will reside. Default is newrelic-agent-control.
   • Enter the specific namespace where individual collection agents will run. Default is 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

   The UI wizard provides the complete value file, values-newrelic-gateway.yaml, with your specific configuration. Download the file and use it with the Helm command.

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 a corporation (The Corp) has two divisions: OrgA (needs 100% of data for audit reasons) and OrgB (needs 1% sampling to control high-volume costs).

With only one fleet, The Corp is stuck. If OrgB applies 1% sampling to save money, OrgA loses 99% of its performance data. One team's cost-control breaks the other team's mission-critical monitoring.

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.
• High-volume fleet: OrgB joins this fleet for 1% sampling and personal data redaction.

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.