# Getting Started with Stackdriver Logging using Logback

[Stackdriver Logging][logging]  allows you to store, search, analyze, monitor,
and alert on log data and events from Google Cloud Platform and Amazon Web
Services.

These sample Java applications demonstrate how to write logs to Stackdriver using
[Logback](https://logback.qos.ch/) appender for [Google Cloud Client Library for Java][google-cloud-java].

[logging]: https://cloud.google.com/logging/
[google-cloud-java]: https://github.com/GoogleCloudPlatform/google-cloud-java

## Setup

Install [Maven](http://maven.apache.org/).

Build your project with:

	mvn clean package -DskipTests
	
[Setup authentication](https://cloud.google.com/docs/authentication) using a service account.

## Configuration

Update [logback.xml](src/main/resources/logback.xml) to configure the appender.

More information on Logback configuration can be found
[here](https://logback.qos.ch/manual/configuration.html).

## Enhancers
[ExampleEnhancer.java](src/main/java/com/example/logging/logback/enhancers/ExampleEnhancer.java)
provides an example of enhancing log entries with additional labels.


## Writing log entries
    mvn exec:java -Dexec.mainClass=com.example.logging.logback.Quickstart         

Logs can be viewed using the [Logs Viewer Console](https://pantheon.corp.google.com/logs/viewer).
