Console Light Web 监控面板#

Angie 提供了广泛的监控工作方式;除了 指标 API 和 Prometheus 模块外,您还可以使用安装在服务器旁边的可视化控制台。

相关模块

Console Light#

Console Light 是一个轻量级的实时活动监控界面,显示关键的服务器负载和性能指标。该控制台基于 Angie 的 API 功能;活动监控数据实时生成。此外,该控制台允许您在 API 本身提供此功能的情况下动态 修改 Angie 配置。

已部署和配置的控制台示例:https://console.angie.software/

版本历史#

版本

发布日期

变更

1.9.1

28.10.2026

修复了无流量的缓存区域始终收到警告的问题。

1.9.0

14.08.2026

在服务器工具提示中添加了 draining 和 recovering 状态的显示。

1.8.2

23.01.2026

修复了指向 Angie ADC 文档的链接。

1.8.1

08.09.2025

修复了 Settings 和工具提示中的错误术语。

1.8.0

03.07.2025

显示代理 HTTP 和 TCP/UDP 服务器的响应时间指标

1.7.2

07.04.2025

在 HTTP/TCP/UDP Upstreams 页面的过滤器控制器中添加了"busy"选项。

1.7.1

04.04.2025

修复了 HTTP Zones 页面上 HTTP/Location Zones 表中的错误值。

1.7.0

02.04.2025

  • 鼠标悬停时显示精确的字节数据量

  • 统计 API 中上游对等节点的新 busy 状态,表示对等节点已达到 max_conns 参数配置的限制

  • 修复了文档链接

1.6.1

27.01.2025

  • 修复了拼写错误

  • 修复了开发时项目构建问题

1.6.0

23.01.2025

  • 国际化支持,可用语言环境:en、ru。

  • 为表格组件添加了粘性标题功能。

  • 支持 pebibytes (PiB) 数据测量单位。

  • 修复了主页面 HTTP Upstreams 小部件中的错误值计数器。

  • 现在在响应上下文中的 HTTP Upstreams 页面上正确使用默认值。

1.5.0

未公开发布。

1.4.0

08.08.2024

在网站图标中添加了监控状态显示。

1.3.0

28.04.2024

添加了在上游上下文中将服务器设置为 draining 状态的功能。

1.2.1

26.12.2023

在 Stream 上下文中添加了主动健康检查。

1.2.0

25.12.2023

在 Stream 上下文中添加了服务器编辑功能。

安装和配置#

Console Light 以 angie-console-light (Angie) 和 angie-pro-console-light (Angie PRO) 软件包的形式发布在 我们的仓库 中, 可以像安装任何其他软件包一样安装; 或者,您可以从 我们的网站 或 GitHub 下载源代码。

安装后, 通过在 服务器配置 的 server 块内添加以下 location 来配置控制台 (注意注释):

location /console/ {

    # 仅本地访问
    allow 127.0.0.1;
    deny all;

    auto_redirect on;

    alias /usr/share/angie-console-light/html/;
    # 仅 FreeBSD:
    # alias /usr/local/www/angie-console-light/html/;
    index index.html;

    location /console/api/ {
        api /status/;
    }

    # 为了在身份验证后使编辑功能正常工作(仅 PRO)
    location /console/api/config/ {

        auth_basic           "Protected site";
        auth_basic_user_file conf/htpasswd;

        api /config/;
    }
}

不要忘记应用修改后的配置:

$ sudo angie -t && sudo service angie reload

之后,控制台将在 server 块指定的服务器上可用, 路径为 location 指定的路径; 在上面的示例中,路径设置为 /console/。

可以为任何 API 部分启用身份验证, 类似于上面的示例,例如:

location /console/server_zones/ {
    auth_basic           "Protected site";
    auth_basic_user_file conf/htpasswd;
}

您还可以限制对已配置控制台 location 的任何部分的访问,例如:

location /console/api/resolvers/ {
    deny all;
}

界面#

控制台是一个带有一组选项卡的单一屏幕, 每个选项卡包含多个带有监控数据的小部件。

小技巧

在下面的部分中,界面元素从左到右描述。

Angie 选项卡#

Console Light - 主屏幕


这是主选项卡,其中以摘要形式显示关键的 Angie 监控指标,基于来自多个 API 部分的数据。

备注

如果在 Angie 配置 中配置了相应的块, 则会显示统计小部件。

About 小部件#

