50_Index_templates.asciidoc 1.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. [[index-templates]]
  2. === 索引模板
  3. Elasticsearch 不要求你在使用一个索引前创建它。((("indices", "templates")))((("scaling", "index templates and")))((("templates", "index")))
  4. 对于日志记录类应用,依赖于自动创建索引比手动创建要更加方便。
  5. Logstash 使用事件中的时间戳((("Logstash")))((("timestamps, use by Logstash to create index names")))来生成索引名。
  6. 默认每天被索引至不同的索引中,因此一个 `@timestamp` 为 `2014-10-01 00:00:01` 的事件将被发送至索引 `logstash-2014.10.01` 中。
  7. 如果那个索引不存在,它将被自动创建。
  8. 通常我们想要控制一些新建索引的设置(settings)和映射(mappings)。也许我们想要限制分片数为 `1` ,并且禁用 `_all` 域。
  9. 索引模板可以用于控制何种设置(settings)应当被应用于新创建的索引:
  10. [source,json]
  11. -------------------------
  12. PUT /_template/my_logs <1>
  13. {
  14. "template": "logstash-*", <2>
  15. "order": 1, <3>
  16. "settings": {
  17. "number_of_shards": 1 <4>
  18. },
  19. "mappings": {
  20. "_default_": { <5>
  21. "_all": {
  22. "enabled": false
  23. }
  24. }
  25. },
  26. "aliases": {
  27. "last_3_months": {} <6>
  28. }
  29. }
  30. -------------------------
  31. <1> 创建一个名为 `my_logs` 的模板。
  32. <2> 将这个模板应用于所有以 `logstash-` 为起始的索引。
  33. <3> 这个模板将会覆盖默认的 `logstash` 模板,因为默认模板的 `order` 更低。
  34. <4> 限制主分片数量为 `1` 。
  35. <5> 为所有类型禁用 `_all` 域。
  36. <6> 添加这个索引至 `last_3_months` 别名中。
  37. 这个模板指定了所有名字以 `logstash-` 为起始的索引的默认设置,不论它是手动还是自动创建的。
  38. 如果我们认为明天的索引需要比今天更大的容量,我们可以更新这个索引以使用更多的分片。
  39. 这个模板还将新建索引添加至了 `last_3_months` 别名中,然而从那个别名中删除旧的索引则需要手动执行。