Skip to content

Commit 9420f94

Browse files
committed
Merge remote-tracking branch 'origin/release-5.10' into release-6.0
2 parents 17a21fa + 57af87b commit 9420f94

File tree

4 files changed

+18
-20
lines changed

4 files changed

+18
-20
lines changed

en_US/changes/known-issues-5.8.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,11 @@
22

33
## e5.8.8
44

5-
| Since version | Issue | Workaround | Status |
6-
| ------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | -------------- |
7-
| 5.8.0 | **Disabling Message Transformation or Schema Validation has no effect after deleting a preceding item**<br />If you delete a Message Transformation or Schema Validation entry and then disable any subsequent entry in the list, the entry remains enabled. | Run the following command on any EMQX node:<br />`$ emqx eval "begin ets:delete_all_objects(emqx_message_transformation_index), emqx_message_transformation_config:load() end."` | Fixed in 5.8.8 |
8-
| 5.8.1 | **External Schema Registries are not loaded after a node restart** | None | Fixed in 5.8.8 |
5+
| Since version | Issue | Workaround | Status |
6+
| ------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ----------------- |
7+
| 5.8.0 | **Disabling Message Transformation or Schema Validation has no effect after deleting a preceding item**<br />If you delete a Message Transformation or Schema Validation entry and then disable any subsequent entry in the list, the entry remains enabled. | Run the following command on any EMQX node:<br />`$ emqx eval "begin ets:delete_all_objects(emqx_message_transformation_index), emqx_message_transformation_config:load() end."` | Resolved in 5.8.8 |
8+
| 5.8.1 | **External Schema Registries are not loaded after a node restart** | - | Resolved in 5.8.8 |
9+
| 5.7.0 | **Cluster Link garbage collection may remove active routes**<br />When multiple independent Cluster Links are configured and some links remain down for relatively long periods, the garbage collection process may mistakenly remove active routes from the internal routing table. This can cause affected Cluster Links to forward only a subset of messages or stop forwarding messages entirely. | - | |
910

1011
## e5.8.6
1112

en_US/observability/log.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -15,23 +15,21 @@ To minimize the impact of logs on system operation, for example, when the log da
1515

1616
## Log Level
1717

