namespace apext::log

O namespace apext::log disponibiliza, com o modelo de função TraceArti, uma interface para o encaminhamento de mensagens de rastreio modeladas para ferramentas externas de rastreio em tempo de execução [SWS_LOG_20000]. A função é chamada exclusivamente de forma interna pela framework do logger ao alternar entre logging e tracing, processando identificadores específicos da mensagem e parâmetros variáveis [SWS_LOG_20000]. As principais condições de contorno são um overhead mínimo em tempo de execução, total segurança para threads e uma execução segura contra exceções sem valores de erro ou de retorno.

mais ›

Contexto

O namespace apext::log fornece interfaces funcionais para o subsistema de logging e tracing da AUTOSAR Adaptive Platform. A sua responsabilidade primária reside na disponibilização de uma interface dedicada para ferramentas externas de rastreio em tempo de execução através do modelo de função TraceArti [SWS_LOG_20000]. Como interpretação, a nomenclatura com o prefixo apext deverá indicar que se trata de uma extensão da plataforma (Adaptive Platform Extension) que conecta mecanismos específicos de rastreio, como a AUTOSAR Run-Time Interface (ARTI), à framework de logging. Pergunta Q-325896ce9f6b8e42 (aberta)

Na arquitetura do sistema, o namespace funciona como elemento de ligação entre a infraestrutura interna de logging e ferramentas posteriores de análise ou rastreio. Interagem essencialmente três componentes entre si: a framework interna do logger, a função de interface TraceArti dentro de apext::log e a ferramenta de rastreio conectada [SWS_LOG_20000]. A framework do logger processa eventos da aplicação e, mediante a respetiva comutação, encaminha mensagens modeladas para TraceArti, que transmite os dados para a ferramenta de rastreio específica do fabricante [SWS_LOG_20000].

Diagrama de contexto: integração de TraceArti entre a framework do logger e a ferramenta de rastreio. Fontes: [SWS_LOG_20000]

Ciclo de vida

O namespace apext::log não encapsula instâncias de classes de longa duração, objetos de sessão ou entidades com estado que possuam um ciclo de vida autónomo. Não existem rotinas explícitas de inicialização ou de terminação no namespace; em vez disso, a funcionalidade é implementada exclusivamente através de funções-modelo livres [SWS_LOG_20000]. O ciclo de vida da funcionalidade de rastreio está, assim, totalmente acoplado ao ciclo de vida operacional superior da framework do logger.

Relativamente ao comportamento de concorrência e à segurança operacional, aplicam-se garantias estritas: a interface TraceArti é explicitamente especificada como segura para threads (thread-safe) [SWS_LOG_20000]. Isto permite que a framework do logger delegue chamadas de rastreio em paralelo a partir de múltiplos contextos de execução e threads para o namespace, sem necessidade de sincronização externa. Ao mesmo tempo, a função está declarada como segura contra exceções (exception safe) e noexcept [SWS_LOG_20000], garantindo que em nenhum momento ocorram fugas de recursos ou estados descontrolados de desenrolamento de pilha (stack unwinding) durante a chamada.

Caminho de utilização

As funções do namespace apext::log não foram concebidas para serem chamadas diretamente pelo software aplicacional comum. Em vez disso, TraceArti é chamado exclusivamente de forma interna pela framework do logger quando esta alterna entre o logging clássico e o rastreio baseado em ARTI [SWS_LOG_20000]. Se necessário, os programadores ou integradores incluem o ficheiro de cabeçalho correspondente #include "apext/log/trace_arti.h" para obter acesso à declaração [SWS_LOG_20000].

Durante a chamada, a função processa mensagens modeladas (modeled messages) específicas da ferramenta de rastreio utilizada em cada caso [SWS_LOG_20000]. Para o efeito, a interface aceita um identificador da mensagem msg_id de um tipo definido pela implementação MsgId, bem como um pacote de parâmetros variáveis params... de tipos arbitrários Params... [SWS_LOG_20000]. Para manter os custos de tempo de execução no caminho de rastreio o mais baixos possível, a especificação exige uma minimização estrita do overhead de tempo de execução; isto deve ser alcançado, por exemplo, através de especializações de modelo personalizadas com base no respetivo MsgId [SWS_LOG_20000]. É de presumir que tais especializações sejam tipicamente geradas por geradores de ferramentas no âmbito da integração da toolchain para os respetivos sistemas-alvo.

Cenários de erro

No domínio do tratamento de erros, apext::log adota um desenho tolerante a falhas sem sinalização de erros de tempo de execução ao chamador. A assinatura da função de TraceArti não define qualquer valor de retorno (void) e proíbe integralmente o lançamento de exceções C++ através da especificação noexcept [SWS_LOG_20000]. As pré-condições, como a validade dos IDs de mensagem e dos dados úteis passados, têm, portanto, de ser obrigatoriamente garantidas pela framework de logger chamadora ou pelas respetivas especializações, uma vez que, em caso de erro, nenhum código de erro pode ser transportado [SWS_LOG_20000].