Audit.NET 25.0.3

dotnet add package Audit.NET --version 25.0.3
NuGet\Install-Package Audit.NET -Version 25.0.3
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Audit.NET" Version="25.0.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Audit.NET --version 25.0.3
#r "nuget: Audit.NET, 25.0.3"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Audit.NET as a Cake Addin
#addin nuget:?package=Audit.NET&version=25.0.3

// Install Audit.NET as a Cake Tool
#tool nuget:?package=Audit.NET&version=25.0.3

Audit.NET

USAGE | OUTPUT | CUSTOMIZATION | DATA PROVIDERS | CREATION POLICY | CONFIGURATION | EXTENSIONS

issues build status chat / support donations
issues-openissues-closed build-status Gitter Gitter backers paypal

An extensible framework to audit executing operations in .NET and .NET Core.

Generate audit logs with evidence for reconstruction and examination of activities that have affected specific operations or procedures.

With Audit.NET you can generate tracking information about operations being executed. It gathers environmental information such as the caller user ID, machine name, method name, and exceptions, including execution time and exposing an extensible mechanism to enrich the logs and handle the audit output.

NuGet

NuGet Status NuGet Count

To install the package run the following command on the Package Manager Console:

PM> Install-Package Audit.NET

Changelog

Check the CHANGELOG.md file.

Introduction

The Audit Scope and Audit Event are the central objects of this framework.

Audit Scope

The AuditScope serves as the central object in this framework, representing the scope of an audited operation or event. It acts as a context for auditing, capturing pertinent details like the start time, involved entities, and any additional custom information. Essentially, the AuditScope encapsulates an AuditEvent, controlling its life cycle.

The AuditScope is a disposable object, commonly utilized within a using statement to ensure proper finalization and recording of audit information upon exiting the scope.

See the audit scope statechart.

Audit Event

The AuditEvent functions as an extensible information container that captures the details of the audited operation, is the representation of the audited information within an Audit Scope. It includes details about the audited operation, such as the event type, timestamp, execution duration, and any custom fields or properties.

The AuditEvent is typically serialized into a format suitable for storage or transmission, such as JSON.

The audit events are stored using a Data Provider. You can use one of the available data providers or implement your own.

SUPPORT FOR OLDER .NET FRAMEWORKS

Beginning with version 23.0.0, this library and its extensions have discontinued support for older .NET Framework and Entity Framework (versions that lost Microsoft support before 2023).

For reference, please consult the following links:

This library and its extensions will maintain support for the following minimum .NET framework versions:

  • .NET Framework 4.6.2 (net462)
  • .NET Standard 2.0 (netstandard2.0)
  • .NET 6 (net6.0)

The following frameworks were deprecated and removed from the list of target frameworks:

  • net45, net451, net452, net461
  • netstandard1.3, netstandard1.4, netstandard1.5, netstandard1.6
  • netcoreapp2.1, netcoreapp3.0
  • net5.0

This discontinuation led to the following modifications:

  • All library versions will now use System.Text.Json as the default (Newtonsoft.Json will be deprecated but can still be used through the JsonAdapter).
  • Support for EF Core versions 3 and earlier has been discontinued in the Audit.EntityFramework.Core libraries. The minimum supported version is now EF Core 5 (Audit.EntityFramework will continue to support .NET Entity Framework 6).
  • The libraries Audit.EntityFramework.Core.v3 and Audit.EntityFramework.Identity.Core.v3 has been deprecated.
  • Audit.NET.JsonSystemAdapter has been deprecated.

Usage

The Audit Scope is the central object of this framework. It encapsulates an audit event, controlling its life cycle. The Audit Event is an extensible information container of an audited operation.

There are several ways to create an Audit Scope:

  • Calling the Create() / CreateAsync() method of an AuditScopeFactory instance, for example:

    var factory = new AuditScopeFactory();
    var scope = factory.Create(new AuditScopeOptions(...));
    
  • Using the overloads of the static methods Create() / CreateAsync() on AuditScope, for example:

    var scope = AuditScope.Create("Order:Update", () => order, new { MyProperty = "value" });
    

    The first parameter of the AuditScope.Create method is an event type name intended to identify and group the events. The second is the delegate to obtain the object to track (target object). This object is passed as a Func<object> to allow the library to inspect the value at the beginning and the disposal of the scope. It is not mandatory to supply a target object.

    You can use the overload that accepts an AuditScopeOptions instance to configure any of the available options for the scope:

    var scope = AuditScope.Create(new AuditScopeOptions()
    {
      EventType = "Order:Update",
      TargetGetter = () => order,
      ExtraFields = new { MyProperty = "value" }
    });
    
  • Using the provided fluent API, for example:

    var scope = AuditScope.Create(_ => _
        .EventType("Order:Update")
        .ExtraFields(new { MyProperty = "value" })
        .Target(() => order));
    
AuditScope options
Option Type Description
EventType string A string representing the type of the event
TargetGetter Func<object> Target object getter (a func that returns the object to track)
ExtraFields object Anonymous object that contains additional fields to be merged into the audit event
DataProvider AuditDataProvider The data provider to use. Defaults to the DataProvider configured on Audit.Core.Configuration.DataProvider
CreationPolicy EventCreationPolicy The creation policy to use. Default is InsertOnEnd
IsCreateAndSave bool Value indicating whether this scope should be immediately ended and saved after creation. Default is false
AuditEvent AuditEvent Custom initial audit event to use. By default it will create a new instance of basic AuditEvent
SkipExtraFrames int Value used to indicate how many frames in the stack should be skipped to determine the calling method. Default is 0
CallingMethod MethodBase Specific calling method to store on the event. Default is to use the calling stack to determine the calling method.

Suppose you have the following code to cancel an order that you want to audit:

Order order = Db.GetOrder(orderId);
order.Status = -1;
order.OrderItems = null;
order = Db.OrderUpdate(order);

To audit this operation, you can surround the code with a using block that creates an AuditScope, indicating a target object to track:

Order order = Db.GetOrder(orderId);
using (AuditScope.Create("Order:Update", () => order))
{
    order.Status = -1;
    order.OrderItems = null;
    order = Db.OrderUpdate(order);
}

Note

It is not mandatory to use a using block, but it simplifies the syntax when the code to audit is on a single block, allowing the detection of exceptions and calculating the duration by implicitly saving the event on disposal.

Note

When using the extensions that logs interactions with different systems, like Audit.EntityFramework, Audit.WebApi, etc. you don't need to explicitly create the AuditScope or AuditEvent, they are created internally by the extension.

