네임스페이스 apext::log

네임스페이스 apext::log은 함수 템플릿 TraceArti을 통해 모델링된 추적 메시지를 외부 런타임 추적 도구로 전달하기 위한 인터페이스를 제공합니다 [SWS_LOG_20000]. 이 함수는 로깅과 추적 간을 전환할 때 로거 프레임워크에 의해서만 내부적으로 호출되며 메시지별 식별자와 가변 매개변수를 처리합니다 [SWS_LOG_20000]. 주요 제약 조건으로는 최소한의 런타임 오버헤드, 완전한 스레드 안전성, 오류나 반환 값 없는 예외 안전 실행이 적용됩니다.

자세히 ›

컨텍스트

네임스페이스 apext::log은 AUTOSAR Adaptive Platform의 로깅 및 추적 서브시스템을 위한 기능 인터페이스를 제공합니다. 주된 책임은 함수 템플릿 TraceArti을 통해 외부 런타임 추적 도구를 위한 전용 인터페이스를 제공하는 데 있습니다 [SWS_LOG_20000]. 접두사 apext을 사용한 명명은 AUTOSAR Run-Time Interface (ARTI)와 같은 특정 추적 메커니즘을 로깅 프레임워크에 연결하는 플랫폼 확장(Adaptive Platform Extension)임을 나타내는 것으로 해석할 수 있습니다. 질문 Q-325896ce9f6b8e42 (열림)

시스템 아키텍처에서 네임스페이스는 내부 로깅 인프라와 후속 분석 및 트레이스 도구 간의 연결고리 역할을 합니다. 이때 기본적으로 세 가지 컴포넌트가 상호작용합니다. 내부 로거 프레임워크, apext::log 내부의 인터페이스 함수 TraceArti, 그리고 연결된 트레이스 도구 [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의 함수는 일반 애플리케이션 소프트웨어가 직접 호출하도록 설계되지 않았습니다. 대신 로거 프레임워크가 클래식 로깅과 ARTI 기반 추적 간을 전환할 때 내부적으로만 TraceArti이 호출됩니다 [SWS_LOG_20000]. 개발자 또는 통합자는 필요한 경우 선언에 액세스하기 위해 해당 헤더 파일 #include "apext/log/trace_arti.h"을 포함합니다 [SWS_LOG_20000].

호출 시 함수는 사용되는 특정 추적 도구에 특화된 모델링된 메시지(modeled messages)를 처리합니다 [SWS_LOG_20000]. 인터페이스는 이를 위해 구현 정의 타입 MsgId의 메시지 식별용 식별자 msg_id과 임의 타입 Params... [SWS_LOG_20000]의 가변 매개변수 팩 params...을 수락합니다. 추적 경로의 런타임 비용을 가능한 한 낮게 유지하기 위해 사양에서는 런타임 오버헤드의 엄격한 최소화를 요구하며, 이는 예를 들어 해당 MsgId을 기반으로 한 맞춤형 템플릿 특수화를 통해 달성되어야 합니다 [SWS_LOG_20000]. 이러한 특수화는 일반적으로 대상 시스템에 대한 툴체인 통합의 일환으로 도구 생성기에 의해 생성될 것으로 추정됩니다.

오류 시나리오

오류 처리 영역에서 apext::log은 호출자에게 런타임 오류를 알리지 않는 무결함 설계를 따릅니다. TraceArti의 함수 시그니처는 반환 값을 정의하지 않으며(void), noexcept 사양을 통해 C++ 예외 발생을 완전히 금지합니다 [SWS_LOG_20000]. 오류 발생 시 오류 코드를 전송할 수 없으므로, 메시지 ID 및 전달된 페이로드 데이터의 유효성과 같은 사전 조건은 호출하는 로거 프레임워크 또는 해당 특수화에 의해 반드시 보장되어야 합니다 [SWS_LOG_20000].