Edge Delta OTLP Destination Node

Send analytics and insights to a OTLP destination.

Overview

The OTLP (OpenTelemetry Protocol) destination node in Edge Delta is used to send logs, metrics, and traces over gRPC to a specified OTLP endpoint. This node can handle multiple data types, providing a comprehensive solution for telemetry data transmission. The OTLP output node requires Edge Delta version 1.32.0.

Example Configuration

nodes:
  - name: my_otlp_stream
    type: otlp_output
    endpoint: example.com
    port: 443
    buffer_max_bytesize: 10485760 # 10MB
    buffer_ttl: 15m
    buffer_path: /var/log/edgedelta/outputbuffer
    tls:
      enabled: true
      ignore_certificate_check: false
      ca_file: /path/to/ca_file.pem

Required Parameters

name

A descriptive name for the node. This is the name that will appear in Visual Builder and you can reference this node in the YAML using the name. It must be unique across all nodes. It is a YAML list element so it begins with a - and a space followed by the string. It is a required parameter for all nodes.

nodes:
  - name: <node name>
    type: <node type>

type: otlp_output

The type parameter specifies the type of node being configured. It is specified as a string from a closed list of node types. It is a required parameter.

nodes:
  - name: <node name>
    type: <node type>

endpoint

The endpoint parameter specifies the OTLP server endpoint to send telemetry data. It is required and must be specified as a string.

nodes:
  - name: <node name>
    type: otlp_output
    endpoint: <OTLP server URI>
    port: <port number>

port

The port parameter defines the port number for the OTLP endpoint. It should be an integer between 1 and 65535 and is required.

Optional Parameters

buffer_max_bytesize

The buffer_max_bytesize parameter sets the maximum byte size allowed for buffered data when streaming fails. Remaining items exceeding this size are discarded until space becomes available. It is optional and specified as a data size.

nodes:
  - name: <node name>
    type: otlp_output
    endpoint: <OTLP server URI>
    port: <port number>
    buffer_max_bytesize: 10485760 # 10MB

buffer_ttl

The buffer_ttl parameter specifies the time-to-live for buffered items that fail to stream. Items are discarded after the duration expires. It is optional and specified as a duration.

nodes:
  - name: <node name>
    type: otlp_output
    endpoint: <OTLP server URI>
    port: <port number>
    buffer_ttl: 20m

buffer_path

The buffer_path parameter defines the file path for storing unsuccessful streaming items for later retry. It is optional and specified as a string.

nodes:
  - name: <node name>
    type: otlp_output
    endpoint: <OTLP server URI>
    port: <port number>
    buffer_path: /var/log/edgedelta/outputbuffer

TLS Configuration

The tls parameter allows configuring SSL/TLS settings. It includes sub-parameters like enabled, ignore_certificate_check, ca_file, among others, which control the security configuration for gRPC connections. All TLS settings are optional.

nodes:
  - name: <node name>
    type: otlp_output
    endpoint: <OTLP server URI>
    port: <port number>
    tls:
      enabled: true
      ignore_certificate_check: true
      ca_file: /path/to/ca_file.pem