Áú»¢¶Ä²©

10 Variables d'entorn

Visi¨® general

Les variables d'entorn permeten configurar components Áú»¢¶Ä²© sense codificar valors en fitxers de configuraci¨®. Aix¨° facilita la gesti¨® de configuracions en entorns din¨¤mics, com ara Docker, on es poden passar variables en temps d'execuci¨® per adaptar-se a diferents configuracions.

En el cas m¨¦s simple, establint el valor del par¨¤metre de configuraci¨® del servidor Áú»¢¶Ä²© DebugLevel a una variable d'entorn, podeu emprar-lo per configurar el servidor a l'inici:

# Fitxer de configuraci¨® del servidor Áú»¢¶Ä²©:
       DebugLevel=${NewDebugLevel}
       
       # Engegada del servidor Áú»¢¶Ä²©:
       NewDebugLevel=5 /usr/sbin/zabbix_server

Les variables d'entorn s¨®n compatibles amb els components Áú»¢¶Ä²© seg¨¹ents:

• Servidor
• Proxy
• Agent (UNIX o Windows)
• Agent 2 (UNIX o Windows), inclosos plugins
• Servei web
• Remitent Áú»¢¶Ä²© (quan s'empra l'opci¨® -c, --config)

Notes importants

• Quan un par¨¤metre de configuraci¨® s'estableix en una variable d'entorn, que no s'especifica en executar el component, s'empra el valor per defecte del par¨¤metre.
• Quan empreu ordres d'execuci¨® (com ara per pujar el nivell de registre de l'agent), s'han d'especificar les variables d'entorn emprades anteriorment. Aix¨° es deu al fet que els components Áú»¢¶Ä²© utilitzen el seu fitxer de configuraci¨® per executar ordres d'execuci¨®; si s'ometen les variables d'entorn, s'empraran els valors predeterminats dels par¨¤metres de configuraci¨®. Veieu Examples.
• L'ordre d'execuci¨® userparameter_reload no admet la rec¨¤rrega de variables d'entorn. Durant la rec¨¤rrega, les variables s'ignoren i nom¨¦s es tornen a carregar els par¨¤metres amb valors regulars.
• Les variables d'entorn actuals del proc¨¦s, que es van emprar als fitxers de configuraci¨®, s'esborren despr¨¦s d'iniciar el component Áú»¢¶Ä²©. Aix¨° garanteix que els processos fills (per exemple, scripts remots executats per Áú»¢¶Ä²©) no puguin accedir a aquestes variables. Tanmateix, tingueu en compte que les variables inicials del proc¨¦s encara es poden recuperar (per exemple, mitjan?ant el fitxer /proc/<PID>/environ).

Sintaxi

Les variables d'entorn han d'emprar la sintaxi seg¨¹ent: ${alphanumerics/underscores}.

El nom de la variable nom¨¦s pot incloure lletres (a-z, A-Z), guions baixos (_) i d¨ªgits (0-9) i no ha de comen?ar amb un d¨ªgit.

Les variables que no coincideixen amb la sintaxi requerida o que es combinen amb un valor regular es tractaran com a valors regulars, que poden produir errors.

Sintaxi de variable correcta:

DebugLevel=${NewDebugLevel}
       Hostname=${ZBX_HOSTNAME}
       LogFile=${LogFile_001}

Sintaxi de variable incorrecta:

DebugLevel=${5_DebugLevel}
       Hostname=${ZBX.HOSTNAME 1}
       LogFile=/${HOME}/zabbix/zabbix_server.log

Exemples

Els exemples seg¨¹ents mostren com configurar i utilitzar variables d'entorn amb components Áú»¢¶Ä²©.

Exemple 1: °ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® i prova de l'agent Áú»¢¶Ä²©

1. Establiu les variables d'entorn al fitxer de configuraci¨® de l'agent:

Hostname=${ZBX_HOSTNAME}
       ServerActive=${ServerActive}

2. Proveu el fitxer de configuraci¨®:

