インデックス¶
ログフィールドやメトリクスタグなどの主要な特徴を抽出することで、インデックスは特徴値と元データを関連付け、効率的な検索を実現し、非効率な全件スキャンを回避します。
複数のインデックスを作成・管理すると、システムは事前設定されたフィルター条件に基づいて、ログデータを対応するインデックスに自動的にアーカイブします。同時に、各インデックスごとにデータ保存戦略をカスタマイズでき、保存コストを効果的に制御・削減し、データ管理の柔軟性と経済性を両立させます。
作成¶
Guanceでは、以下の3種類のインデックスの作成またはバインディングをサポートしています。
インデックスタイプ |
定義 | 主な特徴とデータフロー |
管理権限の帰属 |
|---|---|---|---|
| ログインデックス | Guanceにおける基本的なログストレージユニットです。ログデータがアップロードされると、システムは事前定義されたルール（例：マッチング条件、フィルタリング）に基づいて自動的に仕分けされ、該当するインデックスに保存されます。 | ルールに基づく自動仕分け コレクター → Guance集約 → ルールに従い仕分け → 対象インデックスへ書き込み |
Guanceプラットフォームコンソール （インデックスルールの設定により制御） |
| ネイティブダイレクトライトインデックス | コレクター側が直接対象インデックス名を指定する書き込み方式です。データはプラットフォーム側のデフォルトの仕分けルールをバイパスし、指定されたインデックスに直接書き込まれます。 | 対象指定による直接書き込み コレクター（インデックス名指定）→ 対象インデックスへ直接書き込み |
コレクター設定 （DataKit 等の収集側設定で指定） |
| 外部インデックス | Guanceが提供するクロスデータソース統合機能です。認証をバインドすることで、外部データソース（例：セルフホスト ES）をワークスペース内で統一クエリ可能な論理インデックスとしてマッピングします。 | 外部データソースのバインディングと統一クエリ データは外部に保存され、Guanceはクエリチャネルを確立して検索を実行 |
外部データソースシステム （データの所有権と保存管理は外部にあり） |
データが Guanceに収集されると、システムはルールに従ってデータを分割し、インデックスに送信するか、または他のサードパーティシステムに転送します。これにより、データ処理効率が向上し、データのマルチパス分散のニーズを満たします。
管理¶
以下の操作でインデックス一覧を管理できます。
インデックスのエクスポート¶
該当するインデックスタイプの一覧で、右上の「エクスポート」ボタンをクリックすると、対応するインデックスの JSON ファイルをエクスポートできます。
インデックスのインポート¶
ローカルのインデックス設定ファイルのインポートをサポートしています。
ログインデックスマッピング¶
ログインデックスマッピングは、詳細データ内のフィールド値に基づいて、詳細ページの関連クエリで使用するデフォルトのログインデックスを自動選択するための機能です。
注意
ログインデックスマッピングは、詳細ページの関連ログクエリにのみ影響し、ログの書き込み先インデックスのマッチング条件には影響しません。
設定画面へのアクセス¶
ログ > インデックス に移動し、「ログインデックスマッピング」をクリックすると、フィールド値とデフォルトのログインデックス間のマッピング関係を作成および管理できます。
設定方法¶
各マッピングは以下の要素で構成されます。
- マッチングフィールド：詳細データ内のフィールド名。例：
app_id、source、service、env、version。 - フィールド値：マッチングの可否を判断するためのフィールド値。
- デフォルトログインデックス：フィールド値がマッチした場合にクエリ対象とするログインデックス。
設定例：
| マッチングフィールド | フィールド値 | デフォルトログインデックス |
|---|---|---|
app_id |
KKHome |
com_kkhome_kksecurity |
source |
df_rum_ios_log |
ios-security-log |
service |
front-backend |
sm-test-front-backend |
元の「サービス一致」機能を設定する場合は、マッチングフィールドを service に設定し、サービス名と対応するログインデックスを入力します。
関連クエリ¶
設定が有効になると、APM、RUM 等のデータ詳細ページから関連ログを表示する際に、システムは現在の詳細データ内のフィールドを読み取り、マッチしたすべての利用可能なログインデックスを自動的に選択します。
ログ数統計とログ一覧クエリは同じインデックスマッチング結果を使用するため、件数とリスト内容の一貫性が保たれます。
フィールド値のマッチング¶
フィールド値は以下の設定方法をサポートしています。
- 完全一致：例：
front-backend - 複数値一致：複数の値はカンマ区切りで指定します。例：
api,web - ワイルドカード一致：
*：0文字以上の任意の文字列に一致?：任意の1文字に一致
複数ルールのマッチ¶
システムはすべてのマッピングルールをチェックし、マッチしたすべての利用可能なログインデックスを統合します。
- 同じフィールド値が複数のマッピングにマッチした場合、該当するすべてのインデックスをクエリ対象とします。
- 完全一致ルールとワイルドカードルールが同時にマッチした場合、該当するすべてのインデックスを統合します。
- 複数のルールが同じインデックスを指している場合、システムは自動的に重複を排除します。
- ログ数統計とログ一覧クエリは同じインデックスセットを使用します。
例：
| マッチングフィールド | フィールド値 | デフォルトログインデックス |
|---|---|---|
service |
api-* |
application-log |
service |
api-order |
order-log |
現在のサービスが api-order の場合、システムは application-log と order-log の両方をクエリ対象とします。
インデックスの状態制御¶
- インデックスを無効にする：以降のログはこのインデックスには保存されず、他のマッチングするインデックスを探して保存されます。他のインデックスにマッチしない場合は、デフォルトの
defaultインデックスに保存されます。 - インデックスを有効にする：以降のログは再びこのインデックスに保存されるようになります。
インデックス設定の編集¶
作成済みのログインデックスの設定を編集できます。
注意
保存ポリシーを変更すると、インデックス内のデータが削除されます。慎重に操作してください。
インデックスの削除¶
削除アイコンをクリックすると、作成済みのインデックスを削除できます。
注意
- 削除すると、そのインデックス内のログデータも削除されます。他のマッチングするインデックスがない場合、以降にアップロードされたログデータはデフォルトインデックス
defaultに保存されます。 - 削除されたインデックスが他のワークスペースにクエリ権限として付与されていた場合、削除後は相手側のワークスペースからそのインデックスをクエリできなくなります。
- ログインデックスを削除した後は、必要に応じて同名のインデックスを再作成できます。
インデックスの並び替え¶
編集モードをクリックすると、作成済みのログインデックスの順序を上下にドラッグして調整できます。単一選択、複数選択、ページを跨いだ並び替え調整が可能で、1つまたは複数のインデックスを指定した位置に移動できます。
注意
ログは最初にマッチしたインデックスに保存されます。インデックスの順序を変更すると、ログの保存先が変更される可能性があります。
操作監査¶
監査アイコンをクリックすると、該当インデックスに対するすべての操作ログを表示できます。