Liferayクラウドサービスのログを読む

環境ログは、プロジェクトにおける技術的な問題を診断し、解決するために非常に重要です。 Liferay Cloud は、ユーザーが Liferay Cloud コンソールまたは OS ターミナルを介してアクセスしてダウンロードできるさまざまな環境ログを提供します。

ログの種類

Liferay Cloud は、環境サービスに対して 3 種類のログを提供します。

• アプリケーション ログ: アプリケーションが実行され、ユーザーがアクセスした後に生成されるランタイム情報を表示します。

• ビルド ログ: アプリケーションの起動時に生成されたビルド情報を表示します。 例としては、Docker イメージがレジストリからプルされたとき、デプロイが進行中のとき、ビルドが成功したときなどが挙げられます。

• ステータス ログ: Kubernetes クラスターからのオーケストレーション レイヤー情報を表示します。 例としては、イメージが正常にプルされたとき、コンテナが作成および起動されたとき、準備または生存プローブが失敗したときなどが挙げられます。

• VPN ログ: VPN サーバー情報を表示します。 例としては、VPN 接続が失敗した場合、証明書が無効または期限切れの場合、接続がタイムアウトした場合などが挙げられます。

ログ構造

Liferay Cloud のログは、追加のコンテキスト情報を提供する特定の構造に準拠しています。 例として、以下のログメッセージを参照してください：

Jun 29 10:07:46.585 build-214 [webserver-699bf65bfb-4w8pl] [WARNING] 179/170746 (13) : api/backend2 changed its IP from 10.0.17.186 to 10.0.26.120 by DNS cache.

ログは、ダウンロードするとき、または ターミナルから表示するときには常にこの形式で表示されます。 ただし、コンソール経由でログ にアクセスする場合、各ログ メッセージの情報の列はカスタマイズ可能であるため、構造は異なります。

Liferay Cloud の多くのログには、このメッセージがサービスの出力から直接ではなく、Liferay Cloud インフラストラクチャから送信されたことを示すラベル (この例では [WARNING]) が付いています。 ログには、 [LIFERAY]のように、Liferay Cloud インフラストラクチャから取得されるもののサービスに関連したラベルを付けることもできます。 サービスの出力から直接取得されるログにはラベルがありません。

さらに、Liferay Cloud のすべてのログ メッセージには、次のコンポーネントが常に存在します。

• タイムスタンプ: この例では、 Jun 29 10:07:46.585。

• ビルド ID: この例では、 build-214です。 これは、現在デプロイされているサービスのバージョンが対応するビルドに相当します。 このビルド ID は、プロジェクトのの ビルド ページに表示されるビルドのリストと一致させることができます。

• インスタンス ID: この例では、 [webserver-699bf65bfb-4w8pl]です。 これは、メッセージがどのサービスのどのインスタンスに関連しているかを識別するために使用されます。

ログメッセージに関連付けられたインスタンスIDは、サービスのいずれかのインスタンスに対応しています。 インスタンスIDの形式は、サービスがどのような配布タイプ（展デプロイまたはステートフルセット）として構成されているかによって異なります。 詳細については、「 デプロイメント タイプについて 」を参照してください。

配布タイプログのインスタンスID

配布タイプログは、複数のパートからなるインスタンスIDを持っています。 以下は配布タイプサービスのログメッセージの例です：

Jun 29 10:07:57.102 build-214 [liferay-7485669bdd-7ktfl] [LIFERAY] Executing 010_liferay_cloud_customizable_files_override.sh.

このメッセージのインスタンスID（この例では、 [liferay-7485669bdd-7ktfl]）には、以下のコンポーネントが含まれています：

• サービス名: この例では、 liferayです。

• ランダムに生成された バージョン ID: この例では、 7485669bdd。 これは、変更が可能な状態でデプロイされたサービスのバージョンに相当します。 なお、新しいデプロイ、環境変数の変更、サービスの手動での再起動は、すべて新しいバージョンIDを生成します（設定に新しい変更が加えられた可能性があるためです）。

• ランダムに生成された コンテナ ID: この例では、 7ktfl。 サービスが起動するたびに新しいコンテナが作成されるため（例えば、新しいビルドをデプロイした後サービスが再起動した場合など）、新しいコンテナIDが生成されます。 バージョンIDが変更されない場合でも、再起動すると新しいコンテナIDが生成されることに注意してください（例えば、 ライブネスやレディネスプローブの失敗 が再起動をトリガーした場合など）。

ステートフルセットタイプログのインスタンスID

