AUTOSAR Adaptive 実行可能ファイルの実行時ログの設定

AUTOSAR Specification of Diagnostic Log and Trace で定義されているように、Adaptive アプリケーションはイベントログ情報をコンソール、ファイル、またはネットワークに転送できます。これにより、複数のアプリケーションからログデータを照合、解析できるようになります。既定では、ローカルコンソールへのイベントメッセージのログが記録されます。ファイルまたはネットワークからのログデータを表示するために、サードパーティ製のツールを使用できます。

Adaptive モデルの実行時ログの既定動作を変更するには、set などの AUTOSAR プロパティ関数を使用します。コード生成では、指定されたログプロパティを ARXML 実行マニフェストファイルにエクスポートします。マニフェストファイルは、ログモードや詳細レベルなど、Adaptive アプリケーションの Linux^® 実行可能ファイルに関する実行時動作の一部を設定するために使用します。

Adaptive モデルから Linux 実行可能ファイルを生成する場合、AUTOSAR プロパティ関数 createManifest を使用して JSON 実行マニフェストファイルを生成できます。JSON ファイルは、実行可能ファイルに対する既定のログ動作を変更します。Linux 実行可能ファイルをビルドした後に、JSON 実行マニフェストファイルを生成できます。Linux 実行可能ファイルを実行する前に、JSON 実行マニフェストファイルと実行可能ファイルが同じフォルダーにあることを確認します。

コンソールへのログ
ファイルへのログ
ネットワークへのログ

コンソールへのログ

AUTOSAR Adaptive モデルを開きます。

AUTOSAR プロパティ関数を使用して、AUTOSAR プロパティ LogMode を次のように Console に設定します。

apiObj = autosar.api.getAUTOSARProperties(modelName);
processPath = find(apiObj,'/','Process','PathType','FullyQualified');
set(apiObj,processPath{1},'LogTraceLogMode','Console');

オプションで、ログの詳細レベルを Verbose に設定します。
```
set(apiObj,processPath{1},'LogTraceDefaultLogLevel','Verbose');
```
モデルのコードおよび ARXML ファイルを生成します。このビルドにより、ログプロパティがファイル modelname_ExecutionManifest.arxml に生成されます。
Adaptive モデルの Linux スタンドアロン実行可能ファイルをビルド、実行する場合、関数 createManifest を使用して、マニフェストファイル ExecutionManifest.json を現在の作業フォルダーに生成します。
```
createManifest(apiObj);
```
Linux 実行可能ファイルを実行する前に、JSON 実行マニフェストファイルと実行可能ファイルが同じフォルダーにあることを確認します。
アプリケーションを実行して、ログメッセージがコンソールに表示されることを確認します。

ファイルへのログ

AUTOSAR Adaptive モデルを開きます。

AUTOSAR プロパティ関数を使用して、AUTOSAR プロパティ LogMode を次のように File に設定します。

apiObj = autosar.api.getAUTOSARProperties(modelName);
processPath = find(apiObj,'/','Process','PathType','FullyQualified');
set(apiObj,processPath{1},'LogTraceLogMode','File');

オプションで、ログファイルへのパスを指定します。既定では、ログファイルは実行可能ファイルのフォルダーに保存されます。
```
set(apiObj,processPath{1},'LogTraceFilePath','customFilePath');
```
オプションで、ログの詳細レベルを Verbose に設定します。
```
set(apiObj,processPath{1},'LogTraceDefaultLogLevel','Verbose');
```
モデルのコードおよび ARXML ファイルを生成します。このビルドにより、ログプロパティがファイル modelname_ExecutionManifest.arxml に生成されます。
Adaptive モデルの Linux スタンドアロン実行可能ファイルをビルド、実行する場合、関数 createManifest を使用して、マニフェストファイル ExecutionManifest.json を現在の作業フォルダーに生成します。
```
createManifest(apiObj);
```
Linux 実行可能ファイルを実行する前に、JSON 実行マニフェストファイルと実行可能ファイルが同じフォルダーにあることを確認します。
アプリケーションを実行して、ログファイルが指定した場所、または既定の場所に作成されていることを確認します。

ネットワークへのログ

AUTOSAR Adaptive モデルを開きます。

AUTOSAR プロパティ関数を使用して、AUTOSAR プロパティ LogMode を次のように Network に設定します。

apiObj = autosar.api.getAUTOSARProperties(modelName);
processPath = find(apiObj,'/','Process','PathType','FullyQualified');
set(apiObj,processPath{1},'LogTraceLogMode','Network');

オプションで、ログの詳細レベルを Verbose に設定します。
```
set(apiObj,processPath{1},'LogTraceDefaultLogLevel','Verbose');
```
モデルのコードおよび ARXML ファイルを生成します。このビルドにより、ログプロパティがファイル modelname_ExecutionManifest.arxml に生成されます。
Linux 実行可能ファイルを実行する前に、JSON 実行マニフェストファイルと実行可能ファイルが同じフォルダーにあることを確認します。
Adaptive アプリケーションの AUTOSAR ランタイム環境を次のコマンドで初期化します。
```
autosar.ara.initialize
```
メモ
コマンド autosar.ara.initialize は、将来のリリースで削除される予定です。代わりに、Embedded Coder^® Support Package for Linux Applications を使用してください。詳細については、Support Package Installation (Embedded Coder)を参照してください。
アプリケーションを実行して、ログメッセージがネットワークに表示されることを確認します。

メモ

モデルで ara::log ブロックを使用するには、Embedded Coder Support Package for Linux Applications 入門の例の adaptive_msg_sender モデルからコピーします。

次のコマンドを使用して、ara::log ブロックを含むモデル例を開きます。

openExample("adaptive_msg_sender");

参考

createManifest