ServiceStack.CloudTrail.RequestLogsFeature 1.0.1

ServiceStack.CloudTrail.RequestLogsFeature

A ServiceStack plugin that logs requests to AWS CloudTrail as JSON. For more details on JSON logging to CloudTrail, please review this page and this page.

*NB. This version is compatible with ServiceStack v8.x.

Installing

The package is available from nuget.org

Install-Package Servicestack.CloudTrail.RequestLogsFeature

Requirements

You must have an AWS account and a user with access key and secret created.

Quick Start

In your AppHost class Configure method, add the plugin. By default configuration values are read from the registered IAppSettings instance. By default this will be an instance of AppSettings, if an alternative implementation of IAppSettings is to be used it must be registered prior to this plugin being registered. Alternatively all configuration options are exposed as public properties of the feature class.

public override void Configure(Container container)
{
    // Basic setup. All config read from AppSettings
    Plugins.Add(new CloudTrailRequestLogsFeature());

    var logger = new CloudTrailRequestLogsFeature
    {
        // required parameter
        AwsAccessKeyId = "logger_user_key_id",

        // required parameter
        AwsSecretAccessKey = "logger_secret_access_key",

        // a region code from the list: https://www.aws-services.info/regions.html
        // required parameter
        Region = "ca-central-1",
        
        // this is the name of the log group shown within the cloudtrail UI
        // required parameter
        LogGroupName = "{CompanyName}/Api",

        // this can be the individual API instance or ip address of the machine.
        // required parameter
        LogStreamName = calculatedStreamName,
        
        // add additional properties to Cloudtrail log entry.
        AppendProperties = (request, dto, response, duration) => new Dictionary<string, object> { { "NewCustomProperty", "42" } },

        // exclude specific dto types from logging
        ExcludeRequestDtoTypes = new[] { typeof(HealthCheckService.IsAlive) }, 
        
        // exclude request body logging for specific dto types
        HideRequestBodyForRequestDtoTypes = new[] { typeof(HealthCheckService.IsAlive) },
        
        // custom request logging exclusion
        SkipLogging = (request) => request.RawUrl == "/isalive"; 
    };

    this.Plugins.Add(logger);
}

Configuration Options

Request Correlation

This plugin will detect the default header x-mac-requestid created by ServiceStack.Request.Correlation and add this as a property. This is useful for tracking requests from their point of origin across multiple services

Logging in action

Once you start your AppHost, every request will be now logged to cloudtrail using the default options or the options you provided. Logging levels are colour coded and depending on your settings, the full requestDto's and even responseDto's are available to search.