Application Insights para aplicaciones de ASP.NET Core

En este artículo se describe cómo habilitar Application Insights para una aplicación de ASP.NET Core. Al completar las instrucciones de este artículo, Application Insights recopilará solicitudes, dependencias, excepciones, contadores de rendimiento, latidos y registros de la aplicación de ASP.NET Core.

El ejemplo que vamos a usar aquí es una aplicación de MVC que tiene como destino netcoreapp3.0. Estas instrucciones se pueden aplicar a todas las aplicaciones de ASP.NET Core. Si usa el Servicio de trabajo, siga las instrucciones que encontrará aquí.

Escenarios admitidos

El SDK de Application Insights para ASP.NET Core puede supervisar sus aplicaciones, independientemente de dónde y cómo se ejecuten. Si la aplicación se está ejecutando y tiene conectividad de red a Azure, se pueden recopilar datos de telemetría. La supervisión de Application Insights se admite siempre y cuando .NET Core sea compatible. La compatibilidad abarca lo siguiente:

• Sistema operativo: Windows, Linux o Mac.
• Método de hospedaje: en el proceso o fuera del proceso.
• Método de implementación: marco dependiente o independiente.
• Servidor web: IIS (Internet Information Server) o Kestrel.
• Plataforma de hospedaje: característica Web Apps de Azure App Service, VM de Azure, Docker, Azure Kubernetes Service (AKS), etc.
• Versión de .NET Core: todas las versiones de .NET Core compatibles oficialmente que no están en versión preliminar.
• IDE: Visual Studio, Visual Studio Code o la línea de comandos.

Requisitos previos

• Una aplicación de ASP.NET Core en funcionamiento. Si necesita crear una aplicación de ASP .NET Core, siga este tutorial de ASP.NET Core.
• Una clave de instrumentación de Application Insights válida. Esta clave es necesaria para enviar los datos de telemetría a Application Insights. Si necesita crear un nuevo recurso de Application Insights para obtener un clave de instrumentación, consulte Creación de recursos en Application Insights.

Habilitación de la telemetría de Application Insights del lado servidor (Visual Studio)

En caso de Visual Studio para Mac, use las instrucciones manuales. Solo la versión de Windows de Visual Studio admite este procedimiento.

1. Abra el proyecto en Visual Studio.

   Sugerencia

   Para realizar un seguimiento de todos los cambios que Application Insights realiza, puede configurar el control de código fuente para el proyecto. Para realizar esta configuración, seleccione Archivo > Agregar al control de código fuente.

2. Seleccione Proyecto > Agregar Telemetría de Application Insights.

3. Seleccione Comenzar. Dependiendo de la versión de Visual Studio, el nombre de este botón puede variar. En algunas versiones anteriores, se trataba del botón Comenzar gratis.

4. Seleccione la suscripción y luego seleccione Recurso > Registrar.

5. Después de agregar Application Insights al proyecto, confirme que está usando la versión estable más reciente del SDK. Vaya a Proyecto > Administrar paquetes NuGet > Microsoft.ApplicationInsights.AspNetCore. Si es necesario, seleccione Actualizar.

   

6. Si agregó el proyecto al control de código fuente, vaya a Ver > Team Explorer > Cambios. Puede seleccionar cada archivo para ver una vista de las diferencias de los cambios realizados por la telemetría de Application Insights.

Habilitación de la telemetría de Application Insights del lado servidor (sin Visual Studio)

1. Instale el SDK de Application Insights desde el paquete de NuGet para ASP.NET Core. Se recomienda que use siempre la versión estable más reciente. Consulte las notas de la versión completa para el SDK en el repositorio de GitHub de código abierto.

   En el siguiente ejemplo de código se muestran los cambios que se agregarán al archivo .csproj del proyecto.

       <ItemGroup>
         <PackageReference Include="Microsoft.ApplicationInsights.AspNetCore" Version="2.16.0" />
       </ItemGroup>
   

