# Dashboard 首页概览

登录成功后就可以进入到 EMQX Dashboard 的首页，即**集群概览**页面。该页面包含以下标签页：

- **集群概览**：显示整个集群内数据的概况。
- **节点**：查看集群中的节点列表和节点信息。
- **指标**：查看集群或单个节点内所有的数据指标。

## 集群概览

该页面提供了运行中整个 EMQX 集群的数据概况，包括以下信息：

### 消息速率

消息数据是 EMQX 的一大关键指标数据。消息是指当前所有的 MQTT 客户端或真实设备连接到 EMQX 后所传输的数据内容，客户端或设备通过主题来发送或接收消息，以此来完成它们之间的数据通信。

在概览页面左上角的卡片内，通过可视化的速率频谱图与实时的速率值展示，可以更加清晰和方便的监控当前系统内发送和接收消息量的速率变化（消息速率的统计单位为每秒多少条消息）。

![image](./assets/message_rate.png)

### 连接数和订阅主题数

EMQX 作为一款 MQTT 服务器，其连接数和订阅主题数是整个系统中最为重要的观测数据指标之一。连接数是指当前 MQTT 客户端或真实设备连接到 EMQX 的数量，订阅是当前每个客户端中订阅主题的总数，而主题数是当前存在于 EMQX 集群内，所有客户端订阅过的主题总数。

在概览页面的右上方的卡片里，我们可以快速的查看到整个集群内的所有的连接数，订阅数和主题数。当有连接或订阅主题更新时，卡片内的统计数据将会实时的更新。

![image](./assets/connections_subscriptions.png)

::: tip

订阅是按客户端区分的，而主题是唯一的订阅，同一主题可能包含在不同的客户端中。

:::

除提供直观的实时数字统计的显示外，在该页面的底部还提供了可视化图表的展示，可以通过时间变化来查看历史和当前的连接、订阅主题数的变化（时间单位精确到年月日时分），从而可以更好的帮助用户能够更加清晰直观的监控到整个 EMQX 集群内连接和订阅主题数的变化趋势。将鼠标移动到图表右上角可以通过点击图标来放大图表。

![image](./assets/connection_statistic.png)

### 消息数

消息数是指客户端或设备之间传输数据的条数统计，页面中所展示的消息数包含：消息流入、消息流出和消息丢弃的数量统计。

在页面底部图表中，可以看到消息数量的可视化图表，通过时间变化来查看历史和当前的消息数（时间单位精确到年月日时分），用户通过图表能更好的动态监测到当前 EMQX 集群内，所有消息数量的实时变化。将鼠标移动到图表右上角可以通过点击图标来放大图表。

点击页面右侧的“重置监控数据”按钮后，集群监控页面中的图表数据将被清空，并从当前时间重新开始显示新的监控数据。

![image](./assets/messages.png)

::: tip

上述所有随时间变化的图表都可以在左上角选择查看：过去 1 小时、过去 6 小时、过去 12 时、过去 1 天、过去 3 天和过去 7 天的数据变化统计。

:::

## 节点

EMQX 作为一款大规模分布式物联网 MQTT 消息服务器，支持集群部署，而在集群中的每个 EMQX 即为一个节点。

### 节点信息

在概览页面中部可以查看到整个 EMQX 集群节点的概况，包括可视化展示集群内所有节点的关联与分布的拓扑图。点击拓扑图中的单个节点，可以查看到当前节点的基础信息、运行状况，包括了节点名称、角色，当前单个节点上连接数、订阅数和主题数，当前节点上的 EMQX 版本（点击版本号可以查看当前版本的发布信息，以此来快速了解当前版本的内容更新），同时还可以查看到部署了该节点的操作系统的 CPU 负载与内存使用量等基础信息（内存仅支持在部署到 Linux 系统上的节点中查看）。

![image](./assets/nodes.png)

::: tip

当拓扑图中的节点变为灰色的时候，表示该节点目前处于停止的状态。

:::

### 节点列表

在节点信息区域点击最右侧的**查看节点列表**可以访问节点列表页面，您也可以点击顶部的**节点**页签访问。节点列表页面列出了当前 EMQX 集群内所有的节点，可以简单查看到每一个节点的节点名称，运行状态、时长，版本信息，客户端连接数，Erlang 进程占用数，内存使用量和 CPU 负载等信息，点击右上角的**刷新**按钮，可以实时的查看当前节点列表的最新信息。

![image](./assets/node_list.png)

### 节点详情

在节点列表中，仅可以查看节点的部分基础信息，如需查看更多节点的完整信息，可以**名称**列中的节点名，进入到节点的详情页面。在详情页面中，您可以看到以下信息：

- 在**节点信息**卡片中，除了节点的基础信息，还可以查看当前节点的最大文件句柄数，节点的系统路径和日志路径等（显示日志路径需要在配置中起用文件日志处理进程）。

- 在**节点统计**卡片中，可以看到一些当前节点的统计数据，包括：连接数，订阅数，主题数，保留消息数，会话数和共享订阅数等。数据统计的数值分为两部分，通过斜杠分割，左边的数据为实时的数据展示，右边为高水位线数据，即当前数据达到过的最大值。


![image](./assets/node-detail.png)

## 指标

点击顶部的**指标**页签可以访问指标页面，查看 EMQX 集群或某个节点在使用过程中产生的所有数据指标，包括报文信息、消息统计与流量收发统计等。根据这些指标可以了解当前的服务状态。

在右上角的下拉框中可以选择查看集群数据还是单个节点上的数据，点击旁边的**刷新**按钮，可以实时的监控到当前页面下指标数据。

完整的指标数据详情与内容解释，请访问[指标](../observability/metrics-and-stats.md)查看。

### 连接、会话与访问

指标数据覆盖了字节、报文、消息和事件 4 个方面，在卡片中可以查看到事件相关的指标数据，包含了连接会话与认证授权等相关事件的次数统计。

![image](./assets/metrics-1.png)

### 规则和动作（Sink）

该部分提供与数据集成相关的指标，用于帮助了解规则被匹配的次数以及动作（Sink）被执行的情况。

![rule-action-metrics](./assets/rule-action-metrics.png)

### 消息传输

在下图展示的 4 个卡片中，主要统计了在消息传输时所产生的一些数据指标，例如流量收发的统计（单位字节），连接应答、发布订阅时的各项报文数据统计，消息数量和分发消息数等。

![image](./assets/metrics-2.png)
