私は雰囲気でkibanaをやっていたので反省して使い方をちゃんとまとめることにする

Posted at 2020-12-15

この記事はエイチーム引越し侍 / エイチームコネクトの社員による、Ateam Hikkoshi samurai Inc.× Ateam Connect Inc. Advent Calendar 2020 15日目の記事です。

はじめに

引越し侍ではサーバのログをAWS Elasticserchに突っ込んでkibanaで解析しています。
朝会でダッシュボードをみて気になることがあればkibanaでログを見る、ということをしているのですが、
ぶっちゃけ今日の今日まで私は雰囲気でkibanaをやっていました。反省しています。
なので反省を生かしてきちんと使い方を調べつつまとめていこうと思います。

kibanaの使い方

今回使用しているkibanaはv7.8.0です。

Discover

データをいろんな条件で検索してグラフ化される画面です。

インデックスパターンを選択し見たいデータを選びます。
時間フィルター
初期値は直近15分のデータが表示されており、画像では12/1 0:00~12/2 0:00を選択しています。このように絶対値や現在からの相対値を設定できます。
データを検索
KQL（Kibana Query Language）という言語を使用して検索することができます。
フィールドの追加と削除
フィールド名の横にある「Add」をクリックすることでテーブルに表示するフィールドを選ぶことができます。
検索結果をフィルタリング
フィールド名をクリックすると上位5つまでの値が表示されます。ここで(+)アイコンをクリックするとその値のみに検索結果を絞ることができます。※その他の方法は後述

Kibana Query Language

完全一致

{フィールド}:{値}
andやorも使える
例
- response:200
- message:"Quick brown fox"
- response:200 and (extension:php or extension:css)
- response:(200 or 404)

否定

not {構文}
例
- not response:200
- response:200 and not (extension:php or extension:css)

演算子

>, >=, <, <=, *
例
- bytes > 1000
- machine.os:win*
  - ワイルドカードでwinで始まる文字列すべてと一致

ネストされたフィールド

{
  "grocery_name": "Elastic Eats",
  "items": [
    {
      "name": "banana",
      "stock": "12",
      "category": "fruit"
    },
    {
      "name": "peach",
      "stock": "10",
      "category": "fruit"
    },
    {
      "name": "carrot",
      "stock": "9",
      "category": "vegetable"
    },
    {
      "name": "broccoli",
      "stock": "5",
      "category": "vegetable"
    }
  ]
}

上のようなネストされたフィールドは下記のように検索できます。

items:{ name:banana and stock > 10 } 1つめが一致
items:{ name:banana and stock:9 } 一致なし
items:{ name:banana } and items:{ stock:9 } 1つめと3つめが一致

注意

以前のversionで使えたresponse:[400 TO 499]のような範囲指定はこのバージョンでは使えないので注意

filter

フィルターを使う簡単な方法は5にあげたものがありますが、それ以外の方法を紹介します。

③の検索欄の下、「Add filter」をクリック
fieldを選択
Operatorの選択

Operator
is	フィールドの値が指定された値と一致
is not	フィールドの値が指定された値と一致しない
is one of	フィールドの値が指定された値の1つと一致
is not one of	フィールドの値が指定された値のいずれとも一致しない
is between	フィールドの値が指定された範囲内に存在
is not between	フィールドの値が指定された範囲内に存在しない
exists	フィールドには任意の値が存在
does not exist	フィールドに値が存在しない
4.フィルタの値を選択
5.「Save」してフィルタを検索に適用

filterのアクション

Pin across all apps → インデックスを変更したり、Visualizeに切り替えてもそのまま残る
Exclude results → フィルターが逆の意味になる
Temporarily disable → 一時的に無効になる。フィルタは削除されず、もう一度クリックすると有効化できる。
Delete

Edit as Query DSL

フィルタの編集画面にでてくるこれを利用すると、クエリを直接変更できます。これにより複数のフィールドを使用してより複雑なフィルターを作成できます。
Query DSL

下の例では中国かカナダからのアクセスで発生している404エラーを表示するフィルターを作成しています。

{
  "bool": {
    "should": [
      {
        "term": {
          "geoip.country_name.raw": "Canada"
        }
      },
      {
        "term": {
          "geoip.country_name.raw": "China"
        }
      }
    ],
    "must": [
      {
        "term": {
          "response": "404"
        }
      }
    ]
  }
}