2. Agregue services.AddApplicationInsightsTelemetry(); al método ConfigureServices() en su clase Startup, como en este ejemplo:

       // This method gets called by the runtime. Use this method to add services to the container.
       public void ConfigureServices(IServiceCollection services)
       {
           // The following line enables Application Insights telemetry collection.
           services.AddApplicationInsightsTelemetry();
   
           // This code adds other services for your application.
           services.AddMvc();
       }
   

3. Comprobar la clave de instrumentación.

   Aunque puede proporcionar la clave de instrumentación como un argumento a AddApplicationInsightsTelemetry, se recomienda que especifique la clave de instrumentación en la configuración. En el siguiente ejemplo de código se muestra cómo especificar una clave de instrumentación en appsettings.json. Asegúrese de que appsettings.json se copia en la carpeta raíz de la aplicación durante la publicación.

       {
         "ApplicationInsights": {
           "InstrumentationKey": "putinstrumentationkeyhere"
         },
         "Logging": {
           "LogLevel": {
             "Default": "Warning"
           }
         }
       }
   

   Como alternativa, puede especificar la clave de instrumentación en cualquiera de las siguientes variables de entorno:

   • APPINSIGHTS_INSTRUMENTATIONKEY

   • ApplicationInsights:InstrumentationKey

   Por ejemplo:

   • SET ApplicationInsights:InstrumentationKey=putinstrumentationkeyhere

   • SET APPINSIGHTS_INSTRUMENTATIONKEY=putinstrumentationkeyhere

   • Normalmente, APPINSIGHTS_INSTRUMENTATIONKEY se utiliza en Azure Web Apps, pero también se puede usar en todos los lugares donde se admita este SDK. (Si va a realizar la supervisión de aplicaciones web sin código, este formato es necesario si no está usando cadenas de conexión).

   En lugar de establecer las claves de instrumentación, ahora también puede utilizar Cadenas de conexión.

   Nota

   Una clave de instrumentación especificada en el código prevalece frente a la variable del entorno APPINSIGHTS_INSTRUMENTATIONKEY, que prevalece sobre otras opciones.

Secretos de usuario y otros proveedores de configuración

Si desea almacenar la clave de instrumentación en los secretos de usuario de ASP.NET Core o recuperarla de otro proveedor de configuración, puede usar la sobrecarga con un parámetro Microsoft.Extensions.Configuration.IConfiguration. Por ejemplo, services.AddApplicationInsightsTelemetry(Configuration);. A partir de la versión 2.15.0 de Microsoft.ApplicationInsights.AspNetCore, al llamar a services.AddApplicationInsightsTelemetry() se lee automáticamente la clave de instrumentación desde Microsoft.Extensions.Configuration.IConfiguration de la aplicación. No es necesario proporcionar explícitamente el valor de IConfiguration.

Ejecución de la aplicación

Ejecute la aplicación y realícele solicitudes. Ahora, la telemetría debería fluir hacia Application Insights. El SDK de Application Insights recopila automáticamente las solicitudes web entrantes en la aplicación, junto con la telemetría siguiente.

Live Metrics

Live Metrics se puede usar para comprobar rápidamente si la supervisión de Application Insights está configurada correctamente. La telemetría puede tardar unos minutos en aparecer en el portal y el análisis, pero Live Metrics muestra el uso de la CPU del proceso en ejecución casi en tiempo real. También puede mostrar otros tipos de telemetría, como las solicitudes, las dependencias y los seguimientos.

Registros de ILogger

La configuración predeterminada recopila los registros ILogger Warning y los registros más graves. Puede Personalizar esta configuración.

Dependencias

La recopilación de dependencias está habilitada de manera predeterminada. En este artículo se explican las dependencias que se recopilan automáticamente; también contiene pasos para realizar el seguimiento manual.

Contadores de rendimiento

La compatibilidad con los contadores de rendimiento en ASP.Net Core es limitada:

