6.2.2. VERSION (версия)
В поле VERSION объявляется версия поддерживаемой спецификации протокола Syslog. Номер версии ДОЛЖЕН увеличиваться для каждой новой спецификации протокола Syslog, изменяющей формат поля HEADER в любой его части. Изменения включают как добавление и удаление полей, так и изменение синтаксиса и семантики существующих полей. Данный документ использует значение 1
для поля VERSION. Это значение назначено IANA с помощью Процедуры Стандартизации (Standarts Action), как это описано в RFC 5226 (см. раздел 9.1. настоящего документа).
6.2.3. TIMESTAMP (отметка-времени)
В поле TIMESTAMP помещается формализованная отметка времени, наследуемая из RFC 3339.
Поскольку RFC 3339 допускает широкое синтаксическое разнообразие, то здесь на синтаксис накладываются ограничения. Данные в поле TIMESTAMP ДОЛЖНЫ соответствовать следующим ограничениям:
- символы
TиZДОЛЖНЫ использоваться в верхнем регистре, - использование символа
TТРЕБУЕТСЯ, - корректировочные секунды НЕ ДОЛЖНЫ использоваться[перевод] .
Источнику РЕКОМЕНДУЕТСЯ заполнять поле TIME-SECFRAC (доли-секунды) с той точностью, насколько позволяет это сделать точность и производительность его часов. Элемент структурированных данных SD-ID timeQuality
, описанный в Разделе 7.1, позволяет источнику указать точность и степень доверия к отметке времени.
Приложения Syslog должны использовать NILVALUE (пропуск) в качестве TIMESTAMP, если они неспособны получить системное время.
6.2.3.1. Примеры
- Пример 1:
1985-04-12T23:20:50.52Z
Здесь представлена запись отметки времени, соответствующая 23 часам 20 минутам 50 целым 52 сотым секунды 12 апреля 1985 года в UTC.
- Пример 2:
1985-04-12T19:20:50.52-04:00
Та же самая отметка времени, что и в предыдущем примере, но по Восточному Стандартному Времени США (с учетом перехода на летнее время).
- Пример 3:
2003-10-11T22:14:15.003Z
Здесь представлена запись отметки времени, соответствующая 22 часам 14 минутам 15 секундам 3 миллисекундам 11 октября 2003 года в UTC. Отметка предоставлена в миллисекундном разрешении. В действительности, источник мог иметь лучшее разрешение, но предоставил только три действующие цифры в дробной части секунд.
- Пример 4:
2003-08-24T05:14:15.000003-07:00
Здесь представлена запись отметки времени, соответствующая 5 часам 14 минутам 15 секундам 3 микросекундам 24 августа 2003 года по Тихоокеанскому Времени США с учетом летного времени. Отметка предоставлена в микросекундном разрешении (поле TIME-SECFRAC).
- Пример 5 — неправильное значение TIMESTAMP:
2003-08-24T05:14:15.000000003-07:00
Отметка, подобная предыдущему примеру, но в наносекундном разрешении, является неправильной, поскольку в поле TIME-SECFRAC допустимо не больше 6 цифр.