[Cluster Health]

기본적인 cluster health check부터 시작해 보자. 이를 통해 우리는 cluster가 어떻게 작업을 수행하고 있는지 볼 수 있다. Curl을 사용하여 health check하겠지만, HTTP/REST call을 수행할 수 있는 어떤 tool을 사용해도 된다. Elasticsearch를 실행한 node에 있다고 가정하고, 또 다른 command shell window를 open하자.

Cluster health check하기 위해서, _cat API를 사용할 것이다. 이전에 node의 endpoint 주소를 기억해보면 9200 포트를 사용했다.

curl 'localhost:9200/_cat/health?v'

응답 결과는 다음과 같다.

epoch      timestamp cluster       status node.total node.data shards pri relo init unassign
1394735289 14:28:09  elasticsearch green           1         1      0   0    0    0        0

Cluster name이 elasticsearch임을 알 수 있다. 현재 cluser 상태는 green status이다.

Cluster health에 대해 언제든지 질의하면, green/yellow/red 중 한가지 상태를 알 수 있다. Green은 모든 것이 좋은 상태 (cluster가 모든 기능을 정상적으로 수행)임을 의미하고, yellow는 모든 data를 이용할 수는 있지만, 몇몇 replicas가 아직 할당되지 않은 상태(cluster가 모든 기능을 정상적으로 수행)임을 의미하고, red는 몇몇 데이터를 이용할 수 없는 상태임을 의미한다. Cluster가 red 상태일지라도 부분적으로 동작한다. (이용 가능한 shard에 있는 데이터에 대한 검색 요청을 지속적으로 수행) 하지만, 유실한 데이터가 있기 때문에 ASAP(As Soon As Possible) 문제 상황을 fix해야 한다.

위의 응답 결과로부터 우리는 전체 1개의 node가 있고, 0개의 shard가 있음을 알 수 있다. 왜냐하면 아직 데이터가 없기 때문이다. Default cluster name (elasticsearch)를 사용했고, 다른 node를 discover하기 위해서 elasticsearch는 multicase를 사용하므로 네트워크 상에서 하나 이상의 node를 우연하게 실행하면 모두 cluster에 join하게 된다. 이 시나리오에서는 응답 결과로 1개 이상의 node를 볼 수 있을 것이다.

다음과 같이 cluster에 있는 node list를 볼 수 있다.

curl 'localhost:9200/_cat/nodes?v'

응답은 다음과 같다.

curl 'localhost:9200/_cat/nodes?v'
host         ip        heap.percent ram.percent load node.role master name
mwubuntu1    127.0.1.1            8           4 0.00 d         *      New Goblin

여기서 우리는 현재 cluster에 있는 단일 node name이 "New Goblin"임을 알 수 있다.

[The REST API]

이제 우리는 실행된 node (cluster)를 가지고 있다. 다음 단계는 실행중인 node(cluster)와 어떻게 communicate하는지를 이해하는 것이다. 운이 좋게도, elasticsearch는 이해하기 쉽고 강력한 REST API를 제공한다. 여러분은 REST API를 통해서 cluster와 interact할 수 있다. API를 이용해서 할 수 있는 작업들은 다음과 같다.

• Cluster, node, index health, status, statistics 체크

• Cluster, node, index data, metadata 관리

• Index에 대한 CRUD(Create, Read, Update, Delete) 및 검색 작업 수행
• Paging, sorting, filtering, scripting, faceting, aggregation 등의 많은 advanced search 작업 실행

Elasticsearch는 java 7을 필요로 한다. 특히 이글을 쓰는 시점에서, Oracle J아 1.8.0_25 버전을 사용할 것을 추천한다. Java 설치는 platform에 따라 다르다. 따라서 여기서 Java 설치에 대해서 깊이 들어가지는 않을 것이다.

여러분이 elasticsearch를 설치하기 전에 java version을 체크하라는 것을 말하는 것으로 충분하다. (필요하다면 java를 설치하거나 업그레이드 하라)

java -version