• Las versiones 2.4.1 y posteriores del SDK recopilan contadores de rendimiento si la aplicación se ejecuta en Azure Web Apps (Windows).
• Las versiones 2.7.1 y posteriores del SDK recopilan contadores de rendimiento si la aplicación se ejecuta en Windows y tiene como destino NETSTANDARD2.0 o una versión posterior.
• Para las aplicaciones que tienen como destino .NET Framework, todas las versiones del SDK admiten contadores de rendimiento.
• Las versiones 2.8.0 y posteriores del SDK admiten el contador de CPU/memoria de Linux. No se admite ningún otro contador en Linux. La manera recomendada de obtener contadores del sistema en Linux (y otros entornos que no son Windows) es mediante EventCounters.

EventCounter

EventCounterCollectionModule está habilitado de forma predeterminada. Para obtener información sobre cómo configurar la lista de contadores que se recopilarán, consulte Introducción a EventCounters.

Habilitación de la telemetría del lado cliente para aplicaciones web

Los pasos anteriores son suficientes para ayudarle a empezar a recopilar datos de telemetría del lado servidor. Si la aplicación tiene componentes del lado cliente, siga estos pasos para comenzar a recopilar telemetría de uso.

1. En _ViewImports.cshtml, agregue la inserción:

    @inject Microsoft.ApplicationInsights.AspNetCore.JavaScriptSnippet JavaScriptSnippet

2. En _Layout.cshtml, inserte HtmlHelper al final de la sección <head> pero antes de cualquier otro script. Si quiere informar de cualquier telemetría de JavaScript desde la página, insértela después de este fragmento de código:

    @Html.Raw(JavaScriptSnippet.FullScript)
    </head>

Como alternativa al uso de FullScript, ScriptBody está disponible a partir del SDK de Application Insights para ASP.NET Core, versión 2.14. Úselo si necesita controlar la etiqueta <script> para establecer una directiva de seguridad de contenido:

 <script> // apply custom changes to this script tag.
     @Html.Raw(JavaScriptSnippet.ScriptBody)
 </script>

Los nombres del archivo .cshtml mencionados anteriormente son de una plantilla de la aplicación de MVC predeterminada. En última instancia, si desea habilitar correctamente la supervisión del lado cliente para la aplicación, el fragmento de código de JavaScript debe aparecer en la sección <head> de cada página de la aplicación que quiere supervisar. Para hacer esto en esta plantilla de aplicación, agregue el fragmento de código de JavaScript a _Layout.cshtml.

Si el proyecto no incluye _Layout.cshtml, aún puede agregar la supervisión del lado cliente. Para ello, agregue el fragmento de código de JavaScript a un archivo equivalente que controle el objeto <head> de todas las páginas de la aplicación. O bien, puede agregar el fragmento de código en varias páginas, pero esta solución es difícil de mantener y no se recomienda.

Configuración del SDK de Application Insights

Puede personalizar el SDK de Application Insights para ASP.NET Core para cambiar la configuración predeterminada. Es posible que los usuarios de los SDK de Application Insights ASP.NET estén familiarizados con el cambio de configuración mediante el uso de ApplicationInsights.config o modificando TelemetryConfiguration.Active. En ASP.NET Core, realice casi todos los cambios de configuración en el método ConfigureServices() de su clase Startup.cs, a menos que se indique lo contrario. Para más información, consulte las siguientes secciones.

Uso de ApplicationInsightsServiceOptions

Puede modificar algunos ajustes de configuración comunes pasando de ApplicationInsightsServiceOptions a AddApplicationInsightsTelemetry, como se muestra en este ejemplo:

public void ConfigureServices(IServiceCollection services)
{
    Microsoft.ApplicationInsights.AspNetCore.Extensions.ApplicationInsightsServiceOptions aiOptions
                = new Microsoft.ApplicationInsights.AspNetCore.Extensions.ApplicationInsightsServiceOptions();
    // Disables adaptive sampling.
    aiOptions.EnableAdaptiveSampling = false;

    // Disables QuickPulse (Live Metrics stream).
    aiOptions.EnableQuickPulseMetricStream = false;
    services.AddApplicationInsightsTelemetry(aiOptions);
}

