GeoIP stats API

geoip プロセッサ に関する統計情報を取得し、それに使用される GeoIP2 データベースのダウンロード統計を含みます。

Python

  1. resp = client.ingest.geo_ip_stats()
  2. print(resp)

Ruby

  1. response = client.ingest.geo_ip_stats
  2. puts response

Js

  1. const response = await client.ingest.geoIpStats();
  2. console.log(response);

Console

  1. GET _ingest/geoip/stats

Request

GET _ingest/geoip/stats

Prerequisites

  • Elasticsearch のセキュリティ機能が有効になっている場合、この API を使用するには monitor または manage クラスター権限 が必要です。
  • ingest.geoip.downloader.enabled が無効で、カスタムデータベースが構成されていない場合、この API はゼロ値と空の nodes オブジェクトを返します。

Response body

  • stats
  • (オブジェクト) すべての GeoIP2 データベースのダウンロード統計。
    stats のプロパティ
    • successful_downloads
    • (整数) 成功したデータベースダウンロードの合計数。
    • failed_downloads
    • (整数) 失敗したデータベースダウンロードの合計数。
    • total_download_time
    • (整数) データベースのダウンロードに費やした合計ミリ秒数。
    • database_count
    • (整数) 使用可能なデータベースの現在の数。
    • skipped_updates
    • (整数) スキップされたデータベース更新の合計数。
  • nodes
  • (オブジェクト) 各ノードの統計。
    nodes のプロパティ
    • <node_id>
    • (オブジェクト) ノードのダウンロードされたデータベース。 フィールドキーはノード ID です。
      <node_id> のプロパティ
      • databases
      • (オブジェクトの配列) ノードのダウンロードされたデータベース。
        databases オブジェクトのプロパティ
        • name
        • (文字列) データベースの名前。
      • cache_stats
      • (オブジェクト) ノードの GeoIP キャッシュ統計。
        cache_stats のプロパティ
        • count
        • (Long) キャッシュされたエントリの数。
        • hits
        • (Long) キャッシュから提供されたエンリッチルックアップの数。
        • misses
        • (Long) キャッシュから提供できなかった geoIP ルックアップの回数。
        • evictions
        • (Long) キャッシュから追い出されたキャッシュエントリの数。
        • hits_time_in_millis
        • (Long) 成功したキャッシュヒットのみでキャッシュからデータを取得するのに費やした時間（ミリ秒）。
        • misses_time_in_millis
        • (Long) キャッシュミスのみでキャッシュとバックアップの GeoIP2 データベースからデータを取得し、キャッシュを更新するのに費やした時間（ミリ秒）。
      • files_in_temp
      • (文字列の配列) ダウンロードされたデータベースファイル、関連するライセンスファイルを含む。 Elasticsearch はこれらのファイルをノードの 一時ディレクトリ に保存します: $ES_TMPDIR/geoip-databases/<node_id>。