Amazon Developer

as

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

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

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

基本的な使用方法

構成コマンド

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

構成のリセット

ログ構成をデフォルトにリセットする方法は次のとおりです。
  1. レート制限: レートをデフォルト値(1000)に戻します。
  2. ログレベル: レベルをデフォルト(info)に戻します。
  3. 変更をシステム全体に適用するには: ロギングサービスを再起動します。

logコマンド

systemd-journaldメモリからリアルタイムで、または保存されているデータからログを表示できます。 loggingctl logコマンドは、デフォルトで現在のセッションからのログのみを表示します。古いログを表示するには、Vega仮想デバイスで—-bootオプションを使用します。Fire TV Stickの場合は、loggingctl vaultコマンドを使用して以前のログを表示できます。

ログの表示に推奨されるフィルター

React NativeおよびJavaScriptの開発者の場合は、パッケージIDフィルター(-v)を使用して特定のアプリのログを表示します。
アプリのログが表示されない場合:
  1. アプリを手動でインストールします。
  2. LoggingCtlを起動します。
  3. アプリを起動します。

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

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

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

--priority、--facility、--since、--until、--output-formatの各コマンドは、特定のキーワードを受け取ります。
  1. 優先度レベル - 優先度レベルを設定してログの表示を制御するには、--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)
  2. 時刻の指定 - 時刻でログをフィルタリングするには、--sinceまたは--untilを使用します。
    • キーワード:now、yesterday、today、tomorrow
    • 時刻の形式:
  3. --output-formatによる出力形式の指定: a. short_concise(デフォルト)
    例:
    b. short_precise
    例:
Vegaパッケージの場合、LoggingCtlはSYSLOG_IDENTIFIERを使用するのではなく、_CMDLINEを使用して元のパッケージURLを表示します。アプリのログを最も確実にフィルタリングするには、-v(パッケージID)フィルターを使用します。 例:

vaultコマンド

smartboxdボールトシステムの管理とアクセスを行うことができます。

パーミッション構造

LoggingCtlには、デフォルトおよびコンポーネントシェルのパーミッションを通じたロールベースのアクセス制御が実装されています。デフォルトまたはコンポーネントシェルモードで操作する場合、次の情報にアクセスできます。
  1. ログインデックスの追跡と管理を行うインデックス操作:
    • --last-index - 最新のログエントリのインデックスを表示します。
    • --get-index-stats - 現在のログインデックスに関する統計情報を取得します。
  2. --catを使用してログを表示するためのコンテンツアクセス:
    • コンポーネント固有のログ
    • サイドロードされたパッケージのログ
    • システムプロセス:stemd、lcm_service、inputd、関連サービス
  3. 次のコマンドを使用してアーティファクト情報を表示するリスト操作:
    • --ls - 使用可能なログを一覧表示します
    • --json-dump - メタデータをエクスポートします
    • --size - アーティファクトファイルのサイズをチェックします
    • --storage - vaultストレージの合計または特定のアーティファクトストレージをチェックします
すべてのリスト操作は、main、system、SYSTEM_TOMBSTONE、ACR_REPORTで機能します。

アクセス拒否

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

ログへのアクセス制限

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

関連トピック


最終更新日 2026年10月26日