Esta tabla contiene la lista completa de valores ApplicationInsightsServiceOptions:

Para obtener una lista más actualizada, vea los valores configurables en ApplicationInsightsServiceOptions.

Recomendación de configuración para la versión 2.15.0 y posterior del SDK de Microsoft.ApplicationInsights.AspNetCore

En la versión 2.15.0 y posteriores del SDK de Microsoft.ApplicationInsights.AspNetCore, se recomienda configurar cada valor disponible en ApplicationInsightsServiceOptions, incluido InstrumentationKey, mediante la instancia IConfiguration de la aplicación. La configuración debe estar en la sección "ApplicationInsights", como se muestra en el ejemplo siguiente. La siguiente sección de appSettings.json configura la clave de instrumentación y deshabilita el muestreo adaptable y la recopilación de contadores de rendimiento.

{
    "ApplicationInsights": {
    "InstrumentationKey": "putinstrumentationkeyhere",
    "EnableAdaptiveSampling": false,
    "EnablePerformanceCounterCollectionModule": false
    }
}

Si se utiliza services.AddApplicationInsightsTelemetry(aiOptions), se invalida la configuración de Microsoft.Extensions.Configuration.IConfiguration.

muestreo

El SDK de Application Insights SDK para ASP.NET Core admite el muestreo adaptable y el de tipo fijo. El muestreo adaptable está habilitado de forma predeterminada.

Para obtener más información, consulte Configuración del muestreo adaptable para aplicaciones ASP.NET Core.

Adición de TelemetryInitializers

Cuando quiera enriquecer la telemetría con información adicional, use inicializadores de telemetría.

Agregue cualquier nuevo objeto TelemetryInitializer al contenedor DependencyInjection tal como se muestra en el código siguiente. El SDK recoge automáticamente cualquier objeto TelemetryInitializer que se agregue al contenedor DependencyInjection.

public void ConfigureServices(IServiceCollection services)
{
    services.AddSingleton<ITelemetryInitializer, MyCustomTelemetryInitializer>();
}

Eliminación de Telemetryinitializer

Los inicializadores de telemetría están presentes de forma predeterminada. Para quitar todos los inicializadores de telemetría o solo algunos específicos, use el siguiente código de ejemplo después de llamar a AddApplicationInsightsTelemetry().

public void ConfigureServices(IServiceCollection services)
{
    services.AddApplicationInsightsTelemetry();

    // Remove a specific built-in telemetry initializer
    var tiToRemove = services.FirstOrDefault<ServiceDescriptor>
                        (t => t.ImplementationType == typeof(AspNetCoreEnvironmentTelemetryInitializer));
    if (tiToRemove != null)
    {
        services.Remove(tiToRemove);
    }

    // Remove all initializers
    // This requires importing namespace by using Microsoft.Extensions.DependencyInjection.Extensions;
    services.RemoveAll(typeof(ITelemetryInitializer));
}

Adición de procesadores de telemetría

Puede agregar procesadores de telemetría personalizados a TelemetryConfiguration mediante el método de extensión AddApplicationInsightsTelemetryProcessor en IServiceCollection. Los procesadores de telemetría se usan en escenarios de filtrado avanzado. Use el ejemplo siguiente.

public void ConfigureServices(IServiceCollection services)
{
    // ...
    services.AddApplicationInsightsTelemetry();
    services.AddApplicationInsightsTelemetryProcessor<MyFirstCustomTelemetryProcessor>();

    // If you have more processors:
    services.AddApplicationInsightsTelemetryProcessor<MySecondCustomTelemetryProcessor>();
}

Configuración o eliminación de objetos TelemetryModules predeterminados

Application Insights usa módulos de telemetría para recopilar automáticamente información de telemetría útil sobre cargas de trabajo específicas sin necesidad de ninguna configuración adicional.

