O New Relic conecta o métrica a aplicativos individuais usando sua chave de licença e o nome principal do aplicativo. Você pode alterar o nome do aplicativo em seu arquivo de configuração ou atribuir um alias ao aplicativo para alterar a forma como ele aparece na interface do New Relic.
Importante
Se você não especificar o nome do aplicativo no arquivo de configuração do New Relic, a maioria dos agentes do New Relic fornecerá um nome de aplicativo genérico por padrão. Para garantir que todos os dados agregados do mesmo aplicativo sejam relatados com precisão, forneça um nome descritivo a cada aplicativo.
Alterando o nome versus o alias
Você pode atribuir um novo nome ao aplicativo ou alterar o alias do aplicativo. Eles têm dois efeitos diferentes:
Prazo | How to change it | Effect |
|---|---|---|
Nome | Alterar o nome do aplicativo no arquivo de configuração do agente fará com que o aplicativo se reporte a um novo cabeçalho na interface do usuário do New Relic, com total descontinuidade de dados. Isto é útil, por exemplo, se você quiser recomeçar e relatar novos dados. Se nenhum outro agente estiver reportando ao nome antigo do aplicativo, o nome antigo do aplicativo aparecerá em cinza e poderá ser excluído. | |
Alias | A criação de um alias para o nome do aplicativo altera apenas a forma como o nome do aplicativo aparece na interface do New Relic. A alteração do alias não afeta a forma como os dados são relatados. Ele simplesmente ajuda você a controlar seus dados com um alias útil. |
Dê a cada aplicativo um nome descritivo
Por padrão, a maioria dos agentes New Relic fornece um nome de aplicativo padrão, como My Application ou PHP Application, para cada aplicativo vinculado à sua conta.
Importante
Recomendamos alterar o nome padrão de um aplicativo para um nome mais descritivo antes da implantação, e ele pode ter até 128 caracteres.
Cada nome de aplicativo exclusivo cria um novo registro de aplicativo na interface do New Relic, que permite:
- Execute um aplicativo em mais de um host e tenha todos os dados agregados (coletados) sob o mesmo nome.
- Execute vários aplicativos em um único host e tenha todos os dados agregados (coletados) sob nomes diferentes.
Atribua o nome em seu arquivo de configuração
Para alterar o nome do aplicativo, defina o valor do nome do aplicativo no arquivo de configuração do agente. Se você implantou um aplicativo por meio de um agente APM e, em seguida, implantou outro aplicativo com o mesmo nome por meio de um agente APM diferente, a New Relic anexará automaticamente o nome do idioma do agente ao final do nome do segundo aplicativo. Por exemplo, se você implantar um aplicativo Node.js chamado New-App e, em seguida, implantar um aplicativo .NET chamado New-App, o New Relic anexará automaticamente o segundo nome do aplicativo como New-App (DOTNET).
Para garantir a conformidade com as convenções de nomenclatura, observe que os símbolos < e > não são permitidos no nome do aplicativo. Se estes símbolos forem incluídos, eles serão removidos automaticamente. Certifique-se de que o nome do seu aplicativo atenda a esse requisito.
Agent | Configuration file value |
|---|---|
C | Identifique no máximo três nomes separados por ponto e vírgula |
Go | Defina |
Java | Veja as opções para nomear seu aplicativo Java. |
.NET | Use qualquer uma das opções disponíveis para nomear seu aplicativo .NET. |
Node.js | Defina |
PHP | Veja as opções para nomear seu aplicativo PHP. |
Python | Defina |
Ruby | Defina |
Alterar o alias do aplicativo
O nome do aplicativo definido na interface do usuário do New Relic é um alias legível por humanos. Se você renomear seu aplicativo, o nome visível será atualizado em todos os lugares da interface do New Relic, inclusive em aplicativos de browser vinculados.
Inicialmente, esse alias é igual ao nome do identificador do aplicativo no arquivo de configuração do agente New Relic. No entanto, alterar o alias da interface does not afeta o nome do aplicativo subjacente usado para agregar dados, que é definido no arquivo de configuração do agente. O aplicativo deve relatar dados ativamente para alterar o alias. Alterar o alias da interface fará com que todos os agentes que reportam sob o identificador do aplicativo sejam reiniciados.
Para alterar o alias do nome do seu aplicativo na interface do usuário do New Relic:
Vá para
one.newrelic.com > All capabilities > APM & services > (select an app) > Settings > Application
.
No campo
Application alias
, digite um novo nome (alias) para o aplicativo selecionado.
Selecione
Save application settings
.
Você também pode alterar o alias do aplicativo com a API REST New Relic.
Dica
Quando você faz uma alteração por meio de Application settings, a alteração salva reinicia o agente. Somente o agente desse serviço específico será reiniciado, mas a ação não reiniciará seus pools de aplicativos ou servidores Web.
Usando vários nomes para um aplicativo
Ao fornecer vários nomes ao seu aplicativo, você pode agregar métricas para vários agentes em um aplicativo ou serviço inteiro.
Importante
Se você usar vários nomes para um aplicativo, o sobrenome atribuído será o nome menos específico que a New Relic usa para acumular os dados. Para obter melhores resultados, visualize o conjunto de dados agregados e em nível de instância, a ordem dos nomes agregados do seu aplicativo, do mais específico para o menos específico, em seu arquivo de configuração.