開始前に

ジオマップウィジェットを設定するには、データ内の位置情報が必要です。 位置は、地理座標として、またはサポートされている位置識別子として提供することができる。

位置情報は、以下のいずれかのオプションを使って渡すことができる：

• オプション1：各レコードに緯度と経度のフィールドを含める

  緯度と経度のフィールドを直接使ってジオマップウィジェットを設定することができます。

  フィールドは有効な数値座標値を含んでいなければならない。

• オプション2：IPアドレス値を含むフィールドを含み、Geoエンリッチメント機能を使用する

  該当するIPフィールドにジオ・エンリッチメントを設定する必要があります。 ジオエンリッチメントはIPアドレスから緯度と経度の数値を導き出し、ジオマップに一貫した位置データのソースを提供する。 詳細については、 ジオ・エンリッチメントの設定を 参照してください。

ウィジェットを構成するには、緯度と経度のフィールドは、サポートされているフォーマットのいずれかに準拠しなければならない：

ジオマップウィジェットで可視化されるデータは、緯度と経度の座標によってクラスタにグループ化されます。 クラスターは、緯度と経度が共通するデータの仮想バケツだと考えてほしい。

Geomap ウィジェットで構成するクエリは、選択した時間範囲内の最新の 2,000 件のログレコードのみを評価する。 これらのログレコードのいくつかが地理フィールドを含んでいない場合、それらはマップから除外される。 評価されたレコードに地理データが含まれるようにするには、ウィジェットのクエリビルダで明示的に非NULL位置フィールドをフィルタする必要があります。

例えば、地理フィールドを含まないログレコードをフィルタリングするdataprimeクエリを使用することができます：

source logs
| filter $d.latitude != null
| filter $d.longitude != null
xxxxx

地図を操作する際には、以下の情報を考慮してください：

• ズームインとズームアウトは、地理的集計のレベルを変更し、高レベルの地域パターンからより詳細な場所に移動することができます。
• ポイントやクラスターの上にカーソルを置くと、現在の設定に基づくコンテキスト情報がツールチップに表示されます。
• クラスターをクリックすると、より小さな地理的グループにドリルダウンされ、値が混在または集約されたエリアの調査が容易になる。

ステップ1：名前と説明を入力

以下のステップを実行します。

1. カスタムダッシュボードで、[ウィジェットを追加] をクリックし、サイドバーから Geomap ウィジェットをドラッグアンドドロップします。

2. New Geomapをウィジェットの名前に置き換えます。

3. 説明を入力します。

   アクションアイコンをクリック。 次に、 Add descriptionを選択する。

ステップ2：データセットを定義するクエリーの設定

以下のステップを実行します。

1. アクションアイコンをクリック。 次に、 編集モードを選択する。

2. Query 1 の場合、以下のステップを完了する：

   データタイプを選択する。 有効な値は Logs Metrics および DataPrime。

   ソースを選択する。 有効なオプションは Priority Insights と Analyze and Alert。

   クエリー名を変更することができます。 選択し、 クエリの名前の変更をクリックします。

3. クエリーを入力する。

   データ・タイプが DataPrime の場合、 Query フィールドに Dataprime クエリを入力する。

   データ型が Logs の場合、 Query フィールドに Lucene クエリを入力します。 フィルターや集計を適用できる。

   データ・タイプが Metrics の場合、 Query フィールドでメトリックまたは希望する PromQL を指定する。 フィルターや集計を適用できる。

4. [オプション]ゲージに表示されるデータを絞り込むために、ウィジェットに固有の1つまたは複数のフィルタを追加します。

   ラベルと対応する値を選択する。

   フィルタはウィジェットレベルで適用され、ダッシュボードのフィルタと同様に機能します。 競合がある場合、ダッシュボードフィルタがウィジェットフィルタよりも優先されます。

5. ジオマップ用にデータをグループ化して集計する機能を追加します。

ステップ 3: ウィジェットの設定

以下のステップを実行します。

1. アクションアイコンをクリック。 次に、 編集モードを選択する。

2. 位置管理＞座標セクションで、緯度と経度の情報を含む使用するフィールドを選択します。

   緯度と経度の値を含むフィールドは文字列型にはできません。

   1つのウィジェットにつき、緯度情報を提供するフィールドと経度情報を提供するフィールドは1つしか設定できません。

   地理データが異なるレコードの異なるフィールドで利用可能な場合は、解析ルールを使用してデータを1つに統合します。

   ジオマップウィジェットは、位置フィールドを自動的に検出または推論しません。 位置解決に使用するフィールドを明示的に選択する必要がある。