Los siguientes módulos de recopilación automática están habilitados de forma predeterminada. Estos módulos son responsables de recopilar automáticamente datos de telemetría. Puede deshabilitarlos o configurarlos para modificar su comportamiento predeterminado.

• RequestTrackingTelemetryModule: recopila información de RequestTelemetry de las solicitudes web entrantes.
• DependencyTrackingTelemetryModule: recopila información de DependencyTelemetry de llamadas HTTP salientes y llamadas SQL.
• PerformanceCollectorModule: recopila información de PerformanceCounters de Windows.
• QuickPulseTelemetryModule: recopila telemetría para mostrar en el portal de Live Metrics.
• AppServicesHeartbeatTelemetryModule: recopila latidos (que se envían como métricas personalizadas) sobre el entorno de Azure App Service donde se hospeda la aplicación.
• AzureInstanceMetadataTelemetryModule: recopila latidos (que se envían como métricas personalizadas) sobre el entorno de las máquinas virtuales de Azure donde se hospeda la aplicación.
• EventCounterCollectionModule: recopila EventCounters; este módulo es una característica nueva y está disponible en la versión 2.8.0 y versiones posteriores del SDK.

Para configurar cualquier objeto TelemetryModule predeterminado, use el método de la extensión ConfigureTelemetryModule<T> en IServiceCollection, como se muestra en el ejemplo siguiente.

using Microsoft.ApplicationInsights.DependencyCollector;
using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector;

public void ConfigureServices(IServiceCollection services)
{
    services.AddApplicationInsightsTelemetry();

    // The following configures DependencyTrackingTelemetryModule.
    // Similarly, any other default modules can be configured.
    services.ConfigureTelemetryModule<DependencyTrackingTelemetryModule>((module, o) =>
            {
                module.EnableW3CHeadersInjection = true;
            });

    // The following removes all default counters from EventCounterCollectionModule, and adds a single one.
    services.ConfigureTelemetryModule<EventCounterCollectionModule>(
            (module, o) =>
            {
                module.Counters.Add(new EventCounterCollectionRequest("System.Runtime", "gen-0-size"));
            }
        );

    // The following removes PerformanceCollectorModule to disable perf-counter collection.
    // Similarly, any other default modules can be removed.
    var performanceCounterService = services.FirstOrDefault<ServiceDescriptor>(t => t.ImplementationType == typeof(PerformanceCollectorModule));
    if (performanceCounterService != null)
    {
        services.Remove(performanceCounterService);
    }
}

En las versiones 2.12.2 y posteriores, ApplicationInsightsServiceOptions incluye una opción sencilla para deshabilitar cualquiera de los módulos predeterminados.

Configuración de un canal de telemetría

El Canal de telemetría predeterminado es ServerTelemetryChannel. El ejemplo siguiente muestra cómo reemplazarlo.

using Microsoft.ApplicationInsights.Channel;

    public void ConfigureServices(IServiceCollection services)
    {
        // Use the following to replace the default channel with InMemoryChannel.
        // This can also be applied to ServerTelemetryChannel.
        services.AddSingleton(typeof(ITelemetryChannel), new InMemoryChannel() {MaxTelemetryBufferCapacity = 19898 });

        services.AddApplicationInsightsTelemetry();
    }

Deshabilitar la telemetría dinámicamente

Si desea deshabilitar la telemetría condicional y dinámicamente, puede resolver la instancia TelemetryConfiguration con el contenedor de inyección de dependencias de ASP.NET Core en cualquier parte del código y establecer DisableTelemetry como marca.

    public void ConfigureServices(IServiceCollection services)
    {
        services.AddApplicationInsightsTelemetry();
    }

    public void Configure(IApplicationBuilder app, IHostingEnvironment env, TelemetryConfiguration configuration)
    {
        configuration.DisableTelemetry = true;
        ...
    }

El ejemplo de código anterior impide el envío de telemetría a Application Insights. No impide que los módulos de recopilación automática recopilen la telemetría. Si quiere quitar un módulo de recopilación automática particular, vea Quitar el módulo de telemetría.

