xref: /aosp_15_r20/external/opencensus-java/exporters/trace/logging/README.md (revision a24ffb47c3166327784aa05b149974e82e8f71b8)
1*a24ffb47SSadaf Ebrahimi# OpenCensus Logging Trace Exporter
2*a24ffb47SSadaf Ebrahimi[![Build Status][travis-image]][travis-url]
3*a24ffb47SSadaf Ebrahimi[![Windows Build Status][appveyor-image]][appveyor-url]
4*a24ffb47SSadaf Ebrahimi[![Maven Central][maven-image]][maven-url]
5*a24ffb47SSadaf Ebrahimi
6*a24ffb47SSadaf EbrahimiThe *OpenCensus Logging trace exporter* is a trace exporter that logs all data to the system log.
7*a24ffb47SSadaf Ebrahimi
8*a24ffb47SSadaf Ebrahimi## Quickstart
9*a24ffb47SSadaf Ebrahimi
10*a24ffb47SSadaf Ebrahimi### Add the dependencies to your project
11*a24ffb47SSadaf Ebrahimi
12*a24ffb47SSadaf EbrahimiFor Maven add to your `pom.xml`:
13*a24ffb47SSadaf Ebrahimi```xml
14*a24ffb47SSadaf Ebrahimi<dependencies>
15*a24ffb47SSadaf Ebrahimi  <dependency>
16*a24ffb47SSadaf Ebrahimi    <groupId>io.opencensus</groupId>
17*a24ffb47SSadaf Ebrahimi    <artifactId>opencensus-api</artifactId>
18*a24ffb47SSadaf Ebrahimi    <version>0.28.3</version>
19*a24ffb47SSadaf Ebrahimi  </dependency>
20*a24ffb47SSadaf Ebrahimi  <dependency>
21*a24ffb47SSadaf Ebrahimi    <groupId>io.opencensus</groupId>
22*a24ffb47SSadaf Ebrahimi    <artifactId>opencensus-exporter-trace-logging</artifactId>
23*a24ffb47SSadaf Ebrahimi    <version>0.28.3</version>
24*a24ffb47SSadaf Ebrahimi  </dependency>
25*a24ffb47SSadaf Ebrahimi  <dependency>
26*a24ffb47SSadaf Ebrahimi    <groupId>io.opencensus</groupId>
27*a24ffb47SSadaf Ebrahimi    <artifactId>opencensus-impl</artifactId>
28*a24ffb47SSadaf Ebrahimi    <version>0.28.3</version>
29*a24ffb47SSadaf Ebrahimi    <scope>runtime</scope>
30*a24ffb47SSadaf Ebrahimi  </dependency>
31*a24ffb47SSadaf Ebrahimi</dependencies>
32*a24ffb47SSadaf Ebrahimi```
33*a24ffb47SSadaf Ebrahimi
34*a24ffb47SSadaf EbrahimiFor Gradle add to your dependencies:
35*a24ffb47SSadaf Ebrahimi```groovy
36*a24ffb47SSadaf Ebrahimicompile 'io.opencensus:opencensus-api:0.28.3'
37*a24ffb47SSadaf Ebrahimicompile 'io.opencensus:opencensus-exporter-trace-logging:0.28.3'
38*a24ffb47SSadaf Ebrahimiruntime 'io.opencensus:opencensus-impl:0.28.3'
39*a24ffb47SSadaf Ebrahimi```
40*a24ffb47SSadaf Ebrahimi
41*a24ffb47SSadaf Ebrahimi### Register the exporter
42*a24ffb47SSadaf Ebrahimi
43*a24ffb47SSadaf Ebrahimi```java
44*a24ffb47SSadaf Ebrahimipublic class MyMainClass {
45*a24ffb47SSadaf Ebrahimi  public static void main(String[] args) throws Exception {
46*a24ffb47SSadaf Ebrahimi    LoggingTraceExporter.register();
47*a24ffb47SSadaf Ebrahimi    // ...
48*a24ffb47SSadaf Ebrahimi  }
49*a24ffb47SSadaf Ebrahimi}
50*a24ffb47SSadaf Ebrahimi```
51*a24ffb47SSadaf Ebrahimi
52*a24ffb47SSadaf Ebrahimi[travis-image]: https://travis-ci.org/census-instrumentation/opencensus-java.svg?branch=master
53*a24ffb47SSadaf Ebrahimi[travis-url]: https://travis-ci.org/census-instrumentation/opencensus-java
54*a24ffb47SSadaf Ebrahimi[appveyor-image]: https://ci.appveyor.com/api/projects/status/hxthmpkxar4jq4be/branch/master?svg=true
55*a24ffb47SSadaf Ebrahimi[appveyor-url]: https://ci.appveyor.com/project/opencensusjavateam/opencensus-java/branch/master
56*a24ffb47SSadaf Ebrahimi[maven-image]: https://maven-badges.herokuapp.com/maven-central/io.opencensus/opencensus-exporter-trace-logging/badge.svg
57*a24ffb47SSadaf Ebrahimi[maven-url]: https://maven-badges.herokuapp.com/maven-central/io.opencensus/opencensus-exporter-trace-logging
58