Skip to main content

HertzBeat's Monitoring Practice for API Gateway Apache ShenYu

· 6 min read

Monitoring practice for API gateway Apache ShenYu using HertzBeat, 5 minutes!

Introduction to Apache ShenYu

Apache ShenYu is an asynchronous, high-performance, cross-language, responsive API gateway.

  • Proxy: supports Apache Dubbo, Spring Cloud, gRPC, Motan, SOFA, TARS, WebSocket, MQTT.
  • Security: Signature, OAuth 2.0, JSON Web Token, WAF Plugin
  • API Governance: Request, Response, Parameter Mapping, Hystrix, RateLimiter Plugin
  • Observability: tracing, metrics, logging plug-ins
  • Dashboard: dynamic flow control, visual backend for user menu permissions
  • Extension: plugin hot-plugging, dynamic loading
  • Clustering: NGINX, Docker, Kubernetes
  • Languages: .NET, Python, Go, Java clients available for API registration

HertzBeat Introduction

HertzBeat is an open source, easy to use and friendly real-time monitoring tool, no Agent, with powerful custom monitoring capabilities.
Support for application services, database, operating system, middleware, cloud native monitoring, threshold alarms, alarm notification (email WeChat Nail Flybook).
HertzBeat's powerful customization, multi-type support, easy to extend, low-coupling, hope to help developers and small and medium-sized teams to quickly build their own monitoring system.

Monitor Apache ShenYu in HertzBeat in 5 minutes!

You must have a ShenYu environment and a HertzBeat environment.

i. Enable the metrics plugin on the ShenYu side, which will provide the metrics interface data.

The plugin is the core implementer of the Apache ShenYu gateway, and metrics data collection is also integrated at ShenYu in the form of a plugin - Metrics Plugin.
The Metrics plugin is used by the gateway to monitor its own operational status (JVM related), request responses and other related metrics.

  1. Add the metrics plugin dependency to the pom.xml file of the gateway.
  1. metric plugin Capture is turned off by default, edit the following in the gateway's configuration yaml file:
enabled: true #Set to true to enable
name: prometheus
host: #exposed ip
port: 8090 #Exposed port
jmxConfig: #jmx configuration
props: #jvm_enabled: true
jvm_enabled: true #Enable monitoring metrics for jvm
  1. Restart ShenYu Gateway, open a browser or use curl to access http://ip:8090, you can see the metric data.

ii. Adding ShenYu Monitor in HertzBeat Monitor Page

  1. Click Add ShenYu Monitor

Path: Menu -> Middleware Monitor -> ShenYu Monitor -> Add ShenYu Monitor


  1. Configure the parameters required for monitoring ShenYu

On the monitor page, fill in ShenYu service IP, monitor port (default 8090), and click OK to add.
For other parameters such as collection interval, timeout, etc., you can refer to the help file


  1. Done ✅, now we have added monitoring for ShenYu, check the monitor list to see our additions.


  1. Click Options->Monitoring Details icon in the monitor list to view ShenYu's real-time monitoring metrics.


  1. Click the Monitor History TAB to view ShenYu's historical monitoring metrics graphs 📈.



DONE! With the above steps, it's really only two steps

  • The first step is to enable the metrics plugin on the ShenYu side.
  • **The second step is to configure the IP ports on the HertzBeat monitoring page to add monitoring

By the above two steps we have finished monitoring Apache ShenYu, we can check the monitoring details and metrics information in HertzBeat anytime to observe its service status. Of course, just looking at it is not perfect, monitoring is often accompanied by alarm thresholds, when some of ShenYu's indicators exceed our expectations or abnormalities, we can promptly notify the person in charge of our counterparts, the person in charge of the notification to deal with the problem, so that is a complete monitoring and alerting process.

Next we will demonstrate step by step how to configure the threshold alarm notification in HertzBeat system, so that when ShenYu's metrics are abnormal, we will be notified in a timely manner **This is a complete monitoring and alerting process.

III. Adding ShenYu Metrics Threshold Alerts to the HertzBeat System

  1. Configure an alarm threshold for an important metric.

Path: Menu -> Alert Thresholds -> Add Thresholds

  • There are a lot of metrics in ShenYu monitoring, for example, we will set the threshold for the number of open file descriptors process_open_fds -> value metric, which will alert you when the number of open file descriptors on the server side is greater than 3,000.
  • Here we configure an alert to be issued when the value' of process_open_fds` exceeds 3000, with an alert level of Warning alert, which is triggered three times, as shown in the following figure.


  1. Add message notification recipients

Configure recipients to let alert message know who to send to and in what way.

Path: Menu -> Alert Notification -> Alert Recipients -> Add New Recipient.

Message notification methods support Email, Nail, WeChat, Flybook, WebHook, SMS, etc. Here we take the commonly used Nail as an example.

[Alert Notification] -> [Add Recipient] -> [Select Nailed Bot Notification Method] -> [Set Nailed Bot ACCESS_TOKEN] -> [OK]


  1. Configure the associated alert notification policy ⚠️ [Add Notification Policy] -> [Associate the recipient you just set] -> [OK] !

Configure the alert notification policy to bind alert messages to recipients so that you can decide which alerts go to which person.


Over and out, now wait for the alert message to come through. Ding, ding, ding, ding.

[HertzBeat Alert Notification]
Alert target object : shenyu.process_open_fds.value
Task ID : 205540620349696
Task name : SHENYU_localhost
Alarm level : Warning alarm
Alarm Trigger Time : 2023-01-08 22:17:06
Details : Please note that the number of file descriptors opened by ⚠️ ShenYu gateway is 3044 more than 3000



This hands-on article takes us through how to use HertzBeat to monitor Apache ShenYu metrics data, and we can find that HertzBeat, which combines Monitoring-Alert-Notification, is much more convenient to operate and use, and you can include ShenYu in the monitoring by simply clicking on a page. There is no need to deploy multiple components and write multiple YML configuration files.

Apache ShenYu Github:
HertzBeat Github:

Welcome to learn about using Star Support Oh!

Experience heartbeat with a single docker command:
docker run -d -p 1157:1157 --name hertzbeat apache/hertzbeat