36.5.4. Kibana

以下のようなカスタムフィールドの JSON ファイルを作成します。

以下に例を示します。

{
	"order": 20,
	"mappings": {
		"_default_": {
			"properties": {
				"mytimefield1": { 1
					"doc_values": true,
					"format": "yyyy-MM-dd HH:mm:ss,SSSZ||yyyy-MM-dd'T'HH:mm:ss.SSSSSSZ||yyyy-MM-dd'T'HH:mm:ssZ||dateOptionalTime",
					"index": "not_analyzed",
					"type": "date"
				},
				"mytimefield2": {
					"doc_values": true,
					"format": "yyyy-MM-dd HH:mm:ss,SSSZ||yyyy-MM-dd'T'HH:mm:ss.SSSSSSZ||yyyy-MM-dd'T'HH:mm:ssZ||dateOptionalTime",
					"index": "not_analyzed",
					"type": "date"
				}
			}
		}
	},
	"template": "project.<project-name>.*" 2
}

openshift-logging プロジェクトに切り替えます。

$ oc project openshift-logging

Elasticsearch Pod のいずれかの名前を取得します。

$ oc get -n logging pods -l component=es

NAME                                       READY     STATUS    RESTARTS   AGE       IP             NODE                         NOMINATED NODE
logging-es-data-master-5av030lk-1-2x494    2/2       Running   0          38m       154.128.0.80   ip-153-12-8-6.wef.internal   <none>

JSON ファイルを Elasticsearch Pod に読み込みます。

$ cat <json-file-name> | \  1
oc exec -n logging -i -c elasticsearch <es-pod-name> -- \ 2
    curl -s -k --cert /etc/elasticsearch/secret/admin-cert \
    --key /etc/elasticsearch/secret/admin-key \
    https://localhost:9200/_template/<json-file-name> -XPUT -d@- | \ 3
python -mjson.tool

{
    "acknowledged": true
}

個別の OPS クラスターがある場合は、es-ops Elasticsearch Pod のいずれかの名前を取得します。

$ oc get -n logging pods -l component=es-ops

NAME                                           READY     STATUS    RESTARTS   AGE       IP             NODE                         NOMINATED NODE
logging-es-ops-data-master-o7nhcbo4-5-b7stm    2/2       Running   0          38m       154.128.0.80   ip-153-12-8-6.wef.internal   <none>

JSON ファイルを es-ops Elasticsearch Pod に読み込みます。

$ cat <json-file-name> | \ 1
oc exec -n logging -i -c elasticsearch <esops-pod-name> -- \ 2
    curl -s -k --cert /etc/elasticsearch/secret/admin-cert \
    --key /etc/elasticsearch/secret/admin-key \
    https://localhost:9200/_template/<json-file-name> -XPUT -d@- | \ 3
python -mjson.tool

以下のような出力が表示されます。

{
    "acknowledged": true
}

インデックスが更新されていることを確認します。

oc exec -n logging -i -c elasticsearch <es-pod-name> -- \ 1
    curl -s -k --cert /etc/elasticsearch/secret/admin-cert \
    --key /etc/elasticsearch/secret/admin-key \
    https://localhost:9200/project.*/_search?sort=<custom-field>:desc | \ 2
python -mjson.tool

このコマンドは、カスタムフィールドのインデックスレコードを降順でソートします。

Elasticsearch コンテナーから既存のインデックスパターンファイルを取得します。

$ mkdir index_patterns
$ cd index_patterns
$ oc project openshift-logging
$ for espod in $( oc get pods -l component=es -o jsonpath='{.items[*].metadata.name}' ) ; do
>  for ff in $( oc exec -c elasticsearch <es-pod-name> -- ls /usr/share/elasticsearch/index_patterns ) ; do
>    oc exec -c elasticsearch <es-pod-name> -- cat /usr/share/elasticsearch/index_patterns/$ff > $ff
>  done
>  break
> done

インデックスパターンファイルは、 /usr/share/elasticsearch/index_patterns ディレクトリーにダウンロードされます。

以下に例を示します。

index_patterns $ ls

com.redhat.viaq-openshift.index-pattern.json

対応するインデックスパターンファイルを編集して、各カスタムフィールドの定義を fields 値に追加します。

以下に例を示します。

{\"count\": 0, \"name\": \"mytimefield2\", \"searchable\": true, \"aggregatable\": true, \"readFromDocValues\": true, \"type\": \"date\", \"scripted\": false},

ビジュアライゼーションで使用するには、定義に \"searchable\": true, と \"aggregatable\": true, のパラメーターを追加する必要があります。データ型は、上記に追加した Elasticsearch フィールド定義に対応する必要があります。たとえば、number タイプの Elasticsearch に myfield フィールドを追加した場合に、myfield は string タイプとして追加できません。

インデックスパターンファイルで、Kibana インデックスパターンの名前をインデックスパターンファイルに追加します。

たとえば、operation.\* インデックスパターンを使用するには、以下を実行します。

"title": "*operations.*"

project.MYNAMESPACE.\* インデックスパターンを使用するには、以下を実行します。

"title": "project.MYNAMESPACE.*"

ユーザー名を特定し、ユーザー名のハッシュ値を取得します。インデックスパターンは、ユーザー名のハッシュを使用して保存されます。以下の 2 つのコマンドを実行します。

$ get_hash() {
>     printf "%s" "$1" | sha1sum | awk '{print $1}'
> }

$ get_hash admin

d0aeb5660fc2140aec35850c4da997

インデックスパターンファイルを Elasticsearch に適用します。

cat com.redhat.viaq-openshift.index-pattern.json | \ 1
  oc exec -i -c elasticsearch <espod-name> -- es_util \
    --query=".kibana.<user-hash>/index-pattern/<index>" -XPUT --data-binary @- | \ 2
  python -mjson.tool

以下に例を示します。

cat index-pattern.json | \
  oc exec -i -c elasticsearch mypod-23-gb9pl -- es_util \
    --query=".kibana.d0aeb5660fc2140aec35850c4da997/index-pattern/project.MYNAMESPACE.*" -XPUT --data-binary @- | \
  python -mjson.tool

以下のような出力が表示されます。

{
    "_id": ".operations.*",
    "_index": ".kibana.d0aeb5660fc2140aec35850c4da997",
    "_shards": {
        "failed": 0,
        "successful": 2,
        "total": 2
    },
    "_type": "index-pattern",
    "_version": 1,
    "created": true,
    "result": "created"
}