History

Zaiming (Stone) Shi 0cde9e6ecf Merge pull request #6878 from zmstone/slog-ftw refactor: delete deprecated logging macros		2022-01-27 16:15:47 +01:00
..
docs	fix: typo takeovered -> takenover	2021-12-07 16:06:23 +01:00
etc	chore(exhook): change root name emqx_exhook > exhook	2022-01-12 13:51:37 +08:00
include	feat(emqx_exhook): add metrics	2022-01-17 16:04:15 +08:00
priv/protos	docs: fix typos	2022-01-27 12:29:38 +01:00
src	Merge pull request #6878 from zmstone/slog-ftw	2022-01-27 16:15:47 +01:00
test	feat: add api to delete override conf files	2022-01-25 08:29:04 +01:00
.gitignore	refactor(exhook): adapt to the hocon schmea	2021-08-03 14:06:58 +08:00
README.md	docs: fix typos	2022-01-27 12:29:38 +01:00
rebar.config	chore(mix): simplify build by using rebar3 for umbrella apps	2021-12-22 09:40:01 -03:00

README.md

emqx_exhook

The emqx_exhook extremely enhance the extensibility for EMQ X. It allow using an others programming language to mount the hooks instead of erlang.

Feature

Based on gRPC, it brings a very wide range of applicability
Allows you to use the return value to extend emqx behavior.

Architecture

EMQ X                                      Third-party Runtime
+========================+                 +========+==========+
|    ExHook              |                 |        |          |
|   +----------------+   |      gRPC       | gRPC   |  User's  |
|   |   gPRC Client  | ------------------> | Server |  Codes   |
|   +----------------+   |    (HTTP/2)     |        |          |
|                        |                 |        |          |
+========================+                 +========+==========+

Usage

gRPC service

See: priv/protos/exhook.proto

CLI

Example

Recommended gRPC Framework

See: https://github.com/grpc-ecosystem/awesome-grpc

Thanks

grpcbox