ru:manual:appendix:install:elastic_search_setup

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
ru:manual:appendix:install:elastic_search_setup [2021/04/01 10:45]
marinagen updated supported version, added warning about trends
ru:manual:appendix:install:elastic_search_setup [2021/04/01 10:47] (current)
marinagen
Line 1: Line 1:
-==== Установка Elasticsearch ====+==== Установка Elasticsearch ====
  
 <note important>​Поддержка Elasticsearch экспериментальная! </​note>​ <note important>​Поддержка Elasticsearch экспериментальная! </​note>​
  
-Zabbix поддерживает хранение данных истории в Elasticsearch вместо базы данных. Теперь пользователям предоставляется возможность выбора места хранения данных истории между совместимой базой данных и Elasticsearch. ​ Процедура установки,​ которая рассматривается в этом разделе,​ применима к Elasticsearch:​ **7.X**. В случае,​ если используется более старая или более новая версия Elasticsearch,​ некоторый функционал может не работать должным образом.+Zabbix ​недавно начал ​поддерживать хранение данных истории в Elasticsearch вместо базы данных. Теперь пользователям предоставляется возможность выбора места хранения данных истории между совместимой базой данных и Elasticsearch. Процедура установки,​ которая рассматривается в этом разделе,​ применима к следующим версиям ​Elasticsearch:​ **7.x**. В случае,​ если используется более старая или более новая версия Elasticsearch,​ некоторый функционал может не работать должным образом.
  
-<note warning> ​ Если все данные истории хранятся в Elasticsearch,​ тренды не вычисляются и не сохраняются в базу данных. ​Без вычисления и сохранения трендов может потребоваться ​увеличить ​период хранения истории. </​note>​+<note warning> Если все данные истории хранятся в Elasticsearch,​ тренды не рассчитываются и не сохраняются в базе данных. ​Если тренды не рассчитываются и не сохраняются, период хранения ​истории ​может потребоваться продлить.</​note>​
  
 === Настройка === === Настройка ===