3. ロケーション管理］＞［クラスタ値計算］で、地理的クラスタごとに値を計算する方法を選択します。 数値計算、 Sum、 Average、 Minimum 、 Maximum を選択する場合は、クラスタグループに入るデータの計算に使用される Byフィールドで数値フィールドを選択する必要があります。

   有効な値は Count Sum, Average, Minimum または Maximum。

   マップを拡大・縮小すると、クラスターの値が動的に再計算される。

   ズームインすると粒度が増し、より小さなクラスターや個々のポイントが明らかになる。

   ズームアウトすると、近くのクラスターがより高いレベルのグループ分けに集約される。

   体積ベースの計算では、 Count または Sum を使用し、クラスターがマージするにつれて値を蓄積する。

   Average、 Minimum 、 Maximum を用いた価値ベースの計算は、基礎データから再計算される。

   Sum、 Average、 Minimum 、 Maximum を使用した数値集計計算では、クエリ結果に数値フィールドが存在する必要があります。

   有効な数値のない結果は集計から除外される。

   数値が文字列としてデータ内に保存されている場合、数値集約で使用する前に、クエリ内で数値型にキャストするか、取り込み時にパースする必要があるかもしれません。 これにより、 Sum、 Average、 Minimum 、 Maximum の計算に値を含めることができる。

   地理的な場所に解決できないクエリー結果は除外される。

   Count は、それぞれの地理的クラスター内のイベント数をカウントする。 count 、ホットスポット、トラフィックの集中、エラー量の多い地域を特定することができます。 ズームアウトすると、小さいクラスターからのカウントが加算される。

   Sum は、各クラスタ内のすべてのイベントの数値フィールドの値を追加します。 総バイト数、総リクエスト数、総コストなどの累積メトリクスに使用できます。 ズームアウトすると、クラスター間の合計が加算される。

   Average は、クラスターごとの数値フィールドの平均値を計算します。 待ち時間や持続時間などのパフォーマンス測定に使用できます。 ズームアウトすると、平均は合計ではなく、基礎となるクラスターから再計算される。

   Minimum または Maximum 、各クラスタ内で観測された最低値または最高値を表示する。 これらのオプションを使用して、最良ケースと最悪ケースの値、異常値、スパイクを特定することができます。 ズームアウトすると、マージされたクラスタ全体で最小値または最大値が再計算される。

4. ツールチップの管理セクションでは、地図上のポイントやクラスターにカーソルを合わせたときに表示される情報をカスタマイズします。 メッセージを追加し、ツールチップに含めるラベルや属性を選択します。

   ポイントやクラスターの上にカーソルを置いたときに表示されるメッセージや値を追加します。 {{ }} 構文を使えば、集計値などの動的フィールドを参照できる。

   参照されるフィールドがクラスタ内で複数の異なる値に解決される場合、ツールチップは特定の値ではなく、"multiple "のような一般的なラベルを表示します。 これは、クラスターに様々な値が混在していることを示し、より詳細に掘り下げることを促している。

   サービス、アプリケーション、国など、ツールチップに含めるラベルや属性を選択します。

5. ビジュアル管理セクションでは、マップ上での値の表現方法を定義します。

   有効なオプションは Size と Color range。

   体積と濃度が主要なシグナルである体積ベースの分析にはサイズを選択する。

   パフォーマンス重視の分析にはカラーレンジを選択。 カラーパレットを選択し、値を色にマッピングする方法を制御することができます。 クラスタ値がどのように色に変換されるかを制御するために、しきい値を定義することができます。 しきい値は、選択されたクラスタ値計算に対して評価され、クラスタ値の変化に応じて動的に更新されます。

ステップ 4: ウィジェットを保存する

以下のステップを実行します。

1. [オプション]ダッシュボードで選択した時間範囲と異なる時間範囲を使用したい場合は、ウィジェットのダッシュボード時間を設定します。

2. 保存をクリックしてウィジェットを保存します。

3. [オプション]カスタムアクションを追加する。 詳細については、 サードパーティ・サービスと統合するためのアクションの 使用を参照してください。

地図上のアクション

クイックアクションを使用して、地図から直接データを調査します。

ポイントやクラスターを選択すると、コンテキストメニューから以下の操作ができます：

• Open Explore:選択した場所とクラスタのコンテキストを使用して事前にフィルタリングされたログをエクスプローラビューで開きます。

• Filter in:選択した場所と値のコンテキストをダッシュボードのクエリに追加します。

• Filter out:選択した場所と値のコンテキストをダッシュボードのクエリから除外します。

• Copy name:選択 し たポ イ ン ト ま たはク ラ ス タ に関連付け ら れてい る ロ ケーシ ョ ン ラ ベルま たはキー= 値のペアを コ ピー し ます。