リアルタイムログの生成
高度な用途および Titanium サブスクリプションランクで利用できる機能 |
Anypoint Monitoring のログポイント機能を使用すると、アプリケーションと API のログをコードを記述せずにリアルタイムで生成できます。アプリケーションの場合は、生成するログのレベルを指定でき、API の場合は、ログのプロパティを指定できます。これにより、ログをオンデマンドでアプリケーションからリアルタイムで抽出できます。再デプロイメントやアプリケーションのダウンタイムは発生しません。権限管理を使用してアクセス権を管理できます。すべてのログがログ管理にシームレスに取り込まれます。
アプリケーションのログポイント
アプリケーションのログポイント機能を使用すると、任意の Mule アプリケーションでコネクタからの情報をリアルタイムで記録できます。サポート対象のいずれかのコネクタを使用している場合、ログレベル (debug (デバッグ)、info (情報)、warn (警告)、error (エラー)) を選択してログを生成できます。
始める前に
次の前提条件が必要です。
-
Anypoint Integration Advanced パッケージ、または Anypoint Platform の Titanium サブスクリプション
-
[Runtime Manager] > [Manage Settings (設定の管理)] 権限
サポート対象コネクタ
ログポイント機能で使用可能な Anypoint Connector は次のとおりです。
| サポート対象の Anypoint Connector | Mule 3 x でサポート対象。 | Mule 4 x でサポート対象。 |
|---|---|---|
Amazon S3 |
x |
x |
Amazon SQS |
x |
x |
データベース |
x |
x |
メール |
x |
x |
ファイル |
x |
x |
FTP |
x |
x |
IBM MQ |
x |
|
JMS |
x |
x |
Microsoft Service Bus |
x |
x |
MongoDB |
x |
x |
MQ |
x |
x |
Object Store (オブジェクトストア) |
x |
x |
Salesforce |
x |
x |
SFTP |
x |
x |
Sockets |
x |
|
TCP |
x |
|
UDP |
x |
|
VM トランスポート |
x |
x |
WMQ |
x |
アプリケーションログポイントの有効化
-
Anypoint Monitoring コンテンツへのアクセス権限を持つユーザーアカウントを使用して Anypoint Platform にログインします。
-
ナビゲーションバーまたは Anypoint Platform のメイン画面で [Monitoring (監視)] をクリックします。
-
[Anypoint Monitoring] ナビゲーションメニューで、[Log Points (ログポイント)] をクリックします。
-
次の設定を選択します。
-
Environment (環境): アプリケーションが実行されている環境。
-
Resource name (リソース名) - アプリケーションの名前。
-
-
[Select (選択)] をクリックします。
-
ログ生成の対象であるコネクタを選択します。
-
各コネクタのログレベルを選択します。
-
[Save & Apply (保存して適用)] をクリックします。
設定が適用されたことを示すメッセージが [View API Logs (API ログを表示)] リンクと一緒にページ上部に表示されます。ログの表示にはしばらく時間がかかる場合があります。 -
選択したログポイントのログを表示するには、[View Logs (ログを表示)] リンクをクリックします。
| trace (トレース) または debug (デバッグ) ログレベルを選択した場合は、終了時にログポイントの監視を無効化して、アプリケーションのパフォーマンスの低下を回避してください。 |
API のログポイント
API のログポイント機能を使用すると、実行中の管理 API から対話形式でデータを抽出できます。コードの記述やアプリケーションの再デプロイなしで、ログ生成の対象である管理 API のプロパティ (たとえば、リクエストヘッダー内のホストやメソッドなど) を指定できます。これにより、アプリケーションを再起動せずにトラブルシューティングできます。
たとえば、API に Cookie ヘッダーを指定して、インジェクション攻撃が進行中かどうかを確認できます。指定された Cookie ヘッダーのログデータは、リアルタイムで自動的にログページに表示されます。
Mule Runtime Engine のサポート対象バージョン
サポート対象の Mule Runtime バージョンで Mule アプリケーションを実行します。サポート対象のバージョンについては、Mule Runtime Release Notesを参照してください。
API ログポイントの有効化
-
Anypoint Monitoring コンテンツへのアクセス権限を持つユーザーアカウントを使用して Anypoint Platform にログインします。
-
ナビゲーションバーまたは Anypoint Platform のメイン画面で [Monitoring (監視)] をクリックします。
-
[Anypoint Monitoring] ナビゲーションメニューで、[Log Points (ログポイント)] をクリックします。
-
次の設定を選択します。
-
Environment (環境): API が実行されている環境。
-
Resource name (リソース名): API の名前。
-
Version/Instance (バージョン/インスタンス): API のバージョンとインスタンス。
-
-
[Select (選択)] をクリックします。
-
ログに記録して管理する [Request (要求)] ポイントを選択します。
次のリクエストヘッダーログポイントを監視できます。-
User Agent (ユーザーエージェント)
-
Path (パス)
-
Host (ホスト)
-
Method (メソッド)
-
Remote Access (リモートアクセス)
-
Accept (受け入れ)
-
Accept Encoding (エンコードの受け入れ)
-
Accept Language (言語の受け入れ)
-
Cookie
-
Referrer (リファラー)
[Header (ヘッダー)] の左にある青いボックスをクリックすると、すべてのログポイントを選択できます。
[Request Body (リクエストボディ)] を監視する場合は、[Body (ボディ)] を選択します。
-
-
ログに記録して管理する [Response (応答)] ポイントを選択します。
次のリクエストヘッダーログポイントを監視できます。-
Status Code (状況コード)
-
Connection (接続)
-
Date (日付)
-
Set-Cookie (Cookie を設定)
-
Pragma
[Header (ヘッダー)] の左にある青いボックスをクリックすると、すべてのログポイントを選択できます。 [Response Body (レスポンスボディ)] を監視する場合は、[Body (ボディ)] を選択します。
-
-
[Save & Apply (保存して適用)] をクリックします。
設定が適用されたことを示すメッセージが [View API Logs (API ログを表示)] リンクと一緒にページ上部に表示されます。 ログの表示にはしばらく時間がかかる場合があります。 -
選択したログポイントのログを表示するには、[View API Logs (API ログを表示)] リンクをクリックします。
| API ログポイントの監視が終了したら、ログポイントの監視を無効化して、アプリケーションのパフォーマンスの低下を回避してください。 |