Line 84: Line 84:
  -H '​content-type:​application/​json'​ \  -H '​content-type:​application/​json'​ \
  -d '{  -d '{
-   "​settings"​ : { +   "​settings":​ { 
-      "​index"​ : { +      "​index":​ { 
-         "​number_of_replicas"​ : 1, +         "​number_of_replicas":​ 1, 
-         "​number_of_shards"​ : 5+         "​number_of_shards":​ 5
       }       }
    },    },
-   "​mappings"​ : { +   "​mappings":​ { 
-      "values" : { +      "properties": { 
-         "​properties" : { +         "​itemid": { 
-            "itemid" : { +            "type": "​long"​ 
-               "​type"​ : "long"+         }, 
 +         "​clock":​ { 
 +            "​format":​ "​epoch_second",​ 
 +            "​type":​ "​date"​ 
 +         }, 
 +         "​value":​ { 
 +            "​fields": { 
 +               "​analyzed":​ { 
 +                  "​index":​ true, 
 +                  ​"​type":​ "text"
 +                  "​analyzer":​ "​standard"​ 
 +               }
             },             },
-            ​"​clock"​ : { +            "​index":​ false, 
-               "​format"​ : "​epoch_second",​ +            "​type":​ "​text"​
-               "​type"​ : "​date"​ +
-            }, +
-            "​value"​ : { +
-               "​fields"​ : { +
-                  "​analyzed"​ : { +
-                     "​index"​ : true, +
-                     "​type"​ : "​text",​ +
-                     "​analyzer"​ : "​standard"​ +
-                  } +
-               }, +
-               "​index"​ : false, +
-               ​"​type"​ : "​text"​ +
-            }+
          }          }
       }       }
Line 121: Line 119:
 <​note>​Чтобы работать с Elasticsearch,​ пожалуйста,​ обратитесь к [[ru:​manual:​installation:​requirements#​сервер|странице требований]] для получения более подробной информации.</​note> ​ <​note>​Чтобы работать с Elasticsearch,​ пожалуйста,​ обратитесь к [[ru:​manual:​installation:​requirements#​сервер|странице требований]] для получения более подробной информации.</​note> ​
  
-<​note>​[[ru:​manual:​installation:​requirements|Очистка истории]] не удаляет никакие данные ​с Elasticsearch.</​note>​+<​note>​[[ru:​manual:​installation:​requirements|Очистка истории]] не удаляет никакие данные ​из Elasticsearch.</​note>​
  
 === Запись данных истории в несколько индексов на основе даты === === Запись данных истории в несколько индексов на основе даты ===
Line 134: Line 132:
  -H '​content-type:​application/​json'​ \  -H '​content-type:​application/​json'​ \
  -d '{  -d '{
-   "​template": "​uint*"​, +   "​index_patterns": ​
-   "​index_patterns":​ ["​uint*"​], +      ​"​uint*"​ 
-   "​settings"​ : { +   ], 
-      "​index"​ : { +   "​settings":​ { 
-         "​number_of_replicas"​ : 1, +      "​index":​ { 
-         "​number_of_shards"​ : 5+         "​number_of_replicas":​ 1, 
 +         "​number_of_shards":​ 5
       }       }
    },    },
-   "​mappings"​ : { +   "​mappings":​ { 
-      "values" : { +      "properties": { 
-         "​properties" : { +         "​itemid": { 
-            ​"​itemid"​ : { +            "​type":​ "​long"​ 
-               "​type"​ : "​long"​ +         ​}, 
-            }, +         ​"​clock":​ { 
-            "​clock"​ : { +            "​format":​ "​epoch_second",​ 
-               ​"​format"​ : "​epoch_second",​ +            "​type":​ "​date"​ 
-               ​"​type"​ : "​date"​ +         ​}, 
-            }, +         ​"​value":​ { 
-            "​value"​ : { +            "​type":​ "​long"​
-               ​"​type"​ : "​long"​ +
-            }+
          }          }
       }       }
Line 168: Line 165:
  -H '​content-type:​application/​json'​ \  -H '​content-type:​application/​json'​ \
  -d '{  -d '{
-   "​template": "​text*"​, +   "​index_patterns": ​
-   "​index_patterns":​ ["​text*"​], +      ​"​text*"​ 
-   "​settings"​ : { +   ], 
-      "​index"​ : { +   "​settings":​ { 
-         "​number_of_replicas"​ : 1, +      "​index":​ { 
-         "​number_of_shards"​ : 5+         "​number_of_replicas":​ 1, 
 +         "​number_of_shards":​ 5
       }       }
    },    },
-   "​mappings"​ : { +   "​mappings":​ { 
-      "values" : { +      "properties": { 
-         "​properties" : { +         "​itemid": { 
-            "itemid" : { +            "type": "​long"​ 
-               "​type"​ : "long"+         }, 
 +         "​clock":​ { 
 +            "​format":​ "​epoch_second",​ 
 +            "​type":​ "​date"​ 
 +         }, 
 +         "​value":​ { 
 +            "​fields": { 
 +               "​analyzed":​ { 
 +                  "​index":​ true, 
 +                  ​"​type":​ "text"
 +                  "​analyzer":​ "​standard"​ 
 +               }
             },             },
-            ​"​clock"​ : { +            "​index":​ false, 
-               "​format"​ : "​epoch_second",​ +            "​type":​ "​text"​
-               "​type"​ : "​date"​ +
-            }, +
-            "​value"​ : { +
-               "​fields"​ : { +
-                  "​analyzed"​ : { +
-                     "​index"​ : true, +
-                     "​type"​ : "​text",​ +
-                     "​analyzer"​ : "​standard"​ +
-                  } +
-               }, +
-               "​index"​ : false, +
-               ​"​type"​ : "​text"​ +
-            }+
          }          }
       }       }
Line 210: Line 206:
  -H '​content-type:​application/​json'​ \  -H '​content-type:​application/​json'​ \
  -d '{  -d '{
-  ​"​description":​ "daily uint index naming",​ +   "​description":​ "daily uint index naming",​ 
-  "​processors":​ [ +   ​"​processors":​ [ 
-    +      
-      "​date_index_name":​ { +         ​"​date_index_name":​ { 
-        "​field":​ "​clock",​ +            "​field":​ "​clock",​ 
-        "​date_formats":​ ["​UNIX"​],​ +            "​date_formats":​ [ 
-        "​index_name_prefix":​ "​uint-",​ +               "​UNIX"​ 
-        "​date_rounding":​ "​d"​+            ​], 
 +            "​index_name_prefix":​ "​uint-",​ 
 +            "​date_rounding":​ "​d"​ 
 +         }
       }       }
-    } +   ]
-  ​]+
 }' }'
 </​code>​ </​code>​
Line 226: Line 224:
 Пользователь может изменить параметр округления ("​date_rounding"​),​ чтобы задать спефицичный период ротации индекса. Для создания остальных конвейером пользователю необходимо изменить URL (последняя часть имени конвейера) и изменить поле "​index_name_prefix",​ чтобы оно соответствовало имени индекса. Пользователь может изменить параметр округления ("​date_rounding"​),​ чтобы задать спефицичный период ротации индекса. Для создания остальных конвейером пользователю необходимо изменить URL (последняя часть имени конвейера) и изменить поле "​index_name_prefix",​ чтобы оно соответствовало имени индекса.
  
-Смотрите также [[https://​www.elastic.co/​guide/​en/​elasticsearch/​reference/​master/​date-index-name-processor.html|Elasticsearch ​документацию]] [en].+Смотрите также ​документацию ​[[https://​www.elastic.co/​guide/​en/​elasticsearch/​reference/​master/​date-index-name-processor.html|Elasticsearch]] [en].
  
 Кроме того, запись данных истории в несколько индексов на основе даты необходимо также включить в новом параметре в конфигурации Zabbix сервера:​ Кроме того, запись данных истории в несколько индексов на основе даты необходимо также включить в новом параметре в конфигурации Zabbix сервера:​
Line 248: Line 246:
   - Проверьте журналы Elasticsearch.  ​   - Проверьте журналы Elasticsearch.  ​
  
-Если у вас по-прежнему возникают проблемы с вашей инсталляцией,​ пожалуйста,​ создайте отчет об ошибке со всем информацией из этого списка (сопоставления,​ журналы ошибок,​ настройка,​ версия и так далее)+Если у вас по-прежнему возникают проблемы с вашей инсталляцией,​ пожалуйста,​ создайте отчет об ошибке со всей информацией из этого списка (сопоставления,​ журналы ошибок,​ настройка,​ версия и так далее)
  
   ​   ​
-