Simple logging

If you are not tracking an object or the duration of an event, you can use the Log shortcut method that logs an event immediately. For example:

AuditScope.Log("Event Type", new { ExtraField = "extra value" });

Manual Saving

You can control the creation and saving logic, by creating a manual AuditScope. For example to log a pair of Start/End method calls as a single event:

public class SomethingThatStartsAndEnds
{
    private AuditScope auditScope;

    public int Status { get; set; }

    public void Start()
    {
        // Create a manual scope
        auditScope = AuditScope.Create(new AuditScopeOptions()
        {
            EventType = "MyEvent",
            TargetGetter = () => this.Status,
            CreationPolicy = EventCreationPolicy.Manual
        });
    }

    public void End()
    {
        // Save the event
        auditScope.Save();  
        // Discard to avoid further saving
        auditScope.Discard();
    }
}

For more information about the EventCreationPolicy please see Event Creation Policy section.

Output

The library will generate an output (AuditEvent) for each operation, including:

  • Tracked object's state before and after the operation.
  • Execution time and duration.
  • Environment information such as user, machine, domain, locale, etc.
  • Comments and Custom Fields provided.

An example of the output in JSON:

{
    "EventType": "Order:Update",
    "Environment": {
        "UserName": "Federico",
        "MachineName": "HP",
        "DomainName": "HP",
        "CallingMethodName": "Audit.UnitTest.AuditTests.TestUpdate()",
        "Exception": null,
        "Culture": "en-GB"
    },
    "Activity": {
        "StartTimeUtc": "2023-12-01T17:36:52.2256288Z",
	"SpanId": "23a93b9e8cbc457f",
	"TraceId": "2d3e5e90f790c7d2274d9bb047531f66",
	"ParentId": "0000000000000000",
	"Operation": "Update"
    },
    "StartDate": "2016-08-23T11:33:14.653191Z",
    "EndDate": "2016-08-23T11:33:23.1820786Z",
    "Duration": 8529,
    "Target": {
        "Type": "Order",
        "Old": {
            "OrderId": "39dc0d86-d5fc-4d2e-b918-fb1a97710c99",
            "Status": 2,
            "OrderItems": [{
                "Sku": "1002",
                "Quantity": 3.0
            }]
        },
        "New": {
            "OrderId": "39dc0d86-d5fc-4d2e-b918-fb1a97710c99",
            "Status": -1,
            "OrderItems": null
        }
    }
}

Output details

The following tables describe the output fields:

