OpenSearch の監視

監視方法

OpenSearch クラスターの監視にはいくつかの方法があります。どの方法が最適であるかは、デプロイ モデルや運用上の設定によって異なります。

AWS ホスト型 OpenSearch

AWS OpenSearch サービスで管理されるクラスターの場合は、AWS CloudWatch が主要な監視ソリューションとなります。CloudWatch では、クラスターの健全性、リソース使用率、検索のパフォーマンスなど、OpenSearch ドメインから幅広いメトリックが自動的に収集されます。ダッシュボードを作成し、設定可能なアラームを設定することで、クラスターのステータスを常に把握できます。AWS ホスト型 OpenSearch サービスの監視について詳しくは、こちらをご覧ください。

セルフホスト型 OpenSearch

セルフホスト型 OpenSearch クラスターの場合は、Prometheus や Grafana などのオープンソースの監視ツールが一般的に使用されています。OpenSearch Prometheus Exporter プラグインではクラスターのメトリックが収集され、収集されたメトリックは Grafana ダッシュボードで可視化、分析できます。この方法は柔軟性に優れ、カスタマイズが可能であり、ニーズに合わせて監視をカスタマイズできます。Prometheus はアラート ルールもサポートしているため、カスタムしきい値に基づいてプロアクティブな通知を受け取ることができます。セルフホスト型 OpenSearch の監視について詳しくは、こちらをご覧ください。

主要なメトリックとアラート

OpenSearch クラスターが AWS でホストされているか、オンプレミスであるかにかかわらず、安定性、パフォーマンス、信頼性を維持するためには、以下の主要なメトリックを監視することが重要です。

トラブルシューティングとベスト プラクティス

OpenSearch の一般的な監視では、AWS CloudWatch アラームを使用して、クラスターの健全性、リソース使用量、パフォーマンス、エラー率を追跡できます。各アラームには、トラブルシューティングの手順とベスト プラクティスが記載されています。Amazon OpenSearch Service の推奨される CloudWatch アラームについては、こちらをご覧ください。

Jira 固有のメトリック

特定時点 (PIT) メトリック

CurrentPointInTime (開いている PIT コンテキストの数) または AvgPointInTimeAliveTime (PIT コンテキストの平均存続期間) のアラームは、PIT 検索がすぐに終了しないか、同時実行可能な PIT コンテキストの数がクラスターの制限に近づいているか、その制限を超えていることを示します。

これらのアラームには以下の方法で対処できます。

• PIT キープアライブ期間を設定する
  jira-config.properties ファイルの opensearch.pointintime.keepalive.seconds プロパティを設定して、PIT がアクティブな期間を制御します。この値を小さくすると、PIT コンテキストをより早く閉じることができ、リソース使用量を最小限に抑えることができます。ただし、この値を小さくしすぎると、クエリが完了する前に PIT コンテキストの期限が切れる可能性があるため、検索結果が正常に生成されない可能性があります。既定は 120 秒ですが、ワークロードと監視データに基づいて慎重に調整してください。

• 異常なパターンを監視する
  オープン PIT コンテキストが急増していることに気付いた場合は、Jira の使用状況に最近の変更 (新しいプラグイン、統合、過剰な PIT 検索を生成する可能性のある一括操作など) がないか確認してください。

• PIT 制限を引き上げる
  ワークロードでより多くの同時 PIT コンテキストを処理する必要がある場合は、次のように、OpenSearch REST API を使用して search.max_open_point_in_time_context ノード設定を更新し、制限を引き上げてください。
  
  

  PUT _cluster/settings
  {
    "persistent": {
      "search.max_open_point_in_time_context": <desired_limit>
    }
  }

  この制限を引き上げると、より多くのリソースが使用されます。変更後は、クラスタの健全性とリソース使用量を監視してください。

スクロール メトリック

ScrollCurrent (未完了のスクロール コンテキストの数) に関するアラームは、スクロールがクリーンアップされていないことを示している可能性があり、リソース リークやクラスターの不安定化につながるおそれがあります。

これらのアラームには以下の方法で対処できます。

• 権限を確認する
  スクロール コンテキストを削除またはクリアするために必要な権限が Jira に付与されていることを確認してください。適切な権限がないと、スクロールが蓄積され、クリーンアップされない可能性があります。

• 使用パターンを監視する
  スクロールの使用量が多い状態が続いている場合は、一括操作や長時間実行されるクエリがないか確認してください。未完了のスクロール コンテキストの数を減らすため、それらの操作を最適化するか、別の方法でバッチ処理することを検討してください。

デバッグのためにログ記録を有効にする

詳細なログ記録を有効にすると、トラブルシューティングやパフォーマンス分析に役立ちます。OpenSearch には、低速クエリやインデックス作成のボトルネックなどの問題を特定するためのログ記録オプションが複数用意されています。パフォーマンスへの影響を最小限に抑えるために、これらのログ記録はトラブルシューティング中にのみ、一時的に有効にしてください。

• リクエストレベルの低速クエリ ログ: 設定された実行時間を超えたクエリをキャプチャします。これらのログでは、非効率的なクエリや問題のあるクエリを見つけることができます。

• シャードレベルの低速インデックス作成ログ: シャード レベルでインデックス作成操作の速度が予想よりも低い場合に、その操作を記録します。

• シャードレベルの低速検索ログ: シャードレベルで検索操作の速度が低い場合に、その操作を記録します。

詳細については、以下をご覧ください。

• セルフホスト型 OpenSearch のログ記録に関するドキュメント

• AWS OpenSearch Service の Amazon CloudWatch Logs によるログを監視する

その他のリソース

• Jira 向け OpenSearch を設定する

• 低速 JQL クエリを特定する