Configuração do agente .NET

Para o .NET framework, as seguintes variáveis são necessárias:

COR_ENABLE_PROFILING=1
COR_PROFILER={71DA0A04-7777-4EC6-9643-7D28B46A8A41}
NEWRELIC_INSTALL_PATH="INSERT_THE_PATH_TO_THE_AGENT_DIRECTORY"

O instalador do agente Windows .NET (.msi) os adicionará ao IIS por padrão ou como variáveis de ambiente de todo o sistema ao ativar Instrument All.

Ao usar o instalador do agente Windows .NET, certifique-se de que NEWRELIC_INSTALL_PATH esteja configurado como C:\Program Files\New Relic\.NET Agent\. É aqui que as DLLs do agente são colocadas no sistema.

Para obter mais detalhes sobre essas variáveis, bem como valores corretos para outros cenários de instalação, consulte noções básicas sobre variáveis de ambiente do agente .NET.

Ao instalar o agente por meio do pacote Nuget, o agente requer um conjunto diferente de variáveis de ambiente.

Para o .NET Core, as seguintes variáveis são obrigatórias:

Linux:

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
CORECLR_NEWRELIC_HOME=path/to/agent/directory
CORECLR_PROFILER_PATH="${CORECLR_NEWRELIC_HOME}/libNewRelicProfiler.so"

Windows (MSI Installer):

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
NEWRELIC_INSTALL_PATH=C:\Program Files\New Relic\.NET Agent\
CORECLR_NEWRELIC_HOME=C:\ProgramData\New Relic\.NET Agent\

O instalador do agente do Windows .NET adicionará essas variáveis ao IIS por padrão ou como variáveis de ambiente em todo o sistema ao habilitar Instrument All. Exceção: CORECLR_ENABLE_PROFILING precisa ser definido manualmente para instrumentar um aplicativo .NET Core não hospedado no IIS. Consulte Compatibilidade e requisitos do .NET Framework para o aplicativo .NET Framework.

Para obter mais detalhes sobre essas variáveis, bem como valores corretos para outros cenários de instalação, consulte noções básicas sobre variáveis de ambiente do agente .NET.

Ao instalar o agente por meio do pacote Nuget no Windows, o agente requer um conjunto diferente de variáveis de ambiente.

O agente .NET do New Relic depende de variáveis de ambiente para informar ao .NET Common Language Runtime (CLR) para carregar o New Relic em seus processos. As variáveis de ambiente relacionadas à instalação são variáveis da Microsoft, não variáveis da New Relic. Eles podem ser usados por outro criador de perfil .NET e apenas um profiler pode ser anexado a um processo por vez. Por esse motivo, se você usou produtos de monitoramento de aplicativos anteriores, poderá ter conflitos de perfil.

O instalador MSI de 64 bits para o agente .NET da New Relic instala automaticamente o conjunto profiler de 32 bits junto com o conjunto de 64 bits e, a partir da versão 10.16.0, habilita automaticamente o suporte de 32 bits para IIS. Para aplicativos não hospedados no IIS, você pode definir manualmente a variável de ambiente necessária.

COR_PROFILER_PATH_32="C:\Program Files (x86)\New Relic\.NET Agent\NewRelic.Profiler.dll"

Ative ou desative o agente New Relic.

O número máximo de quadros stack a serem trace em qualquer dump stack .

Sua chave de licença do New Relic. A New Relic usa a chave de licença para combinar os dados do seu aplicativo com a conta correta na interface. Defina a chave de licença por meio da variável de ambiente.

Como alternativa, defina a variável de ambiente NEW_RELIC_LICENSE_KEY no ambiente do aplicativo:

NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY

Instrui o agente a registrar informações do ambiente de execução. As informações do ambiente incluem sistema operacional, versão do agente e quais assemblies estão disponíveis.

Bloqueie a inicialização do aplicativo até que o agente se conecte ao New Relic. Se definido como true, a primeira transação poderá levar muito mais tempo para ser concluída, pois será bloqueada até que a conexão com o New Relic seja concluída.

Bloqueie o encerramento do aplicativo enquanto o agente inicia um ciclo final de coleta e envia todos os dados para a New Relic.

