docs: Implement Logger and Tracer part

docs/content/core/logger.mdx

@@ -0,0 +1,142 @@
+---
+title: Logger
+description: Core utility
+---
+
+import Note from "../../src/components/Note"
+
+Logger provides an opinionated 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)
+    - Enable explicitly via annotation param
+* Append additional keys to structured log at any point in time
+
+## Initialization
+
+Powertools extends the functionality of Log4J. Below is an example log4j2.xml file, with the LambdaJsonLayout configured.
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<Configuration packages="com.amazonaws.services.lambda.runtime.log4j2">
+    <Appenders>
+        <Console name="JsonAppender" target="SYSTEM_OUT">
+            <LambdaJsonLayout compact="true" eventEol="true"/>
+        </Console>
+    </Appenders>
+    <Loggers>
+        <Logger name="JsonLogger" level="INFO" additivity="false">
+            <AppenderRef ref="JsonAppender"/>
+        </Logger>
+        <Root level="info">
+            <AppenderRef ref="JsonAppender"/>
+        </Root>
+    </Loggers>
+</Configuration>
+```
+
+You can also explicitly set a service name via `POWERTOOLS_SERVICE_NAME` env var. This sets **service** key that will be present across all log statements.
+
+## Standard structured keys
+
+Your Logger will always include the following keys to your structured logging:
+
+Key | Type | Example | Description
+------------------------------------------------- | ------------------------------------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------
+**timestamp** | String | "2020-05-24 18:17:33,774" | Timestamp of actual log statement
+**level** | String | "INFO" | Logging level
+**coldStart** | Boolean | true| ColdStart value.
+**service** | String | "payment" | Service name defined. "service_undefined" will be used if unknown
+**message** | String |  "Collecting payment" | Log statement value. Unserializable JSON values will be casted to string
+**functionName**| String | "example-powertools-HelloWorldFunction-1P1Z6B39FLU73"
+**functionVersion**| String | "12"
+**functionMemorySize**| String | "128"
+**functionArn**| String | "arn:aws:lambda:eu-west-1:012345678910:function:example-powertools-HelloWorldFunction-1P1Z6B39FLU73"
+
+
+## Capturing context Lambda info
+
+You can enrich your structured logs with key Lambda context information via `logEvent` annotation parameter.
+
+```java:title=App.java
+package helloworld;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import software.amazon.lambda.logging.PowerLogger;
+import software.amazon.lambda.logging.PowerToolsLogging;
+...
+
+/**
+ * Handler for requests to Lambda function.
+ */
+public class App implements RequestHandler<APIGatewayProxyRequestEvent, APIGatewayProxyResponseEvent> {
+
+    Logger log = LogManager.getLogger();
+
+    @PowerToolsLogging
+    public APIGatewayProxyResponseEvent handleRequest(final APIGatewayProxyRequestEvent input, final Context context) {
+     ...
+    }
+}
+```
+
+You can also explicitly log any incoming event using `logEvent` param.
+
+<Note type="warning">
+  This is disabled by default to prevent sensitive info being logged.
+</Note><br/>
+
+```java:title=App.java
+package helloworld;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import software.amazon.lambda.logging.PowerLogger;
+import software.amazon.lambda.logging.PowerToolsLogging;
+...
+
+/**
+ * Handler for requests to Lambda function.
+ */
+public class App implements RequestHandler<APIGatewayProxyRequestEvent, APIGatewayProxyResponseEvent> {
+
+    Logger log = LogManager.getLogger();
+
+    @PowerToolsLogging(logEvent = true)
+    public APIGatewayProxyResponseEvent handleRequest(final APIGatewayProxyRequestEvent input, final Context context) {
+     ...
+    }
+}
+```
+
+## Appending additional keys
+
+You can append your own keys to your existing Logger via `customKey`.
+
+```java:title=App.java
+package helloworld;
+
+import org.apache.logging.log4j.LogManager;
+import org.apache.logging.log4j.Logger;
+import software.amazon.lambda.logging.PowerLogger;
+import software.amazon.lambda.logging.PowerToolsLogging;
+...
+
+/**
+ * Handler for requests to Lambda function.
+ */
+public class App implements RequestHandler<APIGatewayProxyRequestEvent, APIGatewayProxyResponseEvent> {
+
+    Logger log = LogManager.getLogger();
+
+    @PowerToolsLogging(logEvent = true)
+    public APIGatewayProxyResponseEvent handleRequest(final APIGatewayProxyRequestEvent input, final Context context) {
+        ...
+        PowerLogger.customKey("test", "willBeLogged");
+        ...
+    }
+}
+```

docs/content/core/tracer.mdx

@@ -0,0 +1,12 @@
+---
+title: Tracer
+description: Core utility
+---
+
+import Note from "../../src/components/Note"
+
+Tracer is an opinionated thin wrapper for [AWS X-Ray Java SDK](https://github.com/aws/aws-xray-sdk-java/).
+
+**Key features**
+
+* Support tracing async methods

docs/content/index.mdx

@@ -21,15 +21,39 @@ Powertools is available in Maven Central. You can use your favourite dependency
     ...
 </dependencies>
 ```