显示 Angie 版本号及指向相应文档的链接,以及服务器地址和上次 配置重新加载 的时间。

此外,如果启用了 api_config_files 指令, Configs 链接会打开服务器上加载的配置文件列表。 然后可以以紧凑格式查看每个文件,并带有语法高亮显示。

Connections 小部件#

显示基本的服务器连接统计信息,从 /status/connections/ API 部分生成:

Current

当前连接数

Accepted/s

每秒接受的连接数

Active

活动连接数

Idle

空闲连接数

Dropped

丢弃的连接数

还可用:

Accepted

自上次服务器重新加载以来接受的连接总数

HTTP Zones 小部件#

警告

需要在 server 或 location 上下文中设置 status_zone 指令。

显示 http 上下文的共享内存区域统计信息, 从 /status/http/server_zones/ API 部分生成:

Total

区域总数

Problems

存在任何问题的区域数

Traffic

传入和传出流量速率,单位为字节/秒

HTTP Upstreams 小部件#

警告

需要在 http 上下文的 upstream 块中设置 zone 指令。

显示 http 上下文的上游统计信息,从 /status/http/upstreams/ API 部分生成:

Total

上游总数

Problems

存在任何问题的上游数量

Servers

按状态细分的服务器统计信息

TCP/UDP Zones 小部件#

警告

需要在 stream 上下文的 server 块中设置 status_zone 指令。

示例:

stream {

    server {

        # ...
        status_zone foo;
    }
}

显示 stream 上下文的共享内存区域统计信息,从 /status/stream/server_zones/ API 部分生成:

Conn total

客户端连接总数

Conn current

当前客户端连接数

Conn/s

每秒处理的连接数

TCP/UDP Upstreams 小部件#

警告

需要在 stream 上下文的 upstream 块中设置 zone 指令。

显示 stream 上下文的上游统计信息,从 /status/stream/upstreams/ API 部分生成:

Total

上游总数

Problems

存在任何问题的上游数量

Servers

按状态细分的服务器统计信息

Caches 小部件#

警告

需要通过 proxy_cache_path、fastcgi_cache_path、 scgi_cache_path 或 uwsgi_cache_path 指令设置缓存区域。

显示 http 上下文的缓存区域统计信息,从 /status/http/caches/ API 部分生成:

Total

缓存区域总数

Problems

存在问题的区域数量;已分片的区域中,每个有问题的分片分别计数; 若没有问题区域但有些区域带有警告,则标签显示为 Warnings, 数字为这些区域的数量

State

warm 区域(元数据已加载)和 cold 区域(元数据正在加载到内存中)的数量

缓存区域在以下情况下会收到警告:

  • Caches 选项卡上的 Hit ratio 低于 30%, 按 设置 中设定的时间窗口计算, 时间窗口内没有响应的区域没有命中率,因此不参与此项检查;

  • 磁盘占用超出 max_size 的幅度不超过 5%。

磁盘占用超出 max_size 的幅度超过 5% 的区域存在问题。对于已分片的区域,上述大小检查分别应用于每个分片, 某个分片超出幅度不超过 5% 时,整个区域会收到警告。

Resolvers 小部件#

警告

需要为 resolver 指令设置 status_zone 参数 (HTTP、Stream 或 Mail)。

显示 DNS 解析器统计信息,从 /status/resolvers/ API 部分生成:

Total

解析器区域总数

Problems

自上次数据刷新以来,非 Success 响应(含超时)占该区域同一时间间隔内 请求数的百分比超过 设置 中设定的解析器错误阈值的 区域数量

Traffic

所有区域每秒的请求数(Req/s)和收到的响应数(Resp/s, 不含超时)

HTTP Zones 选项卡#

警告

需要在 server 或 location 上下文中设置 status_zone 指令。 Connection Limit Zones 部分还需要 limit_conn_zone 指令, Request Limit Zones 部分还需要 limit_req_zone 指令, 二者都设置在 http 上下文中。

Server Zones 部分#

Console Light — "HTTP Zones"选项卡上的"Server Zones"部分


汇总 http 中 server 上下文的共享内存区域监控统计信息,从 /status/http/server_zones/ API 部分生成。为每个区域显示以下数据:

Zone

区域名称

小技巧

点击 Zone 旁边的箭头,可按字母顺序或配置顺序对区域进行排序。

Requests

请求总数和每秒请求数

Responses

按状态码细分的响应数量及其总数

Traffic

