WARNING: Version 5.x has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
Audit trail
editAudit trail
editElasticsearch.Net and NEST provide an audit trail for the events within the request pipeline that occur when a request is made. This audit trail is available on the response as demonstrated in the following example.
We’ll use a Sniffing connection pool here since it sniffs on startup and pings before first usage, so we can get an audit trail with a few events out
var pool = new SniffingConnectionPool(new []{ TestConnectionSettings.CreateUri() }); var connectionSettings = new ConnectionSettings(pool) .InferMappingFor<Project>(i => i .IndexName("project") ); var client = new ElasticClient(connectionSettings);
After issuing the following request
var response = client.Search<Project>(s => s .MatchAll() );
The response contains an audit trail with four events
response.ApiCall.AuditTrail.Count.Should().Be(4); response.ApiCall.AuditTrail[0].Event.Should().Be(AuditEvent.SniffOnStartup); response.ApiCall.AuditTrail[1].Event.Should().Be(AuditEvent.SniffSuccess); response.ApiCall.AuditTrail[2].Event.Should().Be(AuditEvent.PingSuccess); response.ApiCall.AuditTrail[3].Event.Should().Be(AuditEvent.HealthyResponse);
Each audit has a started and ended DateTime
on it that will provide
some understanding of how long it took
response.ApiCall.AuditTrail .Should().OnlyContain(a => a.Ended - a.Started > TimeSpan.Zero);
The audit trail is also provided in the Debug information in a human readable fashion, similar to
Valid NEST response built from a successful low level call on POST: /project/project/_search # Audit trail of this API call: - [1] SniffOnStartup: Took: 00:00:00.0360264 - [2] SniffSuccess: Node: http://localhost:9200/ Took: 00:00:00.0310228 - [3] PingSuccess: Node: http://127.0.0.1:9200/ Took: 00:00:00.0115074 - [4] HealthyResponse: Node: http://127.0.0.1:9200/ Took: 00:00:00.1477640 # 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.>
to help with troubleshooting
var debugInformation = response.DebugInformation;