1# OpenCensus Instana Trace Exporter 2[![Build Status][travis-image]][travis-url] 3[![Windows Build Status][appveyor-image]][appveyor-url] 4[![Maven Central][maven-image]][maven-url] 5 6The *OpenCensus Instana Trace Exporter* is a trace exporter that exports 7data to Instana. [Instana](http://www.instana.com/) is a distributed 8tracing system. 9 10## Quickstart 11 12### Prerequisites 13 14[Instana](http://www.instana.com/) forwards traces exported by applications 15instrumented with Census to its backend using the Instana agent processes as proxy. 16If the agent is used on the same host as Census, please take care to deactivate 17automatic tracing. 18 19 20### Hello Stan 21 22#### Add the dependencies to your project 23 24For Maven add to your `pom.xml`: 25```xml 26<dependencies> 27 <dependency> 28 <groupId>io.opencensus</groupId> 29 <artifactId>opencensus-api</artifactId> 30 <version>0.16.1</version> 31 </dependency> 32 <dependency> 33 <groupId>io.opencensus</groupId> 34 <artifactId>opencensus-exporter-trace-instana</artifactId> 35 <version>0.16.1</version> 36 </dependency> 37 <dependency> 38 <groupId>io.opencensus</groupId> 39 <artifactId>opencensus-impl</artifactId> 40 <version>0.16.1</version> 41 <scope>runtime</scope> 42 </dependency> 43</dependencies> 44``` 45 46For Gradle add to your dependencies: 47```groovy 48compile 'io.opencensus:opencensus-api:0.16.1' 49compile 'io.opencensus:opencensus-exporter-trace-instana:0.16.1' 50runtime 'io.opencensus:opencensus-impl:0.16.1' 51``` 52 53#### Register the exporter 54 55```java 56public class MyMainClass { 57 public static void main(String[] args) throws Exception { 58 InstanaTraceExporter.createAndRegister("http://localhost:42699/com.instana.plugin.generic.trace"); 59 // ... 60 } 61} 62``` 63 64#### Java Versions 65 66Java 6 or above is required for using this exporter. 67 68[travis-image]: https://travis-ci.org/census-instrumentation/opencensus-java.svg?branch=master 69[travis-url]: https://travis-ci.org/census-instrumentation/opencensus-java 70[appveyor-image]: https://ci.appveyor.com/api/projects/status/hxthmpkxar4jq4be/branch/master?svg=true 71[appveyor-url]: https://ci.appveyor.com/project/opencensusjavateam/opencensus-java/branch/master 72[maven-image]: https://maven-badges.herokuapp.com/maven-central/io.opencensus/opencensus-exporter-trace-instana/badge.svg 73[maven-url]: https://maven-badges.herokuapp.com/maven-central/io.opencensus/opencensus-exporter-trace-instana 74
