Close
Log in to Zabbix Blog
Email
Password
Show password Hide password
Forgot password?
Incorrect e-mail and/or password
or
By creating an account or logging in with an existing account, you agree to our Terms of Service
Как сделатьТехнический постВойти

Декодирование трафика прокси Zabbix для более быстрого решения проблем

Обычно для базового решения проблем с прокси достаточно просто заглянуть на страницу администрирования прокси Zabbix или посмотреть метрики работоспособности прокси. Однако бывают ситуации, когда требуется более глубокий анализ. Сегодня мы рассмотрим обмен данными сервер Zabbix ↔ прокси и узнаем, как интерпретировать внутренний протокол обмена данными. Разбираемся в протоколе Протокол обмена данными Zabbix Компоненты Zabbix используют […]

Обычно для базового решения проблем с прокси достаточно просто заглянуть на страницу администрирования прокси 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

Пример вывода:

TCP Conversations
Filter:<No Filter>
                                   |      <-    ||      ->    ||     Total   |Relative|
                                   |Frames Bytes||Frames Bytes||Frames Bytes |Start   |       
10.10.0.2:57850 <-> 10.20.0.5:10051 5 2,512bytes  6 547bytes    11 3,059bytes 0.0000   
10.10.0.2:57860 <-> 10.20.0.5:10051 5 399bytes    5 516bytes    10 915bytes   0.4700  
10.10.0.2:57864 <-> 10.20.0.5:10051 5 399bytes    5 521bytes    10 920bytes   1.4768  
10.10.0.2:57876 <-> 10.20.0.5:10051 5 399bytes    5 570bytes    10 969bytes   2.4829   
10.10.0.2:57878 <-> 10.20.0.5:10051 5 399bytes    5 522bytes    10 921bytes   3.4882   
10.10.0.2:46628 <-> 10.20.0.5:10051 5 399bytes    5 527bytes    10 926bytes   4.4935   
10.10.0.2:46642 <-> 10.20.0.5:10051 4 333bytes    6 590bytes    10 923bytes   5.4992   
10.10.0.2:46648 <-> 10.20.0.5:10051 5 399bytes    5 478bytes    10 877bytes   6.5047   
10.10.0.2:46662 <-> 10.20.0.5:10051 5 399bytes    5 480bytes    10 879bytes   7.5097
Можно вывести пакеты в хронологическом порядке вместе с номерами потоков:
tshark -r zabbix_stream.pcap -T fields \
-e tcp.stream -e frame.number -e frame.time_relative -e frame.len
Значение столбцов в примере вывода:
  1. Номер потока

  2. Номер кадра

  3. Относительная метка времени от начала захвата

  4. Размер кадра в байтах

0 1  0.000000000 76
0 2  0.000005109 76
0 3  0.000078403 68
0 4  0.000079579 68
0 5  0.000280946 209
0 6  0.000283835 209
0 7  0.001188322 68
0 8  0.001189912 68
0 9  0.001421210 68
0 10 0.001422856 68
1 11 1.003582601 76
1 12 1.003588266 76
1 13 1.003646494 68
1 14 1.003647585 68
1 15 1.003741654 256
1 16 1.003758183 256
1 17 1.004531106 68
1 18 1.004532827 68
1 19 1.004973531 68
.....

Чтобы включить полезную нагрузку (обмен данными Zabbix), добавьте поле -e tcp.payload:

tshark -r zabbix_stream.pcap -T fields \
-e tcp.stream -e frame.number -e frame.time_relative -e frame.len -e tcp.payload

Пример (сокращен для удобства чтения):

0 1  0.000000000 76
0 2  0.000005109 76
0 3  0.000078403 68
0 4  0.000079579 68
0 5  0.000280946 209 5a425844038000000096000000789c2dca4d0e82301040e1ab90591352fb3703477137d3d6483454692518e3dd6dd4edfbde0bd6747fa4526182db9af76717b932f470cedf76649179ef7ec4a1ce5b6a585229735e9a2bf12aa2481c89299032c2ceb21754a44fda609bb7b4fe671cece05a09d71c2e301dd05b4548daf4b014984667b52734f6fd013eac2c96
0 6  0.000283835 209 5a425844038000000096000000789c2dca4d0e82301040e1ab90591352fb3703477137d3d6483454692518e3dd6dd4edfbde0bd6747fa4526182db9af76717b932f470cedf76649179ef7ec4a1ce5b6a585229735e9a2bf12aa2481c89299032c2ceb21754a44fda609bb7b4fe671cece05a09d71c2e301dd05b4548daf4b014984667b52734f6fd013eac2c96
0 7  0.001188322 68
0 8  0.001189912 68
0 9  0.001421210 68
0 10 0.001422856 68
......