echo $JAVA_HOME

Java를 셋업하고 나서, elasticsearch를 다운로드하고 실행한다. www.elasticsearch.org/download 에서 과거에 릴리즈된 모든 버전의 바이너리를 이용할 수 있다. 각 릴리즈별로 zip/tar 압축 파일을 선택하거나 DEB/RPM package를 선택할 수 있다. 간단하게 말하자면, 그냥 tar 파일을 사용하자.

Elasticsearch 1.5.1 tar 파일을 다음과 같이 다운로드 하자. (윈도우 사용자는 zip package를 다운로드 해야 한다.)

curl -L -O https://download.elasticsearch.org/elasticsearch/elasticsearch/elasticsearch-1.5.1.tar.gz

그리고 다음과 같이 압축을 푼다. (윈도우 사용자는 zip package를 unzip 해야 한다.)

tar -xvf elasticsearch-1.5.1.tar.gz

현재 directory에 한 뭉텡이의 file/folder들을 생성할 것이다. 다음과 같이 bin directory로 이동하자.

cd elasticsearch-1.5.1/bin

이제 여러분은 지금 node에서 단일 cluster로 실행할 준비가 되었다. (윈도우 사용자는 elasticsearch.bat 파일을 실행하라)

./elasticsearch

모든 것이 제대로 되었다면, 아래와 같은 메시지들을 확인할 수 있을 것이다.

./elasticsearch
[2014-03-13 13:42:17,218][INFO ][node           ] [New Goblin] version[1.5.1], pid[2085], build[5c03844/2014-02-25T15:52:53Z]
[2014-03-13 13:42:17,219][INFO ][node           ] [New Goblin] initializing ...
[2014-03-13 13:42:17,223][INFO ][plugins        ] [New Goblin] loaded [], sites []
[2014-03-13 13:42:19,831][INFO ][node           ] [New Goblin] initialized
[2014-03-13 13:42:19,832][INFO ][node           ] [New Goblin] starting ...
[2014-03-13 13:42:19,958][INFO ][transport      ] [New Goblin] bound_address {inet[/0:0:0:0:0:0:0:0:9300]}, publish_address {inet[/192.168.8.112:9300]}
[2014-03-13 13:42:23,030][INFO ][cluster.service] [New Goblin] new_master [New Goblin][rWMtGj3dQouz2r6ZFL9v4g][mwubuntu1][inet[/192.168.8.112:9300]], reason: zen-disco-join (elected_as_master)
[2014-03-13 13:42:23,100][INFO ][discovery      ] [New Goblin] elasticsearch/rWMtGj3dQouz2r6ZFL9v4g
[2014-03-13 13:42:23,125][INFO ][http           ] [New Goblin] bound_address {inet[/0:0:0:0:0:0:0:0:9200]}, publish_address {inet[/192.168.8.112:9200]}
[2014-03-13 13:42:23,629][INFO ][gateway        ] [New Goblin] recovered [1] indices into cluster_state
[2014-03-13 13:42:23,630][INFO ][node           ] [New Goblin] started

너무 상세히 들어가지 말고, "New Goblin"이라고 이름 붙여진 node name을 볼 수 있을 것이다. 단일 cluster에서 master로서 선출되고 실행된 node이다. 지금 순간에 master가 무엇을 의미하는지에 대해서 걱정하지 말라. 여기서 중요한 것은 하나의 cluster에서 하나의 node를 실행했다는 것이다.

이전에 언급한 것처럼, cluster나 node name을 override (재정의) 할 수 있다. Command line에서 elasticsearch를 실행할 때 다음과 같이 할 수 있다.

./elasticsearch --cluster.name my_cluster_name --node.name my_node_name

또한 HTTP 주소와 포트에 대한 정보를 가진 http로 mark된 라인이 접속 가능한 주소임을 주목하라. 기본적으로 elasticsearch는 9200 포트 번호를 사용하여 REST API로 접근할 수 있다. 필요할 때, 이 포트 번호는 설정할 수 있다.