<!-- review: finished -->

<a id="external-vts"></a>

# VTS

这是一组用于流量跟踪和实时活动监控的模块。它提供对虚拟主机、上游、缓存状态信息的访问,还包括用于可视化统计信息的现成 HTML 模板。

<a id="installation-31"></a>

## 安装

要 [安装](https://cn.angie.software//angie/docs/installation/index.md#install-packages) 该模块，请使用以下软件包之一：

- Angie：`angie-module-vts`
- Angie PRO：`angie-pro-module-vts`

<a id="loading-modules-1"></a>

## 加载模块

在 `main{}` 上下文中加载模块：

```nginx
load_module modules/ngx_http_stream_server_traffic_status_module.so;
load_module modules/ngx_http_vhost_traffic_status_module.so;
load_module modules/ngx_stream_server_traffic_status_module.so;
```

<a id="preparing-for-demonstration-2"></a>

## 准备演示

HTML 页面模板安装在 `/usr/share/angie-module-vts/` 目录中：

- `/usr/share/angie-module-vts/status.compress.html`
- `/usr/share/angie-module-vts/status.template.html`
- `/usr/share/angie-module-vts/stream/status.compress.html`
- `/usr/share/angie-module-vts/stream/status.template.html`

要使用下面的配置示例，您需要：

1. 将 `/usr/share/angie-module-vts/status.template.html` 复制到
   `/usr/share/angie-module-vts/status.html`：
   ```console
   cp /usr/share/angie-module-vts/status.template.html \
      /usr/share/angie-module-vts/status.html
   ```
2. 在 `/usr/share/angie-module-vts/status.html` 文件中，找到以下行：
   ```html
   var vtsStatusURI = "{{uri}}/format/json", vtsUpdateInterval = 1000;
   ```

   并将 ` *{uri*}` 替换为 `/status`。

<a id="configuration-example-105"></a>

## 配置示例

```nginx
http {
    # ...
    vhost_traffic_status_zone;

    server {
        listen 80;
        server_name localhost;

        root  /usr/share/angie/html;
        index index.html index.htm;

        location = /status.html {
            root  /usr/share/angie-module-vts;
        }

        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
    }
}
```

<a id="additional-information-32"></a>

## 其他信息

详细文档和源代码可在以下位置获取：
[https://github.com/vozlt/nginx-module-vts](https://github.com/vozlt/nginx-module-vts)。