ステートフルセットタイプのログは、インスタンスIDが小さく、一貫性があります。 以下はステートフルセットタイプサービスのログメッセージの例です：

Jun 29 07:44:44.676 build-214 [search-0] #  - Creating and Starting rollup jobs will no longer be allowed.

これらは、ステートフルセットタイプサービスの インスタンスID の唯一の構成要素です：

• サービス名: この例では、 検索。

• 反復する（ランダムではない） ノード ID：この例では、 0。 このIDは、新しいバージョンのサービスをデプロイしても同じです。

ステートフルセットタイプのサービスのインスタンスID全体は、サービスの各ノードで常に同じものが使用されます。 サービスが再デプロイされた後でも、同じインスタンス ID を使用して、同じ ボリュームを持つクラスター内のノードを確実に識別できます。

ログレベル

Liferay Cloud サービスのログは、重大度が上がるにつれて 6 つのレベルに分かれており、それぞれに数値が関連付けられています。

ログレベル	優先度値
TRACE	100
DEBUG	200
INFO	300
WARN	400
ERROR	500
FATAL	600

LCP_SERVICE_LOG_LEVEL 環境変数を使用して、 バックアップ サービス と データベース サービス のログ レベルを設定できます。 サービスのメッセージは、その優先度値がサービスの構成されたログ レベル以上の場合に表示されます。 この環境変数は、ログ レベルの名前 (例: DEBUG) または数値 (たとえば、すべてのメッセージが表示されるようにするには値を 0 に設定し、これらのすべてのメッセージ タイプを抑制するには 601 に設定します) を使用して設定できます。

Liferay Cloud Console 経由でログにアクセスする

Liferay Cloudコンソールから環境サービスログにアクセスするには、

1. プロジェクト環境に移動します。

2. 環境メニューの ［Logs］ をクリックします。

すべての環境サービスにわたるアプリケーション、ステータス、ビルド、および VPN ログを表示するか、ドロップダウン メニューを使用して 結果をフィルター します。

ログをダウンロードするには、[ Download Logs]をクリックします。

右上隅のドロップダウン メニューを使用して、各ログ メッセージの列として表示する情報を選択することもできます。

ログ インスペクタには、各ログの詳細な内訳が含まれています。 ログ インスペクタを開くには、ログの上にマウスを置いたときに表示されるボタンをクリックします。

ログの検索とフィルタリング

ログ ページでは、 タイプ、日付、またはサービスとインスタンスでフィルタリングできます。 サービスまたはサービスの特定のインスタンスごとにフィルタリングするには、[フィルタ] ボタンを使用します。

日付範囲でフィルタリングするには、右上隅にある日付ピッカーを使用します。 有効なログがなくなった日付を選択することはできません。

ヒント

日付範囲を選択した場合は、 「現在にジャンプ」 をクリックして、最新のログ メッセージを表示します。 選択した日付範囲の終了時刻が現在の時刻に変更されます。

検索バーを使用して、ログ メッセージ内の特定の用語を検索することもできます。

サービスログへのショートカット

Liferay Cloud コンソール全体でサービス別にフィルタリングされたログにアクセスする方法は他にもあります。

1. 「概要」または「サービス」ページで、サービスをクリックします。

2. サービスポップオーバーの右上隅にある ログ ボタンをクリックします。

継続的なログ更新の表示

デフォルトでは、[ログ] ページのログは、ページを更新するか、日付範囲を手動で更新した場合にのみ更新されます (ページが読み込まれた秒までの更新が含まれます)。 ログ ページを表示しているときに新しいログ メッセージのストリーミングを有効にするには、 ストリーム をクリックします。 新しいログ メッセージは自動的に下部に表示されます。

ストリーミング ログ メッセージは、次にページを読み込むまでのみ有効になります。 ストリーミングが有効になっている間、日付またはタイプでフィルタリングするコントロール は無効になります。

ターミナルからログにアクセスする

管理者や開発者は、OS端末を使ってログを見ることもできます。

次のコマンドを実行すると、すべてのサービスのログが一覧表示されます：

lcp log

特定の環境からサービス ログにアクセスするには、 lcp log コマンドを実行した後に環境の ID を入力するか、環境 ID を指定して lcp log コマンドを実行します。

lcp log -p <environment-id>

また、 lcp log コマンドの一部としてサービスを指定することもできます：

lcp log -p <environment-id> -s <service-id>

関連トピック

• シェルアクセス
• ディザスタ リカバリの概要
• クロスリージョンディザスタ リカバリの設定