New Relic Flex: crie sua própria integração

New Relic fornece integração e início rápido para muitos serviços e estruturas populares. Se você já usa o New Relic e deseja relatar dados de um serviço para o qual não temos integração, há várias maneiras de criar sua própria integração:

• Com monitoramento de infraestrutura, você pode usar nossa ferramenta Flex leve (recomendada, documentada abaixo) ou, para construir uma integração completa no host, consulte nosso SDK de integração.
• Para soluções de monitoramento de telemetria (métrica, trace), utilize nossos SDKs de telemetria.
• Crie um aplicativo New Relic personalizado que use sua própria funcionalidade de interface JavaScript.

O que é Flex?

New Relic Flex é uma ferramenta completa e independente de aplicativo que permite coletar dados métricos de uma ampla variedade de serviços. Ele vem junto com nosso agente de infraestrutura. Você pode instrumentar qualquer aplicativo que exponha métricas sobre um protocolo padrão (HTTP, arquivo, shell) em um formato padrão (por exemplo, JSON ou texto simples): você cria um arquivo de configuração YAML, inicia o agente de infraestrutura e seus dados são relatado à New Relic.

O Flex pode enviar dados de eventos e métricas para New Relic a partir de uma ampla variedade de fontes. Usando um arquivo de configuração YAML simples, você pode executar solicitações HTTP/HTTPS, executar comandos shell e analisar o conteúdo do arquivo. Você também pode usar expressões regex padrão para personalizar e controlar os dados coletados dessas entradas. Veja um exemplo de configuração.

Depois de coletar e limpar os dados, você pode consultar os dados do Flex no New Relic, criar gráficos personalizados para eles e usar esses dados em seu painel.

Requisitos

Flex vem com nosso agente de infraestrutura versão 1.10.7 ou superior (atualizar | verificar versão) rodando em Linux, Windows ou Kubernetes.

Como funciona o Flex?

O Flex utiliza infraestrutura para executar comandos que geram os dados que você deseja reportar. Aqui está uma breve visão geral de como o Flex funciona para relatar dados:

1. Você define os dados que deseja relatar em um arquivo de configuração YAML, localizado no pacote do agente de infraestrutura. Veja um exemplo de configuração:

   Configuração de exemplo

   A seguir é apresentado um exemplo de configuração Flex para monitoramento do tempo de operação de um servidor Linux. Esta configuração é colocada em um arquivo chamado flex-uptime.yml. Isso seria colocado na seção de configuração de integração do agente de infraestrutura, localizada em /etc/newrelic-infra/integrations.d/flex-uptime.yml.

   integrations:
     - name: nri-flex    
       config:
         name: linuxUptimeIntegration
         apis:
           - name: Uptime
             commands:
               - run: 'cat /proc/uptime'
                 split: horizontal
                 split_by: \s+
                 set_header: [uptimeSeconds,idletimeSeconds]

   Copiar

   Algumas notas sobre o que esta configuração faz:

   • run define o comando a ser executado.
   • O nome indicado por name: Uptime é anexado a Sample para gerar um evento chamado UptimeSample.
   • O nome não deve começar com o prefixo ESX ou PCF.
   • O split_by: \s+ divide os campos com base no caractere de espaço.
   • O comando gera um atributo anexado ao evento UptimeSample . Os atributo são nomeados uptimeSeconds e idletimeSeconds.

2. O agente de infraestrutura executa o Flex em uma frequência baseada em sua própria configuração (padrão: a cada 30 segundos) e envia os dados para o New Relic.

3. Você pode então consultar seus dados, criar gráficos personalizados com eles e adicioná-los ao painel.

Resolução de problemas

Quando você encontrar um problema com a configuração do Flex, primeiro siga estas etapas básicas de resolução de problemas:

• Teste a configuração sem o agente de infraestrutura: você pode testar manualmente um arquivo de configuração para garantir que a saída atenda às suas expectativas executando um comando como este, substituindo <FILE_NAME> pelo nome do seu arquivo de configuração:

# Linux default path: /opt/newrelic-infra/newrelic-integrations/bin/ 
./nri-flex -verbose -pretty -config_path /etc/newrelic-infra/integrations.d/<FILE_NAME>

# Windows default path: C:\Program Files\New Relic\newrelic-infra\newrelic-integrations
.\nri-flex.exe -verbose -pretty -config_path "C:\Program Files\New Relic\newrelic-infra\integrations.d\<FILE_NAME>"

Isso fornecerá uma saída mostrando o log de depuração e a carga JSON que será integrada ao agente de infraestrutura. Certifique-se de que o Flex esteja obtendo e formatando sua telemetria conforme esperado antes de continuar com o restante das etapas de resolução de problemas. Saiba mais sobre como testar a configuração do Flex no repositório GitHub.

• Teste com o agente de infraestrutura no modo dry-run : use a sinalização de simulação no agente de infraestrutura para testar sua configuração Flex. Verifique se a saída contém a telemetria que você espera que seja relatada à New Relic.
• Depure a integração com o agente de infraestrutura: Por fim, certifique-se de que o agente esteja reportando os dados de telemetria conforme esperado, habilitando o log de depuração no agente de infraestrutura.

Saber mais

A integração Flex vem junto com o agente de infraestrutura e pode ser configurada como qualquer outra integração no host. Saiba mais sobre as opções de configuração.

Veja mais documentação do Flex no GitHub:

• Leia-me
• Tutorial