AWS CDK Reference

Appearance

v2.277.0

SystemLogLevel Enum ​

Lambda service will automatically captures system logs about function invocation generated by the Lambda service (known as system logs) and sends these logs to a default CloudWatch log group named after the Lambda function.

Source
aws-lambda/lib/function.ts
Type last changed
v2.110.0 · 17 Nov 2023

Example ​

ts
import { ILogGroup } from 'aws-cdk-lib/aws-logs';

declare const logGroup: ILogGroup;

new lambda.Function(this, 'Lambda', {
  code: new lambda.InlineCode('foo'),
  handler: 'index.handler',
  runtime: lambda.Runtime.NODEJS_LATEST,
  loggingFormat: lambda.LoggingFormat.JSON,
  systemLogLevelV2: lambda.SystemLogLevel.INFO,
  applicationLogLevelV2: lambda.ApplicationLogLevel.INFO,
  logGroup: logGroup,
});
python
from aws_cdk.aws_logs import ILogGroup

# log_group: ILogGroup


lambda_.Function(self, "Lambda",
    code=lambda_.InlineCode("foo"),
    handler="index.handler",
    runtime=lambda_.Runtime.NODEJS_LATEST,
    logging_format=lambda_.LoggingFormat.JSON,
    system_log_level_v2=lambda_.SystemLogLevel.INFO,
    application_log_level_v2=lambda_.ApplicationLogLevel.INFO,
    log_group=log_group
)
java
import software.amazon.awscdk.services.logs.ILogGroup;

ILogGroup logGroup;


Function.Builder.create(this, "Lambda")
        .code(new InlineCode("foo"))
        .handler("index.handler")
        .runtime(Runtime.NODEJS_LATEST)
        .loggingFormat(LoggingFormat.JSON)
        .systemLogLevelV2(SystemLogLevel.INFO)
        .applicationLogLevelV2(ApplicationLogLevel.INFO)
        .logGroup(logGroup)
        .build();
csharp
// Install: dotnet add package Amazon.CDK.Lib
using Amazon.CDK.AWS.Logs;

ILogGroup logGroup;


new Function(this, "Lambda", new FunctionProps {
    Code = new InlineCode("foo"),
    Handler = "index.handler",
    Runtime = Runtime.NODEJS_LATEST,
    LoggingFormat = LoggingFormat.JSON,
    SystemLogLevelV2 = SystemLogLevel.INFO,
    ApplicationLogLevelV2 = ApplicationLogLevel.INFO,
    LogGroup = logGroup
});
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
import "github.com/aws/aws-cdk-go/awscdk"

var logGroup ILogGroup


lambda.NewFunction(this, jsii.String("Lambda"), &FunctionProps{
	Code: lambda.NewInlineCode(jsii.String("foo")),
	Handler: jsii.String("index.handler"),
	Runtime: lambda.Runtime_NODEJS_LATEST(),
	LoggingFormat: lambda.LoggingFormat_JSON,
	SystemLogLevelV2: lambda.SystemLogLevel_INFO,
	ApplicationLogLevelV2: lambda.ApplicationLogLevel_INFO,
	LogGroup: logGroup,
})

Members ​

MemberDescription
INFOLambda will capture only logs at info level.
DEBUGLambda will capture only logs at debug level.
WARNLambda will capture only logs at warn level.

Referenced by ​

  • CapacityProviderProps.systemLogLevelsystem_log_levelsystemLogLevelSystemLogLevelSystemLogLevel
  • FunctionOptions.systemLogLevelV2system_log_level_v2systemLogLevelV2SystemLogLevelV2SystemLogLevelV2
  • WebFunctionProps.systemLogLevelsystem_log_levelsystemLogLevelSystemLogLevelSystemLogLevel