Como alternativa, defina a variável de ambiente NEW_RELIC_SEND_DATA_ON_EXIT no ambiente do aplicativo:

NEW_RELIC_SEND_DATA_ON_EXIT=true

O tempo mínimo que o processo deve ser executado antes que o agente bloqueie seu encerramento. Esta configuração se aplica apenas quando sendDataOnExit é true.

Como alternativa, defina a variável de ambiente NEW_RELIC_SEND_DATA_ON_EXIT_THRESHOLD_MS no ambiente do aplicativo:

NEW_RELIC_SEND_DATA_ON_EXIT_THRESHOLD_MS=2000

Se false, o agente usará um encadeamento de pool para concluir o processamento da transação.

Se for verdade, o agente concluirá o processamento da transação no thread de solicitação.

Se false, o agente tentará reutilizar a transação existente quando métodos instrumentados customizados forem encontrados em cenários assíncronos/threaded.

Se true, o agente tenta criar uma nova transação quando métodos instrumentados customizados são encontrados em cenários assíncronos/threaded.

Como alternativa, a variável de ambiente NEW_RELIC_FORCE_NEW_TRANSACTION_ON_NEW_THREAD pode ser usada para controlar esse comportamento.

NEW_RELIC_FORCE_NEW_TRANSACTION_ON_NEW_THREAD=true

O tempo limite da solicitação do agente ao se comunicar com o New Relic.

Inicie automaticamente o agente .NET quando o primeiro método instrumentado for atingido.

Fornece a capacidade de configurar um endpointcompatível com FedRAMP para uso do agente, com o valor gov-collector.newrelic.com.

<service licenseKey="YOUR_LICENSE_KEY"
  host="gov-collector.newrelic.com" />

Você também pode usar a variável de ambiente NEW_RELIC_HOST.

NEW_RELIC_HOST=gov-collector.newrelic.com

Define o host proxy.

Como alternativa, defina a variável de ambiente NEW_RELIC_PROXY_HOST no ambiente do aplicativo.

Define a porta proxy.

Como alternativa, defina a variável de ambiente NEW_RELIC_PROXY_PORT no ambiente do aplicativo.

Opcionalmente, defina um caminho de URI de proxy.

Como alternativa, defina a variável de ambiente NEW_RELIC_PROXY_URI_PATH no ambiente do aplicativo.

Opcionalmente, defina um domínio para usar ao autenticar com o servidor proxy.

Como alternativa, defina a variável de ambiente NEW_RELIC_PROXY_DOMAIN no ambiente do aplicativo.

Opcionalmente, defina um nome de usuário para autenticação.

Como alternativa, defina a variável de ambiente NEW_RELIC_PROXY_USER no ambiente do aplicativo.

Opcionalmente, defina uma senha para autenticação.

Como alternativa, defina a variável de ambiente NEW_RELIC_PROXY_PASS no ambiente do aplicativo.

Para segurança adicional, o agente .NET suporta o uso de uma senha de proxy ofuscada com o atributo passwordObfuscated . A senha do proxy ofuscada é gerada usando o seguinte comando CLI do New Relic :

$
newrelic agent config obfuscate --key OBSCURING_KEY --value "PLAIN_TEXT_PROXY_PASSWORD"

Como alternativa, defina a variável de ambiente NEW_RELIC_PROXY_PASS_OBFUSCATED no ambiente do aplicativo.

Define o nível de detalhe registrado no arquivo de log. Os valores possíveis, em ordem crescente de detalhes, são:

• off

• error

• warn

• info

• debug

• finest

• all

  Como alternativa, defina a variável de ambiente NEWRELIC_LOG_LEVEL no ambiente do aplicativo.

  Importante

  Aumentar o nível de log aumentará o impacto no desempenho do New Relic.

Registra todos os dados enviados e recebidos da New Relic em um arquivo de log auditlog e no arquivo de log padrão.

Envie mensagem do log para o console, além do arquivo de log. Como alternativa, defina a variável de ambiente NEW_RELIC_LOG_CONSOLE no ambiente do aplicativo.

