Soporte asíncrono en .NET

El agente instrumentó estos HttpClient métodos asíncronos:

• SendAsync
• GetAsync
• PostAsync
• PutAsync
• DeleteAsync
• GetStringAsync
• GetStreamAsync
• GetByteArrayAsync

El agente instrumentó estos RestClient métodos asíncronos:

• ExecuteTaskAsync
• ExecuteGetTaskAsync
• ExecutePostTaskAsync

El agente instrumentó estos SqlCommand métodos asíncronos:

• ExecuteReaderAsync
• ExecuteNonQueryAsync
• ExecuteScalarAsync
• ExecuteXmlReaderAsync

El agente instrumentó estos SqlDataReader métodos asíncronos:

• NextResultAsync
• ReadAsync

El agente instrumentó estos NpgsqlCommand métodos asíncronos (Postgres):

• ExecuteReaderAsync
• ExecuteNonQueryAsync
• ExecuteScalarAsync

El agente .NET admite instrumentación personalizada de sus propios métodos asíncronos.

Se espera que el tiempo de respuesta sea menor que el tiempo total invertido en async-await escenarios de uso. Considere el siguiente ejemplo de código para un extremo web:

async Task<string> WebEndpointExample() 
{
    await DoSomethingForSomeSecondsAsync(5); //kick off a 5-second-work to be done.
    return "Complete";
}

[Trace]
[MethodImpl(MethodImplOptions.NoInlining)]
private static async Task DoSomethingForSomeSecondsAsync(int seconds)
{
    await Task.Delay(TimeSpan.FromSeconds(seconds));
}

En este ejemplo de código, el WebEndpointExample tarda aproximadamente 5 segundos en completarse, por lo que el tiempo de respuesta para la transacción que representa la solicitud al extremo WebEndpointExample será de aproximadamente 5 segundos.

El agente también captura el tiempo "ocupado" (el tiempo que el método instrumentado se está ejecutando realmente) de cada segmento individual que constituye la transacción. Son WebEndpointExample y DoSomethingForSomeSecondsAsync. Idealmente, el tiempo total de ejecución de los dos segmentos es igual al tiempo de respuesta (aproximadamente 5 segundos).

Es fácil ver que el tiempo de ejecución de DoSomethingForSomeSecondsAsync es de 5 segundos. Sin embargo, el tiempo de ejecución de WebEndpointExample debe ser cercano a 0 segundos. (No hace ningún trabajo; es necesario que awaitse complete DoSomethingForSomeSecondsAsync .)

Sin embargo, el agente todavía mide su tiempo de ejecución en aproximadamente 5 segundos. Esto se debe a la incapacidad del agente para detectar el tiempo bloqueado (no el tiempo de CPU) cuando un método está awaittrabajando para otro. Por lo tanto, el tiempo total se informa como 10 segundos, que es mayor que el tiempo de respuesta (aproximadamente 5 segundos).

Al mismo tiempo, el agente no puede asumir que llamar a los métodos async siempre bloquearía a la persona que llama durante todo el tiempo. El siguiente ejemplo demuestra esto:

async Task<string> WebEndpointExample()
{
    var task = DoSomethingForSomeSecondsAsync(5); //kick off a 5-second-work to be done.

    //Do something less than 5 seconds here.

    await task;
    return "Complete";
}

[Trace]
[MethodImpl(MethodImplOptions.NoInlining)]
private static async Task DoSomethingForSomeSecondsAsync(int seconds)
{
    await Task.Delay(TimeSpan.FromSeconds(seconds));
}

En este ejemplo, el tiempo de respuesta sigue siendo de aproximadamente 5 segundos, pero el tiempo de ejecución real de WebEndpointExample ya no es aproximadamente 0.

El agente .NET no utilizará métodos asíncronos si el pipeline ASP legacy está presente. Dado que Microsoft reemplazó el pipeline ASP legacy mucho antes de que se introdujeran los métodos asíncronos, este problema normalmente solo afecta a las aplicaciones creadas en .NET framework 4.0 o inferior y luego migradas a .NET framework 4.5 o superior.

Para ver si este problema afecta su solicitud y cómo resolverlo si lo hace, revise los procedimientos de resolución de problemas.

El agente .NET no admite la instrumentación de métodos asíncronos que tengan un tipo de retorno distinto de Task o Task<T>. El agente no admite async void métodos.

Para obtener más información, consulte la documentación de Microsoft sobre los tipos de devolución asíncronos:

• Task<TResult> tipo de devolución
• Vacío Async
• Tipos de retorno asíncronos generalizados

El agente .NET no utiliza ningún método .NET que utilice el estilo begin* y end* , excepto la aplicación WCF. Fuera de esta excepción, si su aplicación llama a este tipo de métodos, el agente no creará segmentos para ellos. Sin embargo, el resto de su transacción y segmentos se crearán correctamente.

El agente .NET no captura métricas de alcance ni segmentos dentro de subprocesos creados manualmente por su aplicación.

Si su aplicación llama a métodos asíncronos instrumentados, utilice await en lugar de Task métodos relacionados como Task.Result() para esperar los resultados. De lo contrario, es posible que la instrumentación no funcione correctamente.

En general, evite utilizar Task.Result() al llamar a métodos asíncronos. Puede conducir a puntos muertos.

Si agrega su propio bloque ContinueWith({}) a la promesa devuelta por un método asíncrono instrumentado, puede afectar las mediciones de tiempo informadas por la instrumentación. Por ejemplo, el tiempo puede incluir el tiempo que tarda su ContinueWith en ejecutarse.

Los servicios WCF alojados en IIS no anidan correctamente el segmento WCF debajo del segmento ExecuteRequestHandler . Los dos segmentos aparecerán como hermanos dentro de una traza de la transacción, aunque el tiempo total informado será exacto.

Los segmentos en una traza de la transacción no generarán el rastreo de la pila automáticamente, incluso si duran más de transaction_tracer.stack_trace_threshold.