Alibaba Cloud Logstash のログ機能を使用すると、キーワードと時間範囲を入力して特定のログ内容を検索できます。これにより、クラスターの問題を迅速に特定し、日常のメンテナンスを実行できます。このトピックでは、ログのクエリ方法と利用可能なログタイプについて説明します。
操作手順
[Logstash クラスター] ページに移動します。
対象のクラスターに移動します。
上部のナビゲーションバーで、クラスターが存在するリージョンを選択します。
Logstash クラスター ページで、対象のクラスターを見つけて、その ID をクリックします。
左側のナビゲーションウィンドウで、ログ をクリックして、クラスターのランタイムログを表示します。
Alibaba Cloud Logstash は、クラスターログ、低速ログ、GC ログ、デバッグログの 4 種類のログをサポートしています。次の表では、各ログタイプとそのユースケースについて説明します。詳細については、「ログの詳細」をご参照ください。
ログタイプ
説明
ユースケース
クラスターログ
クラスターの動作ステータスを記録します。
クラスターログを使用して、各ノードのヘルス状態とパイプラインのステータスを確認します。これには、ソースと送信先間の接続性の問題のトラブルシューティング、パイプライン設定の変更の検証、実行時エラーの特定が含まれます。
重要アプリケーションで問題が発生した場合は、まずクラスターログとクラスターモニタリングデータを確認してください。これにより、パフォーマンスボトルネックやパイプライン設定の問題を除外できます。
低速ログ
指定された時間のしきい値を超えたパイプラインイベントを記録します。
重要トラブルシューティングを支援するため、低速ログは YML ファイルでデフォルトで有効になっています。この低速ログの設定を削除しないでください。詳細については、「YML ファイルの設定」をご参照ください。
低速な書き込み操作が発生した場合は、低速ログを確認してください。一般的な原因は次のとおりです：
パイプライン設定のソースまたは送信先がリソースのボトルネックに達しています。ソースまたは送信先のリソースをスケールアップすることを推奨します。
Logstash の Pipeline Workers の設定が小さすぎます。Pipeline Batch Size と Pipeline Workers を増やしてください。詳細については、「設定ファイルを使用したパイプラインの管理」をご参照ください。
GC ログ
Java 仮想マシン (JVM) ヒープからのガベージコレクション (GC) イベントを記録します。GC ログを使用して、Old GC、CMS GC、Full GC、Minor GC メカニズムなど、ガベージコレクションに関する詳細情報を取得できます。
クラスターでパフォーマンスボトルネックが発生した場合、GC ログを使用してガベージコレクションの詳細情報を取得し、時間のかかる、または頻繁なガベージコレクションイベントがないか確認できます。
デバッグログ
パイプラインがデータを処理した後の出力データを表示します。この機能はデフォルトで無効になっています。有効にするには、logstash-output-file_extend プラグインをインストールし、output セクションで file_extend パラメーターを設定する必要があります。
コンソールでパイプライン設定の出力を直接表示してデバッグする必要がある場合は、デバッグログを使用します。
[ログ] ページの検索ボックスに検索クエリを入力し、開始時刻と終了時刻を選択してから、Search をクリックします。
過去 7 日間のログをクエリできます。デフォルトでは、ログは逆時系列順に表示されます。Alibaba Cloud Logstash は、Lucene ベースのクエリ構文をサポートしています。詳細については、「クエリ文字列の構文」をご参照ください。
たとえば、content フィールドにキーワード running が含まれ、level が info、host が 172.16.xx.xx であるクラスターログをクエリするには、次のクエリを使用します：
host:172.16.xx.xx AND level:info AND content:running。その後、Alibaba Cloud Logstash は検索結果を [ログ] ページに表示します。
ログの詳細
クラスターログ
クラスターログには、クラスターのランタイムログが表示されます。これには、生成時刻、ソースノードの IP アドレス、詳細なログ情報が含まれます。
|
パラメーター |
説明 |
|
時間 |
ログが生成された時刻。 |
|
ノード IP |
ログを生成したノードの IP アドレス。 |
|
コンテンツ |
ログの詳細情報。level、host、time、content の各フィールドで構成されます。
|
GC ログ
GC ログはデフォルトで有効になっています。これらはクラスターログと同じ構造を共有します。
低速ログ
低速ログはデフォルトで有効になっています。ご利用の Logstash インスタンスの YML ファイルで、デフォルトの低速ログ設定を表示または変更できます。詳細については、「YML ファイルの設定」をご参照ください。
今後の Alibaba Cloud Logstash のトラブルシューティングを容易にするため、この低速ログ設定を削除しないでください。
デバッグログ
出力データが期待どおりでない場合、パイプラインのデバッグは時間のかかるプロセスになることがあります。これを簡素化するために、Alibaba Cloud Logstash はパイプラインデバッグ機能を提供しています。詳細については、「パイプライン設定デバッグ機能の使用」をご参照ください。
デバッグログはデフォルトで無効になっています。有効にするには、次の手順を実行します：
logstash-output-file_extend プラグインをインストールします。詳細については、「プラグインのインストールまたは削除」をご参照ください。
パイプライン設定の output セクションで、file_extend パラメーターを設定します。詳細については、「設定ファイルを使用したパイプラインの管理」をご参照ください。
デバッグログを有効にすると、処理されたパイプラインの出力データが [デバッグログ] タブに表示されます。