Ao trabalhar com seus dados APM no New Relic, você pode querer visualizar dados agregados e "acumulados" para um aplicativo que abrange vários clusters, ambientes ou data centers, mas também poder visualizar cada um dos dados da instância do aplicativo separadamente. Você pode fazer isso definindo vários nomes de aplicativos para seus aplicativos de monitor APM.
Antes que você comece
Aqui estão algumas advertências importantes que você deve observar ao usar vários nomes de aplicativos.
Soluções alternativas
Como a adição de vários nomes de aplicativos resulta no relatório de dados duplicados, convém considerar essas outras opções.
Se o seu objetivo é filtrar mais facilmente seus dados de telemetria por atributo (por exemplo, filtrar por região do agente), recomendamos uma destas opções:
- Adicione tag por meio do arquivo de configuração do agente (por exemplo, esta configuração Java)
- Adicionar atributo personalizado
Como outra opção para organizar os dados do seu aplicativo, você pode definir limites de desempenho distintos para cada ambiente usando condição do alerta e transação principal. Esses limites serão aplicados aos aplicativos individuais, enquanto o aplicativo agregado geral não terá seu próprio limite. O aplicativo geral tratará os dados recebidos de acordo com o limite do ambiente relevante.
Dados duplicados
O uso de vários nomes de aplicativos resulta na geração de eventos e métricas duplicados, que são contados como dados ingeridos. Por exemplo, se o seu aplicativo monitor New Relic tiver três nomes de aplicativos definidos, ele reportará três vezes o evento e a métrica.
Se quiser usar vários nomes de aplicativos e não uma das soluções alternativas abaixo, você pode usar regras de eliminação de dados para eliminar algum evento específico que não precisa.
Prioridade de nomes
A ordem dos nomes dos aplicativos na configuração do agente é importante. Para obter mais informações, consulte Definir nomes de aplicativos.
Como funciona o uso de vários nomes de aplicativos
Normalmente, quando duas instâncias relatam com o mesmo nome de aplicativo, idioma do agente e chave de licença, a New Relic agrega seus dados em um único aplicativo monitor da New Relic. Você também pode visualizar dados de hosts e instâncias individuais na página New Relic APM Overview do aplicativo.
Para segmentar seu aplicativo de uma maneira diferente ou para trabalhar com cada instância como um aplicativo individual enquanto mantém a visão geral dos dados, use o arquivo de configuração do agente New Relic para fornecer ao aplicativo até três nomes agregar diferentes. A New Relic reportará os dados do aplicativo separadamente para cada aplicativo listado no arquivo de configuração.
Por exemplo, você pode querer separar os dados coletados para seu aplicativo em execução no desenvolvimento, preparação e ambiente de produção, mas também ter uma visão comum do aplicativo em todos os ambientes. Ou, se você tiver dois data centers executando o mesmo código, poderá nomear um aplicativo EastCoastApp;AggregateApp e o segundo como WestCoastApp;AggregateApp.
Acumule dados do browser
Ao usar vários nomes para relatar dados do aplicativo, quaisquer dados desse aplicativo também serão agrupados em vários aplicativos usando a mesma configuração.
Importante
Os dados de repetição e trace de sessão, que são reportados ao endpoint de blobs, não oferecem suporte a vários relatórios de aplicativos. Somente o aplicativo principal, ou o primeiro listado, obterá os dados. Outros dados do navegador serão preenchidos em cada um dos três aplicativos.
Defina nomes de aplicativos do mais para o menos específico
Você pode atribuir a cada aplicativo até três nomes, que o New Relic usa para agregar dados do mais ao menos específico. Você pode então usar a interface do New Relic para visualizar os dados de cada nome de aplicativo individualmente, bem como de forma agregada para o desempenho geral do aplicativo. Ao fazer isso, a ordem em que você especifica os nomes dos aplicativos é importante.
Using multiple names | Comments |
|---|---|
Mais específico | Um nome agregador exclusivo. |
Um nome de rollup compartilhado para agregar dados na interface do New Relic. Isso fornece uma organização mais geral. | |
Opcional, menos específico | Um nome adicional e compartilhado para agregar. Se usado, este é o nome mais geral que a New Relic usa para agregar dados em um único aplicativo. |
Nomeie a instância do aplicativo por meio do arquivo de configuração do agente
A convenção de nomenclatura usada no arquivo de configuração depende do agente New Relic. Defina a ordem dos nomes do seu aplicativo para que o primeiro nome agregado seja o mais exclusivo.
O segundo e o terceiro nomes podem ser exclusivos ou podem ser iguais. O segundo nome é mais geral para dados agregados e o terceiro nome (se usado) é o mais geral.
Agent | Configuration file value |
|---|---|
C | Identifique no máximo três nomes separados por ponto e vírgula |
Go | Defina |
Java | Defina |
.NET | Use qualquer uma das opções disponíveis para nomear seu aplicativo .NET. |
Node.js | Defina |
PHP | Use qualquer uma das opções disponíveis para nomear seu aplicativo PHP. Use três nomes separados por ponto e vírgula. |
Python | Defina |
Ruby | Defina |
Para obter mais informações, consulte a documentação do arquivo de configuração do seu agente.
Exemplos
Aqui estão alguns exemplos de como você pode usar vários nomes agregados para um único aplicativo.