Внутренний формат передачи в систему статистики по IP-трафику (HCD)

В этом документе описан внутренний формат, используемый агентом hcd для передачи статистики по трафику в АСР «Гидра». Статистика передаётся по протоколу XML-RPC .

Чтобы получить статистику, АСР отправляет в коллектор запрос следующего формата:

Поле	Тип данных XML-RPC	Описание
seance_id	string	Идентификатор сеанса обмена данными
stat_id	string	Идентификатор статистики внутри сеанса
statistics	string	Код агрегатора (добавляется -ab или -ba в зависимости от направления трафика)
last_success_time	string	Дата и время последней удачной синхронизации в формате `DD.MM.YYYY HH24:MI:SS`
reverse_stats_ab	boolean	Указывает на необходимость переставить столбцы IP-адресов/подсетей A и B местами, чтобы направления входящего и исходящего трафика были разными
reset_counters	boolean	Обнулить на агрегаторе счётчики трафика (в пром. режиме всегда `true`, для отладки — `false`)

Ответ передаётся в структуре XML-RPC (тип данных struct), cодержащей следующие поля:

Поле	Тип данных XML-RPC	Описание
ServiceVersion	string	Версия службы коллектора
SeanceID	string	Идентификатор сеанса обмена данными (`seance_id` из запроса)
StatisticsID	string	Идентификатор статистики внутри сеанса (`stat_id` из запроса)
OperationTime	string	Дата и время синхронизации в формате `DD.MM.YYYY HH24:MI:SS`
ResultCode	boolean	Код завершения (в текущей версии всегда `true`)
DataIsValid	boolean	`true` если полученные данные полные и актуальные. Если `false`, при обработке статистики в АСР будет выдано предупреждение
Reversed	boolean	Признак перестановки адресов A и B местами (reverse_stats_ab из запроса)
NumberOfRecords	string	Количество записей в статистике из поля `Data`
Data	string	Данные статистики

Формат поля статистики Data (формат CSV, разделитель полей — точка с запятой):

EXT_GOOD_ID; EXT_OBJECT_ID; D_BEGIN; D_END; ADDR_1/MASK_1; ADDR_2/MASK_2; BYTES;

Поле	Описание
`EXT_GOOD_ID`	Внешний ID услуги
`EXT_OBJECT_ID`	Внешний ID объекта, по которому загружается статистики
`D_BEGIN`	timestamp времени начала потока данных
`D_END`	timestamp времени окончания потока данных
`ADDR_1/MASK_1`	IP и маска подсети (в формате CIDR) отправителя
`ADDR_2/MASK_2`	IP и маска подсети (в формате CIDR) получателя
`BYTES`	Количество байтов (64-битное целое число без знака)

Пример поля статистики:

88849301;ivanov_device;1254249934;1254250321;10.5.0.34/32;0.0.0.0/0;99930291003
88849301;nikolayev_device;1254249703;1254250118;10.5.0.18/32;0.0.0.0/0;2381034429
53332301;stroyservis;1254249556;1254250449;10.5.0.23/32;10.5.0.0/8;30093

Page tree

Внутренний формат передачи в систему статистики по IP-трафику (HCD)