18-
EMQX log has 8 levels ([RFC 5424](https://www.ietf.org/rfc/rfc5424.txt)), with warning as the default level, from low to high these 8 levels are:
18+
EMQX log has 6 out of the 8 levels ([RFC 5424](https://www.ietf.org/rfc/rfc5424.txt)), with warning as the default level, from low to high these levels are:
1919

2020
```bash
21-
debug < info < notice < warning < error < critical < alert < emergency
21+
debug < info < notice < warning < error < critical
2222
```
2323
The table below describes the meaning and output contents for each log level.
2424

2525
| Log Level | Meaning | Output Examples |
2626
| --------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
2727
| debug | Detailed information about the internal workings of a program, helping to debug and diagnose issues in the code. <br />It is not recommended to output this level of logging directly to the production environment. Instead, enable [Log Trace](./tracer.md) for a specific client. | Variable values, function call stacks, and other detailed debugging data. |
28-
| info | Useful information that is more general than debug-level logs. | Client connections, subscriptions, publishes, QoS levels, and message delivery status. |
29-
| notice | Important system information indicating that an event has occurred, but no action is required. | Number of clients connected to the proxy server, number of reconnections attempted, and number of crashed nodes. |
28+
| info | Useful information that is more general than debug-level logs. | Minor abnormalities such as authorization denial, and management operation results, such as a successful configuration change. |
29+
| notice | Important system information indicating that an event has occurred, but no action is required. | Component restarted per request from dashboard or CLI |
3030
| warning | Potential issues or errors that require action; typically used for proactive monitoring and detecting potential problems before they become critical issues. | Disconnections, connection timeouts, authentication failures, and other similar events. |
3131
| error | The occurrence of an error that requires error handling; typically used to flag errors so that administrators can quickly detect and resolve issues. | Fails to connect to an external database, to subscribe to a non-existent topic, or to parse a configuration file, or other similar events. |
32-
| critical | Critical error that results in system crashes or prevents it from functioning; typically used to flag severe problems so that administrators can take immediate action. | Proxy server crashes, database unavailability, and other similar events. |
33-
| alert | Severe problems that may cause the application to stop and need to take immediate action to prevent further losses. | The application has reached a critical threshold, such as running out of disk space or memory, or a critical system process has crashed or stopped responding. |
34-
| emergency | Extremely serious problems that prevent the application from running and require immediate action; happen in rare circumstances. | Failure in data synchronizing between different nodes. |
32+
| critical | Critical error that results in system crashes or prevents it from functioning; typically used to flag severe problems so that administrators can take immediate action. | A component is unable to start or function normally due to incorrect configuration. |
3533

3634
## Configure Logging via Dashboard
3735

@@ -79,7 +77,7 @@ Configure the following settings for file log handler:
7977

8078
- **Rotation Size**: Log file will be rotated once it reaches the specified size. It is by default enabled. You can type the specific value in the text box below. If you disable it, the value will be `infinity`, which means the log file will grow indefinitely.
8179

82-
- **Log Level**: Select the log level to use from the drop-down list. Optional values are: `debug`, `info`, `notice`, `warning`, `error`, `critical`, `alert`, `emergency`. Default value is: `warning`.
80+
- **Log Level**: Select the log level to use from the drop-down list. Optional values are: `debug`, `info`, `notice`, `warning`, `error`, `critical`. Default value is: `warning`.
8381

8482
- **Log Formatter**: Select the log format from the drop-down list. Optional values are `text` and `JSON`. The default value is `text`.
8583

zh_CN/changes/known-issues-5.8.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@
66
| -------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ----------------- |
77
| 5.8.0 | **删除前置条目后,禁用消息转换或 Schema 验证不生效**<br />如果你删除了一条消息转换或 Schema 验证条目,然后再禁用列表中其后的任意条目,该条目仍会保持启用状态。 | 在任意一个 EMQX 节点上执行以下命令:<br />`$ emqx eval "begin ets:delete_all_objects(emqx_message_transformation_index), emqx_message_transformation_config:load() end."` | 已在 5.8.8 中修复 |
88
| 5.8.1 | **节点重启后不会加载外部 Schema Registry** | - | 已在 5.8.8 中修复 |
9+
| 5.7.0 | **集群连接垃圾回收可能会移除活动路由**<br/>当配置了多个独立的集群连接,并且其中一些连接长时间处于离线状态时,垃圾回收过程可能会错误地从内部路由表中移除仍然有效的路由。<br/>这可能导致受影响的集群连接仅转发部分消息,或完全停止转发消息。 | - | |
910

1011
## e5.8.6
1112

zh_CN/observability/log.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -15,24 +15,22 @@ EMQX 支持两种不同的日志输出方式:控制台输出日志和文件输
1515

1616
## 日志级别
1717

18-
EMQX 日志包含 8 个等级 ([RFC 5424](https://www.ietf.org/rfc/rfc5424.txt)),默认为 warning 级别,由低到高分别为:
18+
EMQX 日志包含 8 个等级中的 6 个常用级别 ([RFC 5424](https://www.ietf.org/rfc/rfc5424.txt)),默认为 warning 级别,由低到高分别为:
1919

2020
```bash
21-
debug < info < notice < warning < error < critical < alert < emergency
21+
debug < info < notice < warning < error < critical
2222
```
2323

2424
下面的表格描述了每个日志级别的含义和输出内容。
2525

2626
| 日志级别 | 含义 | 输出内容 |
2727
| --------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
2828
| debug | 调试级别的日志,包含最详细的信息和调试数据。仅在需要进行详细调试时才使用此级别的日志。不建议在生产环境直接输出该级别日志,可以使用 [日志追踪](./tracer.md) 为指定客户端开启。 | 通常包含最详细的调试信息、变量值、函数调用栈等信息。 |
29-
| info | 提供有用的信息,比 debug 级别的日志更粗略 | 如客户端连接、订阅、发布、QoS 等级别、消息传递等信息。 |
29+
| info | 提供有用的信息,比 debug 级别的日志更粗略 | 授权拒绝等轻微异常,以及管理操作的结果,例如成功的配置更改。 |
3030
| notice | 提供重要的系统信息,表示有事件发生但不需要采取行动。 | 例如,连接到代理服务器的客户端数量、重连次数、崩溃的节点数量等。 |
3131
| warning | 表示存在潜在的问题或错误,需要采取一定的行动; 此级别的日志通常用于发现问题和错误之前的预警。 | 连接断开、连接超时、认证失败等情况。 |
3232
| error | 表示出现了错误,需要进行错误处理;此级别的日志通常用于标记错误,以便管理员可以快速检测和解决问题 | 无法连接到外部数据库、订阅的主题不存在、未能解析配置文件等。 |
33-
| critical | 表示出现了严重错误,导致系统崩溃或无法继续工作;此级别的日志通常用于标记严重问题,以便管理员可以尽快采取行动。 | 代理服务器崩溃、数据库无法访问等。 |
34-
| alert | 表示需要立即采取行动,以防止进一步的损失;此级别的日志记录将触发警报通知操作,并且可能导致应用程序的停止。 | 例如,应用程序已达到关键阈值,例如磁盘空间或内存耗尽,或关键系统进程已崩溃或停止响应。 |
35-
| emergency | 导致系统无法继续运行的严重错误;这种级别的日志通常只会在极少数情况下出现,并且需要立即对其进行处理。 | 例如,EMQX 节点间数据同步失败 |
33+
| critical | 表示出现了严重错误,导致系统崩溃或无法继续工作;此级别的日志通常用于标记严重问题,以便管理员可以尽快采取行动。 | 组件无法正常启动或运行,原因可能是配置不正确。 |
3634

3735
## 通过 Dashboard 修改日志配置
3836

@@ -49,7 +47,7 @@ debug < info < notice < warning < error < critical < alert < emergency
4947
配置控制台日志处理进程的选项:
5048

5149
- **启用日志处理进程**:单击切换开关以启用控制台日志处理进程。
52-
- **日志级别**:从下拉列表中选择要使用的日志级别。可选值为:`debug`, `info`, `notice`, `warning`, `error`, `critical`, `alert`, `emergency` 。默认值为:`warning`
50+
- **日志级别**:从下拉列表中选择要使用的日志级别。可选值为:`debug`, `info`, `notice`, `warning`, `error`, `critical` 。默认值为:`warning`
5351
- **日志格式类型**:从下拉列表中选择日志格式。可选值为:`text``json`。默认值为 `text`
5452
- **时间戳格式**:从下拉列表中选择日志时间戳格式。可选值为:
5553
- `auto`: 根据所使用的日志格式类型自动确定时间戳格式。对于文本格式类型,使用 `rfc3339` 格式;对于 JSON 格式类型,则使用 `epoch`格式。
@@ -72,7 +70,7 @@ debug < info < notice < warning < error < critical < alert < emergency
7270
- **日志文件名字**:填写日志文件的名称。默认为`log/emqx.log`
7371
- **最大日志文件数**:轮换的最大日志文件数。默认值为`10`
7472
- **日志文件轮换大小**:设置日志文件大小,达到设定的值时日志文件将进行轮换。如果禁用,则日志文件将无限增长。可在文本框输入设定的值,在下拉列表中选择单位,可选值为:`MB`, `GB`, `KB`
75-
- **日志级别**:从下拉列表中选择要使用的日志级别。可选值为:`debug`, `info`, `notice`, `warning`, `error`, `critical`, `alert`, `emergency` 。默认值为:`warning`
73+
- **日志级别**:从下拉列表中选择要使用的日志级别。可选值为:`debug`, `info`, `notice`, `warning`, `error`, `critical` 。默认值为:`warning`
7674
- **日志格式类型**:从下拉列表中选择日志格式。可选值为:`text``json`。默认值为 `text`
7775
- **时间戳格式**:从下拉列表中选择日志时间戳格式。可选值为:
7876
- `auto`: 根据所使用的日志格式类型自动确定时间戳格式。对于文本格式类型,使用 `rfc3339` 格式;对于 JSON 格式类型,则使用 `epoch`格式。

0 commit comments

Comments
 (0)