Field Name Type Description
EventType string User-defined string to group the events
Environment Environment Contains information about the execution environment
StartDate DateTime Date and time when the event has started
EndDate DateTime Date and time when the event has ended
Duration integer Duration of the event in milliseconds
Target Target User-defined tracked object
Comments Array of strings User-defined comments
CustomFields Dictionary User-defined custom fields
Field Name Type Description
UserName string Current logged user name
MachineName string Executing machine name
DomainName string Current user domain
CallingMethodName string Calling method signature information
StackTrace string The full stack trace at the moment of the audit scope creation (NULL unless it's enabled by configuration)
Exception string Indicates if an Exception has been detected (NULL if no exception has been thrown)
Culture string Current culture identifier
Field Name Type Description
Type string Tracked object type name
Old Object Value of the tracked object at the beginning of the event
New Object Value of the tracked object at the end of the event

Custom Fields and Comments

The AuditScope object provides two methods to extend the event output.

  • Use SetCustomField() method to add any object as an extra field to the event.
  • Use Comment() to add textual comments to the event's Comments array.

For example:

Order order = Db.GetOrder(orderId);
using (var audit = AuditScope.Create("Order:Update", () => order))
{
    audit.SetCustomField("ReferenceId", orderId);
    order.Status = -1;
    order = Db.OrderUpdate(order);
    audit.Comment("Status Updated to Cancelled");
}

You can also set Custom Fields when creating the AuditScope, by passing an anonymous object with the properties you want as extra fields. For example:

using (var audit = AuditScope.Create("Order:Update", () => order, new { ReferenceId = orderId }))
{
    order.Status = -1;
    order = Db.OrderUpdate(order);
    audit.Comment("Status Updated to Cancelled");
}

You can also access the Custom Fields directly from Event.CustomFields property of the scope. For example:

using (var audit = AuditScope.Create("Order:Update", () => order, new { ReferenceId = orderId }))
{
    audit.Event.CustomFields["ReferenceId"] = orderId;
}

Note

Custom fields are not limited to single properties, you can store any object as well, by default they will be JSON serialized.

Extending AuditEvent

Another way to enrich the event output is to create a class inheriting from the AuditEvent class, then you can pass an instance of your class to the AuditScope.Create method. For example:

public class YourAuditEvent : AuditEvent
{
    public Guid ReferenceId { get; set; } = Guid.NewGuid();
}

using (var scope = AuditScope.Create(new AuditScopeOptions { AuditEvent = new YourAuditEvent() }))
{
    //...
}

The output of the previous examples would be:

{
    "EventType": "Order:Update",
    "Environment": {
        "UserName": "Federico",
        "MachineName": "HP",
        "DomainName": "HP",
        "CallingMethodName": "Audit.UnitTest.AuditTests.TestUpdate()",
        "Exception": null,
        "Culture": "en-GB"
    },
    "Target": {
        "Type": "Order",
        "Old": {
            "OrderId": "39dc0d86-d5fc-4d2e-b918-fb1a97710c99",
            "Status": 2,
            
        },
        "New": {
            "OrderId": "39dc0d86-d5fc-4d2e-b918-fb1a97710c99",
            "Status": -1,
            
        }
    },
    "ReferenceId": "39dc0d86-d5fc-4d2e-b918-fb1a97710c99",           // <-- Custom Field
    "Comments": ["Status Updated to Cancelled"],                     // <-- Comments
    "StartDate": "2016-08-23T11:34:44.656101-05:00",
    "EndDate": "2016-08-23T11:34:55.1810821-05:00",
    "Duration": 8531
}

Discard option

The AuditScope object has a Discard() method to allow the user to discard an event. Discarding an event means it won't be saved.

For example, if you want to avoid saving the audit event under certain conditions:

using (var scope = AuditScope.Create(new AuditScopeOptions("SomeEvent", () => someTarget)))
{
    try
    {
        //some operation
        Critical.Operation();
    }
    catch (Exception ex)
    {
        //If an exception is thrown, discard the audit event
        scope.Discard();
    }
}

Data providers

A data provider (or storage sink) contains the logic to handle the audit event output, where you define what to do with the audit logs.

You can use one of the data providers included or inject your own mechanism by creating a class that inherits from AuditDataProvider and overrides its methods:

  • InsertEvent: should store the event and return a unique ID.
  • ReplaceEvent: should update an event given its ID. This method is only used for Creation Policies Manual or InsertOnStartReplaceOnEnd.

If your data provider will support asynchronous operations, you must also implement the following methods:

  • InsertEventAsync: Asynchronous implementation of the InsertEvent method.
  • ReplaceEventAsync: Asynchronous implementation of the ReplaceEvent method.

Also, if your data provider will support event retrieval, you should implement the following methods:

  • GetEvent: Retrieves an event by id.
  • GetEventAsync: Asynchronous implementation of the GetEvent method.

For example:

public class MyCustomDataProvider : AuditDataProvider
{
    public override object InsertEvent(AuditEvent auditEvent)
    {
        var fileName = $"Log{Guid.NewGuid()}.json";
        File.WriteAllText(fileName, auditEvent.ToJson());
        return fileName;
    }
    public override void ReplaceEvent(object eventId, AuditEvent auditEvent)
    {
        var fileName = eventId.ToString();
        File.WriteAllText(fileName, auditEvent.ToJson());
    }
    public override T GetEvent<T>(object eventId)
    {
        var fileName = eventId.ToString();
        return JsonConvert.DeserializeObject<T>(File.ReadAllText(fileName));
    }
    // async implementation:
    public override async Task<object> InsertEventAsync(AuditEvent auditEvent, CancellationToken cancellationToken = default)
    {
        var fileName = $"Log{Guid.NewGuid()}.json";
        await File.WriteAllTextAsync(fileName, auditEvent.ToJson(), cancellationToken);
        return fileName;
    }
    public override async Task ReplaceEventAsync(object eventId, AuditEvent auditEvent, CancellationToken cancellationToken = default)
    {
        var fileName = eventId.ToString();
        await File.WriteAllTextAsync(fileName, auditEvent.ToJson(), cancellationToken);
    }
    public override async Task<T> GetEventAsync<T>(object eventId, CancellationToken cancellationToken = default)
    {
        var fileName = eventId.ToString();
        return await GetFromFileAsync<T>(cancellationToken);
    }
}

Data provider selection

The data provider can be set globally for the entire application or per audit scope.

Note

If you don't specify a global data provider, it will default to a FileDataProvider that logs events as .json files into the current working directory.

To set the global data provider, assign the DataProvider property on the static Audit.Core.Configuration object, or call the fluent API Use(). For example:

Audit.Core.Configuration.DataProvider = new MyCustomDataProvider();

Or using the fluent API Use() method:

Audit.Core.Configuration.Setup()
  .Use(new MyCustomDataProvider());

To set the data provider per-scope, use the AuditScopeOptions when creating an AuditScope. For example:

var scope = AuditScope.Create(new AuditScopeOptions 
{ 
  DataProvider = new MyCustomDataProvider(), ... }
);

Every data provider is accompanied by a fluent API accessible during object construction or via its respective Use___() method. For instance, in the case of the SqlDataProvider:

var sqlDataProvider = new SqlDataProvider(_ => _
    .ConnectionString("your connection string")
    .TableName("your table name")
    .IdColumnName("your id column name")
    .JsonColumnName("your json column name"));
Audit.Core.Configuration.Setup()
  .UseSqlServer(_ => _
    .ConnectionString("your connection string")
    .TableName("your table name")
    .IdColumnName("your id column name")
    .JsonColumnName("your json column name"));

Data provider wrappers

A special type of Data Providers that allows wrapping other Data Provider with different purposes.

Dynamic data provider

As an alternative to creating a data provider class, you can define the mechanism at run time by using the DynamicDataProvider or DynamicAsyncDataProvider classes. For example:

Audit.Core.Configuration.Setup()
  .UseDynamicProvider(config => config
    .OnInsert(ev => Console.Write(ev.ToJson())));

For async operations, you should use the DynamicAsyncDataProvider, for example:

Audit.Core.Configuration.Setup()
  .UseDynamicAsyncProvider(config => config
    .OnInsert(async ev => await File.WriteAllTextAsync(filePath, ev.ToJson())));
Lazy Factory data provider

You can set the global data provider using a deferred instantiation technique, with a lazy factory method that will be called upon its initial utilization. For instance, in situations where dependency resolution is needed but not immediately accessible during initialization.

Allows to lazily instantiate the data provider to use. The data provider factory method will be called only once; the first time it's needed.

For example:

Audit.Core.Configuration.Setup()
    .UseLazyFactory(() => app.ApplicationServices.GetService<CustomDataProvider>());
Deferred Factory data provider

You can defer creating the data provider for each Audit Event until it is ready to be saved by using a deferred factory method. The factory method will be called for each audit event being saved.

For example:

var sqlDataProvider = new SqlDataProvider(config => config...);
var fileDataProvider = new FileDataProvider(config => config...);

Audit.Core.Configuration.Setup()
    .UseDeferredFactory(auditEvent => auditEvent is AuditEventWebApi ? sqlDataProvider : fileDataProvider);
Conditional data provider

Enables the configuration of different data providers based on conditions related to the audit event.

For example:

Configuration.DataProvider = new ConditionalDataProvider(config => config
  .When(auditEvent => auditEvent.EventType.Equals("A"), new MyCustomDataProvider())
  .When(auditEvent => auditEvent.EventType.Equals("B"), new SqlDataProvider())
  .Otherwise(new FileDataProvider()));
Polly data provider

Allows to define Polly resilience strategies to any Data Provider.

This is useful when you want to add resilience to your data provider, for example, to retry failed operations, or to add a circuit breaker.

For example:

Audit.Core.Configuration.Setup()
  .UsePolly(p => p
    .DataProvider(new SqlDataProvider(...))
    .WithResilience(resilience => resilience
      .AddRetry(new()
      {
        ShouldHandle = new PredicateBuilder().Handle<SqlException>(),
        MaxRetryAttempts = 2
      })));

For more information, please refer to the Audit.NET.Polly documentation.

Data providers included

The Data Providers included are summarized in the following table:

Type Technology Package / Class Description Configuration API
SQL Amazon QLDB Audit.NET.AmazonQLDB / AmazonQldbDataProvider Store the audit events using Amazon QLDB. .UseAmazonQldb()
SQL Entity Framework Audit.EntityFramework / EntityFrameworkDataProvider Store EntityFramework audit events in the same EF context. (This data provider can only be used for Entity Framework audits) .UseEntityFramework()
SQL MySql Audit.NET.MySql / MySqlDataProvider Store the events as rows in a MySQL database table, in JSON format. .UseMySql()
SQL Postgre SQL Audit.NET.PostgreSql / PostgreSqlDataProvider Store the events as rows in a PostgreSQL database table, in JSON format. .UsePostgreSql()
SQL SQL Server Audit.NET.SqlServer / SqlDataProvider Store the events as rows in a MS SQL Table, in JSON format. .UseSqlServer()
NoSQL Azure Cosmos Audit.NET.AzureCosmos / AzureCosmosDataProvider Store the events in an Azure Cosmos DB container, in JSON format. .UseAzureCosmos()
NoSQL Azure Storage Audit.NET.AzureStorageBlobs / AzureStorageBlobDataProvider Store the events in an Azure Blob Storage container, in JSON format. .UseAzureStorageBlobs()
NoSQL Azure Tables Audit.NET.AzureStorageTables / AzureStorageTableDataProvider Store the events in an Azure Table Storage. .UseAzureTableStorage()
NoSQL Dynamo DB Audit.NET.DynamoDB / DynamoDataProvider Store audit events in Amazon DynamoDB™ tables. .UseDynamoDB()
NoSQL Elasticsearch Audit.NET.Elasticsearch / ElasticsearchDataProvider Store audit events in Elasticsearch indices. .UseElasticsearch()
NoSQL Kafka Audit.NET.Kafka / KafkaDataProvider Stream the audit events to Apache Kafka topics. .UseKafka() / .UseKafka<TKey>()
NoSQL Mongo DB Audit.NET.MongoDB / MongoDataProvider Store the events in a Mongo DB collection, in BSON format. .UseMongoDB()
NoSQL Raven DB Audit.NET.RavenDB / RavenDbDataProvider Store the events as documents in a Raven DB database table, in JSON format. .UseRavenDB()
NoSQL Redis Audit.NET.Redis / RedisDataProvider Store audit logs in Redis as Strings, Lists, SortedSets, Hashes, Streams or publish to a PubSub channel. .UseRedis()
Local Windows Event Log Audit.NET / Audit.NET.EventLog.Core 7 EventLogDataProvider Write the audit logs to the Windows EventLog. .UseEventLogProvider()
Local File System Audit.NET / FileDataProvider Store the audit logs as files. Dynamically configure the directory and path. .UseFileLogProvider()
InMemory In-Memory List Audit.NET / InMemoryDataProvider Store the audit logs in memory in a thread-safe list. Useful for testing purposes. .UseInMemoryProvider()
InMemory In-Memory Blocking Collection Audit.NET / BlockingCollectionDataProvider Store the audit events in a BlockingCollection that can be accessed by different threads to consume the events .UseInMemoryBlockingCollectionProvider()
InMemory In-Memory Channel Audit.NET.Channels / ChannelDataProvider Store the audit events in a Channel (from System.Threading.Channels) that can be accessed to consume the events .UseInMemoryChannelProvider()
Logging Log4net Audit.NET.log4net / Log4netDataProvider Store the audit events using Apache log4net™. .UseLog4net()
Logging NLog Audit.NET.NLog / NLogDataProvider Store the audit events using NLog. .UseNLog()
Logging Serilog Audit.NET.Serilog / SerilogDataProvider Store the audit events using Serilog™ .UseSerilog()
Network UDP Audit.NET.Udp / UdpDataProvider Send Audit Logs as UDP datagrams to a network. .UseUdp()
Wrapper Conditional Audit.NET / ConditionalDataProvider Allows the configuration of different data providers based on conditions related to the audit event. .UseConditional()
Wrapper Deferred Audit.NET / DeferredDataProvider Facilitates delayed data provider instantiation via a factory method that is invoked for each Audit Event. .UseDeferredFactory()
Wrapper Dynamic Audit.NET / DynamicDataProvider / DynamicAsyncDataProvider Dynamically change the behavior at run-time. Define Insert and a Replace actions with lambda expressions. .UseDynamicProvider() / .UseDynamicAsyncProvider()
Wrapper Lazy Audit.NET / LazyDataProvider Facilitates delayed data provider instantiation via a factory method that is invoked just once, upon the initial need. .UseLazyFactory()
Wrapper Polly Audit.NET.Polly / PollyDataProvider Allows to define Polly resilience strategies to any Data Provider .UsePolly()

Event Creation Policy

The audit scope can be configured to call its data provider in different ways:

  • Insert on End: (default) The audit event is inserted when the scope is disposed.

  • Insert on Start, Replace on End: The event (in its initial state) is inserted when the scope is created, and then the complete event information is replaced when the scope is disposed.

  • Insert on Start, Insert on End: Two versions of the event are inserted, the initial when the scope is created, and the final when the scope is disposed.

  • Manual: The event saving (insert/replace) should be explicitly invoked by calling the Save() method on the AuditScope.

You can set the Creation Policy per scope, for example, to explicitly set the Creation Policy to Manual:

using (var scope = AuditScope.Create(new AuditScopeOptions { CreationPolicy = EventCreationPolicy.Manual }))
{
    //...
    scope.Save();
}

Note

If you don't provide a Creation Policy, the default Creation Policy configured will be used (see the configuration section).

AuditScope statechart

The following is the internal state machine representation of the AuditScope object:

<img src="https://i.imgur.com/7WqGECe.png" alt="AuditScope statecart" />

Configuration

Data provider

To change the default data provider, set the static property DataProvider on Audit.Core.Configuration class. This should be done before the AuditScope creation, i.e. during application startup.

For example, to set your own provider as the default data provider:

Audit.Core.Configuration.DataProvider = new MyCustomDataProvider();

Note

If you don't specify a Data Provider, a default FileDataProvider will be used to write the events as .json files into the current working directory.

Creation Policy

To change the default creation policy, set the static property CreationPolicy on Audit.Core.Configuration class. This should be done before the AuditScope creation, i.e. during application startup.

For example, to set the default creation policy to Manual:

Audit.Core.Configuration.CreationPolicy = EventCreationPolicy.Manual;

Note

If you don't specify a Creation Policy, the default Insert on End will be used.

Custom Actions

You can configure Custom Actions that are executed for all the Audit Scopes in your application. This allows to globally change the behavior and data, intercepting the scopes after they are created or before they are saved.

Call the static AddCustomAction() method on Audit.Core.Configuration class to attach a custom action.

For example, to globally discard the events under a certain condition:

Audit.Core.Configuration.AddCustomAction(ActionType.OnScopeCreated, scope =>
{
    if (DateTime.Now.Hour == 17) // Tea time
    {
        scope.Discard();
    }
});

Or to add custom fields/comments globally to all scopes:

Audit.Core.Configuration.AddCustomAction(ActionType.OnEventSaving, scope =>
{
    if (scope.Event.Environment.Exception != null)
    {
        scope.SetCustomField("Oops", true);
    }
    scope.Comment("Saved at " + DateTime.Now);
});

Custom actions can also be asynchronous, for example:

Audit.Core.Configuration.AddCustomAction(ActionType.OnScopeCreated, async scope =>
{
    var result = await svcProvider.GetService<InfoService>().GetInfoAsync();
    scope.SetCustomField("Info", result);
});

The ActionType indicates when to perform the action. The allowed values are:

  • OnScopeCreated: When the Audit Scope is being created, before any saving. This is executed once per Audit Scope.
  • OnEventSaving: When an Audit Scope's Event is about to be saved.
  • OnEventSaved: After an Audit Scope's Event is saved.
  • OnScopeDisposed: When an Audit Scope is disposed.

Stack Trace

To include the stack trace details into the event environment, ensure that the IncludeStackTrace configuration is set to true. Default is false.

Audit.Core.Configuration.IncludeStackTrace = true;

or

Audit.Core.Configuration.Setup()
    .IncludeStackTrace();

Activity Trace

To include the current activity trace details from System.Diagnostics.Activity API into the event, ensure that the IncludeActivityTrace configuration is set to true. The default is false.

It will include the current Activity operation name, ID, and StartTime, along with associated Tags and Events.

Audit.Core.Configuration.IncludeActivityTrace = true;

or

Audit.Core.Configuration.Setup()
    .IncludeActivityTrace();

To create and start a new distributed activity trace, you can use the StartActivityTrace configuration:

Audit.Core.Configuration.Setup()
    .StartActivityTrace();

Global switch off

You can disable audit logging by setting the static property Configuration.AuditDisabled to true. The audit events are globally ignored while this flag is set. For example to disable the audits on certain environments:

if (environment.IsDevelopment())
{
    Audit.Core.Configuration.AuditDisabled = true;
}

Global serialization settings

Most of the data providers serialize audit events in JSON format. Audit.NET uses System.Text.Json by default for the serialization and deserialization of audit events.

If you want to change the behavior, you can change the settings via the static property Configuration.JsonSettings.

For example:

Audit.Core.Configuration.JsonSettings = new JsonSerializerOptions
{
    DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingDefault,
    AllowTrailingCommas = true
};
Custom serialization mechanism

If you want to use a custom JSON serialization mechanism for the Audit Events, you can create a class implementing IJsonAdapter and assign it to the static property Configuration.JsonAdapter.

For example:

Audit.Core.Configuration.JsonAdapter = new MyCustomAdapter(); 

Or by using the fluent API:

Audit.Core.Configuration.Setup()
    .JsonAdapter<MyCustomAdapter>()
    ...

Note

Take into account that some of the AuditEvent properties rely on attribute decoration for serialization and deserialization. The recommendation is to use the default adapter and, when needed, use the Newtonsoft Json adapter provided (see next section).

Alternative serialization mechanism

This library offers the option to configure an alternative JSON serialization mechanism through the following adapter:

  • Audit.NET.JsonNewtonsoftAdapter

    Use this when you prefer employing Newtonsoft.Json as the serialization mechanism.

    Assign an instance of JsonNewtonsoftAdapter to the static configuration property Configuration.JsonAdapter. For example:

    var settings = new JsonSerializerSettings()
    {
        TypeNameHandling = TypeNameHandling.All
    };
    Audit.Core.Configuration.JsonAdapter = new JsonNewtonsoftAdapter(settings);
    

    Alternatively, you can use the fluent configuration API with the JsonNewtonsoftAdapter() method, like this:

    Audit.Core.Configuration.Setup()
        .JsonNewtonsoftAdapter(settings)
        ...
    

    NOTE: This JsonNewtonsoftAdapter takes into account JsonExtensionDataAttribute and JsonIgnoreAttribute decorators from both System.Text.Json and Newtonsoft.Json, so the Audit Events will be properly serialized.

Configuration Fluent API

Alternatively to the properties/methods mentioned before, you can configure the library using a convenient Fluent API provided by the method Audit.Core.Configuration.Setup(), this is the most straightforward way to configure the library.

For example, to set the FileLog Provider with its default settings using a Manual creation policy:

Audit.Core.Configuration.Setup
    .IncludeStackTrace()
    .IncludeActivityTrace()
    .UseFileLogProvider()
    .WithCreationPolicy(EventCreationPolicy.Manual);

Configuration examples

File log provider with dynamic directory path and filename:
Audit.Core.Configuration.Setup()
    .UseFileLogProvider(config => config
        .DirectoryBuilder(_ => $@"C:\Logs\{DateTime.Now:yyyy-MM-dd}")
        .FilenameBuilder(auditEvent => $"{auditEvent.Environment.UserName}_{DateTime.Now.Ticks}.json"));
File log provider with an InsertOnStart-ReplaceOnEnd creation policy, and a global custom field set in a custom action:
Audit.Core.Configuration.Setup()
    .UseFileLogProvider(config => config
        .FilenamePrefix("Event_")
        .Directory(@"C:\AuditLogs\1"))
    .WithCreationPolicy(EventCreationPolicy.InsertOnStartReplaceOnEnd)
    .WithAction(x => x.OnScopeCreated(scope => scope.SetCustomField("ApplicationId", "MyApplication")));
Event log provider with an InsertOnEnd creation policy:
Audit.Core.Configuration.Setup()
    .UseEventLogProvider(config => config
        .SourcePath("My Audited Application")
        .LogName("Application"))
    .WithCreationPolicy(EventCreationPolicy.InsertOnEnd);
Dynamic provider to log to the console:
Audit.Core.Configuration.Setup()
    .UseDynamicProvider(config => config
        .OnInsert(ev => Console.WriteLine("{0}: {1}->{2}", ev.StartDate, ev.Environment.UserName, ev.EventType)));
Multiple providers with conditional logic:
var sqlDataProvider = new SqlDataProvider(sql => sql.ConnectionString(CnnString).TableName("Logs"));
var fileDataProvider = new FileDataProvider(file => file.Directory(@"C:\logs"));

Audit.Core.Configuration.Setup()
    .UseConditional(c => c
        .When(ev => ev.EventType == "API", sqlDataProvider)
        .Otherwise(fileDataProvider));

Extensions

The following packages are extensions to log interactions with different systems such as MVC, WebApi, WCF, and Entity Framework:

<a></a> Package Description
<img src="https://i.imgur.com/hVMM5WF.png" alt="icon" width="90"/> Audit.DynamicProxy Generate detailed audit logs for any class without changing its code by using a proxy.
<img src="https://i.imgur.com/wdVHFoc.png" alt="icon" width="90"/> Audit.EntityFramework Generate detailed audit logs for saving operations on Entity Framework, by inheriting from a provided DbContext or IdentityDbContext. Includes support for EF 6 and EF 7 (EF Core).
<img src="https://i.imgur.com/Fn4thn0.png" alt="icon" width="90"/> Audit.FileSystem Generate audit logs by intercepting file system events via FileSystemWatcher.
<img src="https://i.imgur.com/8lV5DRk.png" alt="icon" width="90" /> Audit.HttpClient Generate detailed client-side audit logs for HttpClient REST calls, by configuring a provided message handler.
<img src="https://i.imgur.com/ap6CeoG.png" alt="icon" width="90"/> Audit.MVC Generate detailed audit logs by decorating MVC Actions and Controllers with an action filter attribute. Includes support for ASP.NET Core MVC.
<img src="https://i.imgur.com/GB2e52X.jpg" alt="icon" width="90"/> Audit.SignalR Generate audit logs for SignalR and SignalR Core invocations by intercepting the hub processing
<img src="https://i.imgur.com/p6knit4.png" alt="icon" width="90" /> Audit.WCF Generate detailed server-side audit logs for Windows Communication Foundation (WCF) service calls, by configuring a provided behavior.
<img src="https://i.imgur.com/p6knit4.png" alt="icon" width="90" /> Audit.WCF.Client Generate detailed client-side audit logs for Windows Communication Foundation (WCF) service calls, by configuring a provided behavior.
<img src="https://i.imgur.com/9go2b0f.png" alt="icon" width="90"/> Audit.WebApi Generate detailed audit logs by decorating Web API Methods and Controllers with an action filter attribute, or by using a middleware. Includes support for ASP.NET Core.
<img src="https://i.imgur.com/1nMVLQo.png" alt="icon" width="90"/> Audit.MongoClient Generate detailed audit logs by adding a Command Event Subscriber into the configuration of the MongoDB Driver.

Storage providers

Apart from the FileLog, EventLog and Dynamic event storage providers, there are others included in different packages:

<a></a> Package Description
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/amazondynamodb.svg" /> Audit.NET.AmazonQLDB Store the audit events in Amazon QLDB (Quantum Ledger Database).
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/microsoftazure.svg" /> Audit.NET.AzureCosmos Store the events in an Azure Cosmos DB container, in JSON format.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/microsoftazure.svg" /> Audit.NET.AzureStorage Store the events in an Azure Blob Storage container or an Azure Table using the legacy client WindowsAzure.Storage.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/microsoftazure.svg" /> Audit.NET.AzureStorageBlobs Store the events in an Azure Blob Storage container using the latest client Azure.Storage.Blobs.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/microsoftazure.svg" /> Audit.NET.AzureStorageTables Store the events in an Azure Table Storage using the latest client Azure.Data.Tables.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/csharp.svg" /> Audit.NET.Channels Store the audit events in a Channel (from System.Threading.Channels) that can be accessed to consume the events.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/amazondynamodb.svg" /> Audit.NET.DynamoDB Store the audit events in Amazon DynamoDB tables.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/elasticsearch.svg" /> Audit.NET.Elasticsearch Store the audit events in Elasticsearch indices.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/apachekafka.svg" /> Audit.NET.Kafka Stream the audit events to an Apache Kafka server.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/csharp.svg" /> Audit.NET.log4net Store the audit events using Apache log4net™.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/mongodb.svg" /> Audit.NET.MongoDB Store the events in a Mongo DB Collection, in BSON format.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/mysql.svg" /> Audit.NET.MySql Store the events as rows in MySQL database, in JSON format.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/csharp.svg" /> Audit.NET.NLog Store the audit events using NLog™.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/csharp.svg" /> Audit.NET.Polly Define Polly resiliencie strategies to any data provider.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/postgresql.svg" /> Audit.NET.PostgreSql Store the events as rows in a PostgreSQL database, in JSON format.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/csharp.svg" /> Audit.NET.RavenDB Store the events as documents in a Raven DB database, in JSON format.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/redis.svg" /> Audit.NET.Redis Store Audit Logs in a Redis database as String, List, Hash, Sorted Set, Streams or publishing to a Redis PubSub channel.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/microsoftsqlserver.svg" /> Audit.NET.SqlServer Store the events as rows in a SQL Table, in JSON format.
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/csharp.svg" /> Audit.NET.Serilog Store the audit events using Serilog™
<img width="80" src="https://unpkg.com/simple-icons@v11/icons/csharp.svg" /> Audit.NET.Udp Send audit events as UDP datagrams to a network.

Change Log

For detailed information on changes in the new release refer to the change log.

Contribute

If you like this project please contribute in any of the following ways:

  • Sponsoring this project.
  • Star this project on GitHub.
  • Request a new feature or expose any bug you found by creating a new issue.
  • Ask any questions about the library on StackOverflow.
  • Subscribe to and use the Gitter Audit.NET channel.
  • Support the project by becoming a Backer: Backer    
  • Spread the word by blogging about it, or sharing it on social networks: <p class="share-buttons"> <a href="https://www.facebook.com/sharer/sharer.php?u=https://nuget.org/packages/Audit.NET/&t=Check+out+Audit.NET" target="_blank"> <img width="24" height="24" alt="Share this package on Facebook" src="https://nuget.org/Content/gallery/img/facebook.svg" / > </a> <a href="https://twitter.com/intent/tweet?url=https://nuget.org/packages/Audit.NET/&text=Check+out+Audit.NET" target="_blank"> <img width="24" height="24" alt="Tweet this package" src="https://nuget.org/Content/gallery/img/twitter.svg" /> </a> </p>
  • Donate via PayPal: paypal
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 is compatible.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (62)

Showing the top 5 NuGet packages that depend on Audit.NET:

Package Downloads
Audit.EntityFramework.Core

Generate Audit Logs from EntityFramework context changes

Audit.NET.MongoDB

Store Audit.NET Trail Logs into a MongoDB database

Audit.NET.PostgreSql

Store Audit.NET Trail Logs into a PostgreSQL database

Reo.Core.AutoHistory.Abstractions

Package Description

Audit.WebApi.Core

Generate detailed Audit Logs for AspNet Core Web API Controller calls.

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on Audit.NET:

Repository Stars
Resgrid/Core
The Open Source Computer Aided Dispatch (CAD), Personnel, Shift Management, Automatic Vehicle Location (AVL) and Emergency Management Platform that powers Resgrid.com
thepirat000/spleeter-api
Audio separation API using Spleeter from Deezer
Version Downloads Last updated
25.0.3 2,184 3/13/2024
25.0.2 1,194 3/12/2024
25.0.1 11,908 2/28/2024
25.0.0 32,190 2/16/2024
24.0.1 10,404 2/12/2024
24.0.0 1,387 2/12/2024
23.0.0 125,123 12/14/2023
22.1.0 36,117 12/9/2023
22.0.2 28,803 12/1/2023
22.0.1 45,938 11/16/2023
22.0.0 4,307 11/14/2023
21.1.0 101,820 10/9/2023
21.0.4 89,960 9/15/2023
21.0.3 320,195 7/9/2023
21.0.2 11,055 7/6/2023
21.0.1 149,278 5/27/2023
21.0.0 188,214 4/15/2023
20.2.4 196,038 3/27/2023
20.2.3 232,740 3/17/2023
20.2.2 22,179 3/14/2023
20.2.1 24,106 3/11/2023
20.2.0 30,515 3/7/2023
20.1.6 104,720 2/23/2023
20.1.5 118,530 2/9/2023
20.1.4 100,008 1/28/2023
20.1.3 240,853 12/21/2022
20.1.2 50,406 12/14/2022
20.1.1 20,522 12/12/2022
20.1.0 45,606 12/4/2022
20.0.4 48,889 11/30/2022
20.0.3 163,096 10/28/2022
20.0.2 21,348 10/26/2022
20.0.1 28,652 10/21/2022
20.0.0 275,070 10/1/2022
19.4.1 136,848 9/10/2022
19.4.0 94,201 9/2/2022
19.3.0 56,590 8/23/2022
19.2.2 59,466 8/11/2022
19.2.1 34,909 8/6/2022
19.2.0 76,980 7/24/2022
19.1.4 351,541 5/23/2022
19.1.3 13,693 5/22/2022
19.1.2 26,180 5/18/2022
19.1.1 145,924 4/28/2022
19.1.0 282,912 4/10/2022
19.0.7 291,302 3/13/2022
19.0.6 40,979 3/7/2022
19.0.5 239,316 1/28/2022
19.0.4 64,638 1/23/2022
19.0.3 228,395 12/14/2021
19.0.2 16,726 12/11/2021
19.0.1 187,384 11/20/2021
19.0.0 52,006 11/11/2021
19.0.0-rc.net60.2 4,859 9/26/2021
19.0.0-rc.net60.1 254 9/16/2021
18.1.6 1,103,821 9/26/2021
18.1.5 137,386 9/7/2021
18.1.4 63,586 9/6/2021
18.1.3 47,130 8/19/2021
18.1.2 37,422 8/8/2021
18.1.1 28,117 8/5/2021
18.1.0 34,586 8/1/2021
18.0.1 11,293 7/30/2021
18.0.0 20,207 7/26/2021
17.0.8 96,260 7/7/2021
17.0.7 74,633 6/16/2021
17.0.6 30,507 6/5/2021
17.0.5 27,223 5/28/2021
17.0.4 103,778 5/4/2021
17.0.3 16,193 5/1/2021
17.0.2 63,966 4/22/2021
17.0.1 22,434 4/18/2021
17.0.0 124,760 3/26/2021
16.5.6 17,255 3/25/2021
16.5.5 33,556 3/23/2021
16.5.4 32,223 3/9/2021
16.5.3 27,446 2/26/2021
16.5.2 12,439 2/23/2021
16.5.1 24,197 2/21/2021
16.5.0 33,756 2/17/2021
16.4.5 20,922 2/15/2021
16.4.4 24,879 2/5/2021
16.4.3 21,932 1/27/2021
16.4.2 21,309 1/22/2021
16.4.1 11,242 1/21/2021
16.4.0 38,891 1/11/2021
16.3.3 9,754 1/8/2021
16.3.2 22,423 1/3/2021
16.3.1 12,274 12/31/2020
16.3.0 23,555 12/30/2020
16.2.1 136,057 12/27/2020
16.2.0 218,736 10/13/2020
16.1.5 56,265 10/4/2020
16.1.4 57,138 9/17/2020
16.1.3 18,530 9/13/2020
16.1.2 19,014 9/9/2020
16.1.1 40,855 9/3/2020
16.1.0 364,946 8/19/2020
16.0.3 61,401 8/15/2020
16.0.2 45,464 8/9/2020
16.0.1 10,087 8/8/2020
16.0.0 25,472 8/7/2020
15.3.0 564,218 7/23/2020
15.2.3 45,362 7/14/2020
15.2.2 247,598 5/19/2020
15.2.1 55,982 5/12/2020
15.2.0 13,363 5/9/2020
15.1.1 31,860 5/4/2020
15.1.0 67,416 4/13/2020
15.0.5 129,348 3/18/2020
15.0.4 48,141 2/28/2020
15.0.3 10,108 2/26/2020
15.0.2 209,820 1/20/2020
15.0.1 39,889 1/10/2020
15.0.0 34,750 12/17/2019
14.9.1 118,285 11/30/2019
14.9.0 9,645 11/29/2019
14.8.1 31,825 11/26/2019
14.8.0 50,967 11/20/2019
14.7.0 162,036 10/9/2019
14.6.6 9,745 10/8/2019
14.6.5 69,602 9/27/2019
14.6.4 14,571 9/21/2019
14.6.3 95,716 8/12/2019
14.6.2 22,063 8/3/2019
14.6.1 8,877 8/3/2019
14.6.0 38,402 7/26/2019
14.5.7 41,433 7/18/2019
14.5.6 71,295 7/10/2019
14.5.5 22,343 7/1/2019
14.5.4 33,029 6/17/2019
14.5.3 31,088 6/5/2019
14.5.2 27,626 5/30/2019
14.5.1 18,959 5/28/2019
14.5.0 42,595 5/24/2019
14.4.0 12,485 5/22/2019
14.3.4 24,836 5/14/2019
14.3.3 11,377 5/9/2019
14.3.2 51,964 4/30/2019
14.3.1 12,383 4/27/2019
14.3.0 14,138 4/24/2019
14.2.3 20,881 4/17/2019
14.2.2 28,401 4/10/2019
14.2.1 33,970 4/5/2019
14.2.0 70,928 3/16/2019
14.1.1 27,746 3/8/2019
14.1.0 41,101 2/11/2019
14.0.4 56,559 1/31/2019
14.0.3 18,900 1/22/2019
14.0.2 68,965 12/15/2018
14.0.1 41,771 11/29/2018
14.0.0 41,999 11/19/2018
13.3.0 10,933 11/16/2018
13.2.2 10,513 11/15/2018
13.2.1 12,406 11/13/2018
13.2.0 20,586 10/31/2018
13.1.5 9,863 10/31/2018
13.1.4 15,508 10/25/2018
13.1.3 12,322 10/18/2018
13.1.2 32,140 9/12/2018
13.1.1 11,016 9/11/2018
13.1.0 9,355 9/11/2018
13.0.0 26,023 8/29/2018
12.3.6 11,071 8/29/2018
12.3.5 43,451 8/22/2018
12.3.4 9,400 8/21/2018
12.3.3 33,625 8/21/2018
12.3.2 18,056 8/20/2018
12.3.1 8,691 8/20/2018
12.3.0 8,473 8/20/2018
12.2.2 11,345 8/15/2018
12.2.1 13,461 8/9/2018
12.2.0 8,927 8/8/2018
12.1.11 15,262 7/30/2018
12.1.10 21,374 7/20/2018
12.1.9 16,913 7/10/2018
12.1.8 12,104 7/2/2018
12.1.7 91,254 6/7/2018
12.1.6 32,448 6/4/2018
12.1.5 9,983 6/2/2018
12.1.4 16,986 5/25/2018
12.1.3 14,031 5/16/2018
12.1.2 9,645 5/15/2018
12.1.1 10,948 5/14/2018
12.1.0 15,794 5/9/2018
12.0.7 21,177 5/5/2018
12.0.6 10,196 5/4/2018
12.0.5 9,708 5/3/2018
12.0.4 13,271 4/30/2018
12.0.3 9,678 4/30/2018
12.0.2 9,295 4/27/2018
12.0.1 10,075 4/25/2018
12.0.0 10,438 4/22/2018
11.2.0 17,791 4/11/2018
11.1.0 12,049 4/8/2018
11.0.8 10,089 3/26/2018
11.0.7 9,832 3/20/2018
11.0.6 16,209 3/7/2018
11.0.5 17,200 2/22/2018
11.0.4 11,521 2/14/2018
11.0.3 9,570 2/12/2018
11.0.2 10,916 2/9/2018
11.0.1 13,584 1/29/2018
11.0.0 16,276 1/15/2018
10.0.3 12,087 12/29/2017
10.0.2 9,873 12/26/2017
10.0.1 9,579 12/18/2017
10.0.0 10,070 12/18/2017
9.3.0 8,626 12/17/2017
9.2.0 8,401 12/17/2017
9.1.3 21,457 12/5/2017
9.1.2 10,504 11/27/2017
9.1.1 10,194 11/21/2017
9.1.0 8,274 11/21/2017
9.0.1 8,611 11/11/2017
9.0.0 8,420 11/10/2017
8.7.0 16,662 11/9/2017
8.6.0 8,534 11/9/2017
8.5.0 21,964 10/3/2017
8.4.0 8,436 10/3/2017
8.3.1 13,149 9/8/2017
8.3.0 8,343 9/8/2017
8.2.0 8,420 9/4/2017
8.1.0 10,068 8/22/2017
8.0.0 25,096 8/19/2017
7.1.3 8,314 8/14/2017
7.1.2 8,188 8/2/2017
7.1.1 7,699 7/26/2017
7.1.0 10,546 7/5/2017
7.0.9 7,066 6/28/2017
7.0.8 7,300 6/19/2017
7.0.6 20,606 4/7/2017
7.0.5 6,582 3/21/2017
7.0.4 5,838 3/21/2017
7.0.3 5,894 3/20/2017
7.0.2 5,605 3/13/2017
7.0.0 7,135 3/1/2017
6.2.0 8,037 2/25/2017
6.1.0 9,938 2/14/2017
6.0.0 5,435 2/9/2017
5.3.0 4,824 2/5/2017
5.2.0 5,537 1/26/2017
5.1.0 4,910 1/19/2017
5.0.0 4,748 1/7/2017
4.11.0 4,767 1/5/2017
4.10.0 4,662 12/31/2016
4.9.0 4,777 12/26/2016
4.8.0 5,010 12/17/2016
4.7.0 4,882 12/8/2016
4.6.5 4,808 12/4/2016
4.6.4 4,811 11/25/2016
4.6.2 7,511 11/18/2016
4.6.1 4,531 11/15/2016
4.6.0 4,568 11/11/2016
4.5.9 5,121 11/2/2016
4.5.8 4,470 11/2/2016
4.5.7 4,480 10/26/2016
4.5.6 4,665 10/6/2016
4.5.5 4,474 10/3/2016
4.5.4 4,423 10/2/2016
4.5.3 4,410 9/30/2016
4.5.2 4,480 9/28/2016
4.5.1 4,319 9/28/2016
4.5.0 4,461 9/28/2016
4.4.0 4,318 9/23/2016
4.3.0 4,289 9/22/2016
4.2.0 4,156 9/19/2016
4.1.0 3,839 9/13/2016
4.0.1 4,606 9/9/2016
4.0.0 3,903 9/9/2016
3.6.0 4,398 9/7/2016
3.4.0 4,657 9/7/2016
3.3.0 3,314 9/4/2016
3.2.0 3,251 9/3/2016
3.1.0 3,416 9/2/2016
3.0.0 4,216 8/31/2016
2.5.0 4,437 8/27/2016
2.4.0 3,808 8/26/2016
2.3.0 3,460 8/22/2016
2.2.0 1,785 8/22/2016
2.1.0 3,382 8/22/2016
2.0.0 2,933 8/21/2016
1.0.0.4 2,968 8/19/2016
1.0.0.3 3,204 8/18/2016
1.0.0.1 3,595 8/18/2016
1.0.0 2,115 8/18/2016