Preguntas más frecuentes

¿Admite Application Insights ASP.NET Core 3.X?

Sí. Actualice a la versión 2.8.0 o posterior del SDK de Application Insights para ASP.NET Core. Las versiones anteriores del SDK no admiten ASP.NET Core 3.X.

Además, si va a habilitar la telemetría del servidor basada en Visual Studio, actualice a la última versión de Visual Studio 2019 (16.3.0) para la incorporación. Las versiones anteriores de Visual Studio no admiten la incorporación automática de aplicaciones ASP.NET Core 3.X.

¿Cómo puedo realizar un seguimiento de la telemetría que se recopila automáticamente?

Obtenga una instancia de TelemetryClient mediante el uso de la inserción del constructor y llame al método TrackXXX() necesario que incluye. No se recomienda crear nuevas instancias TelemetryClient o TelemetryConfiguration en una aplicación de ASP.NET Core. Una instancia singleton de TelemetryClient ya está registrada en el contenedor DependencyInjection, que comparte TelemetryConfiguration con el resto de los datos de telemetría. Se recomienda crear una nueva instancia TelemetryClient solo si se necesita una configuración independiente del resto de los datos de telemetría.

En el ejemplo siguiente se muestra cómo realizar el seguimiento de los datos de telemetría adicionales desde un controlador.

using Microsoft.ApplicationInsights;

public class HomeController : Controller
{
    private TelemetryClient telemetry;

    // Use constructor injection to get a TelemetryClient instance.
    public HomeController(TelemetryClient telemetry)
    {
        this.telemetry = telemetry;
    }

    public IActionResult Index()
    {
        // Call the required TrackXXX method.
        this.telemetry.TrackEvent("HomePageRequested");
        return View();
    }

Para obtener más información acerca de los datos personalizados que reporta Application Insights, consulte API de Application Insights para eventos y métricas personalizados. Se puede usar un enfoque similar para el envío de métricas personalizadas a Application Insights mediante la API de GetMetric.

¿Cómo puedo personalizar la colección de registros de ILogger?

De forma predeterminada, solo se capturan automáticamente los registros Warning y los registros más graves. Para cambiar este comportamiento,debe invalidar explícitamente la configuración de registro del proveedor ApplicationInsights tal como se muestra a continuación. La siguiente configuración permite que Application Insights capture todos los registros Information y los registros más graves.

{
  "Logging": {
    "LogLevel": {
      "Default": "Warning"
    },
    "ApplicationInsights": {
      "LogLevel": {
        "Default": "Information"
      }
    }
  }
}

Es importante tener en cuenta que lo siguiente no hará que el proveedor de Application Insights capture los registros Information. No lo captura porque el SDK agrega un filtro de registro predeterminado que indica a ApplicationInsights que capture solo los registros Warning y los registros más graves. Application Insights requiere una invalidación explícita.

{
  "Logging": {
    "LogLevel": {
      "Default": "Information"
    }
  }
}

Para más información, consulte Configuración de ILogger.

Algunas plantillas de Visual Studio usan el método de extensión UseApplicationInsights() en IWebHostBuilder para habilitar Application Insights. ¿Es este uso aún válido?

El método de extensión UseApplicationInsights() todavía es compatible, pero está marcado como obsoleto desde la versión 2.8.0 y posteriores del SDK de Application Insights. Se quitará en el siguiente cambio de versión principal del SDK. Para habilitar la telemetría de Application Insights, se recomienda usar AddApplicationInsightsTelemetry(), porque proporciona sobrecargas para controlar configuración. Además, en las aplicaciones ASP.NET Core 3.X, services.AddApplicationInsightsTelemetry() es la única manera de habilitar Application Insights.

Estoy implementando mi aplicación de ASP.NET Core en Web Apps. ¿Debo habilitar la extensión de Application Insights desde Web Apps?

Si está instalado el SDK en tiempo de compilación, como se muestra en este artículo, no es necesario habilitar la extensión de Application Insights desde el portal de App Service. Incluso si la extensión está instalada, se retirará cuando detecte que el SDK ya está agregado en la aplicación. Si habilita Application Insights desde la extensión, no tiene que instalar ni actualizar el SDK. Pero si habilita Application Insights siguiendo las instrucciones de este artículo, tendrá más flexibilidad porque:

• La telemetría de Application Insights seguirá funcionando en:
  • Todos los sistemas operativos, incluidos Windows, Linux y Mac.
  • Todos los modos de publicación, incluidos los independientes o dependientes del marco.
  • Todas las plataformas de destino, incluida la versión completa de .NET Framework.
  • Todas las opciones de hospedaje, incluidos contenedores, Web Apps, VM, Linux, Azure Kubernetes Service y hospedaje independiente de Azure.
  • Todas las versiones de .NET Core, incluidas las versiones preliminares.
• Puede ver datos de telemetría localmente cuando depure desde Visual Studio.
• Puede realizar un seguimiento de telemetría personalizada adicional mediante la API TrackXXX().
• Tiene control total sobre la configuración.

¿Puedo habilitar la supervisión de Application Insights mediante herramientas como el agente de Application Insights para Azure Monitor (anteriormente, Monitor de estado v2)?

Sí. A partir de Application Insights Agent 2.0.0-beta1, se admiten aplicaciones ASP.NET Core hospedadas en IIS.

Si ejecuto mi aplicación en Linux, ¿se admiten todas las características?

Sí. La compatibilidad de características para el SDK es la misma en todas las plataformas, con las siguientes excepciones:

• El SDK recopila contadores de eventos en Linux, ya que los contadores de rendimiento solo se admiten en Windows. La mayoría de las métricas son las mismas.
• Aunque el objeto ServerTelemetryChannel está habilitado de forma predeterminada, si la aplicación se ejecuta en Linux o macOS, el canal no crea automáticamente una carpeta de almacenamiento local para mantener los datos de telemetría temporalmente si hay problemas de red. Debido a esta limitación, la telemetría se pierde cuando hay problemas temporales de red o del servidor. Para solucionar este problema, configure una carpeta local para el canal:

using Microsoft.ApplicationInsights.Channel;
using Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel;

