韓誥傭痔

Table of Contents

7 唬棗紳款勳眶喝娶硃釵勳車 d'Elasticsearch

7 唬棗紳款勳眶喝娶硃釵勳車 d'Elasticsearch

El suport d'Elasticsearch 谷s experimental!

韓誥傭痔 admet l'emmagatzematge de dades hist辰riques amb mitjanes d'Elasticsearch amb enlla? a una base de dades. Els usuaris poden triar l'enlla? d'emmagatzematge de dades hist辰riques entre una base de dades compatible i Elasticsearch. El proc谷s de configuraci車 descrit en aquesta secci車 s'aplica a Elasticsearch v7.X. Si s'empra una versi車 anterior o posterior, algunes funcions poden no funcionar pas com es desitgi.

1. Si totes les dades d'hist辰ric s'emmagatzemen a Elasticsearch, les tend豕ncies no s車n pas calculades ni emmagatzemades a la base de dades. Amb abs豕ncia de tend豕ncies calculades i emmagatzemades, el per赤ode d'emmagatzematge de l'hist辰ric podria perllongar-se.
2. Quan s'empra Elasticsearch, les consultes d'interval que recuperen valors de la base de dades estan limitades per la marca de temps del per赤ode d'emmagatzematge de dades.

唬棗紳款勳眶喝娶硃釵勳車

Per assegurar una bona comunicaci車 entre tots els elements implicats, assegureu-vos que els par角metres de l'arxiu de configuraci車 del servidor i de l'arxiu de configuraci車 frontal s車n ben configurats.

Servidor i interf赤cie 韓誥傭痔

Esborrany de l'arxiu de configuraci車 del servidor 韓誥傭痔 amb els par角metres per actualitzar:

### Option: HistoryStorageURL
       # History storage HTTP[S] URL.
       #
       # Mandatory: no
       # Default:
       # HistoryStorageURL= 
       ### Option: HistoryStorageTypes
       # Comma separated list of value types to be sent to the history storage.
       #
       # Mandatory: no
       # Default:
       # HistoryStorageTypes=uint,dbl,str,log,text

Exemples de valeurs de param豕tres pour remplir le fichier de configuration du serveur 韓誥傭痔 :

HistoryStorageURL=http://test.elasticsearch.lan:9200
       HistoryStorageTypes=str,log,text

Cette configuration force le serveur 韓誥傭痔角 stocker les valeurs d'historique de types num谷riques dans la base de donn谷es correspondante et les donn谷es d'historique textuelles dans Elasticsearch.

Elasticsearch prend en charge les types d'谷l谷ments suivants :

uint,dbl,str,log,text

Detall del tipus d'element suportat:

Tipus de valor de l'element	Taula de base de dades	Tipus Elasticsearch
Num豕ric (nno signat)	history_uint	uint
Num豕ric (flotant)	history	dbl
唬硃娶角釵喧梗娶	history_str	str
Journal	history_log	log
Text	history_text	text

Projecte d'arxiu de configuraci車 de la interf赤cie (conf/zabbix.conf.php) amb els par角metres per actualitzar:

// Elasticsearch url (can be string if same url is used for all types).
       $HISTORY['url']   = [
             'uint' => 'http://localhost:9200',
             'text' => 'http://localhost:9200'
       ];
       // Value types stored in Elasticsearch.
       $HISTORY['types'] = ['uint', 'text'];

Exemples de valors de par角metres per omplir l'arxiu de configuraci車 de la interf赤cie 韓誥傭痔:

$HISTORY['url']   = 'http://test.elasticsearch.lan:9200';
       $HISTORY['types'] = ['str', 'text', 'log'];

Aquesta configuraci車 obliga a emmagatzemar els valors d'hist辰ric Text, 唬硃娶角釵喧梗娶 iJournal dins d'Elasticsearch.

Tamb谷谷s necessari establir $HISTORY global a conf/zabbix.conf.php, per assegurar que tot funciona correctament (veieuconf/zabbix.conf.php.example per sapiguer com procedir):

// 韓誥傭痔 GUI configuration file.
       global $DB, $HISTORY;

Instal﹞laci車 d'Elasticsearch i creaci車 del mapatge

Les dues darreres etapes per fer funcionar les coses consisteix en instal﹞lar Elasticsearch i crear un proc谷s de mapatge.

Perr instal﹞lar Elasticsearch, fixeu-vos en la .

El mapatge 谷s una estructura de dades dins d'Elasticsearch (semblant a una taula dins una base de dades). El mapatge de tots els tipus de dades d'hist辰ric 谷s disponible aqu赤: database/elasticsearch/elasticsearch.map.

La creaci車 del mapatge 谷s obligat辰ria. Algunes funcionalitats s'interrompran si el mapatge no 谷s pas creat conforme a les instruccions

Per crear un mapatge per al tipus text, envieu la petici車 seg邦ent a Elasticsearch:

curl -X PUT \
        http://your-elasticsearch.here:9200/text \
        -H 'content-type:application/json' \
        -d '{
          "settings": {
             "index": {
                "number_of_replicas": 1,
                "number_of_shards": 5
             }
          },
          "mappings": {
             "properties": {
                "itemid": {
                   "type": "long"
                },
                "clock": {
                   "format": "epoch_second",
                   "type": "date"
                },
                "value": {
                   "fields": {
                      "analyzed": {
                         "index": true,
                         "type": "text",
                         "analyzer": "standard"
                      }
                   },
                   "index": false,
                   "type": "text"
                }
             }
          }
       }'