-* [gradle](https://gradle.org/):
-```
-repositories {
-    mavenCentral()
-}
 
-dependencies {
-    powertools 'software.amazon.lambda:aws-lambda-powertools-java:YOUR_REQUIRED_VERSION'
-}
+And configure the aspectj-maven-plugin to compile-time weave (CTW) the aws-lambda-powertools-java aspects into your project:
+
+```xml
+<build>
+    <plugins>
+        ...
+        <plugin>
+             <groupId>com.nickwongdev</groupId>
+             <artifactId>aspectj-maven-plugin</artifactId>
+             <version>1.12.1</version>
+             <configuration>
+                 <source>1.8</source>
+                 <target>1.8</target>
+                 <complianceLevel>1.8</complianceLevel>
+                 <aspectLibraries>
+                     <aspectLibrary>
+                         <groupId>software.amazon.lambda</groupId>
+                         <artifactId>aws-lambda-powertools-java</artifactId>
+                     </aspectLibrary>
+                 </aspectLibraries>
+             </configuration>
+             <executions>
+                 <execution>
+                     <goals>
+                         <goal>compile</goal>
+                     </goals>
+                 </execution>
+             </executions>
+        </plugin>
+        ...
+    </plugins>
+</build>
 ```
 
 ## Tenets

docs/gatsby-browser.js

@@ -8,7 +8,8 @@ export const onRouteUpdate = ({ location, prevLocation }) => {
         data: {
             url: window.location.href,
             section: location.pathname,
-            previous: prevLocation ? prevLocation.pathname : null
+            previous: prevLocation ? prevLocation.pathname : null,
+            language: 'java'
         },
         streamName: awsconfig.aws_kinesis_firehose_stream_name
     }, 'AWSKinesisFirehose')

docs/gatsby-config.js

@@ -17,15 +17,15 @@ module.exports = {
                 menuTitle: 'Helpful resources',
                 githubRepo: 'awslabs/aws-lambda-powertools-java',
                 baseUrl: `${docsWebsite}`,
-                algoliaApiKey: 'a8491b576861e819fd50d567134eb9ce',
-                algoliaIndexName: 'aws-lambda-powertools-java',
                 logoLink: `${docsWebsite}`,
                 sidebarCategories: {
                     null: [
                         'index'
                     ],
-                    'Core utilities': [],
-                    'Utilities': [],
+                    'Core utilities': [
+                        'core/tracer',
+                        'core/logger'
+                    ]
                 },
                 navConfig: {
                     'Serverless Best Practices video': {
@@ -46,10 +46,6 @@ module.exports = {
                     }
                 },
                 footerNavConfig: {
-                    /*'API Reference': {
-                        href: 'https://awslabs.github.io/aws-lambda-powertools-java/api/',
-                        target: '_blank'
-                    },*/
                     Serverless: {
                         href: 'https://aws.amazon.com/serverless/'
                     },

docs/package.json

@@ -22,7 +22,7 @@
         "gatsby-theme-apollo-docs/*/*/*/*/semver": "^4.3.2"
     },
     "keywords": [],
-    "license": "MIT-0",
+    "license": "Apache-2.0",
     "repository": "https://github.com/awslabs/aws-lambda-powertools-java",
     "name": "aws-lambda-powertools-java",
     "description": "Powertools is a suite of utilities for AWS Lambda Functions that makes tracing with AWS X-Ray, structured logging and creating custom metrics asynchronously easier.",