DebugInformation property on responses and exceptions

[Mpdreamz]

This PR adds a .DebugInformation property on responses & exceptions which acts as the goto diagnosis tool both for devs using NEST and for us maintainers to ask for when we receive a bug report.

Examples

Valid response

Valid NEST response built from a succesful low level call on POST: /project/project/nest-92a78d48/_update?pretty=true&fields=name%2C_source
# Audit trail of this API call:
 - HealthyResponse: Node: http://ipv4.fiddler:9200/ Took: 00:00:00.0105188
# Request :
<Request stream not captured or already read to completion by serializer. Set DisableDirectStreaming() on ConnectionSettings to force it to be set on the response.>
# Response :
<Response stream not captured or already read to completion by serializer. Set DisableDirectStreaming() on ConnectionSettings to force it to be set on the response.>

Invalid response from a healthy low level call:

Individual responses can explain why they marked the response as functionally invalid, e.g here the bulkresponse lists the failed responses

Invalid NEST response built from a succesful low level call on POST: /nest-311ded48/_bulk?pretty=true
operation[0]: update returned 404 _index: nest-311ded48 _type: project _id: Turcotte - Langworth _version: 0 error: Type: document_missing_exception Reason: "[project][Turcotte - Langworth]: document missing"
# Audit trail of this API call:
 - HealthyResponse: Node: http://ipv4.fiddler:9200/ Took: 00:00:00.9404774
# Request :
<Request stream not captured or already read to completion by serializer. Set DisableDirectStreaming() on ConnectionSettings to force it to be set on the response.>
# Response :
<Response stream not captured or already read to completion by serializer. Set DisableDirectStreaming() on ConnectionSettings to force it to be set on the response.>

Response with exception caught:

Invalid NEST response built from a unsuccesful low level call on GET: /doesntexist/_mapping/project
# Audit trail of this API call:
 - BadResponse: Node: http://ipv4.fiddler:9200/ Took: 00:00:02.0921637
# ServerError: ServerError: 404Type: index_not_found_exception Reason: "no such index"
# OriginalException: System.Net.WebException: The remote server returned an error: (404) Not Found.
   at System.Net.HttpWebRequest.GetResponse()
   at Elasticsearch.Net.HttpConnection.Request[TReturn](RequestData requestData) in C:\Users\Mpdreamz\dev\elastic\coreclr\src\Elasticsearch.Net\Connection\HttpConnection.cs:line 138
# Request :
<Request stream not captured or already read to completion by serializer. Set DisableDirectStreaming() on ConnectionSettings to force it to be set on the response.>
# Response :
<Response stream not captured or already read to completion by serializer. Set DisableDirectStreaming() on ConnectionSettings to force it to be set on the response.>

Exception

# FailureReason: BadResponse when trying to GET http://ipv4.fiddler:9200/doesntexist/_mapping/project
# Audit trail of this API call:
 - BadResponse: Node: http://ipv4.fiddler:9200/ Took: 00:00:02.0759486
# ServerError: ServerError: 404Type: index_not_found_exception Reason: "no such index"
# OriginalException: System.Net.WebException: The remote server returned an error: (404) Not Found.
   at System.Net.HttpWebRequest.GetResponse()
   at Elasticsearch.Net.HttpConnection.Request[TReturn](RequestData requestData) in C:\Users\Mpdreamz\dev\elastic\coreclr\src\Elasticsearch.Net\Connection\HttpConnection.cs:line 138
# Request :
<Request stream not captured or already read to completion by serializer. Set DisableDirectStreaming() on ConnectionSettings to force it to be set on the response.>
# Response :
<Response stream not captured or already read to completion by serializer. Set DisableDirectStreaming() on ConnectionSettings to force it to be set on the response.>
# Inner Exception: The remote server returned an error: (404) Not Found.
System.Net.WebException: The remote server returned an error: (404) Not Found.
   at System.Net.HttpWebRequest.GetResponse()
   at Elasticsearch.Net.HttpConnection.Request[TReturn](RequestData requestData) in C:\Users\Mpdreamz\dev\elastic\coreclr\src\Elasticsearch.Net\Connection\HttpConnection.cs:line 138
# Exception:
<stracktrace_trimmed>

Interesting audit trail exception:

This one is from our virtual clustering tests that throws hard Exception's

# FailureReason: Unexpected when trying to POST http://localhost:9201/_search
 - PingFailure: Node: http://localhost:9200/ Exception: Exception Took: 00:00:00
 - PingSuccess: Node: http://localhost:9201/ Took: 00:00:00
 - BadResponse: Node: http://localhost:9201/ Exception: Exception Took: 00:00:00
# Audit exception in step 0 PingFailure:
System.Exception: ping exception
<snip>
# Audit exception in step 1 BadResponse:
System.Exception: boom!
   at Tests.Framework.VirtualClusterConnection.<>c__13`2.<Fail>b__13_0(Exception e) in <snip>
# Inner Exception: boom!
System.Exception: boom!
   at Tests.Framework.VirtualClusterConnection.<>c__13`2.<Fail>b__13_0(Exception e) in <snip>

[russcam]

LGTM 👍