v5.1.0
版本发布时间: 2023-06-21 22:02:07
emqx/emqx最新发布版本:v5.8.1(2024-10-14 23:34:50)
v5.1.0
Enhancements
- #10858 A new utility function timezone_to_offset_seconds/1 has been added to the rule engine SQL language. This function converts a timezone string (for example, "+02:00", "Z" and "local") to the corresponding offset in seconds.
-
#10754 The MQTT bridge has been enhanced to utilize connection pooling and leverage available parallelism, substantially improving throughput.
As a consequence, single MQTT bridge now uses a pool of
clientid
s to connect to the remote broker. -
#10782 Added a new
deliver_rate
option to the retainer configuration, which can limit the maximum delivery rate per session in the retainer. - #10598 Provided a callback method of Unary type in ExProto to avoid possible message disorder issues.
- #10790 Reduced the overhead during configuration reads by optimizing the configuration read mechanism.
-
#10910 The data bridge resource option
auto_restart_interval
was deprecated in favor ofhealth_check_interval
, andrequest_timeout
was renamed torequest_ttl
. Also, the defaultrequest_ttl
value went from 15 seconds to 45 seconds. The previous existence of bothauto_restart_interval
andhealth_check_interval
was a source of confusion, as both parameters influenced the recovery of data bridges under failures. An inconsistent configuration of those two parameters could lead to messages being expired without a chance to retry. Now,health_check_interval
is used both to control the periodicity of health checks that may transition the data bridge intodisconnected
orconnecting
states, as well as recovering fromdisconnected
. - #10929 Upgraded Erlang/OTP to 25.3.2-1.
- #10909 Removed the deprecated HTTP APIs for gateways.
- #10933 Added support for configuring TCP keep-alive in MQTT/TCP and MQTT/SSL listeners.
-
#10948 Added
live_connections
field for some HTTP APIs, i.e:-
/monitor_current
,/monitor_current/nodes/{node}
-
/monitor/nodes/{node}
,/monitor
-
/node/{node}
,/nodes
-
-
#10941 Improved the collection speed of Prometheus metrics when setting
prometheus.vm_dist_collector=disabled
and metricerlang_vm_statistics_run_queues_length_total
is renamed toerlang_vm_statistics_run_queues_length
-
#10985 Renamed
emqx ctl
commandcluster_call
toconf cluster_sync
. The old commandcluster_call
is still a valid command, but not included in usage info. - #10988 Improved log security when data bridge creation fails to ensure sensitive data is always obfuscated.
-
#10926 Allowed
enable
as well asenabled
as the state flag for listeners. Prior to this change, listener can be enable/disabled by setting thetrue
orfalse
on theenabled
config. This is slightly different naming comparing to other state flags in the system. Now theenable
flag is added as an alias in listener config. - #10970 A query_mode parameter has been added to the Kafka producer bridge. This parameter allows you to specify if the bridge should use the asynchronous or synchronous mode when sending data to Kafka. The default is asynchronous mode.
-
#10676 Added CLI commands
emqx ctl export
andemqx ctl import
for importing/exporting configuration and user data. This allows exporting configurations and built-in database data from a running EMQX cluster and importing them into the same or another running EMQX cluster. -
#10961 Added support for unlimited max connections for gateway listeners by allowing infinity as a valid value for the
max_connections
field in the configuration and HTTP API. - #11019 Improved log security for JWT, now it will be obfuscated before print.
-
#11034 Hid the broker config and changed the
broker.shared_subscription_strategy
tomqtt.shared_subscription_strategy
as it belongs tomqtt
. -
#11045 The listener's authentication and zone related apis have been officially removed in version
5.1.0
. -
#11062 Renamed config
log.file.to
tolog.file.path
. - #10833 Only include enabled authenticators and authorizers in telemetry report, not all of them.
Bug Fixes
-
#11018 Fixed multiple issues with the Stomp gateway, including:
- Fixed an issue where
is_superuser
was not working correctly. - Fixed an issue where the mountpoint was not being removed in message delivery.
- After a message or subscription request fails, the Stomp client should be disconnected immediately after replying with an ERROR message.
- Fixed an issue where
-
#11051 Added validation to ensure that certificate
depth
(listener SSL option) is a non negative integer. -
#10884 Fixed an issue where trying to get rule info or metrics could result in a crash when a node is joining a cluster.
-
#10887 Fixed a potential issue where requests to bridges might take a long time to be retried. This only affected low throughput scenarios, where the buffering layer could take a long time to detect connectivity and driver problems.
-
#10871 Fixed an issue where the Dashboard shows that the connection still exists after a CoAP connection is disconnected, but deletion and message posting requests do not take effect.
-
#10880 Added a new REST API
POST /clients/kickout/bulk
for kicking out multiple clients in bulk. -
#10923 Fixed a race-condition in channel info registration. Prior to this fix, when system is under heavy load, it might happen that a client is disconnected (or has its session expired) but still can be found in the clients page in dashboard. One of the possible reasons is a race condition fixed in this PR: the connection is killed in the middle of channel data registration.
-
#10930 Added a schema validation for duration data type to avoid invalid values. Before this fix, it was possible to use absurd values in the schema that would exceed the system limit, causing a crash.
-
#10952 Disallow enabling
fail_if_no_peer_cert
in listener SSL options ifverify = verify_none
is set. Settingfail_if_no_peer_cert = true
andverify = verify_none
caused connection errors due to incompatible options. This fix validates the options when creating or updating a listener to avoid these errors.Note: any old listener configuration with
fail_if_no_peer_cert = true
andverify = verify_none
that was previously allowed will fail to load after applying this fix and must be manually fixed. -
#10951 Fixed the issue in MQTT-SN gateway where the
mountpoint
does not take effect on message publishing. -
#10943 Deprecated UDP mcast mechanism for cluster discovery. This feature has been planed for deprecation since 5.0 mainly due to the lack of actual production use. This feature code is not yet removed in 5.1, but the document interface is demoted.
-
#10902 Avoid syncing cluser.hocon file from the nodes running a newer version than the self-node. During cluster rolling upgrade, if an older version node has to restart due to whatever reason, if it copies the
cluster.hocon
file from a newer version node, it may fail to start. After this fix, the older version node will not copy thecluster.hocon
file from a newer, so it will use its owncluster.hocon
file to start. -
#10911 The error message and log entry that appear when one tries to create a bridge with a name the exceeds 255 bytes is now easier to understand.
-
#10983 Fixed the issue when mqtt clients could not connect over TLS if the listener was configured to use TLS v1.3 only. The problem was that TLS connection was trying to use options incompatible with TLS v1.3.
-
#10977 Fixed the delay in updating subscription count metric and corrected configuration issues in Stomp gateway.
-
#10950 Fixed the issue where the
enable_qos
option does not take effect in the MQTT-SN gateway. -
#10994 Redacted
proxy-authorization
headers as used by HTTP connector to avoid leaking secrets into log files. -
#10996 For any unknown HTTP/API request, the default response is a 404 error rather than the dashboard's index.html.
-
#11005 Fixed the issue where the
method
field cannot be correctly printed in the trace logs of AuthN HTTP. -
#10955 Fixed the issue in MQTT-SN gateway where deleting Predefined Topics configuration does not work.
-
#11030 Improved error messages when a validation error occurs while using the Listeners HTTP API.
-
#11033 Deprecated the
mountpoint
field inAuthenticateRequest
in ExProto gateway. This field was introduced in e4.x, but in fact, in e5.0 we have providedgateway.exproto.mountpoint
for configuration, so there is no need to override it through the Authenticate request.Additionally, updates the default value of
subscriptions_max
,inflight_max
,mqueue_max
toinfinity
. -
#11042 Fixed crash on REST API
GET /listeners
when listener'smax_connections
is set to a string. -
#11028 Disallowed using multiple TLS versions in the listener config that include tlsv1.3 but exclude tlsv1.2. Using TLS configuration with such version gap caused connection errors. Additionally, drop and log TLS options that are incompatible with the selected TLS version(s).
Note: any old listener configuration with the version gap described above will fail to load after applying this fix and must be manually fixed.
-
#11056 Fixed the issue where newly created listeners sometimes do not start properly. When you delete a system default listener and add a new one named 'default', it will not start correctly.
- Fixed the bug where configuration failure on certain nodes can cause Dashboard unavailability.
-
#11070 Fixed the problem that the
cluster.autoclean
configuration item does not take effect. -
#11092 and #11100 Fixed problem when replicant nodes were unable to connect to the core node due to timeout in
mria_lb:core_nodes()
call. Relevant mria pull request: https://github.com/emqx/mria/pull/143
Breaking Changes
Known Issues
1、 emqx-5.1.0-amzn2-amd64.rpm 42.69MB
2、 emqx-5.1.0-amzn2-amd64.rpm.sha256 64B
3、 emqx-5.1.0-amzn2-amd64.tar.gz 63.6MB
4、 emqx-5.1.0-amzn2-amd64.tar.gz.sha256 64B
5、 emqx-5.1.0-amzn2-arm64.rpm 42.01MB
6、 emqx-5.1.0-amzn2-arm64.rpm.sha256 64B
7、 emqx-5.1.0-amzn2-arm64.tar.gz 56.32MB
8、 emqx-5.1.0-amzn2-arm64.tar.gz.sha256 64B
9、 emqx-5.1.0-debian10-amd64.deb 36.86MB
10、 emqx-5.1.0-debian10-amd64.deb.sha256 64B
11、 emqx-5.1.0-debian10-amd64.tar.gz 66.87MB
12、 emqx-5.1.0-debian10-amd64.tar.gz.sha256 64B
13、 emqx-5.1.0-debian10-arm64.deb 36.01MB
14、 emqx-5.1.0-debian10-arm64.deb.sha256 64B
15、 emqx-5.1.0-debian10-arm64.tar.gz 57.7MB
16、 emqx-5.1.0-debian10-arm64.tar.gz.sha256 64B
17、 emqx-5.1.0-debian11-amd64.deb 36.91MB
18、 emqx-5.1.0-debian11-amd64.deb.sha256 64B
19、 emqx-5.1.0-debian11-amd64.tar.gz 65.14MB
20、 emqx-5.1.0-debian11-amd64.tar.gz.sha256 64B
21、 emqx-5.1.0-debian11-arm64.deb 36.05MB
22、 emqx-5.1.0-debian11-arm64.deb.sha256 64B
23、 emqx-5.1.0-debian11-arm64.tar.gz 57.31MB
24、 emqx-5.1.0-debian11-arm64.tar.gz.sha256 64B
25、 emqx-5.1.0-el7-amd64.rpm 42.53MB
26、 emqx-5.1.0-el7-amd64.rpm.sha256 64B
27、 emqx-5.1.0-el7-amd64.tar.gz 56.36MB
28、 emqx-5.1.0-el7-amd64.tar.gz.sha256 64B
29、 emqx-5.1.0-el7-arm64.rpm 41.98MB
30、 emqx-5.1.0-el7-arm64.rpm.sha256 64B
31、 emqx-5.1.0-el7-arm64.tar.gz 55.33MB
32、 emqx-5.1.0-el7-arm64.tar.gz.sha256 64B
33、 emqx-5.1.0-el8-amd64.rpm 41.27MB
34、 emqx-5.1.0-el8-amd64.rpm.sha256 64B
35、 emqx-5.1.0-el8-amd64.tar.gz 66.98MB
36、 emqx-5.1.0-el8-amd64.tar.gz.sha256 64B
37、 emqx-5.1.0-el8-arm64.rpm 40.47MB
38、 emqx-5.1.0-el8-arm64.rpm.sha256 64B
39、 emqx-5.1.0-el8-arm64.tar.gz 57.83MB
40、 emqx-5.1.0-el8-arm64.tar.gz.sha256 64B
41、 emqx-5.1.0-el9-amd64.rpm 38.81MB
42、 emqx-5.1.0-el9-amd64.rpm.sha256 64B
43、 emqx-5.1.0-el9-amd64.tar.gz 65.17MB
44、 emqx-5.1.0-el9-amd64.tar.gz.sha256 64B
45、 emqx-5.1.0-el9-arm64.rpm 38.3MB
46、 emqx-5.1.0-el9-arm64.rpm.sha256 64B
47、 emqx-5.1.0-el9-arm64.tar.gz 57.57MB
48、 emqx-5.1.0-el9-arm64.tar.gz.sha256 64B
49、 emqx-5.1.0-elixir-amzn2-amd64.tar.gz 71.16MB
50、 emqx-5.1.0-elixir-amzn2-amd64.tar.gz.sha256 64B
51、 emqx-5.1.0-elixir-ubuntu22.04-amd64.tar.gz 73.18MB
52、 emqx-5.1.0-elixir-ubuntu22.04-amd64.tar.gz.sha256 64B
53、 emqx-5.1.0-macos11-amd64.zip 47MB
54、 emqx-5.1.0-macos11-amd64.zip.sha256 65B
55、 emqx-5.1.0-macos12-amd64.zip 46.99MB
56、 emqx-5.1.0-macos12-amd64.zip.sha256 65B
57、 emqx-5.1.0-macos12-arm64.zip 46.29MB
58、 emqx-5.1.0-macos12-arm64.zip.sha256 65B
59、 emqx-5.1.0-ubuntu18.04-amd64.deb 36.94MB
60、 emqx-5.1.0-ubuntu18.04-amd64.deb.sha256 64B
61、 emqx-5.1.0-ubuntu18.04-amd64.tar.gz 63.72MB
62、 emqx-5.1.0-ubuntu18.04-amd64.tar.gz.sha256 64B
63、 emqx-5.1.0-ubuntu18.04-arm64.deb 36.02MB
64、 emqx-5.1.0-ubuntu18.04-arm64.deb.sha256 64B
65、 emqx-5.1.0-ubuntu18.04-arm64.tar.gz 56.17MB
66、 emqx-5.1.0-ubuntu18.04-arm64.tar.gz.sha256 64B
67、 emqx-5.1.0-ubuntu20.04-amd64.deb 36.97MB
68、 emqx-5.1.0-ubuntu20.04-amd64.deb.sha256 64B
69、 emqx-5.1.0-ubuntu20.04-amd64.tar.gz 67.54MB
70、 emqx-5.1.0-ubuntu20.04-amd64.tar.gz.sha256 64B
71、 emqx-5.1.0-ubuntu20.04-arm64.deb 36.13MB
72、 emqx-5.1.0-ubuntu20.04-arm64.deb.sha256 64B
73、 emqx-5.1.0-ubuntu20.04-arm64.tar.gz 58.36MB
74、 emqx-5.1.0-ubuntu20.04-arm64.tar.gz.sha256 64B
75、 emqx-5.1.0-ubuntu22.04-amd64.deb 38.51MB
76、 emqx-5.1.0-ubuntu22.04-amd64.deb.sha256 64B
77、 emqx-5.1.0-ubuntu22.04-amd64.tar.gz 65.52MB
78、 emqx-5.1.0-ubuntu22.04-amd64.tar.gz.sha256 64B
79、 emqx-5.1.0-ubuntu22.04-arm64.deb 37.99MB
80、 emqx-5.1.0-ubuntu22.04-arm64.deb.sha256 64B
81、 emqx-5.1.0-ubuntu22.04-arm64.tar.gz 57.81MB
82、 emqx-5.1.0-ubuntu22.04-arm64.tar.gz.sha256 64B
83、 emqx-5.1.0-windows-amd64.zip 51.36MB