AWS.Lambda.Powertools.Logging 2.0.0
AWS.Lambda.Powertools.Logging
The logging utility provides a AWS Lambda optimized logger with output structured as JSON.
Key features
- Capture key fields from Lambda context, cold start and structures logging output as JSON
- Log Lambda event when instructed (disabled by default)
- Log sampling enables DEBUG log level for a percentage of requests (disabled by default)
- Append additional keys to structured log at any point in time
Read the docs
For a full list of features go to docs.powertools.aws.dev/lambda/dotnet/core/logging/
GitHub: https://github.com/aws-powertools/powertools-lambda-dotnet/
Sample Function
public class Function
{
[Logging(LogEvent = true)]
public async Task<APIGatewayProxyResponse> FunctionHandler(APIGatewayProxyRequest apigwProxyEvent,
ILambdaContext context)
{
var requestContextRequestId = apigwProxyEvent.RequestContext.RequestId;
var lookupInfo = new Dictionary<string, object>()
{
{"LookupInfo", new Dictionary<string, object>{{ "LookupId", requestContextRequestId }}}
};
// Appended keys are added to all subsequent log entries in the current execution.
// Call this method as early as possible in the Lambda handler.
// Typically this is value would be passed into the function via the event.
// Set the ClearState = true to force the removal of keys across invocations,
Logger.AppendKeys(lookupInfo);
Logger.LogInformation("Getting ip address from external service");
var location = await GetCallingIp();
var lookupRecord = new LookupRecord(lookupId: requestContextRequestId,
greeting: "Hello Powertools for AWS Lambda (.NET)", ipAddress: location);
try
{
await SaveRecordInDynamo(lookupRecord);
return new APIGatewayProxyResponse
{
Body = JsonSerializer.Serialize(lookupRecord),
StatusCode = 200,
Headers = new Dictionary<string, string> { { "Content-Type", "application/json" } }
};
}
catch (Exception e)
{
Logger.LogError(e.Message);
return new APIGatewayProxyResponse
{
Body = e.Message,
StatusCode = 500,
Headers = new Dictionary<string, string> { { "Content-Type", "application/json" } }
};
}
}
}
Sample output
{
"cold_start": false,
"xray_trace_id": "1-623d34cb-00c3698b02f11dc713442693",
"lookup": {
"lookup_id": "7d2ce9bb-c7d1-4304-9912-6078d276604f"
},
"function_name": "PowertoolsLoggingSample-HelloWorldFunction-hm1r10VT3lCy",
"function_version": "$LATEST",
"function_memory_size": 256,
"function_arn": "arn:aws:lambda:ap-southeast-2:111111111111:function:PowertoolsLoggingSample-HelloWorldFunction-hm1r10VT3lCy",
"function_request_id": "f5c3bae7-0e18-495a-9959-ef101c7afbc0",
"timestamp": "2022-03-25T03:19:39.9322301Z",
"level": "Information",
"service": "powertools-dotnet-logging-sample",
"name": "AWS.Lambda.Powertools.Logging.Logger",
"message": "Getting ip address from external service"
}
No packages depend on AWS.Lambda.Powertools.Logging.
.NET 6.0
- Amazon.Lambda.Core (>= 2.5.0)
- Amazon.Lambda.Serialization.SystemTextJson (>= 2.4.4)
- AspectInjector (>= 2.8.1)
- Microsoft.Extensions.Logging (>= 8.0.1)
- Microsoft.Extensions.Logging.Configuration (>= 8.0.1)
.NET 8.0
- Amazon.Lambda.Core (>= 2.5.0)
- Amazon.Lambda.Serialization.SystemTextJson (>= 2.4.4)
- AspectInjector (>= 2.8.1)
- Microsoft.Extensions.Logging (>= 8.0.1)
- Microsoft.Extensions.Logging.Configuration (>= 8.0.1)
| Version | Downloads | Last updated |
|---|---|---|
| 3.2.2 | 30 | 06/23/2026 |
| 3.2.1 | 7 | 07/17/2026 |
| 3.2.0 | 14 | 07/03/2026 |
| 3.1.0 | 16 | 06/26/2026 |
| 3.0.2 | 13 | 06/28/2026 |
| 3.0.1 | 18 | 07/01/2026 |
| 3.0.1-alpha | 17 | 06/30/2026 |
| 3.0.0 | 14 | 06/28/2026 |
| 2.0.2 | 14 | 07/17/2026 |
| 2.0.1 | 13 | 06/26/2026 |
| 2.0.0 | 22 | 06/27/2026 |
| 2.0.0-preview.1 | 10 | 06/23/2026 |
| 1.7.0 | 18 | 07/18/2026 |
| 1.6.5 | 19 | 06/26/2026 |
| 1.6.4 | 23 | 07/01/2026 |
| 1.6.3 | 12 | 06/26/2026 |
| 1.6.2 | 17 | 07/18/2026 |
| 1.6.2-alpha2 | 12 | 07/17/2026 |
| 1.6.2-alpha | 11 | 06/26/2026 |
| 1.6.1 | 12 | 06/27/2026 |
| 1.6.0 | 11 | 07/01/2026 |
| 1.6.0-alpha | 15 | 06/25/2026 |
| 1.5.1 | 18 | 06/30/2026 |
| 1.4.4 | 14 | 07/17/2026 |
| 1.3.3 | 17 | 12/11/2023 |
| 1.3.2 | 18 | 01/05/2024 |
| 1.3.0 | 26 | 01/03/2024 |
| 1.2.0 | 16 | 12/15/2023 |
| 1.1.1 | 22 | 01/09/2024 |
| 1.1.0 | 19 | 01/09/2024 |
| 1.0.1 | 16 | 01/04/2024 |
| 1.0.0 | 16 | 01/09/2024 |
| 0.0.2-preview | 23 | 01/10/2024 |
| 0.0.1-preview.1 | 22 | 06/29/2026 |