eventhubs

README

Kubemq event-hubs Target Connector

Kubemq event-hubs target connector allows services using kubemq server to access event-hubs messaging services.

Prerequisites

The following are required to run the event-hubs target connector:

• kubemq cluster
• Azure active with event-hubs enable
• kubemq-targets deployment

Configuration

event-hubs target connector configuration properties:

Properties Key	Required	Description	Example
end_point	yes	event hubs target endpoint	"sb://my_account.net"
shared_access_key_name	yes	event hubs access key name	"keyname"
shared_access_key	yes	event hubs shared access key name	"213ase123"
entity_path	yes	event hubs path entity to send	"mypath"

Example:

bindings:
  - name: kubemq-query-azure-event-hubs
    source:
      kind: kubemq.query
      name: kubemq-query
      properties:
        address: "kubemq-cluster:50000"
        client_id: "kubemq-query-azure-eventhubs-connector"
        auth_token: ""
        channel: "azure.eventhubs"
        group:   ""
        auto_reconnect: "true"
        reconnect_interval_seconds: "1"
        max_reconnects: "0"
    target:
      kind: azure.eventhubs
      name: target-azure-eventhubs
      properties:
        end_point: "sb://my_account.net"
        shared_access_key_name: "keyname"
        shared_access_key: "213ase123"
        entity_path: "mypath"

Usage

send

send metadata setting:

Metadata Key	Required	Description	Possible values
method	yes	type of method	"send"
properties	no	event properties key value string interface	"{"tag-1":"test","tag-2":"test2"}"
data	yes	file data (byte array)	"bXktZmlsZS1kYXRh"
partition_key	no	partition key to assign the messages	"0"

Example:

{
  "metadata": {
    "method": "send",
    "properties": "{\"tag-1\":\"test\",\"tag-2\":\"test2\"}"
  },
  "data": "bXktZmlsZS1kYXRh"
}

send batch

send batch metadata setting:

Metadata Key	Required	Description	Possible values
method	yes	type of method	"send_batch"
properties	no	event properties key value string interface	"myfile.txt"
data	yes	file data (byte array)slice , for each message	"WyJ0ZXN0MSIsInRlc3QyIiwidGVzdDMiLCJ0ZXN0NCJd
partition_key	no	partition key to assign all the messages	"0"

Example:

{
  "metadata": {
    "method": "send_batch",
        "properties": "{\"tag-1\":\"test\",\"tag-2\":\"test2\"}"
  },
  "data": "WyJ0ZXN0MSIsInRlc3QyIiwidGVzdDMiLCJ0ZXN0NCJd"
}

Documentation

Index

• Constants
• func Connector() *common.Connector
• type Client
  • func New() *Client
  • func (c *Client) Connector() *common.Connector
  • func (c *Client) Do(ctx context.Context, req *types.Request) (*types.Response, error)
  • func (c *Client) Init(ctx context.Context, cfg config.Spec, log *logger.Logger) error
  • func (c *Client) Stop() error

Constants

const (
	DefaultPartitionKey = ""
)

Functions

func Connector

func Connector() *common.Connector

Types

type Client

type Client struct {
	// contains filtered or unexported fields
}

func New

func New() *Client

func (*Client) Connector

func (c *Client) Connector() *common.Connector

func (*Client) Do

func (c *Client) Do(ctx context.Context, req *types.Request) (*types.Response, error)

func (*Client) Init

func (c *Client) Init(ctx context.Context, cfg config.Spec, log *logger.Logger) error

func (*Client) Stop

func (c *Client) Stop() error