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); }