# Jaeger

### Description

This Jaeger destination configures an OTLP exporter to send traces to a Jaeger server for ingestion. Replaces the pre-existing Jaeger destination that utilized a Jaeger specific exporter.

### Supported Types

| Metrics | Logs | Traces | Bindplane Collector |
| ------- | ---- | ------ | ------------------- |
|         |      | ✓      | `v1.36.0`+          |

### Configuration

| Field                              | Description                                                                                                                                                                       |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Hostname                           | Hostname or IP address of the Jaeger server.                                                                                                                                      |
| Port                               | Port of the Jaeger server, either gRPC or HTTP depending on `Protocol`, to send OTLP data to. [Read more](https://www.jaegertracing.io/docs/1.50/getting-started/).               |
| Protocol                           | The OTLP protocol to use when sending to the Jaeger server. Can be gRPC or HTTP.                                                                                                  |
| Compression                        | Compression algorithm to use when sending data to the OTLP server. Ensure that the server supports the compression algorithm selected. Kinds of compression depend on `Protocol`. |
| Additional Headers                 | Add additional headers to be attached to each request.                                                                                                                            |
| Enable TLS                         | Whether or not to use TLS.                                                                                                                                                        |
| Skip TLS Certificate Verification  | Enable to skip TLS certificate verification.                                                                                                                                      |
| TLS Certificate Authority File     | Certificate authority used to validate TLS certificates.                                                                                                                          |
| Mutual TLS                         | Whether or not to use mutual TLS authentication.                                                                                                                                  |
| Mutual TLS Client Certificate File | A TLS certificate used for client authentication.                                                                                                                                 |
| Mutual TLS Client Private Key File | A TLS private key used for client authentication.                                                                                                                                 |

This destination supports the [retry settings](https://docs.bindplane.com/configuration/bindplane-otel-collector/retry-on-failure), the [sending queue settings](https://docs.bindplane.com/configuration/bindplane-otel-collector/sending-queue), and the [persistent queue settings.](https://docs.bindplane.com/configuration/bindplane-otel-collector/persistent-queue)

| Sending Queue | Persistent Queue | Retry on Failure |
| ------------- | ---------------- | ---------------- |
| ✓             | ✓                | ✓                |

### Example Configuration

#### Basic Configuration

For basic configuration, we specify the `hostname` of the Jaeger server traces are going to be sent to, as well as what `protocol` will be used (in this case gRPC).

**Web Interface**

<figure><img src="https://1405008107-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmiOMzBfoNFwmKJFHMcJ%2Fuploads%2Fgit-blob-98d1d75eaa6e9ef3a50a44ea0cb39a56befbecc4%2Fintegrations-destinations-jaeger-image-1.png?alt=media" alt="Bindplane docs - Jaeger - image 1"><figcaption></figcaption></figure>

**Standalone Destination**

```yaml
apiVersion: bindplane.observiq.com/v1
kind: Destination
metadata:
  id: jaeger_otlp
  name: jaeger_otlp
spec:
  type: jaeger_otlp
  parameters:
    - name: hostname
      value: '0.0.0.0'
    - name: protocol
      value: 'grpc'
    - name: grpc_port
      value: '4317'
    - name: enable_tls
      value: 'false'
```

#### Advanced Configuration

This configuration is similar to the basic configuration but also utilizes TLS, Sending Queue, Persistent Queue, and Retry on Failure.

**Web Interface**

<figure><img src="https://1405008107-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmiOMzBfoNFwmKJFHMcJ%2Fuploads%2Fgit-blob-49f67f3aee3d8b16ad638bc77c4a8b3380789647%2Fintegrations-destinations-jaeger-image-2.png?alt=media" alt="Bindplane docs - Jaeger - image 2"><figcaption></figcaption></figure>

<figure><img src="https://1405008107-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmiOMzBfoNFwmKJFHMcJ%2Fuploads%2Fgit-blob-31f9bb7f365144d558315c8248becb1f768fe876%2Fintegrations-destinations-jaeger-image-3.png?alt=media" alt="Bindplane docs - Jaeger - image 3"><figcaption></figcaption></figure>

**Standalone Destination**

```yaml
apiVersion: bindplane.observiq.com/v1
kind: Destination
metadata:
  id: jaeger_otlp
  name: jaeger_otlp
spec:
  type: jaeger_otlp
  parameters:
    - name: hostname
      value: '0.0.0.0'
    - name: protocol
      value: 'grpc'
    - name: grpc_port
      value: '4317'
    - name: grpc_compression
      value: 'gzip'
    - name: enable_tls
      value: 'true'
    - name: ca_file
      value: '/some_ca_file'
    - name: retry_on_failure_enabled
      value: 'true'
    - name: sending_queue_enabled
      value: 'true'
    - name: persistent_queue_enabled
      value: true
    - name: persistent_queue_storage_extension
      value: 
        type: file_storage_persistent_queue
        parameters:
          - name: persistent_queue_directory
            value: ${OIQ_OTEL_COLLECTOR_HOME}/storage
          - name: timeout
            value: 1
          - name: persistent_queue_fsync
            value: true
```