Не все кадры содержат полезную нагрузку — пустые соответствуют рукопожатиям TCP и другим управляющим пакетам. Нас интересуют только кадры с полезной нагрузкой, потому что именно в них находятся данные Zabbix.

Анализ полезной нагрузки

Если присмотреться, каждая полезная нагрузка начинается с последовательности 5a 42 58 44 — или «ZBXD» в ASCII. Это сигнатура пакета Zabbix, и она подтверждает, что мы захватили нужный трафик.

Пример:

5a42584403af000000f0000000789c658ecb0e823014447f85dc3521853e6edb4fd1b868a1c646b44a0bc110fedd22ec5cce9ce4cc2c30b8f7e862020daf21cc9fa233c94009b7f0eb4ec65a3f173b326df293cb30ba187d78664eac201d5adb2969642b09b58633232c12d95c1b8a9bc9c7148643accf0bf80e34150d2bc127f7d812278cd312da3eb477d0350a4624ca2657cf081a15e74cd588254ca61f5d9ead61bde4e486e30656ace2f06f60bb417154825056af5fed34456b
Полный заголовок Zabbix — это первые 13 байт каждого пакета: 5a 42 58 44 03 af 00 00 00 f0 00 00 00 
  • 5a 42 58 44 — сигнатура пакета Zabbix ZBXD

  • 03 — флаги (0x01 протокол Zabbix + 0x02 сжатие)

  • af 00 00 00 — длина данных

  • f0 00 00 00 — длина несжатых данных

Следующий заголовок — 78 9c, который указывает на сжатие zlib. За ним следует сжатый JSON с интересующими нас данными. Дополнительную информацию можно найти в документации Zabbix здесь.

Извлечем только полезную нагрузку с помощью команды:

tshark -r zabbix_stream.pcap -T fields -e tcp.payload -E occurrence=f \
| grep -v '^$'
  • -T fields: выводить только выбранные поля

  • -e tcp.payload: получать полезную нагрузку каждого TCP-кадра

  • -E occurrence=f: включать все вхождения для каждого кадра

  • grep -v ‘^$’: удалять пустые строки (кадры без полезной нагрузки)

Пример вывода:

5a425844038000000096000000789c2dca4d0e82301040e1ab90591352fb3703477137d3d6483454692518e3dd6dd4edfbde0bd6747fa4526182db9af76717b932f470cedf76649179ef7ec4a1ce5b6a585229735e9a2bf12aa2481c89299032c2ceb21754a44fda609bb7b4fe671cece05a09d71c2e301dd05b4548daf4b014984667b52734f6fd013eac2c96                                                                                5a425844038000000096000000789c2dca4d0e82301040e1ab90591352fb3703477137d3d6483454692518e3dd6dd4edfbde0bd6747fa4526182db9af76717b932f470cedf76649179ef7ec4a1ce5b6a585229735e9a2bf12aa2481c89299032c2ceb21754a44fda609bb7b4fe671cece05a09d71c2e301dd05b4548daf4b014984667b52734f6fd013eac2c96                                                                                5a42584403af000000f0000000789c658ecb0e823014447f85dc3521853e6edb4fd1b868a1c646b44a0bc110fedd22ec5cce9ce4cc2c30b8f7e862020daf21cc9fa233c94009b7f0eb4ec65a3f173b326df293cb30ba187d78664eac201d5adb2969642b09b58633232c12d95c1b8a9bc9c7148643a

Распаковка полезной нагрузки

Сначала сохраним полезную нагрузку в файл:

tshark -r zabbix_stream.pcap -T fields -e tcp.payload -E occurrence=f \
| grep -v '^$'  > zabbix_payload.hex