Se desativado, nenhum registro será tentado. Destinado a sistemas de arquivos somente leitura. Como alternativa, defina a variável de ambiente NEW_RELIC_LOG_ENABLED no ambiente do aplicativo.

O diretório para armazenar o arquivo de log gerado pelo agente. Se isso for omitido, um diretório chamado Logs na área de instalação do agente New Relic será usado por padrão.

Como alternativa, defina a variável de ambiente NEWRELIC_LOG_DIRECTORY no ambiente do aplicativo. Você também pode enviar o log do profiler para um diretório personalizado, mas só pode fazer isso com a variável de ambiente NEWRELIC_PROFILER_LOG_DIRECTORY no ambiente do aplicativo:

NEWRELIC_LOG_DIRECTORY=path\to\a\directory
NEWRELIC_PROFILER_LOG_DIRECTORY=path\to\a\directory # not configurable via config file

Define um nome para o arquivo de log. Se você não definir um fileName, o nome será derivado do nome do processo de monitoramento.

Como alternativa, defina a variável de ambiente NEW_RELIC_LOG no ambiente do aplicativo:

NEW_RELIC_LOG=MyApp.log

Define a estratégia de rolagem do arquivo de log do agente. Os valores possíveis são:

• size (padrão): o arquivo de log é transferido quando atinge o tamanho especificado em maxLogFileSizeMB.

• day: o arquivo de log é transferido à meia-noite.

  Como alternativa, defina a variável de ambiente NEW_RELIC_LOG_ROLLING_STRATEGY no ambiente do aplicativo:

  NEW_RELIC_LOG_ROLLING_STRATEGY=day

  Copiar

  Compatível com o agente .NET v10.21.0 e superior.

Define o número de arquivo de log do agente a ser retido por instância do agente. Vários aplicativos em execução no mesmo host criarão, cada um, esse número de arquivos. Quando o número máximo de arquivos de log for atingido, o arquivo de log mais antigo será excluído. Um valor 0 especifica que não há número máximo de arquivos de log.

Como alternativa, defina a variável de ambiente NEW_RELIC_LOG_MAX_FILES no ambiente do aplicativo:

NEW_RELIC_LOG_MAX_FILES=2

Compatível com o agente .NET v10.21.0 e superior.

Define o tamanho máximo do arquivo de log do agente em megabytes antes de ele ser transferido. Válido somente quando logRollingStrategy estiver definido como size. Um valor 0 especifica que não há tamanho máximo de arquivo de log.

Como alternativa, defina a variável de ambiente NEW_RELIC_LOG_MAX_FILE_SIZE_MB no ambiente do aplicativo:

NEW_RELIC_LOG_MAX_FILE_SIZE_MB=100

Compatível com o agente .NET v10.21.0 e superior.

O nome do seu aplicativo .NET é filho do elemento application . A New Relic agregará seus dados de acordo com este nome. Por exemplo, se você tiver dois aplicativos em execução chamados AppA e AppB, você verá dois aplicativos na interface do New Relic: AppA e AppB.

Você também pode atribuir até três nomes ao seu aplicativo. O primeiro nome é o nome principal. Por exemplo:

<application>
  <name>MY APPLICATION PRIMARY</name>
  <name>SECOND APP NAME</name>
  <name>THIRD APP NAME</name>
</application>

Como alternativa, defina a variável de ambiente NEW_RELIC_APP_NAME no ambiente do aplicativo:

NEW_RELIC_APP_NAME=Descriptive Name

Para vários nomes:

NEW_RELIC_APP_NAME="App Name, App Name 2, App Name 3"

Os amostradores coletam informações sobre o consumo de memória e CPU. Defina como true para desativar a amostragem.

Como alternativa, defina a variável de ambiente NEW_RELIC_DISABLE_SAMPLERS no ambiente do aplicativo:

NEW_RELIC_DISABLE_SAMPLERS=true

Define o método HTTP usado ao enviar dados para o New Relic. Defina como true para ativar o uso do método PUT ao enviar dados. O método POST é usado por padrão.

Defina o atributo displayName no elemento processHost em newrelic.config. O elemento processHost é filho do elemento configuration .

