start readmes

Author: jaydeluca

instrumentation/ratpack/ratpack-1.7/library/README.md

@@ -0,0 +1,56 @@
+# Library Instrumentation for Ratpack version 1.7 and higher
+
+Provides OpenTelemetry instrumentation for [Ratpack](https://ratpack.io/), enabling CLIENT and SERVER spans.
+
+## Quickstart
+
+### Add these dependencies to your project
+
+Replace `OPENTELEMETRY_VERSION` with the [latest release](https://central.sonatype.com/artifact/io.opentelemetry.instrumentation/opentelemetry-ratpack-1.7).
+
+For Maven, add to your `pom.xml` dependencies:
+
+```xml
+<dependencies>
+  <dependency>
+    <groupId>io.opentelemetry.instrumentation</groupId>
+    <artifactId>opentelemetry-ratpack-1.7</artifactId>
+    <version>OPENTELEMETRY_VERSION</version>
+  </dependency>
+</dependencies>
+```
+
+For Gradle, add to your dependencies:
+
+```kotlin
+implementation("io.opentelemetry.instrumentation:opentelemetry-ratpack-1.7:OPENTELEMETRY_VERSION")
+```
+
+### Usage
+
+```java
+import io.opentelemetry.api.OpenTelemetry;
+import io.opentelemetry.instrumentation.ratpack.v1_7.RatpackServerTelemetry;
+import io.opentelemetry.instrumentation.ratpack.v1_7.RatpackClientTelemetry;
+import ratpack.server.RatpackServer;
+import ratpack.http.client.HttpClient;
+
+public class RatpackExample {
+  public static void main(String[] args) throws Exception {
+    OpenTelemetry openTelemetry = OpenTelemetry.noop();
+
+    // Server instrumentation
+    RatpackServerTelemetry serverTelemetry = RatpackServerTelemetry.create(openTelemetry);
+    RatpackServer.start(server -> {
+      server.registryOf(serverTelemetry::configureRegistry);
+      server.handlers(chain ->
+        chain.get(ctx -> ctx.render("Hello, World!"))
+      );
+    });
+
+    // Client instrumentation
+    RatpackClientTelemetry clientTelemetry = RatpackClientTelemetry.create(openTelemetry);
+    HttpClient instrumentedHttpClient = clientTelemetry.instrument(HttpClient.of(spec -> {}));
+  }
+}
+```

instrumentation/reactor/reactor-3.1/library/README.md

@@ -0,0 +1,53 @@
+# Library Instrumentation for Project Reactor version 3.1 and higher
+
+Provides OpenTelemetry instrumentation for [Project Reactor](https://projectreactor.io/).
+
+This instrumentation generates spans for each reactive operation.
+
+## Quickstart
+
+### Add these dependencies to your project
+
+Replace `OPENTELEMETRY_VERSION` with the [latest release](https://central.sonatype.com/artifact/io.opentelemetry.instrumentation/opentelemetry-reactor-3.1).
+
+For Maven, add to your `pom.xml` dependencies:
+
+```xml
+<dependencies>
+  <dependency>
+    <groupId>io.opentelemetry.instrumentation</groupId>
+    <artifactId>opentelemetry-reactor-3.1</artifactId>
+    <version>OPENTELEMETRY_VERSION</version>
+  </dependency>
+</dependencies>
+```
+
+For Gradle, add to your dependencies:
+
+```kotlin
+implementation("io.opentelemetry.instrumentation:opentelemetry-reactor-3.1:OPENTELEMETRY_VERSION")
+```
+
+### Usage
+
+```java
+import io.opentelemetry.api.OpenTelemetry;
+import io.opentelemetry.instrumentation.reactor.v3_1.ContextPropagationOperator;
+import reactor.core.publisher.Mono;
+import reactor.core.publisher.Flux;
+
+public class ReactorExample {
+  public static void main(String[] args) {
+    OpenTelemetry openTelemetry = OpenTelemetry.noop();
+
+    ContextPropagationOperator contextPropagationOperator = ContextPropagationOperator.create();
+    contextPropagationOperator.registerOnEachOperator();
+
+    Mono<String> mono = Mono.just("Hello, World!");
+    Flux<String> flux = Flux.just("Hello", "World");
+
+    mono.subscribe(System.out::println);
+    flux.subscribe(System.out::println);
+  }
+}
+```

instrumentation/restlet/restlet-1.1/library/README.md

@@ -0,0 +1,55 @@
+# Library Instrumentation for Restlet version 1.1 and higher
+
+Provides OpenTelemetry instrumentation for [Restlet](https://restlet.talend.com/).
+
+This instrumentation generates SERVER spans for each HTTP request.
+
+## Quickstart
+
+### Add these dependencies to your project
+
+Replace `OPENTELEMETRY_VERSION` with the [latest release](https://central.sonatype.com/artifact/io.opentelemetry.instrumentation/opentelemetry-restlet-1.1).
+
+For Maven, add to your `pom.xml` dependencies:
+
+```xml
+<dependencies>
+  <dependency>
+    <groupId>io.opentelemetry.instrumentation</groupId>
+    <artifactId>opentelemetry-restlet-1.1</artifactId>
+    <version>OPENTELEMETRY_VERSION</version>
+  </dependency>
+</dependencies>
+```
+
+For Gradle, add to your dependencies:
+
+```kotlin
+implementation("io.opentelemetry.instrumentation:opentelemetry-restlet-1.1:OPENTELEMETRY_VERSION")
+```
+
+### Usage
+
+```java
+import io.opentelemetry.api.OpenTelemetry;
+import io.opentelemetry.instrumentation.restlet.v1_1.RestletTelemetry;
+import org.restlet.Filter;
+import org.restlet.Application;
+import org.restlet.Restlet;
+
+public class RestletExample {
+  public static void main(String[] args) throws Exception {
+    OpenTelemetry openTelemetry = OpenTelemetry.noop();
+
+    RestletTelemetry restletTelemetry = RestletTelemetry.create(openTelemetry);
+    Filter tracingFilter = restletTelemetry.newFilter("/api");
+
+    Application application = new Application() {
+      @Override
+      public Restlet createInboundRoot() {
+        return tracingFilter;
+      }
+    };
+  }
+}
+```