Nomeie seu aplicativo .NET

O agente .NET da New Relic oferece várias maneiras de alterar o nome do aplicativo relatado e exibido no APM. Este documento fornece uma visão geral dessas opções de nomenclatura.

Para obter uma visão geral da nomenclatura de aplicativos APM (não específica do .NET), consulte Nomeie seu aplicativo. Para alterar o nome de um aplicativo sem interromper a continuidade dos dados, use a opção interface alias-change.

Defina o nome do seu aplicativo (método recomendado)

Ao implantar seu aplicativo pela primeira vez, você pode alterar o nome padrão para um nome mais descritivo. Como o New Relic coleta métricas usando esses nomes, personalizá-los permite executar a mesma aplicação em vários hosts e obter métricas de todas as suas instâncias.

Normalmente, configurar o arquivo newrelic.config local do aplicativo é o método de nomenclatura mais conveniente.

Método de nomenclatura	Descrição
Recomendado: Configure seu arquivo `newrelic.config` local do aplicativo	Este método permite que você dê ao seu aplicativo um nome exclusivo com definições de configuração específicas. Ele também funciona para aplicativos hospedados em IIS e não IIS. Copie o arquivo `newrelic.config` do diretório inicial do agente para a pasta raiz do seu aplicativo. Default: `%ALLUSERSPROFILE%\New Relic\.NET Agent` Abra a cópia e defina o nome do seu aplicativo da seguinte forma: `<application> <name>App Name</name> </application>` Reinicie seu aplicativo.

Método de nomenclatura

Descrição

Recomendado:

Configure seu arquivo newrelic.config local do aplicativo

Este método permite que você dê ao seu aplicativo um nome exclusivo com definições de configuração específicas. Ele também funciona para aplicativos hospedados em IIS e não IIS.

Copie o arquivo newrelic.config do diretório inicial do agente para a pasta raiz do seu aplicativo.
Default: %ALLUSERSPROFILE%\New Relic\.NET Agent
Abra a cópia e defina o nome do seu aplicativo da seguinte forma:
```
<application>
    <name>App Name</name>
</application>
```
Reinicie seu aplicativo.

Enquanto seu aplicativo estiver ativo, os dados deverão aparecer em alguns minutos. Caso contrário, siga nossos procedimentos de resolução de problemas.

Outros métodos

Se você tiver um uso ou propósito específico em mente, poderá preferir um método de nomenclatura diferente. Aqui está uma lista completa dos métodos alternativos:

Importante

Alguns métodos têm precedência sobre outros. Antes de escolher um método de nomenclatura, certifique-se de entender como sua configuração pode ser afetada.

Método de nomenclatura	Descrição
Configure seu arquivo `web.config`	Se você tiver aplicativos hospedados no IIS e preferir não ter um arquivo `newrelic.config` local, poderá definir as configurações de nomenclatura em seu arquivo `web.config` . For .NET Framework apps: Adicione a seguinte entrada à seção `appSettings` do arquivo e reinicie o aplicativo. `<appSettings> <add key="NewRelic.AppName" value="App Name" /> </appSettings>` For .NET Core apps: Adicione a variável de ambiente `NEW_RELIC_APP_NAME` ao arquivo da seguinte maneira e reinicie o aplicativo. `<aspNetCore processPath="dotnet" arguments=".\MyApp.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="InProcess" > <environmentVariables> <environmentVariable name="NEW_RELIC_APP_NAME" value="App Name" /> </environmentVariables> </aspNetCore>`
Defina o nome do aplicativo usando variáveis de ambiente	Se você deseja definir facilmente os nomes das aplicações durante a implantação do contêiner, defina uma variável de ambiente no ambiente da aplicação.
Nome após pools de aplicativos	Se seus pools de aplicativos do IIS já tiverem nomes exclusivos de sua preferência ou se você estiver usando uma infraestrutura de conteúdo de rede compartilhada (SNCI), você poderá nomear seu aplicativo com base no pool de aplicativos atribuído. Remova quaisquer chaves `NewRelic.AppName` da seção `<appSettings>` em `web.config.` Certifique-se de não excluir a tag `<appSettings>` ao redor. Remova quaisquer elementos filhos `<name>` do elemento pai `<application>` em `newrelic.config`. Certifique-se de não excluir a tag `<application>` ao redor. `<application> <!-- <name>App Name</name> --> </application>` Cada aplicativo reportará de acordo com o nome do pool de aplicativos.
Configure seu arquivo `app.config`	Se você tiver um aplicativo não hospedado no IIS e preferir não ter um arquivo `newrelic.config` local, poderá definir as configurações de nomenclatura em seu arquivo `app.config` .
Use a API do agente .NET	Se quiser renomear seu aplicativo programaticamente, você poderá usar a chamada de API do agente`SetApplicationName()` para definir o nome do aplicativo no tempo de execução. Este nome terá prioridade sobre todas as outras fontes de nomenclatura de aplicativos.

Enquanto seu aplicativo estiver ativo, os dados deverão aparecer em alguns minutos. Caso contrário, certifique-se de ter executado um IISRESET em um prompt de comando administrativo se tiver alterado o arquivo de configuração do seu aplicativo .NET (newrelic.config ou app.config). Caso contrário, siga nossos procedimentos de resolução de problemas.

Use vários nomes de aplicativos

Você pode usar vários nomes de aplicativos para agregar dados do seu aplicativo. Às vezes chamamos isso de “acumulação” de seus dados.

Para o agente .NET, você pode configurar até três nomes de aplicativos. O primeiro nome é o nome principal do aplicativo e o segundo e terceiro nomes são usados para as categorias de agregação de dados mais gerais. Para saber mais sobre como funcionam vários nomes de aplicativos, consulte Usar vários nomes de aplicativos.

Aqui está um exemplo de configuração de vários nomes no arquivo newrelic.config local do aplicativo:

<application>
    <name>Primary App Name</name>
    <name>Second App Name</name>
    <name>Third App Name</name>
</application>

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

Defina o nome do seu aplicativo (método recomendado)

Outros métodos

Importante

Passos

Passos

Importante

Passos

Passos

Use vários nomes de aplicativos

`newrelic.config` arquivo

`web.config` arquivo

`app.config` arquivo

`NEW_RELIC_APP_NAME` variável de ambiente

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

Nomeie seu aplicativo .NET

Defina o nome do seu aplicativo (método recomendado) .css-21sua1{background:none;border:none;width:0;padding:0;}

Outros métodos

Importante

Passos

Passos

Passos

Use vários nomes de aplicativos

newrelic.config arquivo

web.config arquivo

app.config arquivo

NEW_RELIC_APP_NAME variável de ambiente

Defina o nome do seu aplicativo (método recomendado)

`newrelic.config` arquivo

`web.config` arquivo

`app.config` arquivo

`NEW_RELIC_APP_NAME` variável de ambiente