<configuration . . . >
  <processHost displayName="CUSTOM_NAME" />
</configuration>

Defina a variável de ambiente NEW_RELIC_PROCESS_HOST_DISPLAY_NAME :

NEW_RELIC_PROCESS_HOST_DISPLAY_NAME="CUSTOM_NAME"

Determina se o agente pesquisa a API de metadados da AWS.

Como alternativa, esse comportamento pode ser controlado por meio da variável de ambiente NEW_RELIC_UTILIZATION_DETECT_AWS :

NEW_RELIC_UTILIZATION_DETECT_AWS=false

Determina se o agente pesquisa a API de metadados do Microsoft Azure.

Como alternativa, esse comportamento pode ser controlado por meio da variável de ambiente NEW_RELIC_UTILIZATION_DETECT_AZURE :

NEW_RELIC_UTILIZATION_DETECT_AZURE=false

Determina se o agente pesquisa a API de metadados do GCP.

Como alternativa, esse comportamento pode ser controlado por meio da variável de ambiente NEW_RELIC_UTILIZATION_DETECT_GCP :

NEW_RELIC_UTILIZATION_DETECT_GCP=false

Determina se o agente pesquisa informações de PCF a partir de variáveis de ambiente.

Como alternativa, esse comportamento pode ser controlado por meio da variável de ambiente NEW_RELIC_UTILIZATION_DETECT_PCF :

NEW_RELIC_UTILIZATION_DETECT_PCF=false

Determina se o agente lê informações Docker do sistema de arquivos.

Como alternativa, esse comportamento pode ser controlado por meio da variável de ambiente NEW_RELIC_UTILIZATION_DETECT_DOCKER :

NEW_RELIC_UTILIZATION_DETECT_DOCKER=false

Determina se o agente pesquisa informações do Kubernetes a partir de variáveis de ambiente.

Como alternativa, esse comportamento pode ser controlado por meio da variável de ambiente NEW_RELIC_UTILIZATION_DETECT_KUBERNETES :

NEW_RELIC_UTILIZATION_DETECT_KUBERNETES=false

Habilite ou desabilite a coleta de atributos. Quando definida como false no elemento atributo principal, esta configuração substitui todas as configurações de atributo para destinos individuais.

Como alternativa, defina a variável de ambiente NEW_RELIC_ATTRIBUTES_ENABLED no ambiente do aplicativo.

Se atributo estiver habilitado, o agente coletará todas as chaves de atributo especificadas nesta lista. Para especificar diversas chaves de atributo, especifique cada uma individualmente. Você também pode usar um caractere curinga * no final de uma chave para corresponder a vários atributos (por exemplo, myApiKey.*). Para mais informações, consulte regras de atributo.

Como alternativa, defina a variável de ambiente NEW_RELIC_ATTRIBUTES_INCLUDE no ambiente do aplicativo. Esta variável de ambiente aceita uma lista delimitada por vírgulas de nomes de atributos.

Se atributo estiver habilitado, o agente não coletará as chaves de atributo especificadas nesta lista. Para especificar diversas chaves de atributo, especifique cada uma individualmente. Você também pode usar um caractere curinga * no final de uma chave para corresponder a vários atributos (por exemplo, myApiKey.*). Para mais informações, consulte regras de atributo.

Como alternativa, defina a variável de ambiente NEW_RELIC_ATTRIBUTES_EXCLUDE no ambiente do aplicativo. Esta variável de ambiente aceita uma lista delimitada por vírgulas de nomes de atributos.

Define como o agente .NET se comportará em nível "global" para pools de aplicativos servidos via IIS. O agente .NET instrumento todos os pools de aplicativos por padrão. Quando true, os pools de aplicativos listados em applicationPool com um atributo instrument definido como false não serão instrumentados.

Essencialmente, quando definida como false, a lista de pools de aplicativos atua como uma lista de permissões. Quando definida como true, a lista de pools de aplicativos atua como uma lista de negações.

Define o comportamento da instrumentação para um pool de aplicativos específico. O atributo name é o nome de um pool de aplicativos. Ative ou desative a criação de perfil no atributo instrument . Defina este aplicativo no atributo name .

