loggingctlコマンドにアクセスするには、vega exec vda shellコマンドを使用して、Vegaデバイスシェルに入る必要があります。
このツールを使用すると、次の操作を実行できます。
- リアルタイムのログモニタリングを通じてアプリの問題をデバッグする。
- さまざまなプロセスのログレベルとレートを構成する。
- 保存されているログとクラッシュレポートにアクセスして分析する。
- ログストレージと保存期間を管理する。
- 診断データを使用してシステムの問題を調査する。
新しいアプリをインストールした後にLoggingCtlを起動または再起動する方法
LoggingCtlでは、セッションの開始時にインストール済みのアプリに基づいてログ権限を決定します。LoggingCtlの開始後にインストールされたアプリのログは、LoggingCtlセッションを再起動するまで表示されません。基本的な使用方法
構成コマンド
構成コマンドを使用して、アプリのログ動作を制御します。（注：画面の出力に関する日本語表記は説明のために提供しています。実際には英語で表示されます。）構成のリセット
ログ構成をデフォルトにリセットする方法は次のとおりです。-
レート制限：レートをデフォルト値（1000）に戻します。
-
ログレベル：レベルをデフォルト（info）に戻します。
-
変更をシステム全体に適用するには：ロギングサービスを再起動します。
logコマンド
systemd-journaldメモリからリアルタイムで、または保存されているデータからログを表示できます。
loggingctl logコマンドは、デフォルトで現在のセッションからのログのみを表示します。古いログを表示するには、Vega仮想デバイスで—-bootオプションを使用します。Fire TV Stickの場合は、loggingctl vaultコマンドを使用して以前のログを表示できます。
ログの表示に推奨されるフィルター
React NativeおよびJavaScriptの開発者の場合は、パッケージIDフィルター（-v）を使用して特定のアプリのログを表示します。
-
アプリを手動でインストールします。
-
LoggingCtlを起動します。
-
アプリを起動します。
JavaScriptロギングに関する注意事項
VegaアプリでJavaScriptロギングを使用する場合： 推奨アプローチ：ログレベルのフィルタリングにはconsole.*メソッドを使用します。
サポートされている引数キーワード
--priority、--facility、--since、--until、--output-formatの各コマンドは、特定のキーワードを受け取ります。
-
優先度レベル - 優先度レベルを設定してログの表示を制御するには、
--priorityを使用します。これにより、指定の優先度レベルのみを表示するようにログ出力がフィルタリングされ、独自のコンポーネントやその他のプロセスのログに集中しやすくなります。- emerg - システム利用不可。マップ先：
- APMF_LOG(…, FATAL)
- alert - 即時対応が必要。
- crit - 重大な状態。マップ先：
- LOG_F(FATAL)
- LOG_S(FATAL)
- err - エラー状態。マップ先：
- APMF_LOG(…, ERROR)
- LOG_F(ERROR)
- LOG_S(ERROR)
console.error()(JavaScript)
- warning - 警告状態。マップ先：
- APMF_LOG(…, WARNING)
- LOG_F(WARNING)
- LOG_S(WARNING)
console.error()(JavaScript)
- notice - 正常だが重要な情報がある状態。
- info - 情報メッセージ。マップ先：
- APMF_LOG(…, INFO)
- LOG_F(INFO)
- LOG_S(INFO)
console.error()(JavaScript)
- debug - デバッグレベルのメッセージ。マップ先：
- APMF_LOG(…, DEBUG)
- LOG_F(DEBUG)
- LOG_S(DEBUG)
- emerg - システム利用不可。マップ先：
-
時刻の指定 - 時刻でログをフィルタリングするには、
--sinceまたは--untilを使用します。- キーワード：now、yesterday、today、tomorrow
-
時刻の形式：
-
--output-formatによる出力形式の指定： a. short_concise（デフォルト）例：b. short_precise例：
SYSLOG_IDENTIFIERを使用するのではなく、_CMDLINEを使用して元のパッケージURLを表示します。アプリのログを最も確実にフィルタリングするには、-v（パッケージID）フィルターを使用します。
例：
vaultコマンド
smartboxdボールトシステムの管理とアクセスを行うことができます。
パーミッション構造
LoggingCtlには、デフォルトおよびコンポーネントシェルのパーミッションを通じたロールベースのアクセス制御が実装されています。デフォルトまたはコンポーネントシェルモードで操作する場合、次の情報にアクセスできます。-
ログインデックスの追跡と管理を行うインデックス操作：
--last-index- 最新のログエントリのインデックスを表示します。--get-index-stats- 現在のログインデックスに関する統計情報を取得します。
-
--catを使用してログを表示するためのコンテンツアクセス：- コンポーネント固有のログ
- サイドロードされたパッケージのログ
- システムプロセス：stemd、lcm_service、inputd、関連サービス
-
次のコマンドを使用してアーティファクト情報を表示するリスト操作：
--ls- 使用可能なログを一覧表示します--json-dump- メタデータをエクスポートします--size- アーティファクトファイルのサイズをチェックします--storage- vaultストレージの合計または特定のアーティファクトストレージをチェックします
アクセス拒否
許可されていない操作を試みたり、特権データにアクセスしようとしたりすると、拒否のレスポンスが返されます。ログへのアクセス制限
LoggingCtlでは、次のログタイプへのアクセスは制限されます。- サイドロードされたコンポーネントのログ
- daemonファシリティのログ
- システムコンポーネント：stemd、acr_core_dump、lcm_service、servicergrd、pkgmgrd、inputdを含む
