Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Nomeie ou altere o nome do seu aplicativo

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

Atribua o nome em seu arquivo de configuração

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

Altere o alias na interface de configurações do APM

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 ;em seu newrelic_app_config_t* config;.

Go

Defina AppName com no máximo três nomes separados por ponto e vírgula.

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 app_name com no máximo três nomes separados por vírgula. Coloque os nomes entre aspas simples ou duplas. (Ou altere a variável de ambiente NEW_RELIC_APP_NAME.)

PHP

Veja as opções para nomear seu aplicativo PHP.

Python

Defina app_name com no máximo três nomes separados por ponto e vírgula. Não adicione espaço após o ponto e vírgula, ou o próximo nome será interpretado como um comentário.

Ruby

Defina app_name com no máximo três nomes separados por ponto e vírgula.

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:

  1. Vá para

    one.newrelic.com > All capabilities > APM & services > (select an app) > Settings > Application

    .

  2. No campo

    Application alias

    , digite um novo nome (alias) para o aplicativo selecionado.

  3. 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.