+7 381 249-00-02Лучше по e-mailЗапросить КП

JSON-шаблон rsyslog: экранирование и типы полей проверяют отдельно

Запросить

Фотография конкретного исполнения не приложена.

Собранная вручную строка JSON может выглядеть правильной на простом сообщении и ломаться на кавычке, обратном слеше или переводе строки. Ошибка появляется в выходном шаблоне, хотя вход уже успешно прошёл разбор. Поэтому форматирование является самостоятельной частью контракта с получателем.

Документация рекомендует JSON-safe вывод с option.jsonf и соответствующим format у полей либо сериализацию подготовленного поддерева. Такой механизм выполняет необходимое экранирование. При этом важно определить имена полей и отличать текстовое представление объекта от уже разобранного JSON-значения. Доступность конкретных опций сверяют с установленным выпуском.

Ранее разобранные массивы и объекты могут сохранять свою структуру при соответствующей сериализации. DataType предназначен для преобразования скалярных значений и не превращает произвольную строку с фигурными скобками в JSON-объект. Если получателю нужен массив, сначала требуется корректный разбор, а затем вывод полученного значения.

В приёмке сравнивают не только внешний вид строки, но и результат её разбора независимым получателем. Проверяют кавычки, Unicode, пустые значения, массивы и вложенные объекты. Сверяют ожидаемые типы с фактической схемой хранения. Валидный JSON с числом в строковом поле может быть несовместим с прикладным контрактом, даже если транспорт принял сообщение без ошибки.

Основание — Official rsyslog8 daily stable documentation snapshot; exact installed release not inferred, разделы Schema mapping with JSONF; JSON arrays and objects with JSONF; Parsed JSON values. Сохранён текст публичной справочной публикации; конкретная реализация может поддерживать только часть возможностей. Использован снимок официальной документации rsyslog 8 daily stable. Это обновляемая ветка, а не комплект руководств конкретного установленного выпуска. Экспериментальные segmentedDisk и local queue scope в рекомендации не включены; установленная версия, очередь и получатель не проверялись.

Все разборы