出站和入站流量速率(单位为字节/秒),以及出站和入站流量总量(单位为字节)

SSL

汇总计数:成功的 SSL 握手;SSL 会话重用;超时过期的 SSL 握手;不成功的 SSL 握手

Location Zones 部分#

Console Light — "HTTP Zones"选项卡上的"Location Zones"部分


汇总 http 中 location 上下文的共享内存区域监控统计信息,从 /status/http/location_zones/ API 部分生成。为每个区域显示以下数据:

Zone

区域名称

小技巧

点击 Zone 旁边的箭头,可按字母顺序或配置顺序对区域进行排序。

Requests

请求总数和每秒请求数

Responses

按状态码细分的响应数量及其总数

Traffic

出站和入站流量速率(单位为字节/秒),以及出站和入站流量总量(单位为字节)

Connection Limit Zones (Limit Conn) 部分#

Console Light — "HTTP Zones"选项卡上的"Connection Limit Zones"部分


显示 http 上下文中由 limit_conn_zone 定义的区域的统计信息,由 /status/http/limit_conns/ API 部分生成。为每个区域显示以下数据:

Zone

区域名称

小技巧

点击 Zone 旁边的图标,可打开或关闭包含以下指标的图表。

Passed

经过该区检查且未被限制的连接总数

Rejected

已拒绝连接总数

Exhausted

由于区域存储溢出而拒绝的连接总数

Skipped

因键为空或长度超过 255 字节而未经该区检查的连接总数 (仅在没有任何区拒绝该连接时计入)

Request Limit Zones (Limit Req) 部分#

Console Light — "HTTP Zones"选项卡上的"Request Limit Zones"部分


显示 http 上下文中由 limit_req_zone 定义的区域的统计信息,由 /status/http/limit_reqs/ API 部分生成。为每个区域显示以下数据:

Zone

区域名称

小技巧

点击 Zone 旁边的图标,可打开或关闭包含以下指标的图表。

Passed

经过该区检查且既未被延迟也未被拒绝的请求总数

Delayed

已延迟请求总数

Rejected

已拒绝请求总数

Exhausted

由于区域存储溢出而拒绝的请求总数

Skipped

因键为空或长度超过 65535 字节而未经该区检查的请求总数 (仅在另一个区检查了该请求且未拒绝时计入)

HTTP 上游 选项卡#

Console Light — "HTTP 上游"选项卡


警告

需要在 http 上下文的 upstream 块中设置 zone 指令。

此选项卡汇总 http 上下文的上游监控统计信息,从 /status/http/upstreams/ API 部分生成。在调试模式下,还会显示内存使用百分比。

  • Show upstreams list 按钮可切换显示包含问题上游和对等节点数量的简要列表。

  • Failed only 开关可切换问题上游统计信息的显示模式。

  • 编辑按钮可切换 upstream editing (上游编辑)界面。

  • 每个上游表右侧的下拉列表允许您按特定状态(Up、Failed、Checking、 Down)筛选服务器。

对于每个上游,除了其名称和共享内存区域利用率之外,还显示以下数据:

Server

上游服务器的名称、总停机时间和权重

小技巧

点击 Server 旁边的箭头,可按服务器状态或配置顺序对服务器进行排序。

Requests

请求总数和处理速率

Responses

按状态码细分的响应数量

Connections

活动连接数及其最大限制(如果已设置)

Traffic

出站和入站流量速率(单位为字节/秒),以及出站和入站流量总量(单位为字节)

Server checks

联系服务器失败的尝试次数以及服务器被视为不可用的次数(API 中的 health 对象)

Health monitors

服务器检查总数、不成功检查的数量以及最后一次检查的时间

Response time

从请求开始到发送响应的第一个字节的时间;从请求开始到完成发送整个响应的总时间(API 中的 health 对象)

编辑上游#

在 Angie PRO 中,每个上游旁边都有一个编辑按钮;点击后, 会显示另外两个按钮:

Edit selected

编辑上游中选定的服务器。允许您 一次性为所有服务器设置以下参数:Weight (权重)、 最大连接数限制(Max_conns)、标记服务器为不可用的最大失败 次数限制(Max_fails)、计算最大失败次数限制的失败 时间窗口(Fail_timeout)、状态(active – 启用、 down – 禁用,或 draining – 仅接收 先前通过 sticky 绑定的会话请求)。

您也可以在此处删除选定的服务器。

Console Light — 在"HTTP Upstreams"选项卡上 编辑服务器