Una petici車 similar s'ha d'executar per la creaci車 del mapatge dels valors d'hist辰ric Character iLog amb la correcci車 de tipus corresponent.

Per treballar amb Elasticsearch, consulteu la p角gina de requisits per tindre m谷s informaci車.

La neteja no esborra pas cap dada d'Elasticsearch.

Emmagatzematge de les dades d'hist辰ric a diversos 赤ndexs basats en dades

Aquesta secci車 descriu les etapes addicionals necess角ries per treballar amb pipelines i ingerir nodes.

Per comen?er, heu de creear els models per l'赤ndex.

L'exemple seg邦ent mostra una petici車 de creaci車 de model uint:

curl -X PUT \
        http://your-elasticsearch.here:9200/_template/uint_template \
        -H 'content-type:application/json' \
        -d '{
          "index_patterns": [
             "uint*"
          ],
          "settings": {
             "index": {
                "number_of_replicas": 1,
                "number_of_shards": 5
             }
          },
          "mappings": {
             "properties": {
                "itemid": {
                   "type": "long"
                },
                "clock": {
                   "format": "epoch_second",
                   "type": "date"
                },
                "value": {
                   "type": "long"
                }
             }
          }
       }'

Per crear altres models, l'usuari ha de modificar l'URL (la darrera part 谷s el nom del model), modificar el camp "index_patterns" per tal que es correspongui amb el nom de l'赤ndex i per definir un mapatge v角lid, que es pugui extreure de database/elasticsearch/elasticsearch.map.

Per exemple, la comanda seg邦ent es pot emprar per crear un model per l'赤ndex de text:

curl -X PUT \
        http://your-elasticsearch.here:9200/_template/text_template \
        -H 'content-type:application/json' \
        -d '{
          "index_patterns": [
             "text*"
          ],
          "settings": {
             "index": {
                "number_of_replicas": 1,
                "number_of_shards": 5
             }
          },
          "mappings": {
             "properties": {
                "itemid": {
                   "type": "long"
                },
                "clock": {
                   "format": "epoch_second",
                   "type": "date"
                },
                "value": {
                   "fields": {
                      "analyzed": {
                         "index": true,
                         "type": "text",
                         "analyzer": "standard"
                      }
                   },
                   "index": false,
                   "type": "text"
                }
             }
          }
       }'

Aix辰谷s necessari per permetre que Elasticsearch defineixi un mapatge v角lid per els 赤ndexs creats autom角ticament. Despr谷s, cal crear la definici車 de la pipeline. La pipeline 谷s una sortida de pretractament de les dades abans de posar les dades als 赤ndexs. La comanda seg邦ent es pot emprar per crear una pipeline per l'赤ndex uint:

curl -X PUT \
        http://your-elasticsearch.here:9200/_ingest/pipeline/uint-pipeline \
        -H 'content-type:application/json' \
        -d '{
          "description": "daily uint index naming",
          "processors": [
             {
                "date_index_name": {
                   "field": "clock",
                   "date_formats": [
                      "UNIX"
                   ],
                   "index_name_prefix": "uint-",
                   "date_rounding": "d"
                }
             }
          ]
       }'

L'usuari pot modificar el par角metre d'arrodonir ("date_arrondi") per definir un per赤ode de rotaci車 espec赤fic de l'赤ndex. Per crear altres pipelines, l'usuari ha de canviar l'URL (la darrera part 谷s el nom de la pipeline) i canviar el camp "index_name_prefix" per fer que es correspongui amb el nom de l'赤ndex.

Veieu tamb谷 la .

A m谷s, l'emmagatzematge de dades d'hist辰ric a diversos 赤ndexs basats en la data s'ha d'activar igualment al nou par角metre de la configuraci車 del servidor 韓誥傭痔:

### Option: HistoryStorageDateIndex
       # Enable preprocessing of history values in history storage to store values in different indices based on date.
       # 0 - disable
       # 1 - enable
       #
       # Mandatory: no
       # Default:
       # HistoryStorageDateIndex=0

Problemes

Les seg邦ents etapes us poden ajudar a resoldre els problemes vinculats a la configuraci車 d'Elasticsearch:

Verifiqueu si el mapatge 谷s correcte (petici車 GET a l'URL d'赤ndex consultat com a http://localhost:9200/uint).
Verifiqueu si els fragments no s車n pas en estat fallit (el reinici d'Elasticsearch hauria d'ajudar).
Verifiqueu la configuraci車 d'Elasticsearch. La configuraci車 ha de permetre l'acc谷s despr谷s de l'equip frontal 韓誥傭痔 i l'equip del servidor 韓誥傭痔.
Verifiqueu els registres d'Elasticsearch.
LogSlowQueries es pot emprar per comprovar si hi ha consultes lentes a la base de dades d'Elasticsearch.

Si seguiu trobant problemes amb la vostra instal﹞laci車, mireu de crear un informe d'errors amb tota la informaci車 d'aquesta llista (mapatge, informe d'errors, configuraci車, versi車, etc.)