データ検索¶
Obsy Copilot は、ユーザーがクエリ文を作成したり、自然言語をエクスプローラーのフィルター条件に変換したりすることを支援します。この2つの機能は目的が異なります。DQL / PromQL アシスタントは、可読性が高く再利用可能なクエリ文を生成します。一方、エクスプローラーの自然言語検索は、現在のページのデータを絞り込むために使用されます。
DQL / PromQL アシスタント¶
DQL / PromQL アシスタントは、クエリ文の生成、解釈、修正、レビューに使用されます。また、変換可能な DQL をプラットフォームの PromQL に書き換えることもできます。DQL を生成する際、Obsy Copilot は現在のワークスペース内の実際のデータソース、フィールド、タグを優先的に確認し、最終的な DQL に対して構文チェックを実行します。
この機能は、ユーザーが「最近のログを確認」と要求した場合に、デフォルトで DQL を返すことはありません。DQL / PromQL の作成、解釈、修正、レビュー、または変換が明示的に要求された場合にのみ、クエリ言語フローが開始されます。
以下のようなクエリタスクに適しています。
- DQL や PromQL の構文に詳しくなく、目的に基づいてクエリを生成したい場合。
- 既存のクエリが機能しない、結果の範囲が不明瞭、またはリスクを確認する必要がある場合。
- 既存のクエリのフィルター、集約、グループ化、時間ウィンドウを理解したい場合。
- メトリクス系の DQL をプラットフォームの PromQL に変換する必要がある場合。
- 汎用的なサンプルではなく、現在のワークスペースの実際のフィールドに基づいたクエリを取得したい場合。
クエリの作成または確認¶
Obsy Copilot にクエリの目的を直接記述し、可能な限り以下の情報を提供してください。
- データドメイン: メトリクス、ログ、イベント、トレース、RUM、またはその他のデータタイプ。
- データオブジェクト: 既知のメジャーメント、source、service、またはフィールド。
- 時間範囲: 例：直近30分間、または過去7日間。
- 統計の範囲: 合計数、レート、平均値、パーセンタイル、TopN、またはグループ化ディメンション。
- 出力タイプ: DQL、プラットフォーム PromQL、または標準 Prometheus クエリ。
例：
クエリの修正や解釈が必要な場合は、元の文をそのまま貼り付け、期待する結果を説明してください。データドメイン、時間範囲、統計の範囲に曖昧さがある場合、Obsy Copilot はデータソースやフィールドを推測せず、先に情報の補足を求めます。
クエリ結果と検証¶
DQL を生成する際、Obsy Copilot はデフォルトで、ニーズに最も適合し、かつ構文チェックが完了したクエリを1つ返し、データソース、フィルター条件、集約、時間範囲を簡潔に説明します。現在のワークスペースからフィールドやデータソースを確認できない場合は、制限事項を説明し、ユーザーに選択を求めます。確認されていないフィールドが実際に存在するものとして説明されることはありません。
PromQL を生成する際は、デフォルトでプラットフォームがサポートする measurement:field メトリクス形式を使用します。PromQL はこのフロー内で実際に実行されることはありません。目的のクエリページで実行し、データ結果を確認してください。DQL の構文チェックも文の構造を検証するのみであり、選択した時間範囲内に必ずデータが存在することを意味するものではありません。
注意
DQL / PromQL アシスタントはクエリ言語を生成するためのものであり、ページのデータ分析と同等ではありません。現在のログ、トレース、またはアラートで何が発生しているかを確認することを目的とする場合は、該当するページで可観測性分析を使用してください。
エクスプローラー自然言語検索¶
エクスプローラーの自然言語検索は、ユーザーの記述を現在のエクスプローラーが認識可能なクエリ条件に変換し、既存のクエリや時間範囲とともにページで実行します。これは、エクスプローラーの構文に詳しくないが、どのオブジェクト、ステータス、数値範囲をフィルターすればよいかを既に把握しているユーザーに適しています。
現在、この機能は、自然言語検索が導入されているログ、トレース、RUM、基礎オブジェクト、リソースカタログ、イベント、Synthetic モニタリング、セキュリティ、クラウド請求、バックアップログ、Agent モニタリング、LLM などのエクスプローラーで利用可能です。
フィルター条件の設定¶
この機能をサポートするエクスプローラーで、フィルターの目的を自然言語で記述します。例：
等しい、等しくない、部分一致、ワイルドカード、正規表現、数値比較、範囲、フィールドの有無、および AND、OR、NOT などの組み合わせ条件を表現できます。実際に使用可能な操作は、現在のフィールドタイプによって異なります。
デフォルトでは、Obsy Copilot はクエリボックス内の既存の条件を保持し、その後に新しい条件を追加します。既存の条件を置き換えたい場合は、「再クエリ」「元の条件をクリア」「のみを検索」「次に置き換え」などの表現を明確に使用してください。
条件変換ルール¶
Obsy Copilot は、現在のエクスプローラーが提供するフィールドリストに基づいてクエリ条件を生成します。
- 現在のフィールドまたはフィールドエイリアスと明確に対応できる内容は、構造化フィルター条件に変換されます。
- フィールドを確認できないキーワードは、通常のテキスト検索として保持され、類似したフィールドに強制的にマッピングされることはありません。
- サービス名、リソース名、ID、URL、パス、エラーテキストなどの業務上の値は、可能な限り原文が保持されます。
- ユーザーが明確に指定した時間表現は、エクスプローラーの時間ウィジェットに渡されます。
生成された結果は現在のエクスプローラーのフィルタリングに使用され、DQL は作成されず、データが変更されることもありません。フィールドが現在のページで利用可能なフィールドに含まれていない場合、他のエクスプローラーに同名のフィールドが存在しても、構造化条件として使用されることはありません。