LambdaError Event
The LambdaError event is emitted by LambdaSharp.Core when ingesting a Lambda warning or error report from the associated the CloudWatch logs. Note that Core Services must be enabled for these events to be emitted. The LambdaError event captures information about the warning or error that occurred.
Event Schema
Type: String # LambdaError
Version: String # 2020-05-05
ModuleInfo: String
Module: String
ModuleId: String
FunctionId: String
FunctionName: String
Platform: String
Framework: String
Language: String
GitSha: String?
GitBranch: String?
RequestId: String?
Level: String
Fingerprint: String
Timestamp: Long
Message: String
Raw: String
Traces:
- Exception:
Type: String
Message: String
StackTrace: String?
Frames: #List?
- FileName: String?
LineNumber: Int?
ColumnNumber: Int?
MethodName: String
Event Properties
Type
-
The
Type
property holds the event type name. This property is always set to"LambdaMetrics"
.Type: String
Version
-
The
Version
property holds the event type version. This property is set to"2020-05-05"
.Type: String
ModuleInfo
-
The
ModuleInfo
property holds the LambdaSharp module name, version, and origin.Type: String
Module
-
The
Module
property holds the LambdaSharp module name.Type: String
ModuleId
-
The
ModuleId
property holds the stack name of the deployed LambdaSharp module.Type: String
FunctionId
-
The
FunctionId
property holds the Lambda function name.Type: String
FunctionName
-
The
FunctionName
property holds the Lambda function name.Type: String
AppId
-
The
AppId
property holds the application identifier.Type: String
AppName
-
The
AppName
property holds the application name.Type: String
Platform
-
The
Platform
property holds the Lambda or app execution platform.Type: String
Framework
-
The
Framework
property holds the Lambda or app execution framework.Type: String
Language
-
The
Language
property holds the Lambda or app implementation language.Type: String
GitSha
-
The
GitSha
property holds the git SHA checksum when the module was deployed from a git repository, otherwisenull
.Type: String or
null
GitBranch
-
The
GitBranch
property holds the git branch name when the module was deployed from a git repository, otherwisenull
.Type: String or
null
RequestId
-
The
RequestId
property holds the Lambda function invocation request ID if available, otherwisenull
.Type: String or
null
Level
-
The
Level
property describes the severity level of the error log entry. One ofWARNING
,ERROR
, orFATAL
.Type: String
Fingerprint
-
The
Fingerprint
property holds a hash value that can be used to group related LambdaError events.Type: String
Timestamp
-
The
Timestamp
property holds the UNIX epoch in milliseconds when the error log entry was generated.Type: String
Message
-
The
Message
property holds the message of the LambdaError event.Type: String
Raw
-
The
Raw
property holds unprocessed error log entry.Type: String
Traces
-
The
Traces
property describes the exception stack traces when available, otherwisenull
.Type: List of exception stack traces or
null
Exception
-
The
Exception
property holds information about the exception.Type: String
Type
-
The
Type
property holds the full exception type name.Type: String
Message
-
The
Message
property holds the exception message.Type: String
StackTrace
-
The
StackTrace
property the unparsed exception stack trace when available, otherwisenull
.Type: String or
null
Frames
-
The
Frames
property describes the stack frames between where the exception was thrown and where it was caught when available, otherwisenull
.Type: List of stack frames or
null
FileName
-
The
FileName
property holds the source code file name of the stack trace when available, otherwisenull
.Type: String or
null
LineNumber
-
The
LineNumber
property holds the line number in the source code when available, otherwisenull
.Type: Int or
null
ColumnNumber
-
The
ColumnNumber
property holds the column number in the source code when available, otherwisenull
.Type: Int or
null
MethodName
-
The
MethodName
property holds the method name in which the stack frame is located.Type: String
Event Sample
{
"ModuleInfo": "LambdaSharp.BadModule:1.0-DEV@sandbox-lambdasharp-cor-deploymentbucketresource-9h53iqcat7uj",
"Module": "LambdaSharp.BadModule",
"ModuleId": "Sandbox-LambdaSharp-BadModule",
"FunctionId": "Sandbox-LambdaSharp-BadModule-FailError-9ZWPJT2RI6V6",
"FunctionName": "FailError",
"Platform": "AWS Lambda (Unix 4.14.165.102)",
"Framework": "dotnetcore3.1",
"Language": "csharp",
"GitSha": "DIRTY-a8f11ab357937e3cb87d512f08fc649c8261b1b8",
"GitBranch": "WIP-v0.8",
"RequestId": "f7d92855-628c-4285-ad83-fb7f10a81ec1",
"Level": "ERROR",
"Fingerprint": "F5F7309CD31CCF342EC3ED07679E79FD",
"Timestamp": 1589411401688,
"Message": "this exception was thrown on request",
"Traces": [
{
"Exception": {
"Type": "System.Exception",
"Message": "this exception was thrown on request",
"StackTrace": " at BadModule.FailError.Function.ProcessMessageAsync(FunctionRequest request) in C:\\LambdaSharp\\LambdaSharpTool\\Tests\\BadModule\\FailError\\Function.cs:line 36\n at LambdaSharp.ALambdaFunction`2.ProcessMessageStreamAsync(Stream stream)\n at LambdaSharp.ALambdaFunction.FunctionHandlerAsync(Stream stream, ILambdaContext context) in C:\\LambdaSharp\\LambdaSharpTool\\src\\LambdaSharp\\ALambdaFunction.cs:line 398"
},
"Frames": [
{
"FileName": "C:\\LambdaSharp\\LambdaSharpTool\\Tests\\BadModule\\FailError\\Function.cs",
"LineNumber": 36,
"MethodName": "MoveNext"
},
{
"FileName": "System.Runtime.ExceptionServices.ExceptionDispatchInfo",
"MethodName": "Throw"
},
{
"FileName": "System.Runtime.CompilerServices.TaskAwaiter",
"MethodName": "ThrowForNonSuccess(System.Threading.Tasks.Task task)"
},
{
"FileName": "System.Runtime.CompilerServices.TaskAwaiter",
"MethodName": "HandleNonSuccessAndDebuggerNotification(System.Threading.Tasks.Task task)"
},
{
"FileName": "LambdaSharp.ALambdaFunction`2+<ProcessMessageStreamAsync>d__3[TRequest,TResponse]",
"MethodName": "MoveNext"
},
{
"FileName": "System.Runtime.ExceptionServices.ExceptionDispatchInfo",
"MethodName": "Throw"
},
{
"FileName": "System.Runtime.CompilerServices.TaskAwaiter",
"MethodName": "ThrowForNonSuccess(System.Threading.Tasks.Task task)"
},
{
"FileName": "System.Runtime.CompilerServices.TaskAwaiter",
"MethodName": "HandleNonSuccessAndDebuggerNotification(System.Threading.Tasks.Task task)"
},
{
"FileName": "C:\\LambdaSharp\\LambdaSharpTool\\src\\LambdaSharp\\ALambdaFunction.cs",
"LineNumber": 398,
"MethodName": "MoveNext"
}
]
}
],
"Type": "LambdaError",
"Version": "2020-05-05"
}