Ative ou desative o coletor de erros.

Habilite ou desabilite a captura de evento de erro.

Limite de reservatório para evento de erro.

Uma lista de nomes de classes totalmente qualificados a serem ignorados. O número máximo de combinações de classe de erro e mensagem que SHOULD serão relatadas é 50. Se mais de 50 estiverem listados, somente os primeiros 50 SHOULD serão usados.

Um mapa opcional de nomes de classes totalmente qualificados para uma lista de strings que correspondem a uma substring da mensagem de erro. O número máximo de combinações de classe de erro e mensagem que SHOULD serão relatadas é 50. Se mais de 50 estiverem listados, somente os primeiros 50 SHOULD serão usados.

Lista exceções específicas para não reportar à New Relic. O nome completo da exceção deve ser usado, como System.IO.FileNotFoundException.

Lista códigos de erro HTTP específicos para não reportar à New Relic. Você pode usar códigos de erro HTTP integrais padrão, como apenas 401, ou pode usar códigos de status completos da Microsoft com pontos decimais, como 401.4 ou 403.18. Os códigos de status devem ser iguais ou maiores que 400.

Isso também pode ser configurado via variável de ambiente, especificando vários códigos com uma lista separada por vírgulas:

NEW_RELIC_ERROR_COLLECTOR_IGNORE_ERROR_CODES=401, 403.18

Uma lista de nomes de classes totalmente qualificados a serem marcados conforme esperado. O número máximo de combinações de classe de erro e mensagem que SHOULD serão relatadas é 50. Se mais de 50 estiverem listados, apenas os primeiros 50 SHOULD serão usados

Um mapa opcional de nomes de classes totalmente qualificados para uma lista de strings que correspondem a uma substring da mensagem de erro. O número máximo de combinações de classe de erro e mensagem que SHOULD serão relatadas é 50. Se mais de 50 estiverem listados, apenas os primeiros 50 SHOULD serão usados

Uma lista de códigos de status separados por vírgula. A lista pode incluir intervalos de números inteiros usando um único traço (-) e incluirá o número inteiro inicial e final do intervalo.

Isso também pode ser configurado através da variável de ambiente:

NEW_RELIC_ERROR_COLLECTOR_EXPECTED_ERROR_CODES=401, 501-503

Use este subelemento para personalizar as configurações de atributo do agente para rastreamento de erros. Este subelemento usa as mesmas configurações do elemento attributes principal: enabled, include e exclude.

Ative ou desative o modo de alta segurança. Exemplo:

<highSecurity enabled="true"/>

Como alternativa, defina a variável de ambiente NEW_RELIC_HIGH_SECURITY no ambiente do aplicativo:

NEW_RELIC_HIGH_SECURITY=true

Habilite ou desabilite mensagens de exceção de remoção. Exemplo:

<stripExceptionMessages enabled="true"/>

Ative ou desative o gravador de eventos.

O número máximo de eventos de transação amostrados que o agente pode armazenar na memória de uma só vez. Este será o número máximo de transações que o agente pode enviar por minuto.

Como alternativa, defina a variável de ambiente MAX_TRANSACTION_SAMPLES_STORED no ambiente do aplicativo:

MAX_TRANSACTION_SAMPLES_STORED=500

Use este subelemento para personalizar as configurações de atributo do agente para evento de transação. Este subelemento usa as mesmas configurações do elemento attributes principal: enabled, include e exclude.

Ative ou desative o gravador de eventos.

O número máximo de eventos personalizados amostrados que o agente pode armazenar na memória de uma só vez. Este será o número máximo de eventos personalizados que o agente poderá enviar por minuto.

Como alternativa, defina a variável de ambiente MAX_EVENT_SAMPLES_STORED no ambiente do aplicativo:

MAX_EVENT_SAMPLES_STORED=500

• Se você estiver configurando o agente para AI Monitoring, recomendamos definir o valor como 100000.

Habilite ou desabilite a captura de parâmetro personalizado.

Por padrão, o agente injeta automaticamente o JavaScript do agente do browser. Para desativar a injeção automática, defina esse atributo como false.

