11 KiB

Raw Blame History

Метрики

Данное руководство описывает более простой и эффективный способ настройки экспорта статистических данных для Marzban. Использование метрик позволяет администраторам системы отслеживать производительность и состояние сети, а также быстро выявлять и решать возникающие проблемы.

Связанные настройки

Добавление входящего подключения `metrics`

Для настройки экспорта метрик необходимо добавить входящее подключение metrics в раздел inbounds конфигурационного файла. Это подключение будет слушать на локальном интерфейсе и порту, что обеспечит безопасность доступа к метрикам.

"inbounds": [
    {
        "listen": "127.0.0.1",
        "port": 11111,
        "protocol": "dokodemo-door",
        "settings": {
            "address": "127.0.0.1"
        },
        "tag": "metrics_in"
    }
]

Добавление правила маршрутизации

Для правильной маршрутизации трафика, поступающего на входящее подключение metrics, необходимо добавить правило маршрутизации в раздел routing. Это правило направит трафик, поступающий на тег metrics_in, на тег metrics_out.

"routing": {
    "rules": [
        {
            "type": "field",
            "inboundTag": [
                "metrics_in"
            ],
            "outboundTag": "metrics_out"
        }
    ]
}

Добавление метрик в основные настройки

Для активации метрик необходимо добавить раздел metrics в основные настройки конфигурационного файла. Это позволит системе собирать и экспортировать метрики.

"metrics": {
    "tag": "metrics_out"
}

Использование

pprof

Для профилирования и просмотра запущенных горутин можно использовать встроенный инструмент pprof. Откройте браузер и перейдите по адресу http://127.0.0.1:11111/debug/pprof/ или используйте утилиту go tool pprof для более детального анализа.

expvars

Для просмотра текущих метрик и состояния системы можно использовать экспортные переменные (expvars). Откройте браузер и перейдите по адресу http://127.0.0.1:11111/debug/vars.

Экспортируемые переменные включают:

stats — статистика по входящим, исходящим подключениям и пользователям.
observatory — результаты мониторинга.

Пример данных, полученных с помощью luci-app-xray:

Показать

{
    "observatory": {
        "tcp_outbound": {
            "alive": true,
            "delay": 782,
            "outbound_tag": "tcp_outbound",
            "last_seen_time": 1648477189,
            "last_try_time": 1648477189
        },
        "udp_outbound": {
            "alive": true,
            "delay": 779,
            "outbound_tag": "udp_outbound",
            "last_seen_time": 1648477191,
            "last_try_time": 1648477191
        }
    },
    "stats": {
        "inbound": {
            "api": {
                "downlink": 0,
                "uplink": 0
            },
            "dns_server_inbound_5300": {
                "downlink": 14286,
                "uplink": 5857
            },
            "http_inbound": {
                "downlink": 74460,
                "uplink": 10231
            },
            "https_inbound": {
                "downlink": 0,
                "uplink": 0
            },
            "metrics": {
                "downlink": 6327,
                "uplink": 1347
            },
            "socks_inbound": {
                "downlink": 19925615,
                "uplink": 5512
            },
            "tproxy_tcp_inbound": {
                "downlink": 4739161,
                "uplink": 1568869
            },
            "tproxy_udp_inbound": {
                "downlink": 0,
                "uplink": 2608142
            }
        },
        "outbound": {
            "blackhole_outbound": {
                "downlink": 0,
                "uplink": 0
            },
            "direct": {
                "downlink": 97714548,
                "uplink": 3234617
            },
            "dns_server_outbound": {
                "downlink": 7116,
                "uplink": 2229
            },
            "manual_tproxy_outbound_tcp_1": {
                "downlink": 0,
                "uplink": 0
            },
            "manual_tproxy_outbound_udp_1": {
                "downlink": 0,
                "uplink": 0
            },
            "tcp_outbound": {
                "downlink": 23873238,
                "uplink": 1049595
            },
            "udp_outbound": {
                "downlink": 639282,
                "uplink": 74634
            }
        },
        "user": {}
    }
}

Визуализация данных с помощью Netdata

Для лучшей визуализации данных и мониторинга можно использовать систему мониторинга Netdata с плагином python.d. Netdata предоставляет интерактивные графики, которые облегчают анализ и отслеживание метрик.

Отредактируйте соответствующий файл конфигурации Netdata:
```
sudo /etc/netdata/edit-config python.d/go_expvar.conf
```
Используйте следующий файл конфигурации в качестве примера: