> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickStackを使った検索

> ClickStackを使った検索

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

ClickStack では、イベント (ログやトレース) に対して全文検索を行えます。検索を始めるには、イベントに含まれるキーワードを入力するだけです。たとえば、ログに "Error" が含まれていれば、検索バーに "Error" と入力するだけで見つけられます。

この検索構文は、Dashboards や Charts でイベントを絞り込む場合にも
使用されます。

<div id="search-features">
  ## Search 機能
</div>

<div id="natural-language-syntax">
  ### 自然言語の検索構文
</div>

* 検索では大文字と小文字は区別されません
* 検索はデフォルトで単語全体に一致します (例: `Error` は `Error here`
  には一致しますが、`Errors here` には一致しません) 。単語をワイルドカードで囲むと部分
  一致させることができます (例: `*Error*` は `AnyError` と `AnyErrors` に一致します)
* 検索語の順序は問いません (例: `Hello World` は
  `Hello World` と `World Hello` を含むログに一致します)
* `NOT` または `-` を使ってキーワードを除外できます (例: `Error NOT Exception` または
  `Error -Exception`)
* `AND` と `OR` を使って複数のキーワードを組み合わせられます (例:
  `Error OR Exception`)
* 完全一致は二重引用符で指定できます (例: `"Error tests not found"`)

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/16jdCy1HTWZ9Bvmz/images/use-cases/observability/hyperdx-27.png?fit=max&auto=format&n=16jdCy1HTWZ9Bvmz&q=85&s=2d311a1e0ba7da3080e90cfb1021692a" alt="Search" size="md" width="3430" height="2340" data-path="images/use-cases/observability/hyperdx-27.png" />

<div id="column-search">
  #### カラム/プロパティ検索
</div>

* カラムや JSON/map のプロパティは、`column:value` を使って検索できます (例: `level:Error`,
  `service:app`)
* 比較演算子 (`>`, `<`,
  `>=`, `<=`) を使うと、値の範囲を検索できます (例: `Duration:>1000`)
* `property:*` を使うと、プロパティの有無を検索できます (例:
  `duration:*`)

<div id="time-input">
  ### 時刻入力
</div>

* 時刻入力では、自然言語の入力を受け付けます (例: `1 hour ago`, `yesterday`,
  `last week`)
* 単一の時点を指定すると、その時点から現在までの範囲が検索対象になります。
* 時間範囲は、時間クエリをデバッグしやすいように、検索時に常に解析後の時間範囲へ変換されます。
* ヒストグラムのバーをハイライトして、特定の時間範囲にズームインすることもできます。

<div id="sql-syntax">
  ### SQL 検索構文
</div>

必要に応じて、検索入力を SQL モードに切り替えられます。すると、検索条件として有効な
SQL の WHERE 句をそのまま使用できます。これは、Lucene 構文では表現できない複雑な
クエリに便利です。

<div id="select-statement">
  ### SELECT ステートメント
</div>

検索結果に表示するカラムを指定するには、`SELECT`
入力欄を使用できます。これは、Search ページで選択するカラムを指定するための SQL の SELECT 式です。
現時点では別名はサポートされていません (例: `column as "alias"` は使用できません) 。

<div id="saved-searches">
  ## 保存済み検索
</div>

検索を保存しておくと、後ですばやくアクセスできます。保存した検索は `Saved Searches` ページに表示されるため、よく使う検索クエリを毎回組み直さなくても簡単に見直せます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/vnVcNA3Hildxme_Z/images/use-cases/observability/clickstack-saved-search-listing.png?fit=max&auto=format&n=vnVcNA3Hildxme_Z&q=85&s=04d07350f6fb6818b7a09f9ad506f2ec" alt="保存済み検索の一覧ページ" size="lg" width="1468" height="614" data-path="images/use-cases/observability/clickstack-saved-search-listing.png" />

検索を保存するには、検索クエリを設定して保存ボタンをクリックするだけです。後で識別しやすいように、保存済み検索にはわかりやすい名前を付けられます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/vnVcNA3Hildxme_Z/images/use-cases/observability/clickstack-saved-search.png?fit=max&auto=format&n=vnVcNA3Hildxme_Z&q=85&s=0fb135768b2d9758cbe233ea98f7a9d2" alt="検索を保存する" size="md" width="912" height="711" data-path="images/use-cases/observability/clickstack-saved-search.png" />

<div id="alerts-on-saved-searches">
  ### 保存済み検索にアラートを追加する
</div>

保存済み検索にはアラートを設定でき、特定の条件を満たしたときに通知を受け取れます。保存済み検索に一致するイベント数が指定したしきい値を上回った場合または下回った場合にトリガーされるよう、アラートを設定できます。

アラートの設定と構成の詳細については、[Alerts ドキュメント](/ja/clickstack/features/alerts)を参照してください。

<div id="tagging">
  ### タグ付け
</div>

ダッシュボードや保存済み検索にタグを追加すると、整理しやすくなります。
タグを使うことで、必要に応じて柔軟に分類したり絞り込んだりできます。

<div id="how-tags-work">
  #### タグの仕組み
</div>

* **整理方法**: タグは左側のサイドバーに表示され、ダッシュボードと保存済み検索は割り当てられたタグごとにグループ化されます
* **複数のタグ**: 1 つの項目に複数のタグを追加して、より適切に分類できます
* **自動作成**: まだ存在しないタグを割り当てると、そのタグは自動的に作成されます
* **簡単な管理**: 整理方法に合わせて、タグはいつでも追加または削除できます

これにより、関連する項目を簡単に見つけられ、項目が増えても整理されたワークスペースを維持できます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/vnVcNA3Hildxme_Z/images/use-cases/observability/clickstack-tags-search.png?fit=max&auto=format&n=vnVcNA3Hildxme_Z&q=85&s=61ffc809253e67f908264fcf2b75f207" alt="保存済み検索内のタグ" size="md" border width="743" height="230" data-path="images/use-cases/observability/clickstack-tags-search.png" />

また、複数のタグを選択して、異なるカテゴリにまたがる項目を絞り込んで表示することもできます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/vnVcNA3Hildxme_Z/images/use-cases/observability/clickstack-tags-dashboard.png?fit=max&auto=format&n=vnVcNA3Hildxme_Z&q=85&s=cbb372afa375d0041857743d95430571" alt="ダッシュボードで複数のタグを選択" size="md" border width="529" height="252" data-path="images/use-cases/observability/clickstack-tags-dashboard.png" />