com.amazonaws.services.lambda.runtime.api.client.logging

Class FramedTelemetryLogSink

java.lang.Object

com.amazonaws.services.lambda.runtime.api.client.logging.FramedTelemetryLogSink

All Implemented Interfaces:

LogSink, Closeable, AutoCloseable

public class FramedTelemetryLogSink
extends Object
implements LogSink

FramedTelemetryLogSink implements the logging contract between runtimes and the platform. It implements a simple framing protocol so message boundaries can be determined. Each frame can be visualized as follows:

 
 +----------------------+------------------------+---------------------+-----------------------+
 | Frame Type - 4 bytes | Length (len) - 4 bytes | Timestamp - 8 bytes | Message - 'len' bytes |
 +----------------------+------------------------+---------------------+-----------------------+
 
 

The first 4 bytes indicate the type of the frame - log frames have a type defined as the hex value 0xa55a0001. The second 4 bytes should indicate the message's length. The next 8 bytes contain UNIX timestamp of the message in microsecond accuracy. The next 'len' bytes contain the message. The byte order is big-endian.

Constructor Summary

Constructors

Constructor and Description
FramedTelemetryLogSink(FileDescriptor fd)

Method Summary

Modifier and Type	Method and Description
void	close()
void	log(byte[] message)
void	log(com.amazonaws.services.lambda.runtime.logging.LogLevel logLevel, com.amazonaws.services.lambda.runtime.logging.LogFormat logFormat, byte[] message)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FramedTelemetryLogSink

public FramedTelemetryLogSink(FileDescriptor fd)
                       throws IOException

Throws:

IOException

Method Detail

log

public void log(com.amazonaws.services.lambda.runtime.logging.LogLevel logLevel,
                com.amazonaws.services.lambda.runtime.logging.LogFormat logFormat,
                byte[] message)

Specified by:

log in interface LogSink

log

public void log(byte[] message)

Specified by:

log in interface LogSink

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException