メインコンテンツへスキップ

ログの表示

blocklet server logs コマンドは、トラブルシューティングとモニタリングに不可欠なユーティリティです。ログの内容を直接表示するのではなく、Blocklet Server デーモンおよびインストールされているすべての blocklet に関連するすべてのログの正確なファイルパスを提供します。これにより、cat、tail、less などの標準的なコマンドラインツールを使用して、ログを簡単に見つけて検査できます。

使用法

ログファイルのパスを表示するには、Blocklet Server プロジェクトディレクトリ内からコマンドを実行するだけです：

blocklet server logs

bash
blocklet server logs

出力の説明

コマンドの出力は、サーバーレベルのログと blocklet 固有のログの2つの主要なセクションに分かれています。

サーバーログ

このセクションでは、コア Blocklet Server デーモンログへのパスを提供します。常にデーモンログのメインディレクトリを表示し、最新のビジネスログファイルを指します。

サーバーはいくつかの種類のログを保持しており、これらは毎日ローテーションされます：

ファイル名パターン説明
access-<date>.log標準のアクセスログで、受信 HTTP リクエストの追跡に役立ちます。
daemon-<date>.logサーバーからの運用情報を含む主要なビジネスログ。
daemon-error-<date>.logサーバーによってスローされた例外やクリティカルエラーをキャプチャするエラーログ。
service.log基盤となる Blocklet Server サービスマネージャー（abtnode）に関連するログ。
stderr.logサーバープロセスからの生の標準エラー出力。
stdout.logサーバープロセスからの生の標準出力。

Blocklet ログ

Blocklet Server が実行中で、blocklet がインストールされている場合、コマンドはそれぞれのログファイルもリストアップします。これは、個々の blocklet を分離してデバッグするのに非常に役立ちます。

インストールされている各 blocklet について、2つのログファイルパスが表示されます：

  • Output: blocklet のプロセスからの標準出力（stdout）を含む output.log へのパス。
  • Error: blocklet のプロセスからの標準エラー（stderr）を含む error.log へのパス。

出力例

以下は、2つの blocklet がインストールされたサーバーでコマンドを実行したときに表示される可能性のある例です：

出力例

bash
$ blocklet server logs

Blocklet Server Logs
- Latest logs: /path/to/your/data/daemon/logs/daemon-2023-10-27.log
- Daemon Logs Directory: /path/to/your/data/daemon/logs

  Daemon Logs
  - access-<date>.log: access logs rotated by day
  - daemon-<date>.log: business logs rotated by day
  - daemon-error-<date>.log: error logs rotated by day
  - service.log: abtnode service logs
  - stderr.log: stderr logs
  - stdout.log: stdout logs

my-first-blocklet@1.2.0
- Output: /path/to/your/data/logs/my-first-blocklet/output.log
- Error: /path/to/your/data/logs/my-first-blocklet/error.log

another-blocklet@2.0.1
- Output: /path/to/your/data/logs/another-blocklet/output.log
- Error: /path/to/your/data/logs/another-blocklet/error.log

一般的なシナリオ

  • サーバーが実行されていない場合: Blocklet Server が実行されていない場合、コマンドは blocklet 固有のログにアクセスできず、警告が表示されます：Unable to get blocklet logs because Blocklet Server is not running。
  • Blocklet がインストールされていない場合: サーバーは実行中ですが、まだ blocklet がインストールされていない場合は、次のメッセージが表示されます：No blocklets installed yet.