Contents

# Logstash Java Plugin

[![Java CI with Gradle](https://github.com/paulgrav/logstash-output-opentelemetry/actions/workflows/gradle.yml/badge.svg)](https://github.com/paulgrav/logstash-output-opentelemetry/actions/workflows/gradle.yml)

This is a Java plugin for [Logstash](https://github.com/elastic/logstash).

It is fully free and fully open source. The license is Apache 2.0, meaning you are free to use it however you want.

The documentation for Logstash Java plugins is available [here](https://www.elastic.co/guide/en/logstash/6.7/contributing-java-plugin.html).

## OpenTelemetry

This plugin allows Logstash to output looks to an OpenTelemetry GRPC otlp endpoint. The default endpoint is http://localhost:4317

Fields below are mapped as per the spec: https://opentelemetry.io/docs/reference/specification/logs/data-model/#elastic-common-schema

```
@timestamp >> Timestamp
log.level >> SeverityText
message >> Body
```

All other fields are attached as Attributes.

## Installation

`logstash-plugin install logstash-output-opentelemetry`

## Usage

```
input {
    generator => {
        count => 10
    }
}
output {
    opentelemetry => {
        endpoint => "http://localhost:4317"
    }
}
```

## Options

Use `endpoint` to specify a GRPC otlp endpoint.

## Building

`make gem`

## Running locally

`docker-compose up`

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
logstash-output-opentelemetry-0.1.1	README.md
logstash-output-opentelemetry-0.1.0	README.md
logstash-output-opentelemetry-0.0.1.pre.rc16	README.md