O recurso de serviços externos está disponível para o agente New Relic APM e OpenTelemetry.
Se você quiser começar a trabalhar o mais rápido possível, recomendamos usar nosso agente APM.
Clicar em um logotipo direciona você para a plataforma New Relic, onde você será orientado na instalação e configuração do agente.
Configurar serviços externos
As instruções a seguir orientarão você na configuração de serviços externos.
Comece a enviar dados
A configuração de alterações de serviços externos com base no fato de você estar usando o agente APM ou OpenTelemetry. Selecione a guia da opção de instalação adequada ao seu sistema:
Preencha o seguinte para cada serviço que deseja visualizar em serviços externos:
Se ainda não tiver feito isso, instale o agente New Relic APM apropriado.
Certifique-se de que distributed tracing esteja ativado no agente:
- Se você instalou um novo agente, distributed tracing padrão será ativado por padrão. Se o seu serviço se comunicar com outros serviços que usam o Rastreamento Infinito, consulte a documentação do seu agente para obter ajuda com o Rastreamento Infinito.
- Se você tiver um agente mais antigo, siga as etapas de configuração para ativar distributed tracing padrão ou o rastreamento infinito. Quando você habilita distributed tracing, ele substitui o antigo rastreamento multiaplicativo.
Veja se o seu agente requer etapas adicionais de configuração:
Agente
Versão Mínima
Configurar
Go
3.6.0
Consulte a documentação sobre como usar
NewRoundTripper().Java
5.13.0
Consulte a documentação sobre como usar a API do agente Java para chamadas externas de instrumentos.
.NET
8.29.0
O agente .NET e o agente .NET no Azure instrumentalizam automaticamente chamadas externas, mas não instrumentalizam métodos de transação. Para ver a transação, você precisa usar uma combinação dos seguintes:
Node.js
6.9.0
Consulte a documentação sobre como usar a API do agente Node.js.
PHP
9.12.0.268
Veja a documentação sobre como usar a API do agente PHP para chamadas externas de instrumentos.
Python
5.14.0.142
Nenhuma etapa extra é necessária: As chamadas externas são instrumentadas automaticamente.
Ruby
6.12.0.367
Veja a documentação sobre como usar a API do agente Ruby para chamadas externas de instrumentos.
Dica
A versão clássica de serviços externos ainda estará disponível se você precisar adicionar um novo serviço a uma cadeia de agentes que já utiliza serviços externos clássicos. Para instalar serviços externos clássicos, habilite o rastreamento multiaplicativo em vez do distributed tracing nas etapas abaixo.
A interface do New Relic mostra detalhes de serviços externos depois que você conclui as etapas de configuração da instrumentação OpenTelemetry para seu serviço e as chamadas que ele faz para outros serviços. O recurso de serviços externos mostra chamadas entre seus serviços, divididas por endpoint de transação em cada serviço. O nome de cada transação é derivado do intervalo de entrada do processo (span.kind = "server").
Se o seu serviço APM estiver conectado a um serviço OpenTelemetry (upstream ou downstream), esse serviço OpenTelemetry não aparecerá na visualização desse serviço APM. Isso porque, ao visualizar um serviço APM, este recurso utiliza métricas que são reportadas apenas pelo agente APM. Ao visualizar um serviço OpenTelemetry, o serviço APM aparecerá como uma conexão.
A qualidade das informações que você vê depende da estratégia de amostragem usada no coletor. Consulte a seção a seguir sobre como usar amostragem para controlar o que você vê na interface.
Dica
Se você enviar 100% dos seus dados do OpenTelemetry para nossa API trace , armazenaremos 100% desses dados, a menos que você tenha um limite de taxa específico para sua organização ou se enviar dados suficientes para acionar nosso limite de taxa padrão.
Ajuste a amostragem para ver mais dados da interface
Se você estiver usando um agente APM e estiver vendo poucos ou nenhum dado quando começar a perfurar além da página inicial do mapa, talvez seja necessário ajustar o reservatório de extensão para amostrar mais dados. Isso ocorre porque os dados no nível da transação são preenchidos por dados trace de amostra.
Para o OpenTelemetry, tanto a página inicial quanto todas as páginas de detalhamento são preenchidas por dados de amostra, portanto, talvez seja necessário fazer alguns ajustes na amostragem para obter os dados necessários.
Aqui estão algumas informações sobre as diferentes rotinas de ajuste do reservatório para o agente APM, bem como dicas para ajuste de amostragem para OpenTelemetry:
Todos os agentes APM possuem um reservatório que armazena spans, e a maioria desses reservatórios de agentes são configuráveis. O tamanho deste reservatório afeta a probabilidade de um agente ser capaz de enviar todos os vãos que ele cria. Consulte rastreamento fragmentado para obter mais detalhes.
Os dados para esse recurso são derivados de clientes e servidores adjacentes, onde chamadas externas são feitas de um serviço para outro. Quando um agente atinge seu limite de reservatório de span, há uma chance de ele eliminar alguns spans que representam essas chamadas.
O valor de configuração padrão do agente de 2.000 define o número máximo de eventos que o agente coleta por minuto. Se houver mais intervalos do que esse número, o agente coleta uma amostragem estatística, degradando essencialmente a quantidade de dados usados no mapa de serviços externos.
Se não estiver vendo o tipo de detalhe desejado na interface, você pode aumentar o tamanho do reservatório para até 10.000. Revise o seguinte para ajustar os reservatórios de agente:
Agente APM | Documentação |
|---|---|
Go | O reservatório não é atualmente configurável |
Java | |
.NET | |
Node.js | |
PHP | O reservatório não é atualmente configurável |
Python | Configuração do Python (consulte |
Ruby |
Dica
Esta seção se aplica apenas se seus serviços estiverem enviando dados para o New Relic por meio de um coletor OpenTelemetry. Isso ocorre porque os dados não estão sendo amostrados em um coletor OpenTelemetry.
Para o OpenTelemetry, todas as visualizações de serviços externos são preenchidas por rastreamento de amostra, o que significa que talvez você não veja dados úteis suficientes. Para resolver isso, você pode alterar a amostragem no coletor para permitir mais dados no New Relic.
Consulte Amostragem para dicas sobre configuração.
Qual é o próximo?
- Aprenda como usar serviços externos para solucionar problemas de API
- Saiba mais sobre como navegar na interface de serviços externos.
- Caso tenha dúvidas sobre como entender a interface, veja nossas dicas.