# Sumo Logic

### Description

This Sumo Logic destination can be configured to send logs and metrics data to a Sumo Logic HTTP logs and metrics source.

### Prerequisites

A pre-existing Sumo Logic HTTP logs and metrics source needs to be configured for the exporter to work. [Read more](https://help.sumologic.com/docs/send-data/hosted-collectors/http-source/logs-metrics/#configure-an-httplogs-and-metrics-source).

### Supported Types

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

### Configuration

<table><thead><tr><th width="207.5546875">Field</th><th>Description</th></tr></thead><tbody><tr><td>Choose Telemetry Type</td><td>Select which types of telemetry to export. Logs and metrics are supported.</td></tr><tr><td>Endpoint</td><td>Endpoint for the Sumo Logic HTTP logs and metrics source. See the <a href="https://help.sumologic.com/docs/send-data/hosted-collectors/http-source/logs-metrics/">Sumo Logic documentation</a> for more information.</td></tr><tr><td>Compression</td><td>Compression algorithm to use when sending data to Sumo Logic.</td></tr><tr><td>Max Request Body Size</td><td>Maximum HTTP request body size in bytes (1048576 = 1MiB) before compression is applied.</td></tr><tr><td>Log Format</td><td>Format to send logs in to Sumo Logic. Available formats are JSON and text.</td></tr><tr><td>Metric Format</td><td>Format to send metrics in to Sumo Logic. See the <a href="https://help.sumologic.com/docs/metrics/introduction/metric-formats/">Sumo Logic documentation</a> for more information. Available values are prometheus and OTLP.</td></tr><tr><td>Timeout</td><td>Timeout limit for each attempt to send data to Sumo Logic in seconds. Maximum timeout limit is <code>55s</code>.</td></tr></tbody></table>

### Supported Retry and Queuing Settings

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

The following example configuration will send logs and metrics. Default compression and max request body size will be used. Logs will be sent as JSON and metrics will be sent as Graphite and utilize the Graphite template to alter the metric names. The source host template will be used as well to override the one on the Sumo Logic HTTP logs and metrics source. Sending and persistent queues will be used as well as 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-206b26a4534b1431cd5d9afc4bec64945d0789a6%2Fintegrations-destinations-sumo-logic-image-1.png?alt=media" alt="Bindplane docs - Sumo Logic - image 1"><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-b0852f25833bbbba58af8424cb9a417db2370dd7%2Fintegrations-destinations-sumo-logic-image-2.png?alt=media" alt="Bindplane docs - Sumo Logic - image 2"><figcaption></figcaption></figure>

**Standalone Destination**

```yaml
apiVersion: bindplane.observiq.com/v1
kind: Destination
metadata:
  id: sumo_logic
  name: sumo_logic
spec:
  type: sumo_logic
  parameters:
    - name: telemetry_types
      value: ['Logs', 'Metrics']
    - name: endpoint
      value: 'https://host:1234/some/endpoint/for/sumo-logic'
    - name: compression
      value: 'gzip'
    - name: max_request_body_size
      value: '1048576'
    - name: log_format
      value: 'json'
    - name: metric_format
      value: 'otlp'
    - name: sending_queue_enabled
      value: 'true'
    - name: retry_on_failure_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
```