Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
ログ制御CLI(LoggingCtl)は、Vegaデバイス上のログデータを管理、表示、テストするためのコマンドラインインターフェイス(CLI)ツールです。**デバイスに保存されているクラッシュレポート(ACRファイル)にアクセスすることもできます。コマンドにアクセスするには、loggingctlコマンドを使用してVegaデバイスシェルに入る必要があります。vega exec vda shell このツールを使用すると、次の操作を実行できます。
  • リアルタイムのログモニタリングを通じてアプリの問題をデバッグする。
  • さまざまなプロセスのログレベルとレートを構成する。
  • 保存されているログとクラッシュレポートにアクセスして分析する。
  • ログストレージと保存期間を管理する。
  • 診断データを使用してシステムの問題を調査する。

新しいアプリをインストールした後にLoggingCtlを起動または再起動する方法

LoggingCtlでは、セッションの開始時にインストール済みのアプリに基づいてログ権限を決定します。LoggingCtlの開始後にインストールされたアプリのログは、LoggingCtlセッションを再起動するまで表示されません。

基本的な使用方法

configコマンド

構成コマンドを使用して、loggingctl configアプリのログ動作を制御します。(注:画面の出力に関する日本語表記は説明のために提供しています。実際には英語で表示されます。)

特定のタグを設定

デフォルトでは、config操作はプロセス全体に適用されます。プロセス内の 1 つのログタグを対象とするには、を追加します-t。予算はタグとレベルの組み合わせごとに追跡されるため、残りのプロセスに影響を与えずに 1 つのタグを上げたり下げたりできます。 set 操作の場合は、TAG=VALUEタグをとして渡します。get 操作の場合は、タグ名だけを渡します。

構成のリセット

ログ構成をデフォルトにリセットする方法は次のとおりです。
  1. レート制限: を使用してデフォルトレートに戻します--reset。値を明示的に指定すると、--resetクリア時にオーバーライドがそのまま残るため、--reset手動で値を設定するよりも使用してください。
    デフォルトのレートは**、1 プロセスあたり 1 秒あたり 300 行です**。有効な料金は1~60000円です。loggingctl``0不合格と上記の任意の値。60000
  1. ログレベル: レベルをデフォルトに戻します (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行を記録し、カウンタを集約して定期的な要約にします。それでもさらにスループットが必要な場合は、プロセスのレートを上げてください。
プロセス全体ではなく、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の起動後にアプリをインストールした場合は、アプリを再インストールし、セッションを再起動してください。
  1. アプリを手動でインストールします。
  2. LoggingCtlを起動します。
  3. vmsgr経由で起動します。 vmsgr send以下を使用してアプリを起動します。

JavaScriptロギングに関する注意事項

VegaアプリでJavaScriptロギングを使用する場合: 推奨アプローチ: ログレベルのフィルタリングにはconsole.*console.*メソッドを使用します。

サポートされている引数キーワード

、--priority、--facility、--since``--until、--output-formatおよびコマンドには、特定のキーワードを使用できます。
  1. 優先度レベル - 優先度レベルを設定してログの表示を制御するには、--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)
  2. 時刻の指定 - 時刻でログをフィルタリングするには、--since—sinceまたは--until—untilを使用します。
    • Keywords キーワード:now、yesterday、today、tomorrow
    • 時刻の形式:
  3. --output-format以下を使用する出力形式: a. short_concise(デフォルト)
    例:
    b. short_precise
    例:
Vegaパッケージの場合、_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ファイルの内容がstdoutに出力されます。

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ストレージの合計または特定のアーティファクトストレージをチェックします
すべてのリスト操作は、main、system、SYSTEM_TOMBSTONE、ACR_REPORTで機能します。

アクセス拒否

許可されていない操作を試みたり、特権データにアクセスしようとしたりすると、拒否のレスポンスが返されます。

ログへのアクセス制限

LoggingCtlでは、次のログタイプへのアクセスは制限されます。
  • サイドロードされたコンポーネントのログ
  • daemonファシリティのログ
  • システムコンポーネント:stemd、acr_core_dump、lcm_service、servicergrd、pkgmgrd、inputdを含む

関連トピック


最終更新日 2026年9月14日