Notifications

General

KubeMQ's Notification features allows to subscribe to predefined events channel and receive real-time events for any access to KubeMQ resources.

This feature is useful for external auditing of access control attempts.

How Notifications Works

KubeMQ administrator can configure an Event channel which will be able to subscribe and receive access log notifications.

Access Notification Record consist from the following fields:

Field

Type

Description

Id

string

A unique notification id for the event

RefMessageID

string

The message id which triggered the access attempt

ClientID

string

The client id which tried to access the resource

Resource

string

The resource type: Events, Events Store, Queues, Commands, and Queries

Channel

string

The requested channel

Action

string

The Action type: Send, Receive, Stream, Ack

SubAction

string

The sub action type: Connect

Result

string

The result of the request

Timestamp

int64

Unix time of access attempt

ResultTimestamp

int64

Unix time of access result

Notification Destinations

A Notification event will be sent to an Event channel with the format of Report-Channel-Prefix.Resource.Channel.

For Example:

With Report-Channel-Prefix configuration of notification

Resource

Channel

Destination

Events

foo.bar

notification.events.foo.bar

Events Store

foo.bar.2

notification.events_store.foo.bar.2

Queues

foo.bar.baz

notification.queues.foo.bar.baz

Commands

foo.snork

notification.commands.foo.snork

Queries

foo.fum

notification.queires.fum

Notification Subscription

Since Events message pattern support wildcards subscriptions, we have great flexibility to which channel we would like to monitor.

For Example:

Subscribe

Monitor

notification.>

All notification channels

notification.events.>

All notification events channels

notification.*.foo.>

All notification in any message pattern with channel name start with foo

notification.*.foo.bar>

All notification in any message pattern with channel name foo.bar only

Configuration

KubeMQ allows to configure two settings:

1. Report Channel Prefix - allows to set the prefix report channel name

2. Log - Allows to log the notification to console stdout

The Notification feature is available only on KubeMQ Enterprise Edition.

Register for free 30 days license here.