Use este subelemento para personalizar as configurações de atributo do seu agente para monitoramento do browser. Este subelemento usa as mesmas configurações do elemento attributes principal: enabled, include e exclude.

Utilize este subelemento para evitar que o agente browser seja injetado em páginas específicas. O elemento é usado da seguinte forma:

<requestPathsExcluded>
  <path regex="url-regex-1"/>
  <path regex="url-regex-2"/>
  ...
  <path regex="url-regex-n"/>
</requestPathsExcluded>

O agente não injetará o agente browser em páginas cuja URL corresponda a uma das expressões regulares especificadas. A expressão regular deve seguir as diretrizes da Microsoft para a classe Regex.

É uma referência ao diretório virtual do caminho em seu aplicativo e não ao URL completo do caminho que você deseja excluir. Por exemplo, para excluir as páginas em https://www.mywebsite.com/mywebpages/ basta inserir /mywebpages/ como o valor regex do caminho.

O elemento requestPathsExcluded deve ser utilizado nos casos em que for impossível ou indesejável utilizar a chamada DisableBrowserMonitoring() . Para minimizar um possível impacto no desempenho, tente usar o mínimo possível de expressões regulares e mantê-las o mais simples possível.

Habilite ou desabilite o rastreamento de consulta lenta.

Habilite ou desabilite o rastreamento da transação.

Define o limite para rastreamento da transação. Se uma transação demorar mais que o limite, ela será elegível para rastreamento. Consulte noções básicas de rastreamento da transação para obter mais informações sobre as regras que regem o rastreamento.

O valor padrão é apdex_f, que define o limite para quatro vezes o valor apdex_t do aplicativo. Para obter mais informações sobre apdex_t, consulte Apdex.

Você também pode definir o limite como um valor de tempo específico em milissegundos.

Selecione uma política de rastreamento de consulta. As opções são off, que não registra nada; obfuscated, que registra uma versão ofuscada da consulta; ou raw, que registra a consulta exatamente como ela é emitida para o banco de dados.

Quando true, o agente captura instruções EXPLAIN para consulta lenta com durações superiores a explainThreshold. Observe que a ativação desse recurso pode ter implicações no desempenho porque os planos são capturados para cada transação até o valor maxExplainPlans .

O agente coleta dados de consulta lenta para consultas que excedem esse limite, juntamente com quaisquer planos de explicação disponíveis, como parte do rastreamento da transação.

O número máximo de segmentos a serem coletados em um rastreamento da transação.

O número máximo de planos de explicação a serem coletados por transação.

Por padrão, maxStackTrace é definido como 0, o que desativa o rastreamento stack como parte de um trace da transação. Se esse valor for maior que 0, o rastreamento stack será capturado para rastreamento da transação.

Use este subelemento para personalizar as configurações de atributo do agente para rastreamento da transação. Este subelemento usa as mesmas configurações do elemento attributes principal: enabled, include e exclude.

Use este subelemento para habilitar a coleta de métricas de instância de armazenamento de dados (como host e porta) para algum driver do banco de dados. Estes são relatados em consulta lenta trace e trace da transação. O valor padrão do atributo enabled é true.

Use este subelemento para habilitar a coleta do nome do banco de dados em consulta lenta trace e trace da transação para algum driver do banco de dados. O valor padrão do atributo enabled é true.

Use este subelemento para habilitar a coleta do parâmetro de consulta SQL no rastreamento de consulta lenta. O valor padrão do atributo enabled é false.

Como alternativa, ative distributed tracing por meio da variável de ambiente NEW_RELIC_DISTRIBUTED_TRACING_ENABLED no ambiente do aplicativo:

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true

Por padrão, as versões suportadas do agente utilizam o cabeçalho newrelic e os cabeçalhos W3C Trace Context para distributed tracing. O cabeçalho distributed tracing newrelic permite interoperabilidade com agentes mais antigos que não suportam cabeçalhos W3C Trace Context . As versões do agente que suportam cabeçalhos W3C Trace Context os priorizarão em relação a newrelic cabeçalhos para distributed tracing.

