<!-- review: finished -->

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

# VTS

Это набор модулей для отслеживания трафика и мониторинга активности в реальном
времени. Он предоставляет доступ к информации о состоянии виртуальных хостов,
апстримов, кэшей, а также содержит готовые HTML-шаблоны, позволяющие
визуализировать статистику.

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

## Установка

Для [установки](https://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).