diff --git a/docs/core/diagnostics/distributed-tracing-builtin-activities.md b/docs/core/diagnostics/distributed-tracing-builtin-activities.md index aac1893940af8..f71371001aa8e 100644 --- a/docs/core/diagnostics/distributed-tracing-builtin-activities.md +++ b/docs/core/diagnostics/distributed-tracing-builtin-activities.md @@ -13,7 +13,7 @@ This is a reference for distributed tracing [activities](xref:System.Diagnostics ### HTTP client request - and report the HTTP client request activity following the recommendations defined in OpenTelemetry [HTTP Client Semantic Conventions](https://opentelemetry.io/docs/specs/semconv/http/http-spans/#http-client). It describes the HTTP request sent by 's send overloads during the time interval the underlying handler completes the request. Completing the request includes the time up to reading response headers from the network stream. It doesn't include the time spent reading the response body. `SocketsHttpHandler` may retry requests on connection failure. Retries are not reported as separate *HTTP client request* activities. + and report the HTTP client request activity following the recommendations defined in OpenTelemetry [HTTP Client Semantic Conventions](https://opentelemetry.io/docs/specs/semconv/http/http-spans/#http-client). It describes the HTTP request sent by 's send overloads during the time interval the underlying handler completes the request. Completing the request includes the time up to reading response headers from the network stream. It doesn't include the time spent reading the response body. `SocketsHttpHandler` may retry requests, for example, on connection failures or HTTP version downgrades. Retries are not reported as separate *HTTP client request* activities. | Availability | name | | | |---|---|---|---| @@ -41,7 +41,7 @@ This is a reference for distributed tracing [activities](xref:System.Diagnostics ### HTTP client request: wait for connection (experimental) -This activity is a child of an *HTTP client request* activity. It represents the time interval the corresponding request is waiting for an available connection in the request queue. If a free connection is available in the pool when the request comes in, no *wait for connection* activity will be created. Note that *wait for connection* does not represent the actual connection establishment; that is modeled by the *HTTP connection setup* activity. `SocketsHttpHandler` may retry requests on connection failure. Retries are not reported as separate *HTTP client request* activities; however, each retry will result in a new *wait for connection* activity under the parent request activity. +This activity is a child of an *HTTP client request* activity. It represents the time interval the corresponding request is waiting for an available connection in the request queue. If a free connection is available in the pool when the request comes in, no *wait for connection* activity will be created. Note that *wait for connection* does not represent the actual connection establishment; that is modeled by the *HTTP connection setup* activity. `SocketsHttpHandler` may retry requests, for example, on connection failures or HTTP version downgrades. Retries are not reported as separate *HTTP client request* activities; however, each new connection attempt will result in a new *wait for connection* activity under the parent request activity. | Availability | name | | | |---|---|---|---|