ログデータの表示

CloudHub により、各ワーカーのデプロイメントのメッセージとイベントおよび Mule Runtime Engine ログを含むログデータへのアクセスが可能になります。

ログと診断は、現在 CloudHub ワーカーにデプロイされたアプリケーションのみで使用可能です。ローカルサーバにデプロイされたアプリケーションの場合、外部の分析ソフトウェアにデータを送信できます。「外部分析ツールへのデータのエクスポート」を参照してください。

以下の手段により、さらに詳細な検索やログ管理を行うことができます。

Anypoint Monitoring を使用する。

「Anypoint Monitoring の概要」を参照してください。
Log4j 設定を使用して CloudHub アプリケーションをログシステムに統合する。

「Log4j を使用したログシステムとのインテグレーション」を参照してください。

ログの表示

CloudHub にデプロイされたアプリケーションのログを表示する手順は、次のとおりです。

Anypoint Platform で、[Runtime Manager] を選択します。
Runtime Manager ナビゲーションメニューで [Applications (アプリケーション)] をクリックし、アプリケーション名をクリックします。
ナビゲーションメニューで [Logs (ログ)] をクリックします。
[Deployments (デプロイメント)] セクションで、日付、デプロイメント、システムログ、ワーカーで出力を絞り込みます。

検索条件の適用を解除するには、日付のチェックボックスをオフにします。

Figure 1. 矢印は、[Deployments (デプロイメント)] セクションのデプロイメントでログ出力を絞り込むためのチェックボックスを示しています。

ログのダウンロード

CloudHub デプロイメントの各ワーカーについて、そのワーカーのアクティビティに固有のログをダウンロードできます。

[Deployments (デプロイメント)] セクションで、ログをダウンロードする日付とワーカーを選択します。
ワーカーのダウンロードアイコンをクリックして、[Logs (ログ)] を選択します。

Figure 2. 矢印は、[Deployments (デプロイメント)] セクションのデプロイメント別にログ出力をダウンロードするためのアイコンを示しています。

CloudHub では、ログ出力を deploymentID.instanceID-workerNumber.log の形式でテキストファイルにダウンロードします。ログファイルを表示するには、テキストエディタを使用します。

CloudHub のアプリケーションログを、監査、分析、または同様の目的で定期的にアーカイブまたはダウンロードする必要がある場合は、カスタムログアペンダを使用してログを抽出します。「Log4j を使用したログシステムとのインテグレーション」を参照してください。

診断のダウンロード

診断には、各デプロイメントの各 CloudHub ワーカーの Java スレッドダンプが表示されます。これらはサーバの現在の状態を示し、デバッグとサポートに役立ちます。

3.8.0 より前の Mule バージョン (バージョン 3.7.4 を除く) で実行されるアプリケーションでは、診断は利用できません。

診断をダウンロードする手順は次のとおりです。

 .*[Deployments (デプロイメント)]* セクションで、診断をダウンロードする日付とワーカーを選択します。
. ワーカーのダウンロードアイコンをクリックして、*[Diagnostics (診断)]* を選択します。

+ .矢印は、[Deployments (デプロイメント)] セクションのワーカー別に診断をダウンロードするためのアイコンを示しています。 image::cloudhub-logs-diag-download.png[[Deployments (デプロイメント)] セクションのワーカー別に診断をダウンロードします。]

CloudHub では、診断出力を appName-instance-instanceID-workerNumber-diag.txt の形式でテキストファイルにダウンロードします。診断ファイルを表示するには、テキストエディタを使用します。

次の URL を使用して診断ファイルを直接ダウンロードすることもできます。

api/v2/applications/appName/instances/instanceId/diagnostics

Mule ログをダウンロードする

Mule ログには、CloudHub 用の Mule Runtime Engine のログが表示されます。 Mule ログにはアプリケーションとライフサイクルイベントに関する情報が含まれます。たとえば、Mule サービスまたはアプリケーションの開始、デプロイ、停止、またはアンデプロイ時にログにエントリが記録されます。