    public void ConfigureServices(IServiceCollection services)
    {
        // The following will configure the channel to use the given folder to temporarily
        // store telemetry items during network or Application Insights server issues.
        // User should ensure that the given folder already exists
        // and that the application has read/write permissions.
        services.AddSingleton(typeof(ITelemetryChannel),
                                new ServerTelemetryChannel () {StorageFolder = "/tmp/myfolder"});
        services.AddApplicationInsightsTelemetry();
    }

Esta limitación no es aplicable en la versión 2.15.0 y posteriores.

¿Es este SDK compatible con las nuevas aplicaciones de plantilla de servicio de trabajo de .NET Core 3.X?

Este SDK requiere HttpContext; por lo tanto, no funciona en ninguna aplicación sin HTTP, incluidas las aplicaciones de servicio de trabajo de .NET Core 3.X. Para habilitar Application Insights en estas aplicaciones mediante el SDK de Microsoft.ApplicationInsights.WorkerService recién publicado, consulte Application Insights para las aplicaciones de servicio de trabajo (aplicaciones sin HTTP).

SDK de código abierto

• Lectura y contribución al código.

Para obtener las actualizaciones y correcciones de errores más recientes, vea las notas de la versión.

Pasos siguientes

• Explore los flujos de usuarios para saber cómo navegan por la aplicación.
• Configure una colección de instantáneas para ver el estado del código fuente y las variables en el momento en que se produzca una excepción.
• Use la API para enviar sus propios eventos y métricas para obtener una vista detallada del rendimiento y del uso de la aplicación.
• Las pruebas de disponibilidad comprueban la aplicación constantemente desde cualquier parte del mundo.
• Inserción de dependencias en ASP.NET Core