データ検索¶
Obsy Copilot は、ユーザーのクエリ文の作成を支援できるほか、自然言語をエクスプローラーのフィルター条件に変換することもできます。AI 支援クエリを提供するエクスプローラーとクエリワークベンチでは、編集可能な DQL ドラフトを直接生成できるため、ゼロからクエリを書く作業を削減できます。
DQL / PromQL アシスタント¶
DQL / PromQL アシスタントは、クエリ文の生成、説明、修正、レビューに使用でき、変換に適した DQL をプラットフォームの PromQL に書き換えることもできます。新しい DQL を生成する際、Obsy Copilot は現在のワークスペースのデータソースとフィールドを照合し、フィールド定義に基づいてセマンティクスと単位を確認したうえで、構文チェックと実際のクエリによって結果を検証します。
この機能は、ユーザーが「最近のログを確認したい」と述べただけで既定で DQL を返すことはありません。DQL / PromQL の作成、説明、修正、レビュー、変換が明確に要求された場合にのみ、クエリ言語のフローに入ります。
以下のクエリタスクに適しています:
- DQL や PromQL の構文に不慣れで、目的に応じてクエリを生成する必要がある場合;
- 既存のクエリが通らない、結果の定義が不明確、またはリスクを確認する必要がある場合;
- 既存のクエリのフィルター、集計、グループ化、時間ウィンドウを理解したい場合;
- メトリクス系の DQL をプラットフォームの PromQL に変換する必要がある場合;
- 汎用的な例ではなく、現在のワークスペースの実際のフィールドに基づくクエリを取得したい場合。
クエリの作成または確認¶
Obsy Copilot でクエリの目的を直接説明し、可能な限り以下の情報を提供してください:
- データドメイン:メトリクス、ログ、イベント、トレース、RUM などのデータタイプ;
- データオブジェクト:既知の measurement、source、service、またはフィールド;
- 時間範囲:たとえば直近 30 分、過去 7 日間など;
- 集計定義:総量、レート、平均値、パーセンタイル、TopN、グループ化ディメンション;
- 出力タイプ:DQL、プラットフォームの PromQL、または標準 Prometheus クエリ。
例:
クエリの修正や説明が必要な場合は、元の文をそのまま貼り付け、期待する結果を説明してください。データドメイン、時間範囲、集計定義に曖昧さがある場合、Obsy Copilot はデータソースやフィールドを推測せず、まず追加情報を求めます。
クエリ結果と検証¶
新しい DQL を生成する際、Obsy Copilot はまずクエリの目的、データソース、フィールドを確認し、その後で最終的な文の構文チェックを行い、指定された時間範囲で実際にクエリを実行して、結果のフィールド、グループ化、集計定義を照合します。提示時にはデータソース、フィルター条件、集計、時間範囲を簡潔に説明します。フィールドやデータソースを確認できない場合は、制約を説明するか、選択を求めることがあります。
フィールド定義は別名、単位、ビジネス上の意味の理解には役立ちますが、実際にデータが報告されていることを証明するものではありません。構文が通ることも、結果が正しい、あるいは完全であることを意味しません。データが返らない、アクセスに失敗する、結果が切り捨てられるなどのケースは個別に確認する必要があり、技術的な失敗を「データがない」と見なしてはなりません。
クエリやフィールドの意味を説明するだけの場合は、実際にクエリを実行する必要はありません。既存の式の修正では構文チェックのみを行うことがあり、それをビジネス結果の検証済みと見なすべきではありません。PromQL を生成する場合、既定ではプラットフォームがサポートする measurement:field のメトリクス定義を使用します。このフローでは PromQL を実際に実行しないため、対象のクエリページで実行してデータ結果を確認してください。
注意
DQL / PromQL アシスタントはクエリ言語の生成に使用するものであり、ページ上でのデータ分析とは異なります。現在のログ、トレース、アラートで何が起きているかを判断することが目的の場合は、該当するページで可観測性分析を使用してください。
エクスプローラーの自然言語検索¶
エクスプローラーの自然言語検索は、ユーザーの説明を現在のエクスプローラーが認識できるクエリ条件に変換し、既存のクエリおよび時間範囲とあわせてページに渡して実行します。エクスプローラーの構文に不慣れでも、フィルターしたいオブジェクト、ステータス、数値範囲が分かっているユーザーに適しています。
現在この機能は、AI 支援クエリの入口を提供するログ、トレース、RUM、基礎オブジェクト、リソースカタログ、イベント、Synthetic モニタリング、セキュリティ、クラウド請求、Agent モニタリング、LLM などのエクスプローラーで利用できます。共有ページ、SLS クエリモード、バックアップログエクスプローラーではこの入口は提供されません。
フィルター条件の設定¶
この機能をサポートするエクスプローラーで、フィルターの目的を自然言語で説明します。例:
等しい、等しくない、含む、ワイルドカード、正規表現、数値比較、範囲、フィールドの存在有無、および AND、OR、NOT などの組み合わせ条件を表現できます。実際に使用できる操作は現在のフィールドタイプによって異なります。
既定では、Obsy Copilot はクエリボックスに既にある条件を保持し、その後に新しい条件を追加します。既存の条件を置き換えたい場合は、「再クエリ」「元の条件をクリア」「〜のみを検索」「〜に置き換え」などの表現を明示的に使用してください。
条件変換のルール¶
Obsy Copilot は、現在のエクスプローラーが提供するフィールド一覧に基づいてクエリ条件を生成します:
- 現在のフィールドまたはフィールドエイリアスと明確に対応付けられる内容は、構造化されたフィルター条件に変換されます;
- フィールドを特定できないキーワードは、通常のテキスト検索として保持され、類似したフィールドに無理にマッピングされることはありません;
- サービス名、リソース名、ID、URL、パス、エラーテキストなどのビジネス値は、可能な限り原文のまま保持されます;
- ユーザーが明示した時間表現は、エクスプローラーの時間ウィジェットで処理されます。
クエリ条件を生成を選択した場合、結果は現在のエクスプローラーのフィルターに使用され、DQL は作成されず、データも変更されません。フィールドが現在のページの利用可能なフィールドに含まれていない場合、他のエクスプローラーに同名のフィールドが存在していても、それを構造化条件として使用することはありません。
AI 支援による DQL 生成¶
グループ集計、トレンド分析、より複雑なクエリが必要な場合は、エクスプローラーまたはクエリワークベンチで自然言語から完全な DQL を生成できます。たとえば、「payment サービスの直近 30 分間のエラーログ数を host でグループ化して集計し、件数の多い上位 10 ホストを返してください」のように指定します。
| 入口 | クエリ範囲と生成結果 |
|---|---|
| エクスプローラーの検索バーにある AI 支援クエリ > DQL を生成 | ログ、トレース、RUM、基礎オブジェクト、リソースカタログ、イベントなど、この入口を提供するエクスプローラーで利用できます。現在のデータタイプ、インデックス、限定済みのソースを保持し、ページの時間範囲と組み合わせてドラフトを生成し、クエリエディターに入力します。 |
| クエリワークベンチの DQL 編集モード | データタイプ、データソース、フィルター、集計の目的を説明したうえでDQL を生成をクリックすると、結果が対応するクエリタブに書き込まれます。時間を指定しない場合はページの時間範囲が使用され、クエリは特定のエクスプローラーのデータタイプに制限されません。 |
生成後は引き続き編集やコピーが可能で、クエリが自動実行されたり、既存の結果が更新されたりすることはありません。DQL の実行をサポートするページでは確認後に実行する必要があります。ドラフトのみをサポートするエクスプローラーでは編集とコピーが可能で、文をクエリワークベンチに持ち込んで実行できます。エクスプローラー内で実行する場合、文は引き続き現在のデータタイプ、インデックス、ソース範囲に適合している必要があります。
これら 2 つの入口はクエリドラフトを素早く生成するためのものであり、ワークスペースのフィールドを 1 つずつ検出・検証するわけではないため、ビジネスフィールドが不足している場合は一般的な命名が用いられることがあります。実行前にフィールド、単位、集計定義、時間範囲を確認してください。構文が通ることは、現在のワークスペースに対応するデータがあることや、結果が検証済みであることを意味しません。実際のメタデータに基づいてクエリを生成・検証する必要がある場合は、Obsy Copilot との対話で DQL / PromQL アシスタントを使用してください。