Add server

向上游添加服务器。允许您设置以下参数: 地址、是否为备份服务器、Weight (权重)、最大连接数 限制(Max_conns)、标记服务器为不可用的最大失败次数限制 (Max_fails)、失败计数时间 窗口(Fail_timeout)、状态(active – 启用、 down – 禁用,或 draining – 仅接收 先前通过 sticky 绑定的会话请求)。

Console Light — 在"HTTP Upstreams"选项卡上 添加服务器


TCP/UDP Zones 选项卡#

警告

需要在 stream 上下文的 server 块中设置 status_zone 指令。Connection Limit Zones 部分还需要在 stream 上下文中设置 limit_conn_zone 指令。

示例:

stream {

    # ...
    limit_conn_zone $connection zone=limit-conn-stream:10m;

    server {

        # ...
        status_zone foo;

        # optional: counts this server's connections in the zone
        limit_conn limit-conn-stream 1;
    }
}

TCP/UDP Zones 部分#

Console Light — "TCP/UDP Zones"选项卡


汇总 stream 中 server 上下文的共享内存区域监控统计信息, 由 /status/stream/server_zones/ API 部分生成。每个区域显示以下数据:

Zone

区域名称

Connections

当前和总连接数,以及每秒连接数

Sessions

按状态码细分的会话数, 以及它们的总数

Traffic

出站和入站流量速率(单位为字节/秒),以及出站和入站流量总量(单位为字节)

SSL

汇总计数:成功的 SSL 握手;失败的 SSL 握手; SSL 会话重用

Connection Limit Zones (Limit Conn) 部分#

Console Light — "TCP/UDP Zones"选项卡上的"Connection Limit Zones"部分


显示 stream 上下文中由 limit_conn_zone 定义的区域的统计信息,由 /status/stream/limit_conns/ API 部分生成。每个区域显示以下数据:

Zone

区域名称

小技巧

点击 Zone 旁边的图标以打开或 关闭包含以下指标的图表。

Passed

经过该区检查且未被限制的连接总数

Rejected

拒绝连接的总数

Exhausted

由于区域存储溢出而拒绝的连接总数

Skipped

因键为空或长度超过 255 字节而未经该区检查的连接总数 (仅在没有任何区拒绝该连接时计入)

TCP/UDP Upstreams 选项卡#

Console Light — "TCP/UDP Upstreams"选项卡


警告

需要在 stream 上下文的 upstream 块中 设置 zone 指令。

此选项卡汇总 stream 上下文的上游监控统计信息, 由 /status/stream/upstreams/ API 部分生成。 在调试模式下,还会显示内存使用百分比。

  • Show upstreams list 按钮切换显示包含问题上游和对等点数量的简要上游列表。

  • Failed only 开关启用和禁用问题上游统计信息的显示模式。

  • 编辑按钮打开 upstream editing (上游编辑)小部件。

  • 每个上游表右侧的下拉列表允许您 筛选特定状态的服务器(Up、Failed、Checking、 Down)。

对于每个上游,显示以下数据:

Server

上游服务器的名称、总停机时间和权重

小技巧

点击 Server 旁边的箭头以按服务器 状态或配置顺序对服务器进行排序。

Connections

活动连接数及其最大限制(如果已设置)

Traffic

出站和入站流量速率(单位为字节/秒),以及出站和入站流量总量(单位为字节)

Server checks

联系服务器失败的尝试次数以及服务器 被视为不可用的次数(API 中的 health 对象)

Health monitors

服务器检查的总次数、 失败检查的次数以及最后一次检查的时间

Response time

建立与后端连接所花费的时间; 从请求开始到接收响应的第一个字节的时间; 从请求开始到接收响应的最后一个字节所经过的总时间 (API 中的 health 对象)

编辑上游#

在 Angie PRO 中,每个上游旁边都有一个编辑按钮;点击后, 会显示另外两个按钮:

Edit selected

编辑上游中选定的服务器。允许您一次性为所有服务器设置以下参数: Weight (权重)、最大连接数限制(Max_conns)、 将服务器标记为不可用的最大失败次数限制(Max_fails)、 计算最大失败次数限制的失败时间窗口(Fail_timeout)、 状态(active – 启用、down – 禁用,或 draining – 仅接收先前通过 sticky 绑定的会话请求)。

您也可以在此处删除选定的服务器。

Console Light – 在"TCP/UDP Upstreams"选项卡上编辑服务器