Se você não quiser utilizar o cabeçalho newrelic, defini-lo como true fará com que o agente exclua o cabeçalho newrelic e use apenas cabeçalhos W3C Trace Context para distributed tracing.

Defina o elemento <spanEvents> como false para desativar por meio do arquivo newrelic.config . Este elemento é filho do elemento <configuration> .

<configuration . . . >
  <spanEvents enabled="false" />
</configuration>

Defina a variável de ambiente NEW_RELIC_SPAN_EVENTS_ENABLED no ambiente do aplicativo:

NEW_RELIC_SPAN_EVENTS_ENABLED=false

O elemento trace_observer identifica um host observador independente do agente. Para obter ajuda para obter uma entrada válida de host do observador trace do Infinite Tracing, consulte Localizar ou criar um endpoint do observador trace .

O observador trace também pode ser configurado usando a variável de ambiente NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_HOST.

Habilitar ou desabilitar rastreamento multiaplicativo

Ative ou desative o gravador de eventos.

O número máximo de eventos de extensão amostrados que o agente pode armazenar na memória por vez. Este será o número máximo de eventos span que o agente pode enviar por minuto.

• Isso também pode ser configurado usando a variável de ambiente NEW_RELIC_SPAN_EVENTS_MAX_SAMPLES_STORED .

• Não recomendamos configurar além de 10k. O servidor limitará os dados a 10k por minuto.

• Se você estiver configurando o agente para AI Monitoring, recomendamos definir o valor como 10000.

  Importante

  Esta opção de configuração está disponível apenas no agente .NET v9.0 ou superior.

Use este subelemento para personalizar as configurações de atributo do agente para o evento span. Este subelemento usa as mesmas configurações do elemento attributes principal: enabled, include e exclude.

Habilite ou desabilite a captura de cabeçalhos de solicitação HTTP. Exemplo:

Como alternativa, defina a variável de ambiente NEW_RELIC_ALLOW_ALL_HEADERS no ambiente do aplicativo:

<allowAllHeaders enabled="true" />
<attributes enabled="true">
   <include>request.headers.*</include>
</attributes>

Habilite ou desabilite todos os recursos de instrumentação de log. Se true, a configuração do sub-recurso individual entrará em vigor. Se false, nenhum recurso de instrumentação de criação de log será ativado.

Ou use a variável de ambiente NEW_RELIC_APPLICATION_LOGGING_ENABLED .

Use este subelemento para habilitar a coleta de métricas de registro em log (como Logging/lines) para estrutura de registro em log .NET comum. O valor padrão do atributo enabled é true.

Ou use a variável de ambiente NEW_RELIC_APPLICATION_LOGGING_METRICS_ENABLED .

Use este subelemento para ativar o encaminhamento do log do seu aplicativo para New Relic. O valor padrão do atributo enabled é true, você também pode usar a variável de ambiente NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED .

O valor padrão do atributo maxSamplesStored é 10000, você também pode usar a variável env NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED para esta configuração. Defina um valor mais baixo para reduzir a quantidade de linhas de log enviadas (pode causar amostragem de log). Defina um valor mais alto para enviar mais linhas de log.

Cada log recebe a mesma prioridade que sua transação associada. log que ocorrem fora de uma transação receberão uma prioridade aleatória. Alguns registros podem não ser incluídos porque são limitados por maxSamplesStored. Por exemplo, se o registro em log maxSamplesStored estiver definido como 10.000 e a transação 1 tiver 10.000 entradas de log, somente as entradas de log da transação 1 serão registradas. Se a transação 1 tiver menos de 10.000 logs, você receberá todos os logs da transação 1. Se ainda houver espaço, você receberá todo o log da transação 2 e assim por diante.

Se após todos os logs de transação amostrados forem registrados, e eles não atingirem o limite em maxSamplesStored, será enviada a mensagem do log de transação que não estava em nossa amostragem. Se sobrar alguma, as mensagens do log fora da transação serão registradas.