.*[Deployments (デプロイメント)]* セクションで、Mule ログをダウンロードする日付とワーカーを選択します。
.ワーカーのダウンロードアイコンをクリックして、*[Mule Logs (Mule ログ)]* を選択します。

+ .矢印は、[Deployments (デプロイメント)] セクションのデプロイメント別に Mule ログ出力をダウンロードするためのアイコンを示しています。 image::cloudhub-logs-mule-download.png[[Deployments (デプロイメント)] セクションで Mule ログ出力をダウンロードします。]

CloudHub では、Mule ログ出力を appName-instance-instanceID-workerNumber-mule_ee.log の形式でテキストファイルにダウンロードします。ログファイルを表示するには、テキストエディタを使用します。

Mule ログについての詳細は、「Runtime Log (ランタイムログ)」を参照してください。

デプロイメント履歴の永続性

CloudHub は、非アクティブなデプロイメント履歴をデプロイメントの最終更新時間に基づいて最大 30 日間保存します。

ログの永続性

CloudHub では、ログは、ワーカーごとにアプリケーションあたり最大 100 MB または最長 30 日間のいずれかの制限に達するまで保存されます。

ログのタイムゾーン

CloudHub では、ログデータは協定世界時 (UTC) で保存されますが、コンソールにはコンピュータのローカルタイムゾーンを使用してログが表示されます。

検索ログ

特定の値を含むログを検索したり、日付や優先度でログを検索したりできます。

ログを検索する手順は次のとおりです。

検索ボックスに値を入力するか、または [Advanced (詳細)] をクリックして、時刻、日付、日付範囲、およびメッセージ優先度を指定してログを検索します。
[Apply (適用)] をクリックします。

Figure 3. このスクリーンショットは [Logs (ログ)] ページの (1) [Advanced (詳細)] 検索と (2) [Priority (優先度)] を示しています。

日時による検索

[Date & Time (日時)] 検索条件では、日付範囲を指定してログを検索できます。可能な値:

Last hour (過去 1 時間)
Last 24 hours (過去 24 時間)
Last week (先週)
Last month (先月)

メッセージの優先度による検索

[Priority (優先度)] 検索条件では、ログの特定のイベントを表示できます。表のコマンド列に示すように、検索ボックスにpriority<type>を入力してさまざまな優先度を指定することもできます。

可能な値:

値説明コマンド

値	説明	コマンド
すべての優先度	すべてのメッセージをリストします。	なし
`ERROR`	例外が発生した場合のエラーメッセージのみをリストします。	priority:ERROR
`FATAL`	アプリケーションが失敗した場合の致命的なメッセージのみをリストします。	priority:FATAL
`INFO`	有益情報のメッセージをリストします。	priority:INFO
`SYSTEM`	アプリケーションとワーカーのスタートアップに関するメッセージをリストします。	priority:SYSTEM
`CONSOLE`	オブジェクトストアの設定など、コンソールイベントに関するメッセージをリストします。	priority:CONSOLE
`WARN`	警告メッセージをリストします。	priority:WARN
`DEBUG`	デバッグメッセージをリストします。	priority:DEBUG

すべての優先度

すべてのメッセージをリストします。

なし

ERROR

例外が発生した場合のエラーメッセージのみをリストします。

priority:ERROR

FATAL

アプリケーションが失敗した場合の致命的なメッセージのみをリストします。

priority:FATAL

INFO

有益情報のメッセージをリストします。

priority:INFO

SYSTEM

アプリケーションとワーカーのスタートアップに関するメッセージをリストします。

priority:SYSTEM

CONSOLE

オブジェクトストアの設定など、コンソールイベントに関するメッセージをリストします。

priority:CONSOLE

WARN

警告メッセージをリストします。

priority:WARN

DEBUG

デバッグメッセージをリストします。

priority:DEBUG

ワイルドカード検索

ログページ上部の検索ボックスに、ログメッセージの結果と照合する検索語を入力して、ログデータを絞り込むことができます。

また、ワイルドカード検索の一般的な量指定子を使用して、ログメッセージ内の正確な語を検索することもできます。

? は 0 または 1 個の先行要素に一致します。
∗ は 0 または 1 個以上の先行要素に一致します。