Затем создайте скрипт Python с именем decompress.py.

#!/usr/bin/python3
import zlib

hex_file = "zabbix_payload.hex"
ZBXD_HEADER_LEN = 26 # 13 bytes * 2 hex chars per byte

with open(hex_file, "r") as f:
  for line_number, line in enumerate(f, 1):
    line = line.strip()
    if not line:
      continue

    # Remove Zabbix header
    if line.startswith("5a425844"):
      payload_hex = line[ZBXD_HEADER_LEN:]
    else:
      payload_hex = line

    # Convert hex to bytes
    try:
      payload_bytes = bytes.fromhex(payload_hex)
    except ValueError as e:
      print(f"Line {line_number}: Invalid hex, skipping ({e})")
      continue

    # Decompress using zlib
    try:
      decompressed = zlib.decompress(payload_bytes)
    except zlib.error as e:
      print(f"Line {line_number}: Decompression error ({e})")
      continue
  
    print(f"Line {line_number}: {decompressed}")

Сделайте файл исполняемым:

chmod +x decompress.py

Запустите файл:

./decompress.py

Скрипт выведет распакованный трафик Zabbix:

Line 59: b'{"request":"proxy data","host":"Zabbix proxy active","session":"fbdb545d8250bb4c9b2341cc8ca055f1","history data":[{"id":13,"itemid":50454,"clock":1764172374,"ns":946257883,"value":"[{\\"{#IFNAME}\\":\\"lo\\"},{\\"{#IFNAME}\\":\\"eth0\\"}]"}],"version":"7.4.5","clock":1764172375,"ns":432069960}'
Line 60: b'{"upload":"enabled","response":"success","tasks":[{"type":6,"clock":1764172373,"ttl":3600,"itemid":50454}]}'
Line 61: b'{"request":"proxy data","host":"Zabbix proxy active","session":"fbdb545d8250bb4c9b2341cc8ca055f1","version":"7.4.5","clock":1764172375,"ns":438122213}'
Line 62: b'{"upload":"enabled","response":"success"}'
Line 63: b'{"request":"proxy config","host":"Zabbix proxy active","version":"7.4.5","session":"fbdb545d8250bb4c9b2341cc8ca055f1", "config_revision":18611,"proxy_secrets_provider":0}'
Line 64: b'{"data":{},"config_revision":18613}'

Здесь каждая строка представляет собой запрос от активного прокси Zabbix или ответ сервера Zabbix. Легко различить два типа обмена данными:

  • Запрос proxy data — прокси отправляет собранные значения
  • Запрос proxy config — прокси проверяет редакцию своей конфигурации и при необходимости загружает изменения конфигурации
Итоги

Чтобы прочитать обмен данными в несжатом виде, в этой конфигурации достаточно выполнить всего три команды:

tshark -i eth0 -f "host <ZABBIX SERVER IP> and host <ZABBIX PROXY IP> \
and tcp port 10051" -w zabbix_stream.pcap

tshark -r zabbix_stream.pcap -T fields -e tcp.payload -E occurrence=f \
| grep -v '^$' > zabbix_payload.hex

./decompress.py

Более удобочитаемый формат

Можно ли сделать лучше? Конечно! Объединим запросы в пары с соответствующими ответами, чтобы их было проще разбирать, а затем выведем данные в виде отформатированного JSON. Сначала захватите данные:

tshark -i eth0 -f "host <ZABBIX SERVER IP> and host <ZABBIX PROXY IP> \
and tcp port 10051" -w zabbix_stream.pcap

Затем извлеките данные в CSV, сохранив номер потока:

tshark -r zabbix_stream.pcap -T fields -e tcp.stream -e tcp.payload \
-E occurrence=f -E separator=, -E quote=d, -Y 'tcp.payload && tcp.payload != ""' \
> zabbix_payload.csv

Теперь CSV содержит и номер потока, и полезную нагрузку для каждого пакета.

"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, оставляйте комментарии!

Prev Post Prev Post Next Post Next Post
Подписаться
Уведомить о
0 Comments
Старые
Новые Популярные
0
Оставьте комментарий! Напишите, что думаете по поводу статьи.x