<div id="readability-page-1" class="page"><article>
    <div>

                
                
                
                <p>ElasticSearch를 로그 분석용으로 사용할 때 인덱스의 <code>mapping</code>은 <code>template</code>을 사용해서 생성되도록 설정하면 편리하다.</p>
<p>로그 분석용으로 ElasticSearch 를 사용하면 주로 인덱스는 daily/weekly/monthly 중에 하나로 구성하는게 일반적이다.
동일한 유형의 인덱스를 계속해서 생성하게 되는데, 예를 들자면 nginx log의 인덱스를 다음과 같이 생성한다고 해보자.</p>
<ul>
<li>nginx-access-log-2018.06.20</li>
<li>nginx-access-log-2018.06.21</li>
<li>nginx-access-log-2018.06.22</li>
<li>nginx-access-log-2018.06.23</li>
<li>…</li>
</ul>
<p>위와 같은 인덱스를 자동으로 생성할 때 사용 할 <code>mapping</code>을 미리 지정할 수 있는데 이 기능이 바로 <code>template</code> 이다.</p>
<h3 id="템플릿-생성하기">템플릿 생성하기</h3>
<p>다음은 <code>nginx-access-log</code> 라는 템플릿을 생성하는 것으로, 인덱스가 <code>nginx-access-*</code> 에 해당하는 패턴이라면, 지정된 <code>mapping</code> 으로 인덱스를 생성한다.</p>
<pre><code>## nginx-access-log 템플릿 생성
curl -X "PUT" "http://my-elasticsearch-server-host:9200/_template/nginx-access-log" \
     -H 'Content-Type: application/json; charset=utf-8' \
     -d $'{
  "index_patterns": [
     "nginx-access-*"
  ],
  "mappings": {
    "log": { // type name
      "properties": {
        "ip": {
          "type": "text"
        },
        "host": {
          "type": "keyword"
        },
        "uri": {
          "type": "text"
        },
        "datetime": {
          "type": "date"
        },
        "@timestamp": {
          "type": "date"
        }
      }
    }
    ........
  }
}'

</code></pre><h3 id="setting-설정하기"><code>setting</code> 설정하기</h3>
<p><code>mapping</code> 뿐만 아니라 <code>setting</code> 도 지정할 수 있다.</p>
<pre><code>curl -X "PUT" "http://my-elasticsearch-server-host:9200/_template/new-template-name" \
     -d $'{
  "index_patterns": [
       "nginx-access-*"
  ],
  "settings": { // setting
    "number_of_shards": 1
  },
  "mappings": {
    "type1": {
      "properties": {
        "host_name": {
          "type": "keyword"
        },
        "created_at": {
          "type": "date",
          "format": "EEE MMM dd HH:mm:ss Z YYYY"
        }
      }
    }
  }
}'

</code></pre><h3 id="여러개의-패턴-지정하기">여러개의 패턴 지정하기</h3>
<p>인덱스 패턴을 여러개를 지정하고자 할 때는 배열 안에 계속 추가하면 된다.</p>
<pre><code>curl -X "PUT" "http://my-elasticsearch-server-host:9200/_template/new-template-name" \
     -d $'{
  "index_patterns": [
       "pattern1*",
       "pattern2*",
       "pattern3*",
       "pattern4*"
  ],
  "settings": { // setting
    "number_of_shards": 1
  },
  "mappings": {
    "type1": {
      "properties": {
        "host_name": {
          "type": "keyword"
        },
        "created_at": {
          "type": "date",
          "format": "EEE MMM dd HH:mm:ss Z YYYY"
        }
      }
    }
  }
}'

</code></pre><h3 id="참고">참고</h3>
<ul>
<li><a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-templates.html">https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-templates.html</a></li>
</ul>

                

                <hr>
                

                





<p><a href="https://disqus.com/">comments powered by </a>



            </p></div>
</article></div>

Soo Story

Jung-Soo Ahn

ElasticSearch를 로그 분석용으로 사용할 때 인덱스의 mapping은 template을 사용해서 생성되도록 설정하면 편리하다.

ElasticSearch 에서 template 을 활용하는 방법

댓글