0.144.0-alpha (latest) 0.143.0-alpha 0.142.0-alpha 0.140.0-alpha 0.137.0-alpha 0.136.0-alpha 0.134.0-alpha 0.133.0-alpha 0.132.21-alpha 0.131.17-alpha 0.130.30-alpha 0.129.10-alpha 0.128.0-alpha 0.127.16-alpha 0.126.0-alpha 0.125.3-alpha 0.124.0-alpha 0.123.12-alpha 0.122.9-alpha

## Key Reference Links

**Cloud Logging Logback Appender Description:** null

|---|---|---|
| [Cloud Logging Logback Appender Product Reference](https://cloud.google.com/logging/docs/setup/java#logback_appender_for) | [GitHub Repository](https://github.com/googleapis/google-cloud-java/tree/main/google-cloud-java) | [Maven artifact](https://central.sonatype.com/artifact/com.google.cloud/google-cloud-logging-logback) |

## Getting Started

In order to use this library, you first need to go through the following steps:

- [Install a JDK (Java Development Kit)](https://cloud.google.com/java/docs/setup#install_a_jdk_java_development_kit)
- [Select or create a Cloud Platform project](https://console.cloud.google.com/project)
- [Enable billing for your project](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
- [Enable the API](https://console.cloud.google.com/apis/library/logging-logback.googleapis.com)
- [Set up authentication](https://cloud.google.com/docs/authentication/client-libraries)

## Use the Cloud Logging Logback Appender for Java

To ensure that your project uses compatible versions of the libraries and their component artifacts, import `com.google.cloud:libraries-bom` and use the BOM to specify dependency versions. Be sure to remove any versions that you set previously. For more information about BOMs, see [Google Cloud Platform Libraries BOM](https://cloud.google.com/java/docs/bom).

### Maven

Import the BOM in the `dependencyManagement` section of your `pom.xml` file. Include specific artifacts you depend on in the `dependencies` section, but don't specify the artifacts' versions in the `dependencies` section.

The example below demonstrates how you would import the BOM and include the `google-cloud-logging-logback` artifact.

```xml
<dependencyManagement>
 <dependencies>
   <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.86.0</version>
      <type>pom</type>
      <scope>import</scope>
   </dependency>
 </dependencies>
</dependencyManagement>

<dependencies>
 <dependency>
   <groupId>com.google.cloud</groupId>
   <artifactId>google-cloud-logging-logback</artifactId>
 </dependency>
</dependencies>
```

### Gradle

BOMs are supported by default in Gradle 5.x or later. Add a `platform` dependency on `com.google.cloud:libraries-bom` and remove the version from the dependency declarations in the artifact's `build.gradle` file.

The example below demonstrates how you would import the BOM and include the `google-cloud-logging-logback` artifact.

```groovy
implementation(platform("com.google.cloud:libraries-bom:26.86.0"))
implementation("com.google.cloud:google-cloud-logging-logback")
```

The `platform` and `enforcedPlatform` keywords supply dependency versions declared in a BOM. The `enforcedPlatform` keyword enforces the dependency versions declared in the BOM and thus overrides what you specified.

For more details of the `platform` and `enforcedPlatform` keywords Gradle 5.x or higher, see [Gradle: Importing Maven BOMs](https://docs.gradle.org/current/userguide/platforms.html#sub:bom_import).

If you're using Gradle 4.6 or later, add `enableFeaturePreview('IMPROVED_POM_SUPPORT')` to your `settings.gradle` file. For details, see [Gradle 4.6 Release Notes: BOM import](https://docs.gradle.org/4.6/release-notes.html#bom-import). Versions of Gradle earlier than 4.6 don't support BOMs.

<br />

### SBT

SBT [doesn't support BOMs](https://github.com/sbt/sbt/issues/4531). You can find recommended versions of libraries from a particular BOM version on the [dashboard](https://storage.googleapis.com/cloud-opensource-java-dashboard/com.google.cloud/libraries-bom/index.html) and set the versions manually. To use the latest version of this library, add this to your dependencies:

```scala
libraryDependencies += "com.google.cloud" % "google-cloud-logging-logback" % "0.144.0-alpha"
```