인덱스 템플릿을 생성하려면 다음 단계를 수행하세요.

1. 내비게이션 메뉴 또는 전역 검색 필드를 사용해 Index Management 페이지로 이동합니다.

2. Index Templates 탭에서 Create template을 선택합니다.

   

3. Logistics 페이지에서:

   1. 템플릿 이름을 지정합니다.

   2. 라이프사이클 정책으로 관리할 인덱스와 일치하는 패턴을 지정합니다. 예를 들어 my-index-*와 같이 지정합니다. Elasticsearch 기본 제공 인덱스 템플릿과 이름 패턴이 충돌하지 않도록 주의하세요.

   3. 지속적으로 생성되는 추가 전용(append-only) 데이터를 저장한다면, 더 효율적인 저장을 위해 인덱스 대신 데이터 스트림을 생성하도록 선택할 수 있습니다.

      Note

      데이터 스트림 옵션을 활성화하면 Data retention을 설정하는 옵션도 함께 나타납니다. 데이터 보존은 인덱스 라이프사이클 관리의 대안인 데이터 스트림 라이프사이클을 사용하는 경우에만 적용됩니다. 자세한 내용은 데이터 스트림 라이프사이클을 참고하세요.

   4. 다음을 포함해 원하는 다른 옵션을 구성합니다.

      • 생성되는 인덱스에 사용할 인덱스 모드.
      • 템플릿 우선순위, 버전, 메타데이터.
      • action.auto_create_index 클러스터 설정을 덮어쓸지 여부.

      이 옵션들에 대한 자세한 내용은 create or update index template API 문서를 참고하세요.

4. Component templates 페이지에서는 검색 및 필터 도구를 사용해 인덱스 템플릿에 포함할 컴포넌트 템플릿을 선택할 수 있습니다. 인덱스 템플릿은 컴포넌트 템플릿에 정의된 설정(S), 매핑(M), 별칭(A)을 상속받아 인덱스가 생성될 때 적용합니다.

5. Index settings 페이지에서는 인덱스 설정을 인덱스 템플릿에 직접 정의할 수 있습니다. 컴포넌트 템플릿과 함께 사용하는 경우, 이 페이지에 정의된 매핑이 연결된 컴포넌트 템플릿의 충돌하는 정의를 덮어씁니다.

   1. 선택 사항: 인덱스가 생성될 때 적용되어야 할 추가 인덱스 설정을 추가합니다. 예를 들어 각 인덱스의 샤드 수와 복제본 수를 설정할 수 있고, 인덱스에 적용할 ILM 설정을 지정해 ILM을 구성할 수도 있습니다.

      {
        "index.lifecycle.name": "my_policy",
        "index.lifecycle.rollover_alias": "test-alias",
        "number_of_shards": 1,
        "number_of_replicas": 1
      }
      		

6. 선택 사항: Mappings 페이지에서 문서가 Elasticsearch에 색인될 때 사용되는 필드와 데이터 타입을 사용자 지정합니다. 컴포넌트 템플릿과 함께 사용하는 경우, 이 매핑이 연결된 컴포넌트 템플릿의 충돌하는 정의를 덮어씁니다. 자세한 내용은 매핑을 참고하세요.

   1. 예를 들어 geo라는 object 필드와 그 하위에 coordinates라는 geo_point 필드를 포함하는 매핑을 정의할 수 있습니다.

      또는 Load JSON 링크를 클릭해 매핑을 JSON으로 정의할 수도 있습니다.

      {
        "properties": {
          "geo": {
            "properties": {
              "coordinates": {
                "type": "geo_point"
              }
            }
          }
        }
      }
      		

7. 선택 사항: Aliases 페이지에서 생성되는 각 인덱스에 대한 별칭을 지정합니다. 예를 들어 my-index라는 별칭을 정의할 수 있습니다.

   {
    "my-index": {}
   }
   		

   단, ILM을 구성할 때는 이 설정이 필요하지 않습니다. ILM은 대신 index.lifecycle.rollover_alias 설정을 사용해 롤링 인덱스에 접근합니다.

8. Review 페이지에서 선택 사항을 확인한 뒤 Create template을 선택합니다. 선택한 옵션은 물론, 생성될 인덱스 템플릿의 형식과 연관된 API 요청도 확인할 수 있습니다.

새로 생성된 인덱스 템플릿은 지정한 패턴과 일치하는 이름의 모든 신규 인덱스에 사용되며, 이 인덱스들에는 지정한 ILM 정책이 적용됩니다.

클러스터에 인덱스 템플릿을 추가하려면 create or update index template API를 사용하세요.

다음 요청은 컴포넌트 템플릿 예제에 나온 두 개의 컴포넌트 템플릿으로 구성된 인덱스 템플릿을 생성합니다.

				PUT _index_template/template_1
					{
  "index_patterns": ["te*", "bar*"],
  "template": {
    "settings": {
      "number_of_shards": 1
    },
    "mappings": {
      "_source": {
        "enabled": true
      },
      "properties": {
        "host_name": {
          "type": "keyword"
        },
        "created_at": {
          "type": "date",
          "format": "EEE MMM dd HH:mm:ss Z yyyy"
        }
      }
    },
    "aliases": {
      "mydata": { }
    }
  },
  "priority": 501,
  "composed_of": ["component_template1", "runtime_component_template"],
  "version": 3,
  "_meta": {
    "description": "my custom"
  }
}
		

1. Elasticsearch 기본 제공 인덱스 템플릿과 충돌하지 않는 패턴을 선택하세요.

Kibana의 Index management 페이지에서 컴포넌트 템플릿을 생성, 편집, 복제, 삭제할 수 있습니다. Component Templates 탭으로 이동하세요.

×

• 세부 정보를 보고 작업을 수행하려면 템플릿 이름을 클릭하세요.
• 새 컴포넌트 템플릿을 만들려면 Create component template 마법사를 사용하세요.

component template API를 사용해 컴포넌트 템플릿을 생성하고 관리할 수 있습니다. 다음 요청은 앞선 인덱스 템플릿 예제에서 사용된 두 개의 컴포넌트 템플릿을 생성합니다.

				PUT _component_template/component_template1
					{
  "template": {
    "mappings": {
      "properties": {
        "@timestamp": {
          "type": "date"
        }
      }
    }
  }
}
				PUT _component_template/runtime_component_template
					{
  "template": {
    "mappings": {
      "runtime": {
        "day_of_week": {
          "type": "keyword",
          "script": {
            "source": "emit(doc['@timestamp'].value.dayOfWeekEnum.getDisplayName(TextStyle.FULL, Locale.ENGLISH))"
          }
        }
      }
    }
  }
}
		

1. 이 컴포넌트 템플릿은 새 인덱스가 템플릿에 일치할 때 매핑에 day_of_week라는 런타임 필드를 추가합니다.