Use o atributo logLevelDenyList (ou a variável de ambiente NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LOG_LEVEL_DENYLIST) para filtrar a mensagem do log do nível de log especificado. O valor desse atributo é uma lista de níveis separados por vírgula e que não diferenciam maiúsculas de minúsculas. Fora do caso, a string do nível de log deve corresponder exatamente ao nível de log que está sendo filtrado; curingas e regex não são suportados. Por exemplo, se o valor fosse definido como logLevelDenyList="debug,warn", qualquer mensagem do log com nível de log Debug ou Warn não seria capturada ou encaminhada, mas um log com nível Warning ainda seria enviado para New Relic.

Utilize este subelemento, que é filho do elemento forwarding , para configurar a captura e encaminhamento de dados de contexto de registro (atributo personalizado), nas versões 10.4.0 e superiores do agente.

Defina o atributo enabled como true para ativar a captura e o encaminhamento de dados de contexto de registro para o New Relic. Você também pode usar a variável de ambiente NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_ENABLED. O valor padrão é false.

O atributo include é uma lista separada por vírgula de nomes de atributo a serem incluídos quando a captura de dados de contexto está habilitada. Você também pode usar a variável de ambiente NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_INCLUDE. O valor padrão é uma string vazia, que significa “incluir tudo”.

O atributo exclude é uma lista separada por vírgula de nomes de atributo a serem excluídos quando a captura de dados de contexto está habilitada. Você também pode usar a variável de ambiente NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_EXCLUDE. O valor padrão é uma string vazia, que significa "não excluir nada".

As listas de inclusão e exclusão seguem as mesmas regras de precedência de outras configurações de atributo de agente.

Use este subelemento, que é filho do elemento forwarding , para configurar a adição de seus rótulos (tag) ao log encaminhado pelo agente, nas versões 10.34.0 e superiores do agente.

Defina o atributo enabled como true para habilitar a adição de seus rótulos ao log encaminhado pelo agente. Você também pode usar a variável de ambiente NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_ENABLED. O valor padrão é false.

O atributo exclude é uma lista de nomes de rótulos, separados por vírgulas e sem distinção entre maiúsculas e minúsculas, a serem excluídos quando você habilita rótulos. Você também pode usar a variável de ambiente NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_EXCLUDE. O valor padrão é uma string vazia, o que significa "não excluir nada". Este atributo não suporta curingas ou regex.

Use este subelemento para ativar a decoração do log do seu aplicativo com metadados de vinculação do New Relic. O valor padrão do atributo enabled é false. Algumas alterações de configuração adicionais são necessárias para a decoração log local. Consulte .NET: Configurar logs contextualizados para obter mais informações.

Use este subelemento para permitir que todas as entradas e saídas do evento LLM sejam enviadas para New Relic. O valor padrão do atributo enabled é true. A gravação de conteúdo está desativada no modo de alta segurança.

Observe que se a gravação de conteúdo estiver desabilitada, a contagem token LLM deverá ser fornecida pelos clientes, chamando a APISetLlmTokenCountingCallback . Caso este retorno de chamada não seja fornecido, o agente não poderá fornecer contagem token LLM.

<aiMonitoring enabled="true">
  <recordContent enabled="false" />
</aiMonitoring>

Isso também pode ser configurado através da variável de ambiente:

NEW_RELIC_AI_MONITORING_RECORD_CONTENT_ENABLED=false

Para obter mais informações, consulte Nomeie seu aplicativo .NET.

<appSettings>
  <add key="NewRelic.AppName" value="Descriptive Name" />
</appSettings>

Designa um local alternativo para o arquivo de configuração fora da raiz local do aplicativo ou do local de configuração global. O local inserido deve ser um caminho absoluto.

<appSettings>
  <add key="NewRelic.ConfigFile" value="C:\Path-to-alternate-config-dir\newrelic.config" />
</appSettings>

Para obter mais informações, consulte Nomeie seu aplicativo .NET.

{
  "NewRelic.AppName": "Descriptive Name"
}

Designa um local alternativo para o arquivo de configuração fora da raiz local do aplicativo ou do local de configuração global. O local inserido deve ser um caminho absoluto.

{
  "NewRelic.ConfigFile": "C:Path-to-alternate-config-dir\newrelic.config"
}