ZBX_HOSTNAME="Nou agent Áú»¢¶Ä²©" ServerActive=127.0.0.1 /usr/sbin/zabbix_agentd -c /etc/zabbix/zabbix_agentd.conf --test-config

3. Inicieu l'agent amb variables d'entorn:

ZBX_HOSTNAME="Nou agent Áú»¢¶Ä²©" ServerActive=127.0.0.1 /usr/sbin/zabbix_agentd -c /etc/zabbix/zabbix_agentd.conf

Quan utilitzeu ordres d'execuci¨® (p. ex., per augmentar el nivell de registre de l'agent), s'han d'especificar les variables d'entorn utilitzades anteriorment:

ZBX_HOSTNAME="Nou agent Áú»¢¶Ä²©" ServerActive=127.0.0.1 /usr/sbin/zabbix_agentd -c /etc/zabbix/zabbix_agentd.conf -R log_level_increase

Aix¨° es deu al fet que l'agent utilitza el seu fitxer de configuraci¨® per executar ordres en temps d'execuci¨®; si s'ometen les variables d'entorn, s'utilitzaran els valors predeterminats dels par¨¤metres de configuraci¨®.

Alternativament, despr¨¦s d'establir variables d'entorn al fitxer de configuraci¨® de l'agent, podeu posar-les a disposici¨® dels processos (p. ex., utilitzant l'ordre "exportar"). Aix¨° redueix el risc de comportament inesperat a causa de variables que falten o que s'estableixen incorrectament.

export ZBX_HOSTNAME="New Áú»¢¶Ä²© agent"
       export ServerActive=127.0.0.1
       /usr/sbin/zabbix_agentd -c /etc/zabbix/zabbix_agentd.conf --test-config
       /usr/sbin/zabbix_agentd -c /etc/zabbix/zabbix_agentd.conf
       /usr/sbin/zabbix_agentd -c /etc/zabbix/zabbix_agentd.conf -R log_level_increase

Exemple 2: °ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® de l'agent Áú»¢¶Ä²© per a un contenidor

Si esteu creant i configurant la vostra pr¨°pia imatge personalitzada per als components Áú»¢¶Ä²© (per exemple, l'agent Áú»¢¶Ä²©), podeu definir par¨¤metres de configuraci¨® mitjan?ant variables d'entorn i, a continuaci¨®, iniciar el contenidor amb aquestes variables.

1. Quan prepareu la imatge, configureu les variables d'entorn al fitxer de configuraci¨® de l'agent:

Hostname=${ZBX_HOSTNAME}
       BufferSize=${BUFSZ}
       ListenPort=${LISTENPORT}
       UserParameter=${_UsrPar01}
       UserParameter=${_UsrPar02}

2. Despr¨¦s de crear la imatge del contenidor, inicieu el contenidor de l'agent (p. ex., Docker) amb variables d'entorn:

docker run --name my-zabbix-agent -e ZBX_HOSTNAME=&±ç³Ü´Ç³Ù;²Ô´Ç³Ü-²Ô´Ç³¾-²¹³¾´Ú¾±³Ù°ù¾±¨®&±ç³Ü´Ç³Ù; -e BUFSZ=1000 -e LISTENPORT=20050 -e _UsrPar01="key1,ls" -e _UsrPar02="key2,pwd" --init -d my-zabbix-agent:darrer

3. Quan utilitzeu comandes d'execuci¨® (p. ex., per augmentar el nivell de registre de l'agent), accediu a l'int¨¨rpret d'ordres del contenidor i executeu l'ordre d'execuci¨®:

docker exec -it <containerid> sh
       /usr/sbin/zabbix_agentd -R log_level_increase

::: nota important L'ordre d'execuci¨® userparameter_reload no admet la rec¨¤rrega de variables d'entorn. Durant la rec¨¤rrega, les variables s'ignoren i nom¨¦s es tornen a carregar els par¨¤metres amb valors regulars. :::