Измерение прошедшего времени в Go: сериализация теряет компонент монотонных часов

Что это такое

Документация Go по времени указывает, что time.Now возвращает Time с показанием монотонных часов. Сравнения и вычитание используют монотонные показания, когда они есть у обоих операндов; иначе используются показания календарных часов. Сериализованные формы не включают монотонный компонент, поскольку за пределами процесса он не имеет смысла; некоторые преобразования также удаляют его. Go time package

Почему это важно

Агент может сохранить метку времени начала и предположить, что последующее вычитание имеет в точности ту же семантику часов, что и локальный секундомер. Такое предположение пересекает границу процесса. Определите, требуется ли локальное прошедшее время, календарная временная метка или предельный срок, который должен интерпретировать другой процесс.

Как применять

• Проследите происхождение каждого значения времени и все преобразования до сравнения. Отдельно от первоначального получения значения отметьте сериализацию, разбор и конвертацию.
• Для длительности, измеряемой в одном процессе, сохраняйте предусмотренный путь локального измерения. Записывайте отдельную календарную временную метку, когда журналам или внешним системам нужно время события в понятном человеку виде.
• Для сохраняемых предельных сроков задайте правила на случай изменения часов и задержки обработки. Не описывайте сериализованную временную метку как содержащую монотонные часы исходного процесса.
• Предложите тестовые сценарии, сравнивающие локальный путь с сериализацией и последующим восстановлением. Проверяйте документированную политику, а не полагайтесь на равенство внутренних представлений.
• Проверьте расчёты тайм-аутов и повторных попыток, смешивающие значения разного происхождения. При передаче работы другому процессу явно сохраняйте оставшийся запас времени.

Подводные камни

Как отмечает документация, поведение монотонных часов во время сна компьютера зависит от платформы. Требование к длительности, включающей время приостановки, может нуждаться в иной политике, чем измерение активного выполнения. Не утверждайте, что перевод временной метки в UTC сохраняет все скрытые компоненты часов. Эти проверки представляют собой предложение по анализу проектирования, а не выполненный эксперимент с переводом часов или гарантию защиты от любых временных аномалий.