• /
  • EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

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

Recursos de instalação do agente .NET

Este documento contém descrições detalhadas de recursos e procedimentos mencionados nos procedimentos de instalação do agente .NET.

Importante

Este documento não deve ser lido como um documento independente. Para obter instruções de instalação, consulte Instalação do agente .NET.

Profiler .NET da Microsoft

O agente .NET da New Relic depende da API de criação de perfil da Microsoft para relatar dados do seu aplicativo .NET.

Soluções de monitoramento .NET diferentes da New Relic podem usar esta API de criação de perfil. Mas apenas um serviço pode usar o profiler por vez. Isso significa que se você usou um serviço de monitoramento .NET no passado e não o desabilitou/removeu completamente, o profiler ainda pode estar em uso, o que causará conflitosprofiler quando você tentar habilitar o agente .NET.

Biblioteca de download do agente .NET

A biblioteca de download do agente .NET da New Relic contém pacotes de arquivos de instalação que são referenciados em procedimentos de instalação específicos. Para obter mais informações sobre esses arquivos, consulte o arquivo ReadMe da biblioteca de download.

Arquivos zip para instalação manual do agente .NET (Windows)

Para instalar manualmente o agente usando um arquivo ZIP, escolha o arquivo correto para o aplicativo que deseja monitor:

  1. Acesse o site de download do agente .NET e obtenha o arquivo correspondente à arquitetura do seu aplicativo (64 ou 32 bits):

    • Framework .NET ou .NET Core/.NET 5+ (32 bits): NewRelicDotNetAgent_VERSION_x86.zip
    • Framework .NET ou .NET Core/.NET 5+ (64 bits): NewRelicDotNetAgent_VERSION_x64.zip
  2. Descompacte a pasta do agente no local desejado.

  3. Defina variáveis de ambiente para o processo que você deseja monitor.

    Cuidado

    Não recomendamos definir essas variáveis de ambiente globalmente. Definir essas variáveis de ambiente globalmente pode fazer com que todos os processos .NET em execução no sistema sejam instrumentados e reportados ao New Relic. Se você estiver instalando o agente manualmente, esperamos que você tenha meios para definir essas variáveis de ambiente apenas para os processos que deseja monitor.

  4. Reinicie seu aplicativo. Se estiver usando o IIS, reinicie o IIS.

Se seu aplicativo estiver recebendo tráfego, os dados deverão aparecer em alguns minutos. Caso contrário, consulte Nenhum dado aparece.

Necessidade de instrumentação personalizada

Depois de instalar um agente .NET, a maioria dos aplicativos .NET framework reportará automaticamente os dados para sua conta New Relic. (Consulte compatibilidade de estrutura de aplicativo: .NET framework | .NET Core.)

Se o seu aplicativo .NET usa uma framework de aplicativo que não é instrumentada automaticamente ou se o aplicativo não possui nenhuma framework (como um aplicativo de console), após a instalação você precisará configurar manualmente a instrumentação do seu aplicativo. Aqui estão as etapas para fazer isso:

  1. Siga as instruções de instalação relevantes para seu aplicativo e framework.
  2. Instrumento personalizado em seu aplicativo para definir qual atividade será reportada ao New Relic.

Variáveis de ambiente relacionadas à instalação

A instalação de um agente .NET requer a configuração de variáveis de ambiente. Para alguns procedimentos de instalação (como aplicativos .NET hospedados no IIS), essas variáveis de ambiente são definidas automaticamente. Para outros procedimentos de instalação, você terá que configurá-los manualmente. Para ver as variáveis de ambiente necessárias para o aplicativo .NET framework e .NET Core, consulte Variáveis de ambiente.

Para instalações que exigem a definição manual de variáveis de ambiente, você também pode definir outras opções de configuração por meio de variáveis de ambiente. Aqui está uma olhada em dois que são comumente definidos:

  • License key. A variável de ambiente para definir é:

    NEW_RELIC_LICENSE_KEY = YOUR_LICENSE_KEY

    Você também pode definir isso no arquivo newrelic.config ou no arquivo de configuração do aplicativo.

  • App name. É recomendado definir um nome de aplicativo significativo , mas você também pode definir isso após a instalação. A variável de ambiente é:

    NEW_RELIC_APP_NAME = YOUR_APP_NAME

    Você também pode definir isso por meio do newrelic.config, do arquivo de configuração do aplicativo ou da API.

Instalador programável (somente Windows)

O instalador programável são arquivos ZIP que contêm um script do PowerShell para instalação do agente .NET. Há um arquivo zip separado para .NET framework versus .NET Core.

Importante

Recomendamos usar o instalador MSI em vez do instalador programável. Se você deseja automatizar sua instalação, considere executar o instalador MSI na linha de comando.

Importante

A partir da versão 10.0.0 do agente .NET, o instalador programável não está mais disponível. Esta documentação permanece para clientes que desejam usar o instalador programável para uma versão mais antiga.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.