Add server

向上游添加服务器。允许您设置以下参数: 地址、是否为备份服务器、Weight (权重)、最大连接数限制 (Max_conns)、将服务器标记为不可用的最大失败次数限制 (Max_fails)、失败计数时间窗口(Fail_timeout)、 状态(active – 启用、down – 禁用,或 draining – 仅接收先前通过 sticky 绑定的会话请求)。

Console Light – 在"TCP/UDP Upstreams"选项卡上添加服务器


Caches 选项卡#

Console Light – "Caches"选项卡


警告

需要通过 proxy_cache_path、fastcgi_cache_path、 scgi_cache_path 或 uwsgi_cache_path 指令设置缓存区域。

此选项卡汇总了 http 上下文中缓存区域的监控统计信息, 这些信息从 /status/http/caches/ API 部分生成。 每个区域显示以下数据:

Zone

区域名称

小技巧

点击 Zone 旁边的图标可以打开或关闭所有具有 分片 的区域的分片列表。

State

缓存状态:cold(元数据正在加载到内存中)或 warm(元数据已加载)

Memory usage

内存利用率

Max size

磁盘上缓存的最大大小,以字节为单位;若缓存大小未设置限制, 则显示无穷大符号

Used

磁盘上缓存当前占用的大小,以字节为单位

Disk usage

磁盘利用率

Traffic

从缓存提供的流量、写入缓存的流量以及绕过缓存返回的流量,以字节为单位

Hit ratio

在 设置 中设定的时间窗口内,从缓存提供的响应 (hit、stale、updating、revalidated) 占该区域所有响应的百分比;区域没有响应时不显示

对于已分片的区域,Max size、Used 和 Disk usage 将按分片分别跟踪;区域自身所在行显示为短横线, 该区域将以下拉列表的形式显示各个分片:

Path

分片在磁盘上的路径

State

分片状态:cold(元数据正在加载到内存中)或 warm(元数据已加载)

Max size

磁盘上分片的最大大小,以字节为单位;若分片大小未设置限制, 则显示无穷大符号

Used

磁盘上分片当前占用的大小,以字节为单位

Disk usage

磁盘利用率

Shared Zones 选项卡#

Console Light – "Shared Zones"选项卡


此选项卡汇总了所有上下文中所有共享内存区域的监控统计信息。 每个区域显示以下数据:

Zone

区域名称

小技巧

点击 Zone 旁边的箭头可以按大小或配置顺序对区域进行排序。

Total memory pages

内存页总数

Used memory pages

已使用的内存页数

Memory usage

区域的内存利用率

Resolvers 选项卡#

Console Light – "Resolvers" 选项卡


警告

需要为 resolver 指令设置 status_zone 参数 (HTTP、Stream 或 Mail)。

此选项卡汇总了 DNS 共享内存区域中的查询统计信息, 这些信息从 /status/resolvers/ API 部分生成。 每个区域显示以下数据:

Zone

区域名称

小技巧

点击 Zone 旁边的箭头可以按状态或配置顺序对区域进行排序。

Requests

A 和 AAAA、SRV、PTR 类型请求的数量

Responses

按相应代码细分的响应数量(Success、Format error、 Server failure、Host not found、Unimplemented、 Operation refused、Unknown、Timed out)

Settings 小部件#

Console Light – "Settings" 小部件


允许您配置控制台的常规参数:

  • 数据刷新率。默认值 – 1 秒。

  • HTTP 区域或 HTTP 上游服务器的所有请求中 4xx 响应所占份额的阈值。 超过该阈值时,该区域或服务器在 HTTP Zones 或 HTTP Upstreams 小部件中计为警告; 如果其中没有问题,对应选项卡的图标变为“黄色”;在 HTTP Zones 选项卡上, 该区域所在行也标记为“黄色”。默认值 – 30%。

  • 计算缓存命中率的时间窗口。默认值 – 300 秒。

  • 解析器的错误阈值。超过该阈值时,解析器区域变为“红色”。默认值 – 3%。

  • 控制台界面语言。可用选项:英语和俄语。 默认情况下,控制台语言根据浏览器中设置的区域设置选择。

控制台控制面板#

在所有选项卡上,页面左侧中间位置有一个滑出面板,带有两个按钮 Console Light – "About" 选项卡上的控制台控制按钮。 顶部按钮用于暂停和恢复从 API 更新数据, 底部按钮允许您在更新暂停时手动更新数据。