Обычно для базового решения проблем с прокси достаточно просто заглянуть на страницу администрирования прокси Zabbix или посмотреть метрики работоспособности прокси. Однако бывают ситуации, когда требуется более глубокий анализ.
Сегодня мы рассмотрим обмен данными сервер Zabbix ↔ прокси и узнаем, как интерпретировать внутренний протокол обмена данными.
Разбираемся в протоколе
Протокол обмена данными Zabbix
Компоненты Zabbix используют для обмена данными TCP, а информация кодируется в JSON. Как отличить пакеты обмена данными Zabbix? Для этого нужно применить несколько основных фильтров:
-
Протокол: TCP
-
Порт: 10051 или 10050 (в зависимости от того, активные компоненты или пассивные)
-
Пакет: начинается с
ZBXDили5A 42 58 44в HEX
В старых версиях пакеты Zabbix было легко захватить и прочитать в виде обычного текста. Начиная с Zabbix 4.0.0 введено обязательное сжатие трафика. Это значительно сокращает сетевой трафик — примерно в 10 раз при пренебрежимо малой нагрузке на CPU, но при этом делает трафик нечитаемым для человека.
Современный пакет обмена данными Zabbix выглядит так:
5a425844038200000097000000789c2dcccb0e83201085e15731b33606b90a8fe20ec631256da4056a6c9abe7be965fb7f27e709996e772a151c5c733a1edde2ab871e4ee9db661f423cba1f79ac71a786854a89696bbe7223e5b2326b75e01c199368510b42cf68f2eaf3b453fe8fcdc0063eb68497846770a3d1c25a698cea612be0b43642a9c9b2d71b6c5d2cfd
Не очень-то удобно для человека, правда? В следующих разделах мы шаг за шагом захватим и распакуем такой пакет обмена данными.
Захват трафика
Для этого существует множество инструментов, но мы будем использовать Wireshark — один из самых популярных и широко используемых инструментов анализа пакетов. У него удобный графический интерфейс для Windows и Linux, но мы будем использовать версию для командной строки, поскольку решение проблем чаще всего выполняется в SSH-сеансе. В этом примере используется система CentOS Stream 9, но команды должны работать и в других дистрибутивах Linux с незначительными изменениями синтаксиса.
Сначала установите инструмент:
dnf install wireshark-cli
Будет установлена утилита командной строки tshark. После этого перейдите в рабочий каталог, в котором можно создавать файлы. В этом примере мы будем использовать /tmp:
cd /tmp
Далее захватим немного трафика между сервером Zabbix и активным прокси:
tshark -i eth0 -f "host <ZABBIX SERVER IP> and host <ZABBIX PROXY IP> \ and tcp port 10051" -w zabbix_stream.pcap
Описание параметров:
-
-i eth0— прослушивать интерфейс eth0 (при необходимости укажите другой интерфейс) -
<ZABBIX SERVER IP>— замените на IP-адрес сервера Zabbix -
<ZABBIX PROXY IP>— замените на IP-адрес прокси Zabbix -
tcp port 10051— захватывать TCP-пакеты на порту 10051 (Zabbix траппер) -
-w zabbix_stream.pcap— записывать захваченные данные в файл
Дайте команде поработать пару минут, чтобы собрать необработанные данные трафика. Нажмите CTRL + C, чтобы остановить захват.
Анализ файла захвата
Теперь у нас есть файл захвата *.pcap, который содержит несколько TCP-потоков. TCP-поток соответствует одному TCP-соединению. Поскольку прокси Zabbix не поддерживают постоянные соединения, а открывают новое соединение каждый раз, когда это необходимо, активный прокси Zabbix обычно создает следующие потоки:
-
Data sender — отправляет собранные значения каждую секунду (по умолчанию)
-
Configuration syncer — загружает обновления конфигурации каждые 10 секунд (по умолчанию)
Чтобы просмотреть содержимое файла *.pcap, выполните:
tshark -r zabbix_stream.pcap -q -z conv,tcp
Пример вывода:
tshark -r zabbix_stream.pcap -T fields \ -e tcp.stream -e frame.number -e frame.time_relative -e frame.len
"2","5a42584403aa000000dd000000789c458d410e83201444af62fe9a1814a896a3b4e9e283df9494480bd4688c772f694dba9d37336f8348af37a50c1a9e312c6b35604660700fdfec82c6b8a5fa21b4d9cd5460a2945c980a1fcd60945443df2a6e8cb467d30ad958db5be44a8d4d29bb29531cd15285333a8fc6799757d0d7ed8fdc005a080647c31368ce80620cb14860bf3198291eceae96b52ac7d607fb00dd7427d974ad506531a5f2c3c599ab9ecbfd038a0944ee" "2","5a425844033000000029000000789cab562a2dc8c94f4c51b2524acd4b4cca494d51d2512a4a2d2ec8cf2b4e050a16972627a716172bd502002b010e61" "3","5a42584403db0000003d010000789c658fdd6ac3300c855f25e8da143bb6f2e317196cecc23f0a33f3e2cd76434be9bbcf4d03bbd89584bea3a3a31b64fa3953a9a0e13ba7cbb5f3a61a60f091f6d9abb1365cba2732ae868d1a2c544a486be38bf51615faa9476ead72b3eda512ce4dce70c4453471582be5c538eacc66423436c450afa0df6e7f2878d05232381491400b069473caed08dcdf5ba0506aca47be7dd9efa250e9ebd12257c819b898dc6703e3a0c4d8cbc7682da06735e1340e02196c269e9b3fbc90ed0ae58df2eedfeaf1d378522784ff56e2692545afe6990fc3fd17684060c8" "3","5a425844033000000029000000789cab562a2dc8c94f4c51b2524acd4b4cca494d51d2512a4a2d2ec8cf2b4e050a16972627a716172bd502002b010e61"
Далее создадим немного измененный скрипт Python, который выводит записи по потокам. Назовите его streams.py:
#!/usr/bin/python3
import csv
import zlib
import json
csv_file = "zabbix_payload.csv"
ZBXD_HEADER_LEN = 26 # 13 bytes * 2 hex chars per byte
streams = {}
with open(csv_file, "r") as f:
reader = csv.reader(f)
for row_number, row in enumerate(reader, 1):
if len(row) < 2:
continue
stream_id = row[0].strip().strip('"')
hexdata = row[1].strip().strip('"')
if not hexdata:
continue
# Remove Zabbix header
if hexdata.startswith("5a425844"):
hex_payload = hexdata[ZBXD_HEADER_LEN:]
else:
hex_payload = hexdata
# Convert hex to bytes
try:
payload_bytes = bytes.fromhex(hex_payload)
except ValueError as e:
print(f"[Line {row_number}] Invalid hex: {e}")
continue
# Decompress
try:
decompressed = zlib.decompress(payload_bytes)
except zlib.error as e:
print(f"[Line {row_number}] Decompression error: {e}")
continue
# Store in the stream bucket
streams.setdefault(stream_id, []).append(decompressed)
# ---- OUTPUT SECTION ----
print("\n===== STREAM PAIRS =====\n")
for stream_id, messages in streams.items():
print(f"=== Stream {stream_id} ===")
for i, msg in enumerate(messages):
label = (
"Request:" if i == 0
else "Response:" if i == 1
else f"Extra message #{i+1}:"
)
print(label)
text = msg.decode("utf-8")
# Try to pretty-print JSON
try:
parsed = json.loads(text)
pretty_json = json.dumps(parsed, indent=4, ensure_ascii=False)
print(pretty_json)
except json.JSONDecodeError:
# fallback: print raw text
print(text)
print()
Сделайте файл исполняемым:
chmod +x streams.py
Запустите файл:
./streams.py
Скрипт выведет распакованный трафик Zabbix в разобранном формате JSON:
=== Stream 0 ===
Request:
{
"request": "proxy data",
"host": "Zabbix proxy active",
"session": "fbdb545d8250bb4c9b2341cc8ca055f1",
"interface availability": [
{
"interfaceid": 33,
"available": 0,
"error": ""
}
],
"version": "7.4.5",
"clock": 1764172350,
"ns": 303905804
}
Response:
{
"upload": "enabled",
"response": "success"
}
=== Stream 1 ===
Request:
.......
Как видно, при обычном обмене данными в каждом потоке две записи — один запрос от прокси Zabbix и один ответ от сервера Zabbix. При таком подходе гораздо проще разобраться в обмене данными и решать связанные с ним проблемы — весь трафик теперь сгруппирован в пары «запрос-ответ» и представлен в аккуратном отформатированном виде.
Данные в реальном времени
И наконец — можно ли запустить все это в реальном времени? Конечно, в этом поможет наш третий скрипт Python. В двух предыдущих примерах мы шаг за шагом прошли весь рабочий процесс: захват → извлечение полезной нагрузки → распаковка. Теперь все объединено в одном скрипте, который выполняет весь процесс за вас.
Создайте новый файл с именем live.py:
#!/usr/bin/python3
import subprocess
import zlib
import json
from datetime import datetime
ZBXD_HEADER_LEN = 26 # 13 bytes * 2 hex chars
# === Configurable parameters ===
SRC_IP = "161.35.217.186"
DST_IP = "134.209.233.72"
TCP_PORT = "10051"
INTERFACE = "eth0"
tshark_cmd = [
"tshark",
"-i", INTERFACE,
"-l",
"-f", f"host {SRC_IP} and host {DST_IP} and tcp port {TCP_PORT}",
"-T", "fields",
"-e", "tcp.stream",
"-e", "tcp.payload",
"-E", "separator=,",
"-E", "quote=d",
"-E", "occurrence=f",
"-Y", "tcp.payload && tcp.payload != \"\""
]
proc = subprocess.Popen(
tshark_cmd,
stdout=subprocess.PIPE,
stderr=subprocess.DEVNULL,
text=True
)
seen_streams = set() # track streams we've already printed
for line in proc.stdout:
line = line.strip()
if not line:
continue
# Split CSV (stream_number, payload_hex)
try:
stream_num, payload_hex = line.split(",", 1)
payload_hex = payload_hex.strip('"')
except ValueError:
continue
# Only print timestamp once per stream
if stream_num not in seen_streams:
timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S.%f")[:-3]
print(f"\n=== [{timestamp}] Stream {stream_num} ===")
seen_streams.add(stream_num)
# Remove Zabbix header
if payload_hex.startswith("5a425844"):
payload_hex = payload_hex[ZBXD_HEADER_LEN:]
# Convert hex to bytes
try:
payload_bytes = bytes.fromhex(payload_hex)
except ValueError:
continue
# Decompress
try:
decompressed = zlib.decompress(payload_bytes)
except zlib.error:
continue
# Pretty print JSON if possible
try:
json_obj = json.loads(decompressed)
pretty = json.dumps(json_obj, indent=2)
print(pretty)
except json.JSONDecodeError:
print(decompressed)
Сделайте файл исполняемым:
chmod +x live.py
Запустите файл:
./live.py
Вот и все — теперь ваш скрипт отслеживает трафик прокси в реальном времени и непрерывно выводит результат в формате JSON. Здорово, правда?
=== [2025-11-27 16:59:31.593] Stream "0" ===
{
"request": "proxy data",
"host": "Zabbix proxy active",
"session": "fbdb545d8250bb4c9b2341cc8ca055f1",
"history data": [
{
"id": 73726,
"itemid": 50459,
"clock": 1764262769,
"ns": 947018320,
"value": "0"
},
{
"id": 73727,
"itemid": 50450,
"clock": 1764262770,
"ns": 947145177
}
],
"version": "7.4.5",
"clock": 1764262770,
"ns": 961735298
}
{
"upload": "enabled",
" response": "success"
}
.....
Заключительные замечания
Приведенные здесь примеры скриптов предназначены только для демонстрации и протестированы в небольшой демонстрационной среде. Те же принципы применимы и к более крупным системам, но учтите, что прокси в рабочей среде могут обрабатывать сотни и даже тысячи новых значений в секунду (NVPS), что значительно увеличивает объем полезной нагрузки. Кроме того, во всех примерах предполагается, что прокси Zabbix работает в активном режиме — пассивные прокси обмениваются данными немного иначе. Аналогичный подход можно использовать для мониторинга обмена данными с агентом Zabbix.
Итак, какую полезную информацию на самом деле можно получить из обмена данными прокси Zabbix ⇄ сервер Zabbix?
-
Типы данных, отправляемых с прокси на сервер
-
Обновления конфигурации и их содержимое
-
Задачи тестирования и «Выполнить сейчас»
-
Данные обнаружения и автоматической регистрации
Если вам интересно подробнее изучить обнаружение, автоматическую регистрацию, шифрование или другие аспекты внутреннего обмена данными Zabbix, оставляйте комментарии!