loggingctlコマンドを使用してVegaデバイスシェルに入る必要があります。vega exec vda shell
このツールを使用すると、次の操作を実行できます。
- リアルタイムのログモニタリングを通じてアプリの問題をデバッグする。
- さまざまなプロセスのログレベルとレートを構成する。
- 保存されているログとクラッシュレポートにアクセスして分析する。
- ログストレージと保存期間を管理する。
- 診断データを使用してシステムの問題を調査する。
新しいアプリをインストールした後にLoggingCtlを起動または再起動する方法
LoggingCtlでは、セッションの開始時にインストール済みのアプリに基づいてログ権限を決定します。LoggingCtlの開始後にインストールされたアプリのログは、LoggingCtlセッションを再起動するまで表示されません。基本的な使用方法
configコマンド
構成コマンドを使用して、loggingctl configアプリのログ動作を制御します。(注:画面の出力に関する日本語表記は説明のために提供しています。実際には英語で表示されます。)
特定のタグを設定
デフォルトでは、config操作はプロセス全体に適用されます。プロセス内の 1 つのログタグを対象とするには、を追加します-t。予算はタグとレベルの組み合わせごとに追跡されるため、残りのプロセスに影響を与えずに 1 つのタグを上げたり下げたりできます。
set 操作の場合は、TAG=VALUEタグをとして渡します。get 操作の場合は、タグ名だけを渡します。
構成のリセット
ログ構成をデフォルトにリセットする方法は次のとおりです。-
レート制限: を使用してデフォルトレートに戻します
--reset。値を明示的に指定すると、--resetクリア時にオーバーライドがそのまま残るため、--reset手動で値を設定するよりも使用してください。デフォルトのレートは**、1 プロセスあたり 1 秒あたり 300 行です**。有効な料金は1~60000円です。loggingctl``0不合格と上記の任意の値。60000
-
ログレベル: レベルをデフォルトに戻します (
infoリリースビルド時、debugデバッグビルド時)。
ログバジェットと抑制
各プロセスにはログバジェットがあります。予算が許すよりも早くアプリからログ行が出力される場合、ロギングライブラリは超過分を抑制します。 これらの行はプロセス内で破棄され、ログバックエンドには届きません。抑制はコードに影響しません。ロギングコールは、行が記録されたかドロップされたかにかかわらず正常に返されるため、ギャップのあるログは何も起こらなかったログと同じように見えます。この動作はデバッグビルドで最も顕著です。デバッグビルドでは、ログが多くなり、予算に早く達します。 デフォルトのバジェットは**、1 プロセスあたり 1 秒あたり 300 行です**。info``debug最小レベルはリリースビルドとデバッグビルドです。
予算は、ログタグと重要度レベルの組み合わせごとに異なります。debug``infoおしゃべりなロガーはロガーの予算を消費しません。逆も同様です。errorストリームがきれいだからといって、何もドロップされなかったわけではありませんinfo。
オーバーエミッションが繰り返し発生すると、抑制ウィンドウがエスカレートし(たとえば、1、2、4、16、最大 256 秒)、クワイエット期間ごとに 1 ステップずつ緩和されます。256秒という時間枠は、タグとレベルが4分以上暗くなっていることを意味するので、ログから結論を導き出す前に、ログの量を減らすか、予算を上げてください。
検出抑制
ロギングライブラリは、warning抑制を開始するとアプリ独自のIDの下に-level メッセージを書き込み、停止すると別のメッセージを書き込みます。メッセージは 2 つの形式で表示されます。
プロセス全体、レベルの報告:
suppress、大文字と小文字を区別せずに照合してください。カウントは設計によって異なります。 1つ目はプロセス全体でレベルごとにカウントされ、2つ目はすべてのレベルでタグごとにカウントされます。
これらのメッセージを見つけるには、warningアプリのストリームをフィルタリングし、非表示になっているかどうかをスキャンしてください。
- カウントは、抑制終了を報告するメッセージにのみ表示されます。抑制が有効な間は、カウントは報告されません。
- カウンターは各エピソードの後にリセットされます。40行の3つのエピソードは、
[40]3つの別々のSを報告していますが、そうではありません[120]。 - 抑制が有効なときにプロセスが終了すると、終了メッセージは届かず、カウントは失われます。
- これらの警告自体はレート制限されていないため、予算がそれらを抑えることはできません。
ドロップラインを減らす
抑制されている場合は、まず音量を下げてください。 反復ごとではなく、状態の変化ごとに1行を記録し、カウンタを集約して定期的な要約にします。それでもさらにスループットが必要な場合は、プロセスのレートを上げてください。-t
logコマンド
loggingctl logコマンドを使用して、systemd-journaldメモリのログをリアルタイムで表示したり、保存されているデータからログを表示したりできます。
デフォルトでは、loggingctl logloggingctl logコマンドは現在のセッションからのログのみを表示します。古いログを表示するには、Vega仮想デバイスで--boot—bootオプションを使用します。Fire TV Stickでは、loggingctl vaultコマンドを使用して以前のログを表示できます。
ログの表示に推奨されるフィルター
React NativeおよびJavaScriptの開発者の場合、特定のアプリのログを表示するには、パッケージIDフィルター(-v-v)を使用します。
Ctrl+CCtrl+Cを押します。
アプリのログが表示されない場合:
LoggingCtlは、セッションの開始前にインストールされていたアプリのみを検出します。LoggingCtlの起動後にアプリをインストールした場合は、アプリを再インストールし、セッションを再起動してください。
-
アプリを手動でインストールします。
-
LoggingCtlを起動します。
-
vmsgr経由で起動します。
vmsgr send以下を使用してアプリを起動します。
JavaScriptロギングに関する注意事項
VegaアプリでJavaScriptロギングを使用する場合: 推奨アプローチ: ログレベルのフィルタリングにはconsole.*console.*メソッドを使用します。
サポートされている引数キーワード
、--priority、--facility、--since``--until、--output-formatおよびコマンドには、特定のキーワードを使用できます。
-
優先度レベル - 優先度レベルを設定してログの表示を制御するには、
--priority—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.warn()”javascript”,
- notice - 正常だが重要な情報がある状態。
- info - 情報メッセージ。マップ先:
- APMF_LOG(…, INFO)
- LOG_F(INFO)
- LOG_S(INFO)
console.log()”javascript”,
- debug - デバッグレベルのメッセージ。マップ先:
- APMF_LOG(…, DEBUG)
- LOG_F(DEBUG)
- LOG_S(DEBUG)
- emerg - システム利用不可。マップ先:
-
時刻の指定 - 時刻でログをフィルタリングするには、
--since—sinceまたは--until—untilを使用します。- Keywords キーワード:now、yesterday、today、tomorrow
-
時刻の形式:
-
--output-format以下を使用する出力形式: a. short_concise(デフォルト)例:b. short_precise例:
_CMDLINE SYSLOG_IDENTIFIER LoggingCtlは代わりにパッケージURLのオリジンを表示するためにを使用します。アプリのログを最も確実にフィルタリングするには、-v-v (パッケージID)フィルターを使用します。
例:
vaultコマンド
loggingctl vaultコマンドを使用して smartboxd Vault システムを管理およびアクセスします。
クラッシュレポート(ACRファイル)へのアクセス
デバイスに保存されているクラッシュレポートファイル(ACR)の一覧を表示したり、ファイルを取得したりするには、vaultコマンドを使用します。ACRファイルの概要とシンボリケート方法については、アプリのクラッシュレポートをシンボリケートする方法を参照してください。使用可能なACRファイルの一覧表示
デバイス上のすべてのACRファイルを表示するには、次のコマンドを使用します。
##の前の番号は、そのファイルを取得するときに使用するインデックスです。ファイル名は次のフィールドで構成されます。
ACRメタデータの取得
すべてのACRファイルの詳細なメタデータをJSONとして取得するには、次のコマンドを使用します。最新のクラッシュインデックスの取得
ACRファイルのサイズの確認
ACRファイルの取得
--cat``SYSTEM_TOMBSTONEアーティファクトタイプとインデックス番号とともに使用します。
ACRファイルの保存
ACRファイルをデバイスのファイルシステムに保存するには、--cat—catの出力をリダイレクトします。
例: クラッシュレポートを取得
ACRにアクセスするコマンドのリファレンス
パーミッション構造
LoggingCtlには、デフォルトおよびコンポーネントシェルのパーミッションを通じたロールベースのアクセス制御が実装されています。デフォルトまたはコンポーネントシェルモードで操作する場合、次の情報にアクセスできます。-
ログインデックスの追跡と管理を行うインデックス操作:
--last-index—last-index - 最新のログエントリのインデックスを表示します。--get-index-stats-現在のログインデックスに関する統計を取得
-
--cat—catを使用してログを表示するためのコンテンツアクセス:- コンポーネント固有のログ
- サイドロードされたパッケージのログ
- システムプロセス: ステム、lcm_service、インプット、および関連サービス
-
次のコマンドを使用してアーティファクト情報を表示するリスト操作:
--ls—ls - 使用可能なログを一覧表示します--json-dump-メタデータをエクスポートします--size—size - アーティファクトファイルのサイズをチェックします--storage—storage - vaultストレージの合計または特定のアーティファクトストレージをチェックします
アクセス拒否
許可されていない操作を試みたり、特権データにアクセスしようとしたりすると、拒否のレスポンスが返されます。ログへのアクセス制限
LoggingCtlでは、次のログタイプへのアクセスは制限されます。- サイドロードされたコンポーネントのログ
- daemonファシリティのログ
- システムコンポーネント:stemd、acr_core_dump、lcm_service、servicergrd、pkgmgrd、inputdを含む

