6 Configuració TimescaleDB

Vista general

Zabbix suporta TimescaleDB, una solució de base de dades basada en PostgreSQL que parteix automàticament les dades en blocs temporals per suportar rendiment ràpid a gran escala.

Les instruccions d'aquesta pàgina es poden emprar per als escenaris següents:

• Creació d'una base de dades TimescaleDB o migració de taules PostgreSQL existents a TimescaleDB (veieu Configuració).
• Actualització d'un esquema de base de dades TimescaleDB existent quan actualitzeu Zabbix (veieu Actualització de l'esquema TimescaleDB).

Configuració

Assumim que l'extensió TimescaleDB ja s'ha instal·lat al servidor de base de dades (veieu les instruccions d'instal·lació).

L'extensió de TimescaleDB s'ha d'activar per la DB específica, executant:

echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix

Per executar aquesta comanda cal privilegis d'administrador de la base de dades.

Després, executeu l'script postgresql/timescaledb/schema.sql. Per a installacions noves, l'script ha de córrer després de que la base de dades PostgreSQL s'hagi creat amb l'esquema inicial esquema/dades (veieu creació de base de dades):

cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix

La migració de l'historial i informació de tendències existents pot dur molt de temps. El servidor Zabbix i el frontal s'aturaran durant el període de migració.

L'script schema.sql estableix els següents paràmetres de neteja:

• Sobreescriure l'element del període històric
• Sobreescriure l'element del període de tendències

Per emprar neteja particionada per l'històric i les tendències, ambdós paràmetres s'han d'activar. També és possible activar la sobreescriptura individualment només per històric o tendències.

L'script postgresql/timescaledb/schema.sql estableix dos paràmetres més:

• Permetre compressió
• Comprimir els registres anteriors a 7 dies

S'està actualitzant l'esquema de TimescaleDB

Quan actualitzeu Zabbix a una versió que conté noves hipertaules TimescaleDB, el servidor Zabbix no configura automàticament aquestes hipertaules (per exemple, quan s'actualitza de Zabbix 6.4 a 7.2, ja que les versions 7.0.0 i 7.0.2 han introduït noves hipertaules).

Per configurar noves hipertaules TimescaleDB, seguiu aquests passos:

1. Inicieu el servidor Zabbix; això actualitza la base de dades existent.
2. Comproveu al fitxer de registre del servidor que s'ha completat l'actualització de la base de dades; quan s'hagi completat, atureu el servidor Zabbix. Tingueu en compte que el servidor registra un avís si intenta habilitar la compressió per a una taula que no és una hipertaula.
3. Executeu l'script postgresql/timescaledb/schema.sql; això configura les noves hipertaules TimescaleDB. Tingueu en compte que, des de Zabbix 7.0.0, la ubicació i el nom de l'script han canviat de postgresql/timescaledb.sql a postgresql/timescaledb/schema.sql.

Per esborrar correctament les dades comprimides per la neteja, les opcions Anul·lar el període d'historial d'elements i Anul·lar del període de tendència d'elements han d'esser habilitades. Si la substitució és desactivada i les taules tenen fragments comprimits, la neteja no treurà pas dades d'aquestes taules i es veuran avisos sobre una configuració incorrecta a les seccions Neteja i Informació del sistema.

Tots aquests paràmetres es poden modificar des d'Administració → Neteja després de la instal·lació.

Compressió TimescaleDB

La compressió nadiua de TimescaleDB és suportada a partir de Zabbix 5.0 per a PostgreSQL versió 10.2 o superior i TimescaleDB versió 1.5 o superior per totes les taules Zabbix gestionades per TimescaleDB. Mentre s'actualitza o es migra cap a TimescaleDB, la compressió inicial de les taules grans pot prendre molt de temps.

Veieu que la compressió és admesa sota la llicència "timescale" Timescale Community i que no s'admet sota la llicència "apache" Apache 2.0. A partir de Zabbix 6.0.7, Zabbix detecta si la compressió és admesa; si no ho és pas, escriu un missatge d'advertència al registre del servidor Zabbix i els usuaris no poden pas activar la compressió a la interfície.

Veieu que hi ha algunes limitacions imposades per la compressió en particular:

• Les modificacions de blocs comprimits (insercions, supressions, actualitzacions) no són pas permeses.
• Les modificacions de esquema de les taules comprimides no són pas permeses.

Els paràmetres de compressió es poden modificar al bloc Compressió de l'històric i de les tendències, a la secció Administració → Neteja de la interfície Zabbix.