# Events

KubeMQ Bridges Events source provides an RPC events subscriber for processing target commands.

## Prerequisites

The following are required to run the events source connector:

* kubemq cluster
* kubemq-bridges deployment

## Configuration

Events source connector configuration properties:

| Properties Key               | Required | Description                            | Example                                              |
| ---------------------------- | -------- | -------------------------------------- | ---------------------------------------------------- |
| address                      | yes      | kubemq server address (gRPC interface) | kubemq-cluster-a-grpc.kubemq.svc.cluster.local:50000 |
| client\_id                   | no       | set client id                          | "client\_id"                                         |
| auth\_token                  | no       | set authentication token               | JWT token                                            |
| channel                      | yes      | set channel to subscribe               |                                                      |
| group                        | no       | set subscriber group                   |                                                      |
| auto\_reconnect              | no       | set auto reconnect on lost connection  | "false", "true"                                      |
| reconnect\_interval\_seconds | no       | set reconnection seconds               | "5"                                                  |
| max\_reconnects              | no       | set how many time to reconnect         | "0"                                                  |

Example:

```yaml
bindings:
  - name:  events-binding 
    properties: 
      log_level: error
      retry_attempts: 3
      retry_delay_milliseconds: 1000
      retry_max_jitter_milliseconds: 100
      retry_delay_type: "back-off"
      rate_per_second: 100
    sources:
      kind: source.events # Sources kind
      name: 3-clusters-source # sources name 
      connections: # Array of connections settings per each source kind
        - address: "kubemq-cluster-a-grpc.kubemq.svc.cluster.local:50000"
          client_id: "cluster-a-events-connection"
          auth_token: ""
          channel: "events"
          group: ""
        - address: "kubemq-cluster-b-grpc.kubemq.svc.cluster.local:50000"
          client_id: "cluster-b-events-connection"
          auth_token: ""
          channel: "events"
          group: ""
        - address: "kubemq-cluster-c-grpc.kubemq.svc.cluster.local:50000"
          client_id: "cluster-c-events-connection"
          auth_token: ""
          channel: "events"
          group: ""              
    targets:
    .....
```