RFC: 5424
Оригинал: The Syslog Protocol
Предыдущие версии: RFC 3164
Категория: Предложенный стандарт
Дата публикации:
Автор:
Перевод: StLeutnant

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 цифр.

2007 - 2017 © Русские переводы RFC, IETF, ISOC.