пространство имён apext::log

Пространство имен apext::log с помощью шаблона функции TraceArti предоставляет интерфейс для пересылки смоделированных трассировочных сообщений во внешние инструменты трассировки времени выполнения [SWS_LOG_20000]. Функция вызывается исключительно внутри фреймворка логгера при переключении между журналированием и трассировкой и обрабатывает специфичные для сообщений идентификаторы, а также переменные параметры [SWS_LOG_20000]. В качестве ключевых граничных условий выступают минимальные накладные расходы времени выполнения, полная потокобезопасность и безопасное относительно исключений выполнение без кодов ошибок или возвращаемых значений.

больше ›

Контекст

Пространство имен apext::log предоставляет функциональные интерфейсы для подсистемы журналирования и трассировки AUTOSAR Adaptive Platform. Его основная обязанность заключается в предоставлении выделенного интерфейса для внешних инструментов трассировки времени выполнения через шаблон функции TraceArti [SWS_LOG_20000]. Именование с префиксом apext в качестве интерпретации может указывать на то, что речь идет о расширении платформы (Adaptive Platform Extension), которое подключает специфические механизмы трассировки, такие как AUTOSAR Run-Time Interface (ARTI), к фреймворку журналирования. Вопрос Q-325896ce9f6b8e42 (открытый)

В системной архитектуре пространство имен функционирует как связующее звено между внутренней инфраструктурой журналирования и нижележащими инструментами анализа или трассировки. При этом между собой взаимодействуют главным образом три компонента: внутренний фреймворк логгера, интерфейсная функция TraceArti внутри apext::log, а также подключенный инструмент трассировки [SWS_LOG_20000]. Фреймворк логгера обрабатывает события приложения и при соответствующем переключении пересылает смоделированные сообщения в TraceArti, который передает данные в специфичный для производителя инструмент трассировки [SWS_LOG_20000].

Контекстная диаграмма: встраивание TraceArti между фреймворком логгера и инструментом трассировки. Источники: [SWS_LOG_20000]

Жизненный цикл

Пространство имен apext::log не инкапсулирует долгоживущих экземпляров классов, объектов сессий или сущностей с состоянием, обладающих собственным жизненным циклом. В пространстве имен не существует явных процедур инициализации или завершения; напротив, функциональность реализуется исключительно свободными шаблонными функциями [SWS_LOG_20000]. Таким образом, жизненный цикл функциональности трассировки полностью привязан к вышестоящему рабочему жизненному циклу фреймворка логгера.

В отношении поведения при параллелизме и эксплуатационной безопасности действуют строгие гарантии: интерфейс TraceArti явно специфицирован как потокобезопасный (thread-safe) [SWS_LOG_20000]. Это позволяет фреймворку логгера делегировать вызовы трассировки в пространство имен параллельно из множественных контекстов выполнения и потоков без внешней синхронизации. В то же время функция объявлена как безопасная относительно исключений (exception safe) и noexcept [SWS_LOG_20000], благодаря чему во время вызова ни в какой момент не могут возникать утечки ресурсов или неконтролируемые состояния развертывания стека.

Путь использования

Функции пространства имен apext::log не предназначены для прямого вызова из общего прикладного программного обеспечения. Вместо этого TraceArti вызывается исключительно внутренне фреймворком логгера, когда тот переключается между классическим журналированием и трассировкой на основе ARTI [SWS_LOG_20000]. Разработчики или интеграторы при необходимости подключают соответствующий заголовочный файл #include "apext/log/trace_arti.h" для получения доступа к объявлению [SWS_LOG_20000].

При вызове функция обрабатывает смоделированные сообщения (modeled messages), специфичные для каждого используемого инструмента трассировки [SWS_LOG_20000]. Для этого интерфейс принимает идентифицирующий сообщение идентификатор msg_id определяемого реализацией типа MsgId, а также переменный пакет параметров params... произвольных типов Params... [SWS_LOG_20000]. Чтобы свести накладные расходы времени выполнения в тракте трассировки к минимуму, спецификация требует строгого снижения накладных расходов времени выполнения; этого предполагается достигать, например, за счет специализированных специализаций шаблона на основе соответствующих MsgId [SWS_LOG_20000]. Предположительно, подобные специализации обычно генерируются генераторами инструментов в рамках интеграции инструментария для соответствующих целевых систем.

Сценарии ошибок

В области обработки ошибок apext::log придерживается отказоустойчивой архитектуры без сигнализации об ошибках времени выполнения вызывающей стороне. Сигнатура функции TraceArti не определяет возвращаемого значения (void) и полностью запрещает выброс исключений C++ через спецификацию noexcept [SWS_LOG_20000]. Поэтому предусловия, такие как корректность идентификаторов сообщений и переданных полезных данных, обязательно должны обеспечиваться вызывающим фреймворком логгера или соответствующими специализациями, так как в случае ошибки коды ошибок передаваться не могут [SWS_LOG_20000].