namespace apext::log

El espacio de nombres apext::log proporciona, con la plantilla de función TraceArti, una interfaz para reenviar mensajes de rastreo modelados a herramientas de rastreo de tiempo de ejecución externas [SWS_LOG_20000]. La función se llama exclusivamente de forma interna por el framework de registro al conmutar entre registro y rastreo, y procesa identificadores específicos de mensajes así como parámetros variables [SWS_LOG_20000]. Como restricciones centrales rigen una sobrecarga mínima en tiempo de ejecución, una seguridad total para subprocesos y una ejecución segura contra excepciones sin valores de retorno ni de error.

más ›

Contexto

El espacio de nombres apext::log proporciona interfaces funcionales para el subsistema de registro y rastreo de AUTOSAR Adaptive Platform. Su responsabilidad primaria reside en poner a disposición una interfaz dedicada para herramientas de rastreo de tiempo de ejecución externas a través de la plantilla de función TraceArti [SWS_LOG_20000]. La asignación del nombre con el prefijo apext indicaría, como interpretación, que se trata de una extensión de la plataforma (Adaptive Platform Extension) que vincula mecanismos de rastreo específicos como AUTOSAR Run-Time Interface (ARTI) al framework de registro. Pregunta Q-325896ce9f6b8e42 (abierta)

En la arquitectura del sistema, el espacio de nombres actúa como elemento de enlace entre la infraestructura interna de registro y herramientas de análisis o de rastreo posteriores. En este proceso interactúan esencialmente tres componentes entre sí: el framework de registro interno, la función de interfaz TraceArti dentro de apext::log y la herramienta de rastreo conectada [SWS_LOG_20000]. El framework de registro procesa eventos de aplicación y, ante la conmutación correspondiente, reenvía mensajes modelados a TraceArti, el cual transfiere los datos a la herramienta de rastreo específica del fabricante [SWS_LOG_20000].

Diagrama de contexto: integración de TraceArti entre el framework de registro y la herramienta de rastreo. Fuentes: [SWS_LOG_20000]

Ciclo de vida

El espacio de nombres apext::log no encapsula instancias de clase de larga vida, objetos de sesión ni entidades con estado que posean un ciclo de vida autónomo. No existen en el espacio de nombres rutinas explícitas de inicialización o terminación; más bien, la funcionalidad se implementa exclusivamente mediante funciones de plantilla libres [SWS_LOG_20000]. El ciclo de vida de la funcionalidad de rastreo queda así completamente vinculado al ciclo de vida operativo superior del framework de registro.

En cuanto al comportamiento de concurrencia y a la seguridad operativa, rigen garantías estrictas: la interfaz TraceArti está especificada explícitamente como segura para subprocesos (thread-safe) [SWS_LOG_20000]. Esto permite al framework de registro delegar llamadas de rastreo de forma paralela desde múltiples contextos de ejecución y subprocesos al espacio de nombres sin sincronización externa. Al mismo tiempo, la función está declarada como segura contra excepciones (exception safe) y noexcept [SWS_LOG_20000], de modo que en ningún momento pueden producirse fugas de recursos ni estados incontrolados de desenrollado de pila durante la llamada.

Ruta de uso

Las funciones del espacio de nombres apext::log no están diseñadas para su llamada directa por software de aplicación general. En su lugar, TraceArti es llamada exclusivamente de forma interna por el framework de registro cuando este conmuta entre el registro clásico y el rastreo basado en ARTI [SWS_LOG_20000]. Los desarrolladores o integradores incluyen, en caso necesario, el archivo de encabezado #include "apext/log/trace_arti.h" correspondiente para obtener acceso a la declaración [SWS_LOG_20000].

Al realizar la llamada, la función procesa mensajes modelados (modeled messages) que son específicos para la respectiva herramienta de rastreo utilizada [SWS_LOG_20000]. Para ello, la interfaz acepta un identificador de mensaje msg_id de un tipo definido por la implementación MsgId, así como un paquete de parámetros variables params... de tipos arbitrarios Params... [SWS_LOG_20000]. Para mantener los costes de tiempo de ejecución en la ruta de rastreo tan bajos como sea posible, la especificación exige una minimización estricta de la sobrecarga de tiempo de ejecución; esto debe lograrse, por ejemplo, mediante especializaciones de plantilla a medida basadas en el respectivo MsgId [SWS_LOG_20000]. Es de suponer que tales especializaciones se generan típicamente mediante generadores de herramientas en el marco de la integración de la cadena de herramientas para los sistemas de destino respectivos.

Escenarios de error

En el ámbito del tratamiento de errores, apext::log sigue un diseño tolerante a fallos sin señalización de errores de tiempo de ejecución al llamador. La firma de la función de TraceArti no define ningún valor de retorno (void) y prohíbe por completo el lanzamiento de excepciones de C++ mediante la especificación noexcept [SWS_LOG_20000]. Por lo tanto, las precondiciones como la validez de los ID de mensaje y de los datos útiles transferidos deben garantizarse obligatoriamente por el framework de registro llamador o por las especializaciones correspondientes, ya que en caso de fallo no se pueden transportar códigos de error [SWS_LOG_20000].