Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
Las soluciones de monitoreo .NET distintas de New Relic pueden usar esta API de creación de perfiles. Pero sólo un servicio puede utilizar el generador de perfiles a la vez. Esto significa que si ha utilizado un servicio de monitoreo .NET en el pasado y no lo ha deshabilitado/eliminado por completo, es posible que el generador de perfiles todavía esté en uso, lo que provocará conflictos con el generador de perfiles cuando intente habilitar el agente .NET.
Biblioteca de descarga del agente .NET
La biblioteca de descarga del agente New Relic .NET contiene paquetes de archivos de instalación a los que se hace referencia en procedimientos de instalación específicos. Para obtener más información sobre estos archivos, consulte el archivo ReadMe de la biblioteca de descargas.
Archivos zip para la instalación manual del agente .NET (Windows)
Para instalar manualmente el agente usando un archivo ZIP, elija el archivo correcto para la aplicación que desea monitor:
Vaya al sitio de descarga del agente .NET y obtenga el archivo que coincida con la arquitectura de su aplicación (64 bits o 32 bits):
.NET framework o .NET Core/.NET 5+ (32 bits): NewRelicDotNetAgent_VERSION_x86.zip
.NET framework o .NET Core/.NET 5+ (64 bits): NewRelicDotNetAgent_VERSION_x64.zip
Descomprima la carpeta del agente en la ubicación deseada.
Establezca variables de entorno para el proceso que desea monitor.
Advertencia
No recomendamos configurar estas variables de entorno globalmente. Configurar estas variables de entorno globalmente puede hacer que todos los procesos .NET que se ejecutan en el sistema se instrumenten e informen a New Relic. Si está instalando el agente manualmente, esperamos que tenga los medios para configurar estas variables de entorno solo para los procesos que desea monitor.
Para .NET framework, se requieren las siguientes variables:
Si su aplicación recibe tráfico, los datos deberían aparecer en unos minutos. Si no es así, consulte No aparecen datos.
Necesidad de instrumentación personalizada
Después de instalar un agente .NET, la mayoría de los marcos de aplicaciones .NET informarán automáticamente los datos a su cuenta New Relic. (Consulte la compatibilidad del marco de la aplicación: .NET framework | .NET Core).
Si su aplicación .NET utiliza un framework de aplicación que no está instrumentado automáticamente, o si la aplicación no tiene framework (como una aplicación de consola), después de la instalación deberá configurar manualmente la instrumentación de su aplicación. Estos son los pasos para hacerlo:
Variables de entorno relacionadas con la instalación
La instalación de un agente .NET requiere configurar variables de entorno. Para algunos procedimientos de instalación (como para la aplicación .NET alojada en IIS), estas variables de entorno se configuran automáticamente. Para otros procedimientos de instalación, deberá configurarlos manualmente. Para ver las variables de entorno necesarias tanto para .NET framework como para la aplicación .NET Core, consulte Variables de entorno.
Para instalaciones que requieren que configure manualmente variables de entorno, también puede configurar otras opciones de configuración a través de variables de entorno. He aquí un vistazo a dos que se configuran comúnmente:
License key. La variable de entorno para configurar es:
App name. Se recomienda configurar un nombre de aplicación significativo , pero también puede configurarlo después de la instalación. La variable de entorno es:
El instalador programable son archivos ZIP que contienen un script de PowerShell para instalar el agente .NET. Hay un archivo zip separado para .NET framework frente a .NET Core.
Importante
Recomendamos utilizar el instalador MSI en lugar del instalador programable. Si desea automatizar su instalación, considere ejecutar el instalador MSI desde la línea de comando.
Importante
A partir de la versión 10.0.0 del agente .NET, el instalador programable ya no está disponible. Esta documentación permanece para los clientes que deseen utilizar el instalador programable para una versión anterior.
Para utilizar el instalador programable para instalar el agente .NET para una aplicación de .NET framework :
Asegúrese de tener derechos de administrador para su grupo de administración de Windows. Para obtener más detalles sobre esto, consulte la documentación de permisos.
Descargue el paquete de instalación de secuencias de comandos para .NET framework desde el sitio de descarga. Al descargar o utilizar uno de estos paquetes, acepta los términos de la licencia.
Descomprima el paquete.
Abra un shell de comandos y navegue hasta la carpeta del paquete descomprimido.
Para una instalación sencilla sin opciones, utilice este comando:
bash
$
.\install.cmd -LicenseKey YOUR_LICENSE_KEY
Para instalar con una o más opciones adicionales, utilice el formato siguiente. Consulte la tabla a continuación para obtener una descripción de las opciones de instalación.
Si su aplicación recibe tráfico, los datos deberían aparecer en unos minutos. Si no es así, consulte No aparecen datos.
Opciones de instalación
Descripción
LicenseKey
Required. Tu .
NoIISReset
Opcional. Utilice esta opción para evitar que el instalador inicie un reinicio de IIS.
Importante
Si utiliza esta opción, deberá realizar un restablecimiento de IIS manualmente antes de que New Relic comience a instrumentar cualquier aplicación alojada en IIS.
InstrumentAll
Opcional. De forma predeterminada, el agente .NET implementará todas las aplicaciones alojadas en IIS. Utilice esta opción para habilitar la instrumentación de otros tipos de aplicaciones .NET.
InstallPath
Opcional. Utilice esta opción para elegir una ubicación de instalación diferente. La ubicación de instalación predeterminada es C:\Program Files\New Relic.
Desinstalar el agente con el desinstalador programable:
Sugerencia
Puede agregar la opción Force al script de desinstalación para forzar una desinstalación sin solicitar que reinicie IIS.
Ejecute el siguiente comando para desinstalar el agente .NET:
Tenga en cuenta que se requieren derechos de administrador en un shell elevado (específicamente para seleccionar un directorio log personalizado y realizar un IISReset).
Advertencia
Por razones de seguridad, es necesario ejecutar el script installAgent.ps1 como se muestra a continuación, anteponiendo ./ al nombre del archivo del script, en lugar de anteponer powershell al script. Si ejecuta el script anteponiendo powershell y cualquiera de los argumentos proporcionados (como la ruta de instalación o la ruta de log personalizada) tiene espacios, estos argumentos se dañarán, lo que provocará que el agente se instale en una ubicación que no sea la ubicación prevista, que podría no ser segura.
Para utilizar el instalador programable para instalar el agente .NET para una aplicación .NET Core:
Asegúrese de tener derechos de administrador para su grupo de administración de Windows. Para obtener más detalles sobre esto, consulte la documentación de permisos.
Para instalar con una o más opciones adicionales, use el mismo comando con las opciones deseadas. Para obtener descripciones de las opciones, consulte la tabla a continuación.
La instalación global instrumentará todos los procesos .NET Core en su sistema. Elija la instalación global solo si desea monitorear todos los procesos de .NET Core.
Para una instalación sencilla sin opciones, utilice este comando:
bash
$
./installAgent.ps1 -destinationPATH-installType global -licenseKey YOUR_LICENSE_KEY \
Para instalar con una o más opciones adicionales, use el mismo comando con las opciones deseadas. Para obtener descripciones de las opciones, consulte la tabla a continuación.
Si su aplicación recibe tráfico, los datos deberían aparecer en unos minutos. Si no es así, consulte No aparecen datos.
Opciones de instalación
Descripción
Destination
Required. La ubicación donde está instalado el agente. Esta puede ser una ruta absoluta o relativa. Se requieren cotizaciones de envoltura.
InstallType
Required. Determina si se trata de una instalación local (específica de la aplicación) o global (para todo el sistema).
LicenseKey
Required. Tu .
AppName
Opcional. Establece el nombre de la aplicación predeterminada asociada con la instalación de su agente.
LogDir
Opcional. Establece una ubicación de registro personalizada para el agente. De forma predeterminada, el agente coloca el directorio de registro en el directorio de instalación.
X86
Opcional. Instala la versión de 32 bits del agente en lugar de la versión de 64 bits. New Relic does not recommend instala la versión de 32 bits del agente a nivel global.
ResetIIS
Opcional. Realiza un iisreset después de la instalación.
Importante
Utilice esto únicamente si su aplicación .NET Core está alojada a través de un proxy inverso de IIS.
Force
Opcional. Fuerza el proceso de instalación a sobrescribir una instalación anterior o a instalar en una carpeta existente.
Advertencia
Esto sobrescribe cualquier personalización de configuración. New Relic recomienda hacer una copia de seguridad de su archivo de configuración y de cualquier archivo personalizado de instrumentación antes de forzar una sobreinstalación.
Help
Opcional. Muestra información de uso para este script.