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 .

Type: String

Module

The Module property holds .

Type: String

ModuleId

The ModuleId property holds .

Type: String

FunctionId

The FunctionId property holds .

Type: String

FunctionName

The FunctionName property holds .

Type: String

Platform

The Platform property holds .

Type: String

Framework

The Framework property holds .

Type: String

Language

The Language property holds .

Type: String

GitSha

The GitSha property holds the git SHA checksum when the module was deployed from a git repository, otherwise null.

Type: String or null

GitBranch

The GitBranch property holds the git branch name when the module was deployed from a git repository, otherwise null.

Type: String or null

RequestId

The RequestId property holds the Lambda function invocation request ID if available, otherwise null.

Type: String or null

Level

The Level property describes the severity level of the error log entry. One of WARNING, ERROR, or FATAL.

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, otherwise null.

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, otherwise null.

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, otherwise null.

Type: List of stack frames or null

FileName

The FileName property holds the source code file name of the stack trace when available, otherwise null.

Type: String or null

LineNumber

The LineNumber property holds the line number in the source code when available, otherwise null.

Type: Int or null

ColumnNumber

The ColumnNumber property holds the column number in the source code when available, otherwise null.

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"
}