robomq/messaging-ui repository overview

⁠Quick reference

• Where to get help: Contact RoboMQ⁠, Documentation⁠, Videos⁠, Blogs⁠

• Maintained by: RoboMQ⁠

⁠What is RoboMQ

RoboMQ⁠ is Hybrid Integration Platform⁠ (HIP) that is built to integrate IoT, SaaS applications, cloud and on premise systems in a truly distributed and highly scalable business workflows across networks and clouds. RoboMQ is built with Docker and microservices architecture for the enterprise applications and businesses of today. Key differentiation of RoboMQ are :

1. Any-to-Any Integration⁠
2. Microservices architecture⁠
3. Hybrid Messaging Cloud⁠

RoboMQ⁠ provides added components on the top of core AMQP 0-9-1 broker based built on the strengths of rabbitmq⁠. RoboMQ offers added components that are built with message oriented middleware and microservices architecture. The core broker and all the value added components are packaged as docker containers. The value added components provide capabilities like Messaging dashboard, Quboid smart container, API gateway, API layer, Error Analytics and exception handlers, Event Logging, and health checks and on demand diagnostics, Mission Control.

⁠RoboMQ Messaging UI

Real time dashboard including statistical information that provides the pulse of the messaging activity, message rates, number of clients connections, messages in the queues, and the delivery and publish rates.

RoboMQ Messaging UI is pre-configured and built upon Grafana, an open source metric analytics & visualization suite. It is most commonly used for visualizing time series data.

⁠1. Prerequisites

Ensure the following ports are open on the network for Messaging UI and InfluxDB. Port 3000 is used to access the Messaging UI and InfluxDB port 8086 is used by application to get information from InfluxDB. If the broker runs behind a firewall which blocks these ports, you will need to either change firewall rules to unblock the ports, or switch to an available port permitted by firewall:

• Messaging dashboard: 3000
• InfluxDB HTTP API port: 8086

Messaging-collector and InfluxDB must be started before Messaging UI.

⁠2. Start Messaging UI

The RoboMQ Messaging UI image exposes a shared volume under /var/lib/grafana, so mount a host directory to that point to ensure container data is persisted similar to the RoboMQ broker and InfluxDB setup above. The following command creates the Messaging UI container with volume mounted to host for persisted storage of your user and dashboard data.

$ docker run -d --name messaging-ui -p 3000:3000 -e INFLUXDB_HOST=<InfluxDB Host IP> -e INFLUXDB_PASSWORD=admin123 -v <path-to-host>:/var/lib/grafana --restart always robomq/messaging-ui:latest 

You can choose a different container name by changing the --name option.

• Replace < path-to-host > with desired path to mount from your host server
• Replace < InfluxDB host IP > with the server host name or IP address hosting your InfluxDB container

⁠3. Provision User

Provision your Messaging UI admin user for access to your messaging activity data.

$ docker exec -it messaging-ui sh -c 'provision_user.sh' 

You should see output similar to below indicating successful creation of your admin user dashboard.

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Date: Fri, 22 Dec 2017 20:50:41 GMT
Content-Length: 33

{"id":2,"message":"User created"}

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Date: Fri, 22 Dec 2017 20:50:41 GMT
Content-Length: 52

{"id":1,"message":"Datasource added","name":"admin"}

HTTP/1.1 200 OK
Content-Type: application/json
Date: Fri, 22 Dec 2017 20:50:41 GMT
Content-Length: 55

{"slug":"administrator","status":"success","version":1}

⁠4. Access the Messaging UI

URL : http://<your host IP>:3000
Login credential : admin/admin123

The web interface would look similar to below. If you initially do not see a dashboard button labeled "Administrator". There should be a drop down menu at the top left hand corner labeled "Home". Click that drop down and select "Administrator".

⁠5. Common management tasks

⁠5.1 Show status of the running messaging-ui container:

$ docker ps -f name=<container name> 

⁠5.2 Restart, stop, or remove listener

$ docker restart <container name> 

$ docker stop <container name> 

$ docker rm -v <container name> 

⁠5.3 View listener container logs

$ docker logs <container name>