Suporte assíncrono em .NET

O agente utiliza estes HttpClient métodos assíncronos:

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

O agente utiliza estes RestClient métodos assíncronos:

• ExecuteTaskAsync
• ExecuteGetTaskAsync
• ExecutePostTaskAsync

O agente utiliza estes SqlCommand métodos assíncronos:

• ExecuteReaderAsync
• ExecuteNonQueryAsync
• ExecuteScalarAsync
• ExecuteXmlReaderAsync

O agente utiliza estes SqlDataReader métodos assíncronos:

• NextResultAsync
• ReadAsync

O agente utiliza estes NpgsqlCommand métodos assíncronos (Postgres):

• ExecuteReaderAsync
• ExecuteNonQueryAsync
• ExecuteScalarAsync

O agente .NET oferece suporte à instrumentação personalizada de seus próprios métodos assíncronos.

Espera-se que o tempo de resposta seja menor que o tempo total gasto em async-await cenários de uso. Considere o seguinte exemplo de código para um endpoint da 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));
}

Neste exemplo de código, leva aproximadamente 5 segundos para o WebEndpointExample ser concluído, portanto, o tempo de resposta para a transação que representa a solicitação para o endpoint WebEndpointExample será de aproximadamente 5 segundos.

O agente também captura o tempo “ocupado” (o tempo que o método instrumentado está realmente em execução) de cada segmento individual que constitui a transação. Eles são WebEndpointExample e DoSomethingForSomeSecondsAsync. Idealmente, o tempo total de execução dos dois segmentos é igual ao tempo de resposta (aproximadamente 5 segundos).

É fácil ver que o tempo de execução de DoSomethingForSomeSecondsAsync é de 5 segundos. Entretanto, o tempo de execução do WebEndpointExample deve ser próximo de 0 segundos. (Não faz nenhum trabalho; é awaitpara o DoSomethingForSomeSecondsAsync ser concluído.)

Entretanto, o agente ainda mede seu tempo de execução em aproximadamente 5 segundos. Isso se deve à incapacidade do agente de detectar o tempo bloqueado (não o tempo de CPU) quando um método está awaitexecutando para outro. Portanto, o tempo total é relatado como 10 segundos, que é maior que o tempo de resposta (aproximadamente 5 segundos).

Ao mesmo tempo, o agente não pode presumir que a chamada aos métodos async sempre bloquearia o chamador o tempo todo. O próximo exemplo demonstra isso:

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));
}

Neste exemplo, o tempo de resposta ainda é de aproximadamente 5 segundos, mas o tempo de execução real do WebEndpointExample não é mais de aproximadamente 0.

O agente .NET não utilizará métodos assíncronos se o pipeline ASP legado estiver presente. Como a Microsoft substituiu o pipeline ASP legado bem antes da introdução dos métodos assíncronos, esse problema normalmente afeta apenas aplicativos criados no .NET framework 4.0 ou inferior e depois migrados para o .NET framework 4.5 ou superior.

Para ver se esse problema afeta sua inscrição e como resolvê-lo, caso isso aconteça, revise os procedimentos de resolução de problemas.

O agente .NET não oferece suporte à instrumentação de métodos assíncronos que possuem tipo de retorno diferente de Task ou Task<T>. O agente não suporta métodos async void .

Para obter mais informações, consulte a documentação da Microsoft sobre tipos de retorno assíncronos:

• Task<TResult> tipo de retorno
• Vazio assíncrono
• Tipos de retorno assíncronos generalizados

O agente .NET não utiliza nenhum método .NET que utilize o estilo begin* e end* , exceto o aplicativo WCF. Fora desta exceção, se o seu aplicativo chamar esses tipos de métodos, o agente não criará segmentos para eles. Porém, o restante de suas transações e segmentos serão criados corretamente.

O agente .NET não captura métricas ou segmentos com escopo definido em threads criados manualmente pelo seu aplicativo.

Se seu aplicativo chamar métodos assíncronos instrumentados, use await em vez de Task métodos relacionados, como Task.Result() , para aguardar os resultados. Caso contrário, a instrumentação poderá não funcionar corretamente.

Em geral, evite usar Task.Result() ao chamar métodos assíncronos. Isso pode levar a impasses.

Se você adicionar seu próprio bloco ContinueWith({}) à promessa retornada por um método assíncrono instrumentado, isso poderá afetar as medições de tempo relatadas pela instrumentação. Por exemplo, o tempo pode incluir o tempo que seu ContinueWith leva para ser executado.

Os serviços WCF hospedados pelo IIS não aninham corretamente o segmento WCF no segmento ExecuteRequestHandler . Os dois segmentos parecerão irmãos dentro do rastreamento da transação, embora o tempo total relatado seja preciso.

Os segmentos em um rastreamento da transação não gerarão rastreamento de pilha automaticamente, mesmo que sejam executados por mais de transaction_tracer.stack_trace_threshold.