namespace apext::log

L'espace de noms apext::log fournit, avec le modèle de fonction TraceArti, une interface pour la transmission de messages de trace modélisés à des outils de trace d'exécution externes [SWS_LOG_20000]. La fonction est appelée exclusivement en interne par le framework de journalisation lors du basculement entre la journalisation et le traçage, et traite des identifiants spécifiques au message ainsi que des paramètres variables [SWS_LOG_20000]. Un surcoût à l'exécution minimal, une sécurité complète des threads ainsi qu'une exécution sans exception sans valeurs d'erreur ni de retour s'appliquent comme contraintes centrales.

plus ›

Contexte

L'espace de noms apext::log fournit des interfaces fonctionnelles pour le sous-système de journalisation et de traçage de l'AUTOSAR Adaptive Platform. Sa responsabilité principale réside dans la mise à disposition d'une interface dédiée pour des outils de trace d'exécution externes via le modèle de fonction TraceArti [SWS_LOG_20000]. L'attribution du nom avec le préfixe apext devrait indiquer, selon l'interprétation, qu'il s'agit d'une extension de plateforme (Adaptive Platform Extension) qui relie des mécanismes de traçage spécifiques tels que l'AUTOSAR Run-Time Interface (ARTI) au framework de journalisation. Question Q-325896ce9f6b8e42 (ouverte)

Dans l'architecture système, l'espace de noms sert de passerelle entre l'infrastructure de journalisation interne et les outils d'analyse ou de trace en aval. Trois composants interagissent alors essentiellement entre eux : le framework de journalisation interne, la fonction d'interface TraceArti au sein de apext::log ainsi que l'outil de trace connecté [SWS_LOG_20000]. Le framework de journalisation traite les événements applicatifs et transmet les messages modélisés, en cas de basculement correspondant, à TraceArti, qui remet les données à l'outil de trace spécifique au constructeur [SWS_LOG_20000].

Diagramme de contexte : intégration de TraceArti entre le framework de journalisation et l'outil de trace. Sources : [SWS_LOG_20000]

Cycle de vie

L'espace de noms apext::log n'encapsule aucune instance de classe durable, objet de session ou entité avec état dotée d'un cycle de vie autonome. Il n'existe pas de routines explicites d'initialisation ou de terminaison dans l'espace de noms ; la fonctionnalité est plutôt exclusivement réalisée par des fonctions modèles libres [SWS_LOG_20000]. Le cycle de vie de la fonctionnalité de traçage est ainsi entièrement couplé au cycle de vie opérationnel de niveau supérieur du framework de journalisation.

Des garanties strictes s'appliquent quant au comportement en concurrence et à la sécurité de fonctionnement : l'interface TraceArti est explicitement spécifiée comme thread-safe [SWS_LOG_20000]. Cela permet au framework de journalisation de déléguer des appels de trace en parallèle depuis de multiples contextes d'exécution et threads à l'espace de noms, sans synchronisation externe. En même temps, la fonction est déclarée sans exception (exception safe) et noexcept [SWS_LOG_20000], de sorte qu'aucune fuite de ressources ni aucun état de déroulement incontrôlé de pile ne puisse survenir à aucun moment pendant l'appel.

Parcours d'utilisation

Les fonctions de l'espace de noms apext::log ne sont pas conçues pour être appelées directement par le logiciel applicatif général. Au lieu de cela, TraceArti est appelée exclusivement en interne par le framework de journalisation lorsque celui-ci bascule entre la journalisation classique et le traçage basé sur ARTI [SWS_LOG_20000]. Les développeurs ou intégrateurs incluent en cas de besoin le fichier d'en-tête correspondant #include "apext/log/trace_arti.h" afin d'obtenir l'accès à la déclaration [SWS_LOG_20000].

Lors de son appel, la fonction traite des messages modélisés (modeled messages) qui sont spécifiques à l'outil de trace utilisé [SWS_LOG_20000]. L'interface accepte à cet effet un identifiant de message msg_id d'un type défini par l'implémentation MsgId ainsi qu'un pack de paramètres variables params... de types arbitraires Params... [SWS_LOG_20000]. Afin de maintenir les coûts d'exécution sur le chemin de trace à un niveau aussi bas que possible, la spécification exige une minimisation stricte du surcoût à l'exécution ; cela doit par exemple être atteint au moyen de spécialisations de templates sur mesure basées sur les MsgId respectifs [SWS_LOG_20000]. Il est à présumer que de telles spécialisations sont typiquement générées par des générateurs d'outils dans le cadre de l'intégration de la chaîne d'outils pour les systèmes cibles respectifs.

Scénarios d'erreur

Dans le domaine de la gestion des erreurs, apext::log adopte une conception tolérante aux pannes sans signalement des erreurs d'exécution à l'appelant. La signature de fonction de TraceArti ne définit aucune valeur de retour (void) et interdit complètement la levée d'exceptions C++ via la spécification noexcept [SWS_LOG_20000]. Les préconditions telles que la validité des identifiants de message et des données utiles transmises doivent donc obligatoirement être garanties par le framework de journalisation appelant ou par les spécialisations correspondantes, car aucun code d'erreur ne peut être transporté en cas d'erreur [SWS_LOG_20000].