en-us	 ##### proc.get[<name>,<user>,<cmdline>,<mode>]  <br> The list of OS processes and their parameters. Can be used for low-level discovery.<br> Return value: *JSON object*.<br> [Supported platforms](#supported-platforms): Linux, FreeBSD, Windows, OpenBSD, NetBSD.  Parameters:  -   **name** - the process name (default *all processes*); -   **user** - the user name (default *all users*); -   **cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview)). This parameter is not supported for Windows; on other platforms it is not supported if mode is set to 'summary'. -   **mode** - possible values:<br>*process* (default), *thread* (not supported for NetBSD), *summary*. See a list of [process parameters](/manual/appendix/items/proc_get) returned for each mode and OS.  Comments:  -   If a value cannot be retrieved, for example, because of an error (process already died, lack of permissions, system call failure), `-1` will be returned; -   See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).  Examples:      proc.get[zabbix_server,zabbix,,process] #list of all zabbix_server processes running under the zabbix user, returns one entry per PID     proc.get[java,,,thread] #list of all Java processes, returns one entry per thread     proc.get[,zabbix,,summary] #combined data for processes of each type running under the zabbix user, returns one entry per process name
ca	 ##### proc.get[<name>,<user>,<cmdline>,<mode>]  <br> Llistat de processos del sistema operatiu i els seus paràmetres. Es pot emprar per a la descoberta de baix nivell.<br> Valor de retorn: *objecte JSON*.<br> [Plataformes admeses](#supported-platforms): Linux, FreeBSD, Windows, OpenBSD, NetBSD.  Paràmetres:  - **nom** - nom del procés (per defecte *tots els processos*); - **usuari** - nom d'usuari (per defecte *tots els usuaris*); - **cmdline** - filtra per línia d'ordres (és una [expressió regular](/manual/regular_expressions#overview)). Aquest paràmetre no és compatible amb Windows; en altres plataformes no s'admet si el mode és configurat com a 'resum'. - **mode** - valors possibles:<br>*procés* (per defecte), *fil* (no compatible amb NetBSD), *resum*. Veieu una llista de [paràmetres de procés](/manual/appendix/items/proc_get) retornats per a cada mode i sistema operatiu.  Comentaris:  - Si no es pot recuperar un valor, per exemple, a causa d'un error (procés ja mort, falta de permisos, fallada de la trucada del sistema), es retornarà `-1`; - Veieu [notes](/manual/appendix/items/proc_mem_num_notes) sobre la selecció de processos amb paràmetres `name` i `cmdline` (específics de Linux).  Exemples:       proc.get[zabbix_server,zabbix,,process] #llistat de tots els processos Zabbix que fa córrer l'usuari Zabbix, retorna una entrada per PID      proc.get[java,,,thread] #llistat de tots els processos Java, retorna una entrada per fil      proc.get[,zabbix,,summary] #dades combinades per als processos Zabbix de cada tipus, retorna una entrada per nom de procés

en-us	 ##### proc_info[process,<attribute>,<type>] {#proc-info}  <br> Various information about specific process(es).<br> Return value: *Float*.  Parameters:  -   **process** - the process name;<br> -   **attribute** - the requested process attribute;<br> -   **type** - the representation type (meaningful when more than one process with the same name exists)  Comments:  -   The following `attributes` are supported:<br>*vmsize* (default) - size of process virtual memory in Kbytes<br>*wkset* - size of process working set (amount of physical memory used by process) in Kbytes<br>*pf* - number of page faults<br>*ktime* - process kernel time in milliseconds<br>*utime* - process user time in milliseconds<br>*io\_read\_b* - number of bytes read by process during I/O operations<br>*io\_read\_op* - number of read operation performed by process<br>*io\_write\_b* - number of bytes written by process during I/O operations<br>*io\_write\_op* - number of write operation performed by process<br>*io\_other\_b* - number of bytes transferred by process during operations other than read and write operations<br>*io\_other\_op* - number of I/O operations performed by process, other than read and write operations<br>*gdiobj* - number of GDI objects used by process<br>*userobj* - number of USER objects used by process;<br> -   Valid `types` are:<br>*avg* (default) - average value for all processes named <process><br>*min* - minimum value among all processes named <process><br>*max* - maximum value among all processes named <process><br>*sum* - sum of values for all processes named <process>; -   *io\_\**, *gdiobj* and *userobj* attributes are available only on Windows 2000 and later versions of Windows, not on Windows NT 4.0; -   On a 64-bit system, a 64-bit Zabbix agent is required for this item to work correctly.<br>  Examples:      proc_info[iexplore.exe,wkset,sum] #retrieve the amount of physical memory taken by all Internet Explorer processes     proc_info[iexplore.exe,pf,avg] #retrieve the average number of page faults for Internet Explorer processes
ca	 ##### proc_info[process,<attribute>,<type>] {#proc-info}  <br> Diversa informació sobre processos específics.<br> Valor de retorn: *Flotant*.  Paràmetres:  - **procés** - nom del procés;<br> - **atribut** - atribut de procés sol·licitat;<br> - **tipus** - tipus de representació (significatiu quan existeix més d'un procés amb el mateix nom)  Comentaris:  - S'admeten els següents "atributs":<br>*vmsize* (per defecte) - mida de la memòria virtual del procés en koctets<br>*wkset* - mida del conjunt de treball del procés (cantitat de memòria física emprada pel procés) en koctets<br>*pf* - nombre d'errors de pàgina<br>*ktime* - temps de processament del nucli en mil·lisegons<br>*utime* - temps de processament de l'usuari en mil·lisegons<br>*io\_read\_b* - nombre d'octets llegits per procés durant les operacions d'E/S<br>*io\_read\_op* - nombre d'operacions de lectura realitzades pel procés<br>*io\_write\_b* - nombre d'octets escrits pel procés durant les operacions d'E/S<br>* io\_write\_op* - nombre d'operacions d'escriptura realitzades pel procés<br>*io\_other\_b* - nombre d'octets transferits pel procés durant operacions diferents de les operacions de lectura i escriptura<br>*io\_other\_op* - nombre d'operacions d'E/S realitzades pel procés, a part de les operacions de lectura i escriptura<br>*gdiobj* - nombre d'objectes GDI emprats pel procés<br>*userobj* - nombre d'objectes USER emprats pel procés;<br> - Els "tipus" vàlids són:<br>*mitjana* (per defecte) - valor mitjà per a tots els processos anomenats <br>procés><br>*min* - valor mínim entre tots els processos anomenats <br>procés><br>*max* - màxim valor entre tots els processos anomenats <procés><br>*sum* - suma de valors per a tots els processos anomenats <procés>; - Els atributs *io\_\**, *gdiobj* i *userobj* només són disponibles a Windows 2000 i versions posteriors de Windows, no a Windows NT 4.0; - En un sistema de 64 bits, cal un agent Zabbix de 64 bits perquè aquest element funcioni correctament.<br>  Exemples:       proc_info[iexplore.exe,wkset,sum] #recuperar la quantitat de memòria física ocupada per tots els processos d'Internet Explorer      proc_info[iexplore.exe,pf,avg] #recuperar el nombre mitjà d'errors de pàgina per als processos d'Internet Explorer

en-us	 ##### proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>]  <br> The memory used by the process in bytes.<br> Return value: *Integer* - with `mode` as *max*, *min*, *sum*; *Float* - with `mode` as *avg*<br> [Supported platforms](#supported-platforms): Linux, FreeBSD, Solaris, AIX, Tru64, OpenBSD, NetBSD.  Parameters:  -   **name** - the process name (default is *all processes*); -   **user** - the user name (default is *all users*); -   **mode** - possible values: *avg*, *max*, *min*, or *sum* (default); -   **cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview)); -   **memtype** - the [type of memory](/manual/appendix/items/proc_mem_notes) used by process  Comments:  -   The `memtype` parameter is supported only on Linux, FreeBSD, Solaris^**[6](#footnotes)**^, AIX; -   When several processes use shared memory, the sum of memory used by processes may result in large, unrealistic values.<br><br>See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).<br><br>When this item is invoked from the command line and contains a command line parameter (e.g. using the agent test mode: `zabbix_agentd -t proc.mem[,,,apache2]`), one extra process will be counted, as the agent will count itself.  Examples:      proc.mem[,root] #the memory used by all processes running under the "root" user     proc.mem[zabbix_server,zabbix] #the memory used by all zabbix_server processes running under the zabbix user     proc.mem[,oracle,max,oracleZABBIX] #the memory used by the most memory-hungry process running under Oracle having oracleZABBIX in its command line
ca	 ##### proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>]  <br> Memòria emprada pel procés en octets.<br> Valor de retorn: *Enter* - amb `mode` com a *max*, *min*, *sum*; *Float* - amb `mode` com a *mitjana*<br> [Plataformes admeses](#supported-platforms): Linux, FreeBSD, Solaris, AIX, Tru64, OpenBSD, NetBSD.  Paràmetres:  - **nom** - nom del procés (per defecte és *tots els processos*); - **usuari** - nom d'usuari (el valor per defecte és *tots els usuaris*); - **mode** - valors possibles: *mitjana*, *max*, *min* o *sum* (per defecte); - **cmdline** - filtra per línia d'ordres (és una [expressió] regular (/manual/regular_expressions#overview)); - **memtype** - [tipus de memòria](/manual/appendix/items/proc_mem_notes) emprada pel procés  Comentaris:  - El paràmetre `memtype` només és compatible amb Linux, FreeBSD, Solaris^**[6](#footnotes)**^, AIX; - Quan diversos processos empren memòria compartida, la suma de memòria emprada pels processos pot donar lloc a valors grans i poc realistes.<br><br>Veieu [notes](/manual/appendix/items/proc_mem_num_notes) sobre la selecció de processos amb `name` i paràmetres `cmdline` (específics de Linux).<br><br>Quan aquest element s'invoca des de la línia d'ordres i conté un paràmetre de línia d'ordres (p. ex., emprant el mode de prova de l'agent: `zabbix_agentd -t proc.mem[,,,apache2]`), es comptarà un procés addicional, ja que l'agent es comptarà a ell mateix.  Exemples:       proc.mem[,root] #la memòria emprada per tots els processos que s'executen sota l'usuari "arrel".      proc.mem[zabbix_server,zabbix] #la memòria emprada per tots els processos zabbix_server que s'executen sota l'usuari zabbix      proc.mem[,oracle,max,oracleZABBIX] #la memòria emprada pel procés amb més memòria que s'executa sota Oracle amb oracleZABBIX a la seva línia d'ordres

en-us	 ##### proc.num[<name>,<user>,<state>,<cmdline>,<zone>]  <br> The number of processes.<br> Return value: *Integer*.<br> [Supported platforms](#supported-platforms): Linux, FreeBSD, Solaris^**[6](#footnotes)**^, HP-UX, AIX, Tru64, OpenBSD, NetBSD.  Parameters:  -   **name** - the process name (default is *all processes*); -   **user** - the user name (default is *all users*); -   **state** - possible values:<br>*all* (default),<br>*disk* - uninterruptible sleep,<br>*run* - running,<br>*sleep* - interruptible sleep,<br>*trace* - stopped,<br>*zomb* - zombie; -   **cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview)); -   **zone** - the target zone: *current* (default), or *all*. This parameter is supported on Solaris only.  Comments:  -   The *disk* and *trace* state parameters are supported only on Linux, FreeBSD, OpenBSD, NetBSD; -   When this item is invoked from the command line and contains a command line parameter (e.g. using the agent test mode: `zabbix_agentd -t proc.num[,,,apache2]`), one extra process will be counted, as the agent will count itself; -   When setting the `zone` parameter to *current* (or default) in case the agent has been compiled on a Solaris without zone support, but running on a newer Solaris where zones are supported, then the agent will return NOTSUPPORTED (the agent cannot limit results to only the current zone). However, *all* is supported in this case. -   See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).  Examples:      proc.num[,mysql] #the number of processes running under the mysql user     proc.num[apache2,www-data] #the number of apache2 processes running under the www-data user     proc.num[,oracle,sleep,oracleZABBIX] #the number of processes in sleep state running under Oracle having oracleZABBIX in its command line
ca	 ##### proc.num[<name>,<user>,<state>,<cmdline>,<zone>]  <br> Nombre de processos.<br> Valor de retorn: *Enter*.<br> [Plataformes admeses](#plataformes-admeses): Linux, FreeBSD, Solaris^**[6](#footnotes)**^, HP-UX, AIX, Tru64, OpenBSD, NetBSD.  Paràmetres:  - **nom** - nom del procés (per defecte és *tots els processos*); - **usuari** - nom d'usuari (el valor per defecte és *tots els usuaris*); - **estat** - valors possibles:<br>*tot* (per defecte),<br>*disc* - repòs ininterromput,<br>*executar* - en execució,<br>*sleep* - son interrompible,< br>*trace* - aturat,<br>*zomb* - zombi; - **cmdline** - filtra per línia d'ordres (és una [expressió] regular (/manual/regular_expressions#overview)); - **zona** - zona objectiu: *actual* (per defecte), o *tot*. Aquest paràmetre només és compatible amb Solaris.  Comentaris:  - Els paràmetres d'estat *disk* i *trace* només són compatibles amb Linux, FreeBSD, OpenBSD, NetBSD; - Quan aquest element es crida des de la línia d'ordres i conté un paràmetre de línia d'ordres (per exemple, emprant el mode de prova de l'agent: `zabbix_agentd -t proc.num[,,,apache2]`), es comptarà un procés addicional, com a agent es comptarà a si mateix; - Quan s'estableix el paràmetre `zone` a *actual* (o predeterminat) en cas que l'agent s'hagi compilat en un Solaris sense suport de zones, però que s'executi en un Solaris més nou on s'admeten zones, l'agent retornarà NOTSUPPORTED (l'agent no pot limitar els resultats només a la zona actual). Tanmateix, *tot* és compatible en aquest cas. - Veieu [notes](/manual/appendix/items/proc_mem_num_notes) sobre la tria de processos amb paràmetres `name` i `cmdline` (específics de Linux).  Exemples:       proc.num[,mysql] #el nombre de processos que s'executen sota l'usuari mysql      proc.num[apache2,www-data] #el nombre de processos apache2 que s'executen sota l'usuari www-data      proc.num[,oracle,sleep,oracleZABBIX] #el nombre de processos en estat de repòs que s'executen sota Oracle amb oracleZABBIX a la seva línia d'ordres

en-us	#### Prometheus to JSON  Data from Prometheus can be used for low-level discovery. In this case data in JSON format are needed and the *Prometheus to JSON* preprocessing option will return exactly that.  For more details, see [Discovery using Prometheus data](/manual/discovery/low_level_discovery/examples/prometheus).
ca	#### Prometheus a JSON  Les dades de Prometheus es poden emprar per la descoberta de baix nivell. En aquest cas, calen dades en format JSON i l'opció de preprocessat *Prometheus to JSON* retornarà exactament això.  Per obtindre més informació, consulteu [descoberta emprant informació Prometheus](/manual/discovery/low_level_discovery/examples/prometheus).

en-us	##### Prometheus to JSON  In the discovery rule, go to the Preprocessing tab and select the *Prometheus to JSON* preprocessing option. Data in JSON format are needed for discovery and the *Prometheus to JSON* preprocessing option will return exactly that, with the following attributes:  -   metric name -   metric value -   help (if present) -   type (if present) -   labels (if present) -   raw line  For example, querying `wmi_logical_disk_free_bytes`:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_rule_prom_json.png)  from these Prometheus lines:      # HELP wmi_logical_disk_free_bytes Free space in bytes (LogicalDisk.PercentFreeSpace)     # TYPE wmi_logical_disk_free_bytes gauge     wmi_logical_disk_free_bytes{volume="C:"} 3.5180249088e+11     wmi_logical_disk_free_bytes{volume="D:"} 2.627731456e+09     wmi_logical_disk_free_bytes{volume="HarddiskVolume4"} 4.59276288e+08  will return:  ``` {.java} [     {         "name": "wmi_logical_disk_free_bytes",         "help": "Free space in bytes (LogicalDisk.PercentFreeSpace)",         "type": "gauge",         "labels": {             "volume": "C:"          },         "value": "3.5180249088e+11",         "line_raw": "wmi_logical_disk_free_bytes{volume=\"C:\"} 3.5180249088e+11"     },     {         "name": "wmi_logical_disk_free_bytes",         "help": "Free space in bytes (LogicalDisk.PercentFreeSpace)",         "type": "gauge",         "labels": {             "volume": "D:"          },         "value": "2.627731456e+09",         "line_raw": "wmi_logical_disk_free_bytes{volume=\"D:\"} 2.627731456e+09"     },     {         "name": "wmi_logical_disk_free_bytes",         "help": "Free space in bytes (LogicalDisk.PercentFreeSpace)",         "type": "gauge",         "labels": {             "volume": "HarddiskVolume4"          },         "value": "4.59276288e+08",         "line_raw": "wmi_logical_disk_free_bytes{volume=\"HarddiskVolume4\"} 4.59276288e+08"     } ] ```
ca	##### Prometheus a JSON  A la regla de descoberta, navegueu a la pestanya Preprocessament i trieu l'opció de preprocessament *Prometheus to JSON*. Les dades en format JSON són necessàries per a la descoberta i l'opció de preprocessament *Prometheus to JSON* retornarà exactament això, amb els atributs següents:  - nom mètric - valor mètric - ajuda (si és present) - tipus (si n'hi ha) - etiquetes (si n'hi han) - línia crua  Per exemple, consultant `wmi_logical_disk_free_bytes`:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_rule_prom_json.png)  d'aquestes línies de Prometeu:      # HELP wmi_logical_disk_free_bytes Free space in bytes (LogicalDisk.PercentFreeSpace)     # TYPE wmi_logical_disk_free_bytes gauge     wmi_logical_disk_free_bytes{volume="C:"} 3.5180249088e+11     wmi_logical_disk_free_bytes{volume="D:"} 2.627731456e+09     wmi_logical_disk_free_bytes{volume="HarddiskVolume4"} 4.59276288e+08  retornarà:  ``` {.java} [     {         "name": "wmi_logical_disk_free_bytes",         "help": "Free space in bytes (LogicalDisk.PercentFreeSpace)",         "type": "gauge",         "labels": {             "volume": "C:"          },         "value": "3.5180249088e+11",         "line_raw": "wmi_logical_disk_free_bytes{volume=\"C:\"} 3.5180249088e+11"     },     {         "name": "wmi_logical_disk_free_bytes",         "help": "Free space in bytes (LogicalDisk.PercentFreeSpace)",         "type": "gauge",         "labels": {             "volume": "D:"          },         "value": "2.627731456e+09",         "line_raw": "wmi_logical_disk_free_bytes{volume=\"D:\"} 2.627731456e+09"     },     {         "name": "wmi_logical_disk_free_bytes",         "help": "Free space in bytes (LogicalDisk.PercentFreeSpace)",         "type": "gauge",         "labels": {             "volume": "HarddiskVolume4"          },         "value": "4.59276288e+08",         "line_raw": "wmi_logical_disk_free_bytes{volume=\"HarddiskVolume4\"} 4.59276288e+08"     } ] ```

en-us	#### Propagating host group permissions and tag filters to its subgroups.  Propagate host group permissions and tag filters to its subgroups.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.propagate",     "params": {         "groups": [             {                 "groupid": "6"             }         ],         "permissions": true,         "tag_filters": true     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "6",         ]     },     "id": 1 } ```  
ca	#### Propagar els permisos d'un grup d'equips i filtres d'etiquetes als seus subgrups.  Propaga els permisos d'un grup d'equips i filtres d'etiquetes als seus subgrups.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.propagate",     "params": {         "groups": [             {                 "groupid": "6"             }         ],         "permissions": true,         "tag_filters": true     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "6",         ]     },     "id": 1 } ```

en-us	#### Propagating template group permissions to its subgroups.  Propagate template group permissions to its subgroups.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.propagate",     "params": {         "groups": [             {                 "groupid": "15"             }         ],         "permissions": true     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "15",         ]     },     "id": 1 } ```  
ca	#### Propagar els permisos d'un grup de plantilles als seus subgrups.  Propaga els permisos d'un grup de plantilles als seus subgrups.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.propagate",     "params": {         "groups": [             {                 "groupid": "15"             }         ],         "permissions": true     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "15",         ]     },     "id": 1 } ```

en-us	#### Property behavior  Some of the object properties are marked with short labels to describe their behavior. The following labels are used:  -   *read-only* - the value of the property is set automatically and cannot be defined or changed by the user, even in some specific conditions     (e.g., *read-only* for inherited objects or discovered objects); -   *write-only* - the value of the property can be set, but cannot be accessed after; -   *constant* - the value of the property can be set when creating an object, but cannot be changed after; -   *supported* - the value of the property is not required to be set, but is allowed to be set in some specific conditions     (e.g., *supported* if `type` is set to "Simple check", "External check", "SSH agent", "TELNET agent", or "HTTP agent"); -   *required* - the value of the property is required to be set for all operations (except get operations) or in some specific conditions     (e.g., *required* for create operations; *required* if `operationtype` is set to "global script" and `opcommand_hst` is not set).  ::: noteclassic For update operations a property is considered as "set" when setting it during the update operation. :::  Properties that are not marked with labels are optional.
ca	#### Comportament de la propietat  Algunes de les propietats de l'objecte són etiquetades per descriure el seu comportament. S'empren les següents etiquetes:  - *només lectura* - el valor de la propietat s'estableix automàticament i l'usuari no pot definir ni canviar, fins i tot en algunes condicions específiques (p. ex., *només lectura* per a objectes heretats o objectes descoberts); - *només escriptura* - es pot establir el valor de la propietat, però no s'hi pot accedir després; - *constant* - el valor de la propietat es pot establir en crear un objecte, però no es pot canviar després; - *suportada* - no cal establir el valor de la propietat, però es pot establir en algunes condicions específiques (p. ex., *suportada* si `tipus` s'estableix a "Comprovació simple", "Comprovació externa", "Agent SSH", "Agent TELNET" o "Agent HTTP"); - *obligatori* - cal establir el valor de la propietat per a totes les operacions (excepte les operacions d'obtenció) o en algunes condicions específiques (p. ex., *obligatori* per a les operacions de creació; *obligatori* si `operationtype` s'estableix a "script global" i `opcommand_hst` no s'ha establert).  ::: noteclassic Per a les operacions d'actualització, una propietat es considera "configurada" quan es defineix durant l'operació d'actualització. :::  Les propietats que no són etiquetades són opcionals.

en-us	 |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |name|string|Name of the excluded downtime.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |period\_from|integer|Starting time of the excluded downtime (inclusive).<br><br>Possible values: timestamp.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |period\_to|integer|Ending time of the excluded downtime (exclusive).<br><br>Possible values: timestamp.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |name|cadena|Nom del temps d'indisponibilitat exclòs.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |period\_from|enter|Hora d'inici del període de temps d'indisponibilitat (inclòs).<br><br>Valors possibles: nombre de segons (comptant a partir de diumenge).<br><br>[Comportament de la propietat](/ manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |period\_to|enter|Hora de finalització del període de temps d'indisponibilitat (exclusiu).<br><br>Valors possibles: marca de temps.<br><br>[Comportament de la propietat](/ manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	|Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |period\_from|integer|Starting time of the recurrent weekly period of time (inclusive).<br><br>Possible values: number of seconds (counting from Sunday).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |period\_to|integer|Ending time of the recurrent weekly period of time (exclusive).<br><br>Possible values: number of seconds (counting from Sunday).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |period\_from|enter|Hora d'inici del període de temps setmanal recurrent (inclòs).<br><br>Valors possibles: nombre de segons (comptant a partir de diumenge).<br><br>[Comportament de la propietat](/ manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |period\_to|enter|Hora de finalització del període de temps setmanal recurrent (exclusiu).<br><br>Valors possibles: nombre de segons (a partir de diumenge).<br><br>[Comportament de la propietat](/ manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	|Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|SLA service tag name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |operator|integer|SLA service tag operator.<br><br>Possible values:<br>0 - *(default)* equals;<br>2 - contains.| |value|string|SLA service tag value.|
ca	|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |tag|cadena|Nom de l'etiqueta del servei SLA.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |operator|enter|Operador d'etiqueta del servei SLA.<br><br>Valors possibles:<br>0 - *(per defecte)* iguals;<br>2 - conté.| |value|cadena|Valor de l'etiqueta del servei SLA.|

en-us	##### Protection against brute force attacks  In case of five consecutive failed login attempts, Zabbix interface will pause for 30 seconds in order to prevent brute force and dictionary attacks.  The IP address of a failed login attempt will be displayed after a successful login.
ca	##### Protecció contra atacs de força bruta  En cas de cinc intents d'inici de sessió consecutius sense èxit, la interfície de Zabbix es tancarà durant 30 segons per evitar atacs de força bruta i de diccionari.  L'adreça IP d'un intent d'inici de sessió fallit es mostrarà després d'una sessió correcta.

en-us	##### Protection from overloading  If Zabbix server was down for some time, and proxies have collected a lot of data,  and then the server starts, it may get overloaded (history cache usage stays at 95-100% for some time).  This overload could result in a performance hit, where checks are processed slower  than they should. Protection from this scenario was implemented to avoid problems that arise  due to overloading history cache.  When Zabbix server history cache is full the history cache write access is being  throttled, stalling server data gathering processes. The most common history cache  overload case is after server downtime when proxies are uploading gathered data. To avoid  this proxy throttling was added (currently it cannot be disabled).  Zabbix server will stop accepting data from proxies when history cache usage reaches 80%.  Instead those proxies will be put on a throttling list. This will continue until the cache usage  falls down to 60%. Now server will start accepting data from proxies one by one, defined by the  throttling list. This means the first proxy that attempted to upload data during the throttling  period will be served first and until it's done the server will not accept data from other proxies.  This throttling mode will continue until either cache usage hits 80% again or falls down to 20%  or the throttling list is empty. In the first case the server will stop accepting proxy data again.  In the other two cases the server will start working normally, accepting data from all proxies.  The above information can be illustrated in the following table:  |History write <br>cache usage|Zabbix server mode|Zabbix server action| |--|--|------| |Reaches 80% |Wait|Stops accepting proxy data, but maintains a *throttling list* (prioritized list of proxies to be contacted later).| |Drops to 60% |Throttled|Starts processing the throttling list, but still not accepting proxy data.| |Drops to 20% |Normal|Drops the throttling list and starts accepting proxy data normally.|  You may use the `zabbix[wcache,history,pused]` internal item to correlate this behavior of Zabbix  server with a metric.
ca	##### Protecció contra sobrecàrregues  Si el servidor Zabbix ha estat inactiu durant un temps i els proxys han recopilat moltes dades, quan s'inicia el servidor pot sobrecarregar-se (ús de la memòria cau de l'historial mantingut al 95-100% durant un temps). Aquesta sobrecàrrega pot provocar una davallada de rendiment, on les comprovacions es processen més lentament del que haurien. La protecció contra aquest escenari s'ha implementat per evitar problemes causats per la sobrecàrrega de la memòria cau de l'historial.  Quan la memòria cau de l'historial del servidor Zabbix és plena, l'accés d'escriptura a la memòria cau de l'historial és restringit, cosa que bloqueja els processos de recollida de dades del servidor. El cas més comú de sobrecàrrega de la memòria cau de l'historial és després del temps d'inactivitat del servidor quan els proxys descarreguen les dades recopilades. Per evitar aquest proxy, s'ha afegit una limitació (actualment no es pot desactivar).  El servidor Zabbix deixarà d'acceptar dades dels proxys quan l'ús de la memòria cau de l'historial arribi al 80%. En lloc d'això, aquests proxies es col·locaran en una llista d'acceleració. Això continuarà fins que l'ús de la memòria cau baixa al 60%. En aquest moment, el servidor començarà a acceptar dades dels proxys un per un, definits per la llista d'acceleració. Això vol dir que el primer proxy que miri de baixar dades durant el període d'acceleració es servirà primer i fins que això no es faci, el servidor no acceptarà dades d'altres proxys.  Aquest mode d'acceleració continuarà fins que l'ús de la memòria cau torni a arribar al 80% o baixi al 20% o la llista d'acceleració sigui buida. En el primer cas, el servidor deixarà d'acceptar dades de proxy de nou. En els altres dos casos, el servidor començarà a funcionar amb normalitat, acceptant dades de tots els proxys.  La informació anterior es pot il·lustrar a la taula següent:  |Ús de la memòria cau <br>historial d'escriptura|Mode del servidor Zabbix|Acció del servidor Zabbix| |--|--|------| |S'ha arribat al 80% |Pendent|Deixa d'acceptar dades de proxy, però manté una *llista d'acceleració* (llista de prioritats de proxys per contactar més tard).| |Baixa al 60% |Limitació|Comença a processar la llista d'acceleració, però encara no accepta dades de proxy.| |Baixa al 20% |Normal|Esborra la llista d'acceleració i comença a acceptar dades de proxy amb normalitat.|  Podeu emprar l'element intern `zabbix[wcache,history,pused]` per correlacionar aquest comportament del servidor Zabbix amb una mètrica.

en-us	#### Protocol  Communication between the server and the receiver is done over HTTP using REST API, NDJSON, "Content-Type: application/x-ndjson".  For more details, see [newline-delimited JSON export protocol](/manual/appendix/protocols/real_time_export).
ca	#### Protocol  La comunicació entre el servidor i el receptor es fa via HTTP amb l'API REST, NDJSON, "Tipus de contingut: aplicació/x-ndjson".  Per obtindre més informació, consulteu [protocol d'exportació JSON delimitat per una línia nova](/manual/appendix/protocols/real_time_export).

en-us	##### Providing history export callbacks  ::: noteimportant History export via module is no longer supported by Zabbix proxy since Zabbix 4.0.0. :::  Module can specify functions to export history data by type: Numeric (float), Numeric (unsigned), Character, Text and Log:  ``` {.c} typedef struct {     void    (*history_float_cb)(const ZBX_HISTORY_FLOAT *history, int history_num);     void    (*history_integer_cb)(const ZBX_HISTORY_INTEGER *history, int history_num);     void    (*history_string_cb)(const ZBX_HISTORY_STRING *history, int history_num);     void    (*history_text_cb)(const ZBX_HISTORY_TEXT *history, int history_num);     void    (*history_log_cb)(const ZBX_HISTORY_LOG *history, int history_num); } ZBX_HISTORY_WRITE_CBS; ```  Each of them should take "history" array of "history\_num" elements as arguments. Depending on history data type to be exported, "history" is an array of the following structures, respectively:  ``` {.c} typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     double      value; } ZBX_HISTORY_FLOAT;  typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     zbx_uint64_t    value; } ZBX_HISTORY_INTEGER;  typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     const char  *value; } ZBX_HISTORY_STRING;  typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     const char  *value; } ZBX_HISTORY_TEXT;  typedef struct {     zbx_uint64_t    itemid;     int     clock;     int     ns;     const char  *value;     const char  *source;     int     timestamp;     int     logeventid;     int     severity; } ZBX_HISTORY_LOG; ```  Callbacks will be used by Zabbix server history syncer processes in the end of history sync procedure after data is written into Zabbix database and saved in value cache.  :::noteimportant In case of internal error in history export module, it is recommended that module is written in such a way that it does not block whole monitoring until it recovers but discards data instead and allows Zabbix server to continue running. :::
ca	##### - Proporcioneu recordatoris d'exportació de l'historial  ::: noteimportant L'exportació de l'historial mitjançant el mòdul ja no és compatible amb el proxy Zabbix des de Zabbix 4.0.0. :::  El mòdul pot especificar funcions per exportar dades de l'historial, de tipus: numèric (flotant), numèric (sense signe), caràcter, text i registre:  ``` {.c} structure typedef {     void (*history_float_cb)(const ZBX_HISTORY_FLOAT *history, int history_num);     void (*history_integer_cb)(const ZBX_HISTORY_INTEGER *history, int history_num);     void (*history_string_cb)(const ZBX_HISTORY_STRING *history, int history_num);     void (*history_text_cb)(const ZBX_HISTORY_TEXT *history, int history_num);     void (*history_log_cb)(const ZBX_HISTORY_LOG *history, int history_num); } ZBX_HISTORY_WRITE_CBS ; ```  Cadascun d'ells ha de prendre com a argument la matriu "history" d'elements "history\_num". Segons el tipus de dades de l'historial que s'exportin, "history" és una matriu de les estructures següents, respectivament:  ``` {.c} typedef struct {  · zbx_uint64_t · itemid;  · int · clock;  · int · ns;  · double · value; } ZBX_HISTORY_FLOAT;  typedef struct {  · zbx_uint64_t · itemid;  · int · clock;  · int · ns;  · zbx_uint64_t · value; } ZBX_HISTORY_INTEGER;  typedef struct {  · zbx_uint64_t · itemid;  · int · clock;  · int · ns;  · const char · *value; } ZBX_HISTORY_STRING;  typedef struct {  · zbx_uint64_t · itemid;  · int · clock;  · int · ns;  · const char · *value; } ZBX_HISTORY_TEXT;  typedef struct {  · zbx_uint64_t · itemid;  · int · clock;  · int · ns;  · const char · *value;  · const char · *source;  · int · timestamp;  · int · logeventid;  · int · severity; } ZBX_HISTORY_LOG; ```  Els processos de sincronització de l'historial del servidor Zabbix empraran les tornades de crida al final del procediment de sincronització de l'historial després que les dades s'escriguin a la base de dades de Zabbix i es desin a la memòria cau de valors.  :::noteimportant En cas d'error intern al mòdul d'exportació de l'historial, es recomana escriure el mòdul de manera que no bloqui tot el monitoratge fins que es recuperi, sinó que esborri les dades i permeti que el servidor Zabbix continuï funcionant. :::

en-us	### Provisioning groups mappings  The provisioning groups mappings has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|----------------| |name|string|Full name of a group (e.g., *Zabbix administrators*) in LDAP/SAML user directory (also SCIM if `scim_status` is set to "SCIM provisioning is enabled").<br>Supports the wildcard character "\*".<br>Unique across all provisioning groups mappings.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |roleid|string|ID of the user role to assign to the user.<br><br>If multiple provisioning groups mappings are matched, the role of the highest user type (*User*, *Admin*, or *Super admin*) is assigned to the user. If there are multiple roles with the same user type, the first role (sorted in alphabetical order) is assigned to the user.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |user_groups|array|Array of Zabbix user group ID objects. Each object has the following properties:<br>`usrgrpid` - `(integer)` ID of Zabbix user group to assign to the user.<br><br>If multiple provisioning groups mappings are matched, Zabbix user groups of all matched mappings is assigned to the user.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Mapatge de grups de subministrament  Els mapatges de grups de subministrament tenen les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|-----------------| |name|cadena|Nom sencer d'un grup (p. ex., *administradors Zabbix*) al directori d'usuaris LDAP/SAML (també SCIM si `scim_status` s'estableix a "El subministrament SCIM és habilitat").<br>Accepta el caràcter comodí "\*".<br>Únic en tots els mapatges de grups de subministrament.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |roleid|cadena|ID de la funció d'usuari que s'ha d'assignar a l'usuari.<br><br>Si coincideixen les assignacions de diversos grups de subministrament, la funció del tipus d'usuari més alt (*Usuari*, *Administrador* o *Superadministrador*) s'assigna a l'usuari. Si hi ha diversos rols amb el mateix tipus d'usuari, el primer rol (ordenat per ordre alfabètic) s'assigna a l'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):< br>- *obligatori*| |user_groups|array|Matriu d'objectes d'ID de grup d'usuaris Zabbix. Cada objecte té les propietats següents:<br>`usrgrpid` - `(enter)` ID del grup d'usuaris de Zabbix per assignar-lo a l'usuari.<br><br>Si coincideixen els mapatges de diversos grups de subministrament, els grups d'usuaris de Zabbix de tots els mapatges que coincideixen s'assigna a l'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	#### Provisioning multiple users  Provision two users.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "user.provision",     "params": [         "1",         "5"     ],     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "userids": [             "1",             "5"         ]     },     "id": 1 } ```
ca	#### Aprovisionar diversos usuaris  Aprovisiona dos usuaris.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "user.provision",     "params": [         "1",         "5"     ],     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "userids": [             "1",             "5"         ]     },     "id": 1 } ```

en-us	#### Proxies  A listing of existing proxies with their details is displayed.  ![](../../../../../assets/en/manual/web_interface/proxies1.png){width="600"}  Displayed data:  |Column|Description| |--|--------| |*Name*|Name of the proxy. Clicking on the proxy name opens the proxy [configuration form](/manual/distributed_monitoring/proxies#configuration).| |*Mode*|Proxy mode is displayed - *Active* or *Passive*.| |*Encryption*|Encryption status for connections from the proxy is displayed:<br>**None** - no encryption;<br>**PSK** - using pre-shared key;<br>**Cert** - using certificate.| |*Version*|Proxy version (three digit version number). If proxy is outdated or unsupported, version number is highlighted (red) and info status icon (yellow or red) is displayed. Hover over the icon for details.| |*Last seen (age)*|The time when the proxy was last seen by the server is displayed.| |*Host count*|The number of enabled hosts assigned to the proxy is displayed.| |*Item count*|The number of enabled items on enabled hosts assigned to the proxy is displayed.| |*Required vps*|Required proxy performance is displayed (the number of values that need to be collected per second).| |*Hosts*|All hosts monitored by the proxy are listed. Clicking on the host name opens the host configuration form.|  To configure a new proxy, click on the *Create proxy* button in the top right-hand corner.
ca	#### Proxys  Es mostra una llista dels proxys existents amb els seus detalls.  ![](../../../../../assets/en/manual/web_interface/proxies1.png){width="600"}  Dades mostrades:  |Columna|Descripció| |--|---------| |*Nom*|Nom del proxy. En fer clic al nom del proxy s'obre el [formulari de configuració](/manual/distributed_monitoring/proxies#configuration) del proxy.| |*Mode*|Es mostra el mode proxy - *Actiu* o *Passiu*.| |*Xifrat*|Es mostra l'estat de xifrat de les connexions del proxy:<br>**Cap** - sense xifrat<br>**PSK** - empra una clau prèviament compartida<br> **Cert** - emprar un certificat<br>| |*Version*|Versió del proxy (tres dígits). Si el proxy és desactualitzat o obsolet, el nombre de versió es veurà en vermell i s'hi veurà una icona d'estat informativa (en vermell). Passeu per la icona per obtindre més detalls.| |*Darrera visita (edat)*|Es mostra l'hora en què el servidor va veure per darrer cop el proxy.| |*Nombre d'equips*|Es mostra el nombre d'equips habilitats assignats al proxy.| |*Nombre d'elements*|Es mostra el nombre d'elements activats als equips habilitats assignats al proxy.| |*Rendiment requerit (vps)*|Es mostra el rendiment del proxy necessari (el nombre de valors que s'han de recollir per segon).| |*Equips*|S'enumeren tots els equips monitorats pel proxy. Si feu clic al nom de l'equip, s'obre el formulari de configuració de l'equip.|  Per configurar un proxy nou, feu clic al botó *Crear un proxy* a l'extrem superior dret.

en-us	#### Proxies  In a [proxy](/manual/distributed_monitoring/proxies#configuration) configuration, user macros can be used in the following field:  |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interface port (for passive proxy)|<|no|
ca	#### Proxys  En una configuració [proxy](/manual/distributed_monitoring/proxies#configuration), les macros d'usuari es poden emprar als camps següents:  |Ubicació|<|Múltiples macros/barreja amb text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Port d'interfície (per un proxy passiu)|<|no|

en-us	 ### Proxies  |Macro|Supported in|Description| |--|--------|--------| |{PROXY.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)|*Description of the proxy*. Resolves to either:<br>1) proxy of the Nth item in the trigger expression (in trigger-based notifications). You may use [indexed](/manual/appendix/macros/supported_by_location#indexed_macros) macros here.<br>2) proxy, which executed discovery (in discovery notifications). Use {PROXY.DESCRIPTION} here, without indexing.<br>3) proxy to which an active agent registered (in autoregistration notifications). Use {PROXY.DESCRIPTION} here, without indexing.<br><br>This macro may be used with a numeric index e.g. {PROXY.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{PROXY.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)|*Name of the proxy*. Resolves to either:<br>1) proxy of the Nth item in the trigger expression (in trigger-based notifications). You may use [indexed](/manual/appendix/macros/supported_by_location#indexed_macros) macros here.<br>2) proxy, which executed discovery (in discovery notifications). Use {PROXY.NAME} here, without indexing.<br>3) proxy to which an active agent registered (in autoregistration notifications). Use {PROXY.NAME} here, without indexing.<br><br>This macro may be used with a numeric index e.g. {PROXY.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).|
ca	### Proxys  |Macro|Admesa a|Descripció| |--|------|------| |{PROXY.DESCRIPTION}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions i ordres de descoberta<br>→ Notificacions i ordres d'autoregistre<br>→ Notificacions internes<br>→ Manual acció d'esdeveniment [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Descripció del proxy*. Es resol a:<br>1) el proxy de l'element enèssim del trigger (en les notificacions basades en triggers). Podeu emprar macros [indexed](/manual/appendix/macros/supported_by_location#indexed_macros) aquí.<br>2) Proxy que va executar la descoberta (a les notificacions de descoberta). Empreu {PROXY.DESCRIPTION} aquí, sense indexar.<br>3) Proxy al qual s'ha registrat un agent actiu (a les notificacions d'autoregistre). Feu servir {PROXY.DESCRIPTION} aquí, sense indexar.<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {PROXY.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{PROXY.NAME}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions i ordres de descoberta<br>→ Notificacions i ordres d'autoregistre<br>→ Notificacions internes<br>→ Manual acció d'esdeveniment [scripts](/manual/web_interface/frontend_sections/administration/scripts)|*Nom del proxy*. Es resol a:<br>1) el proxy de l'element enèssim del trigger (en les notificacions basades en triggers). Podeu emprar macros [indexed](/manual/appendix/macros/supported_by_location#indexed_macros) aquí.<br>2) el proxy que va executar la descoberta (a les notificacions de descoberta). Feu servir {PROXY.NAME} aquí, sense indexar.<br>3) el proxy al qual s'ha registrat un agent actiu (a les notificacions d'autoregistre). Feu servir {PROXY.NAME} aquí, sense indexar.<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {PROXY.NAME[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).|

en-us	#### Proxies  Manage the proxies used in your distributed monitoring setup.  [Proxy API](/manual/api/reference/proxy)
ca	#### Proxys  Gestionar els proxys emprats a la configuració de monitoratge distribuït.  [API Proxy](/manual/api/reference/proxy)

en-us	##### ProxyConfigFrequency Determines how often Zabbix server sends configuration data to a Zabbix proxy in seconds. Used only for proxies in a passive mode.  Default: `10`<br> Range: 1-604800
ca	##### ProxyConfigFrequency Determina amb quina freqüència el servidor Zabbix envia dades de configuració a un proxy Zabbix en segons. S'empra només per als proxys en mode passiu.  Per defecte: `10`<br> Rang: 1-604800

en-us	##### ProxyConfigFrequency  How often the proxy retrieves configuration data from Zabbix server in seconds.<br>Active proxy parameter. Ignored for passive proxies (see ProxyMode parameter).  Default: `10`<br> Range: 1-604800
ca	##### ProxyConfigFrequency  Com de sovint el proxy recupera les dades de configuració del servidor Zabbix en segons.<br>Paràmetre de proxy actiu. S'ignora per als proxys passius (veieu el paràmetre ProxyMode).  Per defecte: `10`<br> Rang: 1-604800

en-us	##### Proxy configuration  HA cluster nodes (servers) must be listed in the configuration of either  passive or active Zabbix proxy.  For a passive proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy,  separated by a **comma**.  ``` Server=zabbix-node-01,zabbix-node-02 ```  For an active proxy, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_proxy) of the proxy,  separated by a **semicolon**. ``` Server=zabbix-node-01;zabbix-node-02 ```
ca	##### Configuració del proxy  Els nodes de clúster HA (servidors) s'han d'enumerar a la configuració passiva o activa de proxy Zabbix.  Per a un proxy passiu, els noms dels nodes s'han d'enumerar al [paràmetre](/manual/appendix/config/zabbix_proxy) del proxy, separats per una **coma**.  ``` Servidor=zabbix-node-01,zabbix-node-02 ```  Per a un proxy actiu, els noms dels nodes haurien d'ésser llistats al [paràmetre](/manual/appendix/config/zabbix_proxy) del proxy, separats per un **punt i coma**.  ``` Servidor=zabbix-node-01;zabbix-node-02 ```

en-us	# proxy.create
ca	# proxy.create

en-us	##### ProxyDataFrequency Determines how often Zabbix server requests history data from a Zabbix proxy in seconds. Used only for proxies in the passive mode.  Default: `1`<br> Range: 1-3600
ca	##### ProxyDataFrequency Determina amb quina freqüència el servidor Zabbix demana dades de l'historial d'un proxy Zabbix en segons. S'empra només per als proxys en mode passiu.  Per defecte: `1`<br> Rang: 1-3600

en-us	# proxy.delete
ca	# proxy.delete

en-us	##### Proxy features  When making a choice of using/not using a proxy, several considerations must be taken into account.  | |Proxy| |--------|--| |*Lightweight*|**Yes**| |*GUI*|No| |*Works independently*|**Yes**| |*Easy maintenance*|**Yes**| |*Automatic DB creation*|**Yes**^1^| |*Local administration*|No| |*Ready for embedded hardware*|**Yes**| |*One way TCP connections*|**Yes**| |*Centralized configuration*|**Yes**| |*Generates notifications*|No|  ^1^ Automatic DB creation feature works only with SQLite. Other databases require [manual setup](/manual/appendix/install/db_scripts).
ca	##### Funcions del proxy  A l'hora de decidir si s'empra o no un proxy, s'han de tindre en compte diverses consideracions.  | |Proxy| |--------|--| |*Lluminositat*|**Sí**| |*GUI*|No| |*Funcionament independent.*|**Sí**| |*Fàcil manteniment***|**Sí**| |*Creació automàtica de bases de dades*|**Sí**^1^| |*Administració local*|No| |*Preparat per maquinari incrustat*|**Sí**| |*Connexions TCP unidireccionals*|**Sí**| |*Configuració central*|**Sí**| |*Generació de notificacions*|No|  ^1^ La funció de creació automàtica de bases de dades només funciona amb SQLite. Altres bases de dades requereixen una [configuració manual](/manual/installation/install#requirements).

en-us	# proxy.get
ca	# proxy.get

en-us	### Proxy history housekeeping  The limitation on the amount of outdated information deleted from the proxy database per proxy history housekeeping cycle has been removed.  Previously the [housekeeper](/manual/web_interface/frontend_sections/administration/housekeeping) deleted only no more than 4 times the [`HousekeepingFrequency`](/manual/appendix/config/zabbix_proxy#housekeepingfrequency) hours of outdated information. For example, if `HousekeepingFrequency` was set to "1", no more than 4 hours of outdated information (starting from the oldest entry) was deleted. In cases when a proxy would constantly receive data older than set in [`ProxyOfflineBuffer`](/manual/appendix/config/zabbix_proxy#proxyofflinebuffer), this could result in excessive data accumulation.  Now this limitation has been removed, providing a more effective proxy history housekeeping solution.
ca	### Neteja de l'història del proxy  S'ha tret la limitació de la quantitat d'informació obsoleta esborrada de la base de dades de proxy per cicle de manteniment de l'historial de proxy.  Abans, la [neteja](/manual/web_interface/frontend_sections/administration/housekeeping) només esborrava més de 4 cops les hores de [`HousekeepingFrequency`](/manual/appendix/config/zabbix_proxy#housekeepingfrequency) d'informació obsoleta. Per exemple, si la `Freqüència de manteniment` es va establir a "1", no s'esborren més de 4 hores d'informació obsoleta (a partir de l'entrada més antiga). En els casos en què un proxy rebria constantment dades més antigues que les establertes a [`ProxyOfflineBuffer`](/manual/appendix/config/zabbix_proxy#proxyofflinebuffer), això podria provocar una acumulació excessiva de dades.  Ara s'ha tret aquesta limitació, proporcionant una solució de manteniment de l'historial de proxy més eficaç.

en-us	### Proxy history housekeeping  The limitation on the amount of outdated information deleted from the proxy database per proxy history housekeeping cycle has been removed.  Previously the [housekeeper](/manual/web_interface/frontend_sections/administration/housekeeping) deleted only no more than 4 times the [`HousekeepingFrequency`](/manual/appendix/config/zabbix_proxy#housekeepingfrequency) hours of outdated information. For example, if `HousekeepingFrequency` was set to "1", no more than 4 hours of outdated information (starting from the oldest entry) was deleted. In cases when a proxy would constantly receive data older than set in [`ProxyOfflineBuffer`](/manual/appendix/config/zabbix_proxy#proxyofflinebuffer), this could result in excessive data accumulation.  Now this limitation has been removed, providing a more effective proxy history housekeeping solution.
ca	### Neteja de l'història del proxy  S'ha tret la limitació de la quantitat d'informació obsoleta esborrada de la base de dades de proxy per cicle de manteniment de l'historial de proxy.  Abans, la [neteja](/manual/web_interface/frontend_sections/administration/housekeeping) només esborrava més de 4 cops les hores de [`HousekeepingFrequency`](/manual/appendix/config/zabbix_proxy#housekeepingfrequency) d'informació obsoleta. Per exemple, si la `Freqüència de manteniment` es va establir a "1", no s'esborren més de 4 hores d'informació obsoleta (a partir de l'entrada més antiga). En els casos en què un proxy rebria constantment dades més antigues que les establertes a [`ProxyOfflineBuffer`](/manual/appendix/config/zabbix_proxy#proxyofflinebuffer), això podria provocar una acumulació excessiva de dades.  Ara s'ha tret aquesta limitació, proporcionant una solució de manteniment de l'historial de proxy més eficaç.

en-us	### Proxy installation  Once the required repository is added, you can install Zabbix proxy by running:      # apt install zabbix-proxy-mysql zabbix-sql-scripts  Substitute 'mysql' in the command with 'pgsql' to use PostgreSQL, or with 'sqlite3' to use SQLite3.  The package 'zabbix-sql-scripts' contains database schemas for all supported database management systems for both Zabbix server and Zabbix proxy and will be used for data import.
ca	### Instal·lació del proxy  Un cop afegit el repositori necessari, podeu instal·lar el proxy Zabbix executant:       # apt install zabbix-proxy-mysql zabbix-sql-scripts  Substituïu "mysql" a l'ordre per "pgsql" per emprar PostgreSQL, o per "sqlite3" per utilitzar SQLite3.  El paquet 'zabbix-sql-scripts' conté esquemes de bases de dades per a tots els sistemes de gestió de bases de dades compatibles amb el servidor Zabbix i el proxy Zabbix i s'emprarà per a la importació de dades.

en-us	### Proxy installation  Once the required repository is added, you can install Zabbix proxy by running:      # dnf install zabbix-proxy-mysql zabbix-sql-scripts  Substitute 'mysql' in the commands with 'pgsql' to use PostgreSQL, or with 'sqlite3' to use SQLite3 (proxy only).  The package 'zabbix-sql-scripts' contains database schemas for all supported database management systems for both Zabbix server and Zabbix proxy and will be used for data import.
ca	### Instal·lació del proxy  Un cop afegit el repositori necessari, podeu instal·lar el proxy Zabbix executant:       # dnf install zabbix-proxy-mysql zabbix-sql-scripts  Substituïu "mysql" a les comandes amb "pgsql" per emprar PostgreSQL, o per "sqlite3" per emprar SQLite3 (només el proxy).  El paquet 'zabbix-sql-scripts' conté esquemes de bases de dades per a tots els sistemes de gestió de bases de dades compatibles amb el servidor Zabbix i el proxy Zabbix i s'emprarà per a la importació de dades.

en-us	### Proxy interface  The proxy interface object defines the interface used to connect to a passive proxy. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dns|string|DNS name to connect to.<br><br>Can be empty if connections are made via IP address.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `useip` is set to "connect using DNS name"| |ip|string|IP address to connect to.<br><br>Can be empty if connections are made via DNS names.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `useip` is set to "connect using IP address"| |port|string|Port number to connect to.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |useip|integer|Whether the connection should be made via IP address.<br><br>Possible values:<br>0 - connect using DNS name;<br>1 - connect using IP address.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Interfície de proxy  L'objecte d'interfície proxy defineix la interfície emprada per connectar-se a un proxy passiu. Té les següents propietats.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dns|cadena|Nom DNS al qual connectar-se.<br><br>Pot ésser buit si les connexions es fan emprant una adreça IP.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `useip` s'ha establer a "connectar amb nom DNS"| |ip|cadena|adreça IP per connectar-se.<br><br>Pot ésser buit si les connexions es fan emprant noms DNS.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `useip` s'ha establer a "connectar amb adreça IP"| |port|cadena|Nombre de port per connectar-se.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |useip|enter|Si la connexió s'ha d'establir emprant l'adreça IP.<br><br>Els valors possibles són:<br>0 - connectar emprant el nom DNS;<br>1 - connectar emprant l'adreça IP.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	##### ProxyLocalBuffer  The proxy will keep data locally for N hours, even if the data have already been synced with the server.<br>This parameter may be used if local data will be used by third-party applications.  Default: `0`<br> Range: 0-720
ca	##### ProxyLocalBuffer  El proxy conservarà les dades localment durant N hores, fins i tot si les dades ja s'han sincronitzat amb el servidor.<br>Aquest paràmetre es pot emprar si aplicacions de tercers empren les dades locals.  Per defecte: `0`<br> Rang: 0-720

en-us	##### ProxyMode  The proxy operating mode.<br>0 - proxy in the active mode<br>1 - proxy in the passive mode<br>*Note* that (sensitive) proxy configuration data may become available to parties having access to the Zabbix server trapper port when using an active proxy. This is possible because anyone may pretend to be an active proxy and request configuration data; authentication does not take place.  Default: `0`<br> Range: 0-1
ca	##### ProxyMode  Mode d'operació del proxy.<br>0 - proxy en mode actiu<br>1 - proxy en mode passiu<br>*Tingueu en compte* que les dades de configuració del proxy (sensibles) poden ésser disponibles per a les persones que tinguin accés al capturador del servidor Zabbix port quan empreu un proxy actiu. Això és possible perquè qualsevol persona pot pretendre ser un proxy actiu i demanar dades de configuració; l'autenticació no es produeix.  Per defecte: `0`<br> Rang: 0-1

en-us	# > Proxy object  The following objects are directly related to the `proxy` API.
ca	# > Objecte proxy  Els objectes tenen relació amb l'API `proxy`.

en-us	##### ProxyOfflineBuffer  The proxy will keep data for N hours in case of no connectivity with Zabbix server.<br>Older data will be lost.  Default: `1`<br> Range: 1-720
ca	##### ProxyOfflineBuffer  El proxy conservarà les dades durant N hores en cas de no estar connectat amb el servidor Zabbix.<br>Les dades més antigues es perdran.  Per defecte: `1`<br> Rang: 1-720

en-us	#### Proxy process types  -   `availability manager` - process for host availability updates -   `configuration syncer` - process for managing in-memory cache of     configuration data -   `data sender` - proxy data sender -   `discoverer` - process for discovery of devices -   `history syncer` - history DB writer -   `housekeeper` - process for removal of old historical data -   `http poller` - web monitoring poller -   `icmp pinger` - poller for icmpping checks -   `ipmi manager` - IPMI poller manager -   `ipmi poller` - poller for IPMI checks -   `java poller` - poller for Java checks -   `odbc poller` - poller for ODBC checks -   `poller` - normal poller for passive checks -   `preprocessing manager` - manager of preprocessing tasks -   `preprocessing worker` - process for data preprocessing -   `self-monitoring` - process for collecting internal server     statistics -   `snmp trapper` - trapper for SNMP traps -   `task manager` - process for remote execution of tasks requested by     other components (e.g. close problem, acknowledge problem, check     item value now, remote command functionality) -   `trapper` - trapper for active checks, traps, proxy communication -   `unreachable poller` - poller for unreachable devices -   `vmware collector` - VMware data collector responsible for data     gathering from VMware services  The proxy log file can be used to observe these process types.  Various types of Zabbix proxy processes can be monitored using the **zabbix\[process,<type>,<mode>,<state>\]** internal [item](/manual/config/items/itemtypes/internal).
ca	#### Tipus de processos de proxy  -   `​availability manager`​ - procés d'actualització de la disponibilitat de l'equip -   `​configuration syncer`​ - procés per gestionar la memòria cau de les dades de configuració -   `​data sender`​: permet al proxy enviar les dades -   `​discoverer`​ - procés de descoberta d'equips -   `​discoverer`​ - procés per la descoberta de dispositius -   `​history syncer`​ - escriptura de base de dades de l'històric -   `​history poller`​ - procés de processament per a comprovacions calculades, afegides i internes que requereixen una connexió a una base de dades -   `​housekeeper`​ - procés per esborrar dades de l'historial antic -   `​http poller`​ - poller per el monitoratge web -   `​icmp pinger`​ - poller per les verificacions icmpping -   `​ipmi manager`​ - gestor de poller IPMI -   `​ipmi poller`​ - poller per el monitoratge IPMI -   `​java poller`​ - poller per el monitoratge Java -   `odbc poller` - poller per el monitoratge ODBC -   `​poller`​ - poller normal per el monitoratge passiu -   `​preprocessing manager`​ - responsable de les tasques de pretractament -   `​preprocessing worker`​ - processos de pretractrament de dades -   `​self-monitoring`​ - processos recollint les estadístiques internes del servidor -   `​snmp trapper`​ - trapper per els traps SNMP -   `​task manager`​ - procés per a l'execució remota de tasques sol·licitades per altres components (per exemple, tancar un problema, reconèixer un problema, comprovar ara un element, funcionalitat d'ordres remots) -   `​trapper`​ - ttrapper per a controls actius, trampes, comunicació amb el proxy -   `​unreachable poller`​ - enquestador per a equips inabastables -   `​vmware collector`​ - col·lector de dades de VMware responsable de recuperar dades dels serveis de VMware  El fitxer de registre del proxy es pot emprar per observar aquests tipus de processos.  Es poden monitorar diversos tipus de processos de proxy Zabbix mitjançant l'[element intern](/manual/config/items/itemtypes/internal) **zabbix\[process,<​type>,<​mode>,<​state> ​\] **.

en-us	#### Proxy startup with MySQL 8.0.0-8.0.17  zabbix\_proxy on MySQL versions 8.0.0-8.0.17 fails with the following "access denied" error:      [Z3001] connection to database 'zabbix' failed: [1227] Access denied; you need (at least one of) the SUPER, SYSTEM_VARIABLES_ADMIN or SESSION_VARIABLES_ADMIN privilege(s) for this operation  That is due to MySQL 8.0.0 starting to enforce special permissions for setting session variables. However, in 8.0.18 this behavior was removed: [As of MySQL 8.0.18, setting the session value of this system variable is no longer a restricted operation.](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html)  The workaround is based on granting additional privileges to the `zabbix` user:  For MySQL versions 8.0.14 - 8.0.17:      grant SESSION_VARIABLES_ADMIN on *.* to 'zabbix'@'localhost';  For MySQL versions 8.0.0 - 8.0.13:      grant SYSTEM_VARIABLES_ADMIN on *.* to 'zabbix'@'localhost';
ca	#### Engegada del proxy amb MySQL 8.0.0-8.0.17  El zabbix\_proxy amb les versions 8.0.0-8.0.17 de MySQL falla amb l'error d'"accés rebutjat" següent:      [Z3001] connection to database 'zabbix' failed: [1227] Access denied; you need (at least one of) the SUPER, SYSTEM_VARIABLES_ADMIN or SESSION_VARIABLES_ADMIN privilege(s) for this operation  Això es deu al fet que MySQL 8.0.0 comença a aplicar permisos especials per establir variables de sessió. Tanmateix, a la versió 8.0.18, aquest comportament s'ha esborrat: [A partir de MySQL 8.0.18, establir el valor de sessió d'aquesta variable del sistema ja no és una operació restringida](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html).  La solució passa per concedir privilegis addicionals a l'usuari `zabbix`:  Per les versions 8.0.14 a 8.0.17 de MySQL :       grant SESSION_VARIABLES_ADMIN on *.* to 'zabbix'@'localhost';  Per les versions 8.0.0 a 8.0.13 de MySQL :      grant SYSTEM_VARIABLES_ADMIN on *.* to 'zabbix'@'localhost';

en-us	### Proxy  The proxy object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |proxyid|string|ID of the proxy.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |host|string|Name of the proxy.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |status|integer|Type of proxy.<br><br>Possible values:<br>5 - active proxy;<br>6 - passive proxy.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |description|text|Description of the proxy.| |lastaccess|timestamp|Time when the proxy last connected to the server.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |tls\_connect|integer|Connections to host.<br><br>Possible values:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_accept|integer|Connections from host.<br>This is a bitmask field, any combination of possible bitmap values is acceptable.<br><br>Possible bitmap values:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_issuer|string|Certificate issuer.| |tls\_subject|string|Certificate subject.| |tls\_psk\_identity|string|PSK identity.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*<br>- *required* if `tls_connect` is set to "PSK", or `tls_accept` contains the "PSK" bit| |tls\_psk|string|The preshared key, at least 32 hex digits.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*<br>- *required* if `tls_connect` is set to "PSK", or `tls_accept` contains the "PSK" bit| |proxy\_address|string|Comma-delimited IP addresses or DNS names of active Zabbix proxy.| |auto\_compress|integer|Indicates if communication between Zabbix server and proxy is compressed.<br><br>Possible values:<br>0 - No compression;<br>1 - Compression enabled.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |version|integer|Version of proxy.<br><br>Three-part Zabbix version number, where two decimal digits are used for each part, e.g., 50401 for version 5.4.1, 60200 for version 6.2.0, etc.<br>0 - Unknown proxy version.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |compatibility|integer|Version of proxy compared to Zabbix server version.<br><br>Possible values:<br>0 - Undefined;<br>1 - Current version (proxy and server have the same major version);<br>2 - Outdated version (proxy version is older than server version, but is partially supported);<br>3 - Unsupported version (proxy version is older than server previous LTS release version or server major version is older than proxy major version).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
ca	### Proxy  L'objecte proxy té les següents propietats.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |proxyid|string|Proxy ID.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions d'actualització| |host|string|Nom del proxy<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per opcions de creació.| |status|integer|Tipus de proxy.<br><br>Valors possibles:<br>5 - proxy actiu;<br>6 - proxy passiu.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |description|text|Descripció del proxy.| |lastaccess|timestamp|Hora en què el proxy es va connectar per darrer cop al servidor.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |tls\_connect|integer|Connecteu-vos a l'equip.<br><br>Valors possibles:<br>1 - *(per defecte)* Sense xifrat;<br>2 - PSK;<br>4 - certificat.| |tls\_accept|integer|Connexió a l'equip.<br>És un camp de màscara de bit; qualsevol combinació possible de valors de mapa de bits és acceptable.<br><br>Valors possibles:<br>1 - *(per defecte)* Sense xifrat;<br>2 - PSK;<br>4 - certificat.| |tls\_issuer|string|Emissor del certificat.| |tls\_subject|string|Assumpte del certificat.| |tls\_psk\_identity|string|Identitat PSK.<br>No poseu pas informació sensible a la identitat PSK, es transmet desencriptada per la xarxa per informar al receptor quina PSK ha d'emprar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només escriptura*<br>-*obligatori* si `tls_connect` s'estableix a "PSK", o `tls_accept` conté el bit "PSK"| |tls\_psk|string|La clau prèviament compartida, com a mínim 32 dígits hexadecimals.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només escriptura*<br>-*obligatori* si `tls_connect` s'estableix a "PSK", o `tls_accept` conté el bit "PSK"| |proxy\_address|string|Comma-delimited IP addresses or DNS names of active Zabbix proxy.| |auto\_compress|integer|Indicates if communication between Zabbix server and proxy is compressed.<br><br>Possible values:<br>0 - No compression;<br>1 - Compression enabled.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |version|integer|Versió del proxy.<br><br>Nombre de versió de terceres parts de Zabbix on dos dígits decimals s'empren per cada part (p.e. 50401 per la versió 5.4.1, 60200 per la versió 6.2.0, etc.)<br>0 - Versió de proxy desconeguda.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |compatibility|integer|Versió del proxy comparada amb la versió del servidor Zabbix.<br><br>Valors possibles:<br>0 - No definida;<br>1 - Versió actual (el proxy i el servidor tenen la mateixa versió major));<br>2 - Versió obsoleta (la versió del proxy és anterior a la del servidor, però són parcialment admeses);<br>3 - Versió sense suport (la versió del proxy és més antiga que la versió TLS anterior o la versió del servidor és més antiga que la del proxy actual).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|

en-us	# Proxy  This class is designed to work with proxies.  Object references:\  -   [Proxy](/manual/api/reference/proxy/object#proxy) -   [Proxy     interface](/manual/api/reference/proxy/object#proxy_interface)  Available methods:\  -   [proxy.create](/manual/api/reference/proxy/create) - create new     proxies -   [proxy.delete](/manual/api/reference/proxy/delete) - delete proxies -   [proxy.get](/manual/api/reference/proxy/get) - retrieve proxies -   [proxy.update](/manual/api/reference/proxy/update) - update proxies
ca	# Proxy  Aquesta classe és dissenyada per treballar amb proxys.  Referències d'objecte:\  -   [Proxy](/manual/api/reference/proxy/object#proxy) -   [Interfície del proxy](/manual/api/reference/proxy/object#proxy_interface)  Mètodes disponibles:\  -   [proxy.create](/manual/api/reference/proxy/create) - crear nou proxys -   [proxy.delete](/manual/api/reference/proxy/delete) - esborrar proxys -   [proxy.get](/manual/api/reference/proxy/get) - recuperar proxys -   [proxy.update](/manual/api/reference/proxy/update) - actualitzar proxys

en-us	# proxy.update
ca	# proxy.update

en-us	#### Proxy upgrade process
ca	#### Procés d'actualització del proxy

en-us	##### Proxy  [Zabbix proxy](/manual/concepts/proxy) can collect performance and availability data on behalf of Zabbix server. A proxy is an optional part of Zabbix deployment; however, it may be very beneficial to distribute the load of a single Zabbix server.
ca	##### Proxy  El [Proxy Zabbix](/manual/concepts/proxy) pot collir dades de rendiment i disponibilitat en nom del servidor Zabbix. Un proxy és un component opcional del desplegament de Zabbix. Tanmateix, pot ser molt beneficiós distribuir la càrrega del servidor Zabbix.

en-us	#### proxy  [ZBXNEXT-2557](https://support.zabbix.com/browse/ZBXNEXT-2557) Added new properties `version`, `compatibility`.\
ca	#### proxy  [ZBXNEXT-2557](https://support.zabbix.com/browse/ZBXNEXT-2557) S'han afegit les propietats `version`, `compatibility`.\

en-us	#### proxy  [ZBXNEXT-2557](https://support.zabbix.com/browse/ZBXNEXT-2557) `proxy.get`: Added strict validation of the method parameters.\
ca	#### element  [ZBXNEXT-2557](https://support.zabbix.com/browse/ZBXNEXT-2557) `proxy.get`: Afegida la validació estricta dels paràmetres dels mètodes.\

en-us	#### PSK contains an odd number of hex-digits  Proxy or agent does not start, message in the proxy or agent log:      invalid PSK in file "/home/zabbix/zabbix_proxy.psk"
ca	#### PSK conté un nombre senar de dígits hexadecimals  El proxy o l'agent no s'inicia, missatge al proxy o al registre de l'agent:       PSK no vàlid al fitxer "/home/zabbix/zabbix_proxy.psk"

en-us	#### PSK identity string longer than 128 bytes is passed to GnuTLS  In TLS client side log:      gnutls_handshake() failed: -110 The TLS connection was non-properly terminated.  In TLS server side log.      gnutls_handshake() failed: -90 The SRP username supplied is illegal.
ca	#### La cadena d'identitat PSK de més de 128 octets es passa a GnuTLS  Al registre del client de TLS:       gnutls_handshake() ha fallat: -110 La connexió TLS no ha acabat correctament.  Al registre del servidor TLS.       gnutls_handshake() ha fallat: -90 El nom d'usuari SRP subministrat és invàlid.

en-us	#### Public and private maps  All users in Zabbix (including non-admin users) can create network maps. Maps have an owner - the user who created them. Maps can be made public or private.  -   *Public* maps are visible to all users, although to see it the user     must have read access to at least one map element. Public maps can     be edited in case a user/ user group has read-write permissions for     this map and at least read permissions to all elements of the     corresponding map including triggers in the links.  ```{=html} <!-- --> ``` -   *Private* maps are visible only to their owner and the users/user     groups the map is [shared](/manual/config/visualization/maps/map)     with by the owner. Regular (non-Super admin) users can only share     with the groups and users they are members of. Admin level users can     see private maps regardless of being the owner or belonging to the     shared user list. Private maps can be edited by the owner of the map     and in case a user/ user group has read-write permissions for this     map and at least read permissions to all elements of the     corresponding map including triggers in the links.  Map elements that the user does not have read permission to are displayed with a grayed-out icon and all textual information on the element is hidden. However, the trigger label is visible even if the user has no permission to the trigger.  To add an element to the map the user must also have at least read permission to the element.
ca	#### Mapes públics i privats  Tots els usuaris de Zabbix (inclosos els usuaris no administradors) poden crear mapes de xarxa. Els mapes tenen un propietari: l'usuari que els ha creat. Els mapes es poden fer públics o privats.  - Els mapes *públics* són visibles per a tots els usuaris, encara que per visualitzar-los l'usuari ha de tindre accés de lectura a almenys un element del mapa. Els mapes públics es poden editar en cas que un usuari/grup d'usuaris tingui permisos de lectura i escriptura per a aquest mapa i almenys permisos de lectura per a tots els elements del mapa corresponent, inclosos els triggers dels enllaços.  ```{=html} <!-- --> ``` - Els mapes *privats* només són visibles per al seu propietari i per als usuaris/grups d'usuaris amb els quals el propietari els hagi [compartit](/manual/config/visualization/maps/map). Els usuaris habituals (no superadministradors) només poden compartir amb grups i usuaris dels quals són membres. Els usuaris de nivell d'administrador poden veure mapes privats, tant si són propietaris com si pertanyen a la llista d'usuaris compartida. Els mapes privats els pot editar el propietari del mapa i en cas que un usuari/grup d'usuaris tingui permisos de lectura i escriptura per a aquest mapa i almenys permisos de lectura per a tots els elements del mapa corresponent, inclosos els triggers dels enllaços.  Els elements del mapa per als quals l'usuari no té permís de lectura es mostren amb una icona grisa i s'amaga tota la informació textual sobre l'element. No obstant això, l'etiqueta del trigger és visible encara que l'usuari no tingui permís sobre el trigger.  Per afegir un element al mapa, l'usuari també ha de tindre almenys permisos de lectura sobre l'element.

en-us	##### Purpose of persistent files  When Zabbix agent is started it receives a list of active checks from Zabbix server or proxy.  For log\*\[\] metrics it receives the processed log size and the modification time for finding where to start log file monitoring from. Depending on the actual log file size and modification time reported by file system the agent decides either to continue log file monitoring from the processed log size or re\-analyze the log file from the beginning.  A running agent maintains a larger set of attributes for tracking all monitored log files between checks.  This in\-memory state is lost when the agent is stopped.  The new optional parameter **persistent\_dir** specifies a directory for storing this state of log\[\], log.count\[\], logrt\[\] or logrt.count\[\] item in a file. The state of log item is restored from the persistent file after the Zabbix agent is restarted.  The primary use\-case is monitoring of log file located on a mirrored file system. Until some moment in time the log file is written to both mirrors. Then mirrors are split.  On the active copy the log file is still growing, getting new records. Zabbix agent analyzes it and sends processed logs size and modification time to server. On the passive copy the log file stays the same, well behind the active copy. Later the operating system and Zabbix agent are rebooted from the passive copy. The processed log size and modification time the Zabbix agent receives from server may not be valid for situation on the passive copy.  To continue log file monitoring from the place the agent left off at the moment of file system mirror split the agent restores its state from the persistent file.
ca	##### Objectiu dels fitxers persistents  Quan s'inicia l'agent Zabbix, rep una llista de comprovacions actives del servidor o proxy Zabbix. Per a les mètriques de registre\*\[\], rep la mida del registre processat i el temps de modificació per trobar on començar a monitorar el fitxer de registre. En funció de la mida real del fitxer de registre i del temps de modificació informat pel sistema de fitxers, l'agent decideix si continua monitorant el fitxer de registre en funció de la mida del registre processat o torna a escanejar el fitxer de registre des del principi.  Un agent en execució manté un conjunt més gran d'atributs per fer el seguiment de tots els fitxers de registre monitorats entre comprovacions. Aquest estat a la memòria es perd quan s'atura l'agent.  El nou paràmetre opcional **persistent\_dir** especifica un directori on emmagatzemar aquest estat de l'element log\[\], log.count\[\], logrt\[\] o logrt.count\[\] a la carpeta A. L'estat de l'element de registre es restaura des del fitxer persistent després de reiniciar l'agent Zabbix.  El cas d'ús principal és monitorar el fitxer de registre situat en un sistema de fitxers duplicat. Fins a un cert punt, el fitxer de registre s'escriu als dos miralls. Després es divideixen els miralls. A la còpia activa, el fitxer de registre continua creixent, obtinguent nous registres. L'agent Zabbix l'analitza i envia la mida i el temps de modificació dels registres processats al servidor. A la còpia passiva, el fitxer de registre continua sent el mateix, molt per darrere de la còpia activa. Més tard, el sistema operatiu i l'agent Zabbix es reinicien des de la còpia passiva. La mida del registre processat i el temps de modificació que l'agent Zabbix rep del servidor poden no ser vàlids per a la situació de la còpia passiva. Per continuar monitorant el fitxer de registre des d'on el va deixar l'agent quan es va dividir la rèplica del sistema de fitxers, l'agent restaura el seu estat des del fitxer persistent.

en-us	#### Query language comparison  The following table lists differences and similarities between PromQL and Zabbix Prometheus preprocessing query language.  |[PromQL instant vector selector](https://prometheus.io/docs/prometheus/latest/querying/basics/#instant-vector-selectors)|<|Zabbix Prometheus preprocessing| |----|----|----| |**Differences**|<|<| |Query target|Prometheus server|Plain text in Prometheus exposition format| |Returns|Instant vector|Metric or label value (Prometheus pattern)<br>Array of metrics for single value in JSON (Prometheus to JSON)| |Label matching operators|**=**, **!=**, **=\~**, **!\~**|**=**, **!=**, **=\~**, **!\~**| |Regular expression used in label or metric name matching|RE2|PCRE| |Comparison operators|See [list](https://prometheus.io/docs/prometheus/latest/querying/operators/#comparison-binary-operators)|Only **==** (equal) is supported for value filtering| |**Similarities**|<|<| |Selecting by metric name that equals string|<metric name> or {\_\_name\_\_="<metric name>"}|<metric name> or {\_\_name\_\_="<metric name>"}| |Selecting by metric name that matches regular expression|{\_\_name\_\_=\~"<regex>"}|{\_\_name\_\_=\~"<regex>"}| |Selecting by <label name> value that equals string|{<label name>="<label value>",...}|{<label name>="<label value>",...}| |Selecting by <label name> value that matches regular expression|{<label name>=\~"<regex>",...}|{<label name>=\~"<regex>",...}| |Selecting by value that equals string|{\_\_name\_\_=\~".\*"} == <value>|{\_\_name\_\_=\~".\*"} == <value>|
ca	#### Comparativa dels llenguatges de consultes  La taula següent llista les diferències i semblances entre el llenguatge de consulta de preprocessat PromQL i el Zabbix Prometheus.  |[Selector de vectors instantani PromQL](https://prometheus.io/docs/prometheus/latest/querying/basics/#instant-vector-selectors)|<|Preprocessat de Zabbix Prometheus| |----|----|----| |**Diferències**|<|<| |Destí de la petició|Servidor Prometheus|Text sense format en format d'exposició de Prometheus| |Retorns|Vector d'instantània|Valor de mètrica o etiqueta (plantilla Prometheus)<br>Matriu de mètriques per a un valor únic en JSON (Prometheus a JSON)| |Etiqueta operadors de concordança|**=**, **!=**, **=\~**, **!\~**|**=**, **!=**, **= \~**, **!\~**| |Expressió regular emprada a la concordança de noms d'etiquetes o mètriques|RE2|PCRE| |Operadors de comparació|Veieu [llista](https://prometheus.io/docs/prometheus/latest/querying/operators/#comparison-binary-operators)|Només **==** (igual) és compatible amb la càrrega de valor filtrada | |**Semblances**|<|<| |Trieu per nom mètric equival a cadena|<nom mètric> o {\_\_nom\_\_="<nom mètric>"}|<nom mètric> o {\_\_nom\_\_ ="<nom mètric> >>"}| |Trieu pel nom de mètrica que coincideixi amb l'expressió regular|{\_\_name\_\_=\~"\<regex\>"}|{\_\_name\_\_=\~"\< regex\>" }| |Trieu per <nom de l'etiqueta> el valor és igual a la cadena|{\<nom de l'etiqueta\>=\"<valor de l'etiqueta\>",...}|{\<nom de l'etiqueta\>= "\<valor de l'etiqueta\>", ...}| |Trieu el valor <nom de l'etiqueta> que coincideixi amb l'expressió regular |{\<nom de l'etiqueta\>=\~"\<regex\>",...}|{\<etiqueta de nom\>=\~"\<regex \>",...}| |Trieu per valor és igual a cadena|{\_\_nom\_\_=\~".\*"} == \<valor\>|{\_\_nom\_\_=\~".\* " } == \<valor\>|

en-us	#### Query syntax  The colon symbol (":") is reserved for separating the query from the key.  If a query itself contains a forward slash or a colon, these symbols should be URL-encoded ("/" is encoded as "%2F", ":" is encoded as "%3A").
ca	#### Sintaxi de la consulta  El símbol de dos punts (`:`) es reserva per separar la consulta de la clau. Si una consulta conté una barra inclinada o dos punts, aquests símbols haurien de ser codificats per URL (`/` es codifica com a `%2F`, `:` es codifica com a `%3A`).

en-us	#### Queue item  A special internal item **zabbix\[queue,<from>,<to>\]** can be used to monitor the health of the queue in Zabbix. It will return the number of items delayed by the set amount of time. For more information see [Internal items](/manual/config/items/itemtypes/internal).
ca	#### Element de la cua  Es pot emprar un element intern específic per a **zabbix\[queue,<from>,<to>\]** per controlar l'estat de la cua a Zabbix. Retornarà el nombre d'elements endarrerits en relació a la durada establerta. Per obtindre més informació, veieu els [elements interns](/manual/config/items/itemtypes/internal).

en-us	 ##### radians(value) {#radians}  Converts a value from degrees to radians.  Parameter:   -   **value** - the value to check  For example, a value '1' converted to radians will be '0.0174532925'.  Example:      radians(last(/host/key))
ca	 ##### radians(value) {#radians}  Converteix un valor de graus a radians.  Paràmetre:  - **valor** - valor que cal comprovar  Per exemple, un valor '1' convertit en radians serà '0,0174532925'.  Exemple:      radians(last(/host/key))

en-us	 ##### rand {#rand}  Return a random integer value. A pseudo-random generated number using time as seed (enough for mathematical purposes, but not cryptography).  Example:      rand()
ca	 ##### rand {#rand}  Retorna un valor enter aleatori. Un nombre generat pseudoaleatori que empra el temps com a llavor (suficient per a finalitats matemàtiques, però no per a la criptografia).  Exemple:      rand()

en-us	 ##### rate(/host/key,sec<:time shift>) {#rate}  The per-second average rate of the increase in a monotonically increasing counter within the defined time period.<br> Supported value types: *Float*, *Integer*.  Parameters:   -   See [common parameters](#common-parameters).  Functionally corresponds to '[rate](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)' of PromQL.  Example:      rate(/host/key,30s) #if the monotonic increase over 30 seconds is 20, this function will return 0.67.
ca	 ##### rate(/host/key,sec<:time shift>) {#rate}  Taxa mitjana per segon de l'augment d'un comptador que augmenta monòtonament durant el període de temps definit.<br> Tipus de valors admesos: *Flotant*, *Enter*.  Paràmetres:  - Veieu [paràmetres comuns](#common-parameters).  Funcionalment correspon a '[rate](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)' de PromQL.  Exemple:       rate(/host/key,30s) #si l'augment monòton en 30 segons és 20, aquesta funció retornarà 0,67.

en-us	##### Readable summary in maps  A hidden "aria-label" property is available allowing map information to be read with a screen reader. Both general map description and individual element description is available, in the following format:  -   for map description:     `<Map name>, <* of * items in problem state>, <* problems in total>.` -   for describing one element with one problem:     `<Element type>, Status <Element status>, <Element name>, <Problem description>.` -   for describing one element with multiple problems:     `<Element type>, Status <Element status>, <Element name>, <* problems>.` -   for describing one element without problems:     `<Element type>, Status <Element status>, <Element name>.`  For example, this description is available:      'Local network, 1 of 6 elements in problem state, 1 problem in total. Host, Status problem, My host, Free disk space is less than 20% on volume \/. Host group, Status ok, Virtual servers. Host, Status ok, Server 1. Host, Status ok, Server 2. Host, Status ok, Server 3. Host, Status ok, Server 4. '  for the following map:  ![](../../../../../assets/en/manual/web_interface/map_aria_label.png){width="600"}
ca	##### Resum llegible en mapes  Hi ha disponible una propietat oculta "aria-label" que permet llegir la informació del mapa amb un lector de pantalla. Tant la descripció general del mapa com la descripció dels elements individuals són disponibles en el format següent:  - per a la descripció del mapa:      `<Nom del mapa>, <* de * elements en estat de problema>, <* problemes en total>.` - per descriure un element amb un problema:      `<Tipus d'element>, Estat <Estat de l'element>, <Nom de l'element>, <Descripció del problema>.` - per descriure un element amb múltiples problemes:      `<Tipus d'element>, Estat <Estat de l'element>, <Nom de l'element>, <* problemes>.` - per descriure un element sense problemes:      `<Tipus d'element>, Estat <Estat de l'element>, <Nom de l'element>.`  Per exemple, aquesta descripció és disponible:       'Xarxa local, 1 de 6 elements en estat de problema, 1 problema en total. Equip, Problema d'estat, El meu equip, L'espai lliure en disc és inferior al 20% del volum \/. Grup d'equips, Estat correcte, Servidors virtuals. Equip, Estat correcte, Servidor 1. Equip, Estat correcte, Servidor 2. Equip, Estat correcte, Servidor 3. Equip, Estat correcte, Servidor 4. '  per al següent mapa:  ![](../../../../../assets/en/manual/web_interface/map_aria_label.png){width="600"}

en-us	#### Reading host availability  Host availability icons reflect the current host interface status on Zabbix server. Therefore, in the frontend:  -   If you disable a host, availability icons will not immediately turn     gray (unknown status), because the server has to synchronize the     configuration changes first. -   If you enable a host, availability icons will not immediately turn     green (available), because the server has to synchronize the     configuration changes and start polling the host first.
ca	#### Lectura de la disponibilitat de l'equip  Les icones de disponibilitat de l'equip reflecteixen l'estat actual de la interfície de l'equip al servidor Zabbix. Per tant, a la interfície web:  - Si desactiveu un equip, les icones de disponibilitat no es tornaran grises immediatament (estat desconegut), perquè primer el servidor ha de sincronitzar els canvis de configuració. - Si activeu un equip, les icones de disponibilitat no es tornaran verdes immediatament (disponibles), perquè el servidor primer ha de sincronitzar els canvis de configuració i començar a monitorar l'equip.

en-us	#### Reading the queue  To read the queue, go to *Administration → Queue*.  ![](../../../../assets/en/manual/config/items/queue.png){width="600"}  The picture here is generally "ok" so we may assume that the server is doing fine.  The queue shows some items waiting up to 30 seconds. It would be great to know what items these are.  To do just that, select *Queue details* in the title dropdown. Now you can see a list of those delayed items.  ![](../../../../assets/en/manual/config/items/queue_details.png){width="600"}  With these details provided it may be possible to find out why these items might be delayed.  With one or two delayed items there perhaps is no cause for alarm. They might get updated in a second. However, if you see a bunch of items getting delayed for too long, there might be a more serious problem.  **See also:** Aligning time zones when using [scheduling intervals](/manual/config/items/item/custom_intervals#aligning-time-zones-for-proxies-and-agent-2).  ![](../../../../assets/en/manual/config/items/queue_b.png){width="600"}
ca	#### Llegir la cua  Per llegir la cua, aneu a *Administració → Cua*.  ![](../../../../assets/en/manual/config/items/queue.png){width="600"}  La imatge aquí és generalment "OK", de manera que podem suposar que el servidor rutlla bé.  La cua mostra alguns elements que esperen fins a 30 segons. Estaria bé sapiguer què són aquests.  Per fer-ho, trieu els *Detalls de la cua* a la llista desplegable del títol. Ara podeu veure una llista d'aquests elements amb retard.  ![](../../../../assets/en/manual/config/items/queue_details.png){width="600"}  Amb aquests detalls proporcionats, és possible que es pugui esbrinar per què aquests elements es poden endarrerir.  Amb un o dos elements endarrerits, pot ser que no hi hagi cap motiu d'alarma. Es podrien actualitzar en un segon. Tanmateix, si veieu que un munt d'articles s'endarrereixen massa, podria haver-hi un problema més gros.  **Veieu també:** Alineació de zones horàries quan empreu [intervals de programació](/manual/config/items/item/custom_intervals#aligning-time-zones-for-proxies-and-agent-2).  ![](../../../../assets/en/manual/config/items/queue_b.png){width="600"}

en-us	##### Ready-to-use templates  Zabbix includes a range of ready-to-use [templates](/manual/config/templates) designed for monitoring VMware vCenter or ESXi hypervisors. These templates contain pre-configured low-level discovery rules, along with various built-in checks for monitoring virtual installations.  The following templates can be used for monitoring VMware vCenter or ESXi hypervisors:  -   [*VMware*](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware?at=refs%2Fheads%2Frelease%2F6.4) - uses UUID data for corresponding macros -   [*VMware FQDN*](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware_fqdn?at=refs%2Fheads%2Frelease%2F6.4) - uses FQDN data for corresponding macros  ::: noteclassic For the correct functioning of the *VMware FQDN* template, each monitored virtual machine should have a unique OS name adhering to FQDN rules. Additionally, VMware Tools must be installed on every machine. If these prerequisites are met, using the *VMware FQDN* template is recommended. The *VMware FQDN* template has been available since Zabbix 5.2 with the introduction of the ability to create hosts with custom interfaces. <br><br> A classic *VMware* template is also available and can be used if FQDN requirements are unmet. However, the *VMware* template has a known issue. Hosts for discovered virtual machines are created with names that are saved in vCenter (for example, "VM1", "VM2", etc.). If Zabbix agent is installed on these hosts, and active Zabbix agent autoregistration is enabled, the autoregistration process will read host names as they were registered during launch (for example, "vm1.example.com", "vm2.example.com", etc.). This can lead to the creation of new hosts for existing virtual machines (since no name matches have been found), resulting in duplicate hosts with different names. :::  The following templates are used for discovered entities and, typically, should not be manually linked to a host:  -   *VMware Hypervisor* -   *VMware Guest*
ca	#### Plantilles predeterminades  El conjunt de dades predeterminat de Zabbix ofereix diverses plantilles llestes per emprar per monitorar VMware vCenter o directament l'hipervisor ESX. Aquestes plantilles contenen regles [LLD](/manual/discovery/low_level_discovery) preconfigurades, així com una sèrie de comprovacions integrades per monitorar les instal·lacions virtuals.  Plantilles per al monitoratge de l'hipervisor VMware vCenter i ESX:  - [*VMware*](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware?at=refs%2Fheads%2Frelease%2F6.4) - empra dades UUID per a les macros corresponents; - [*VMware FQDN*](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware_fqdn?at=refs%2Fheads%2Frelease%2F6.4) - empra dades de FQDN per a les macros corresponents.  ::: noteclassic   Perquè la plantilla *VMware FQDN* funcioni correctament, cada màquina virtual monitorada ha de tindre un nom de sistema operatiu únic que compleixi amb les regles de FQDN i VMware Tools s'ha d'instal·lar a cada màquina. Si es compleixen aquestes condicions, es recomana emprar la plantilla *VMware FQDN*. La creació de la plantilla *VMware FQDN* és possible després d'introduir la possibilitat de crear equips amb interfícies personalitzades a Zabbix 5.2.  Una plantilla clàssica *VMware* encara és disponible i es pot emprar si no es poden complir els requisits de FQDN. Tingueu en compte que la plantilla *VMware* té un problema conegut. Els equips per a les màquines virtuals descobertes es crearan amb els noms desats al vCenter (per exemple, "VM1", "VM2", etc.). Si l'agent Zabbix actiu s'instal·la en aquests equips més tard amb l'autoregistre activat, el procés d'autoregistre llegirà els noms d'equips tal com s'han registrat en iniciar-se (per exemple, "vm1.exemple.cat", "vm2.exemple.cat", etc.) i crearà nous equips ja que no s'han trobat noms coincidents. Com a resultat, hi haurà dos equips duplicats per a cada màquina amb noms diferents. :::  Plantilles emprades per discovery (normalment, aquestes plantilles no s'han d'enllaçar manualment a un equip):  - *Hipervisor VMware* - *VMware Guest*

en-us	##### Rebranding  [Rebranding](/manual/web_interface/rebranding) is a way to customize the user interface of your Zabbix frontend installation. You can customize the user interface in the following ways:  -   Replace the Zabbix logo with a desired one. -   Hide links to *Zabbix Support* and *Zabbix Integrations*. -   Set a custom link to the *Help* page. -   Change the copyright notice in the footer.  Note: you can also create you own Zabbix [themes](/manual/web_interface/theming) to better fit the rebranding.
ca	##### Canvi de marca  [Canvi de marca](/manual/web_interface/rebranding) és una manera de personalitzar la interfície d'usuari de la vostra interfície de Zabbix. Podeu personalitzar la interfície d'usuari de les maneres següents:  - Substituïu el logotip de Zabbix per un de desitjat. - Amaga els enllaços a *Zabbix Support* i *Zabbix Integrations*. - Establiu un enllaç personalitzat a la pàgina *Ajuda*. - Canvieu l'avís de drets d'autor al peu de pàgina.  Nota: també podeu crear el vostre [tema](/manual/web_interface/theming) de Zabbix per adaptar-vos millor al canvi de marca.

en-us	##### Receiver response  The response consists of the HTTP response status code and the JSON payload. The HTTP response status code must be "200" for requests that were handled successfully, other for failed requests.  Example of success:  ```json localhost:8080/v1/history": HTTP/1.1 200 OK Date: Wed, 11 Jan 2023 16:40:30 GMT Content-Length: 0 ```  Example with errors:  ```json localhost:8080/v1/history": HTTP/1.1 422 Unprocessable Entity Content-Type: application/json Date: Wed, 11 Jan 2023 17:07:36 GMT Content-Length: 55   {"error":"invalid character '{' after top-level value"} ```
ca	##### Resposta del receptor  La resposta consisteix en el codi d'estat de resposta HTTP i la càrrega útil JSON. El codi d'estat de la resposta HTTP ha de ser "200" per a les peticions que s'han gestionat correctament, una altra per a les peticions fallides.  Exemple d'èxit:  ```json localhost:8080/v1/history": HTTP/1.1 200 OK Date: Wed, 11 Jan 2023 16:40:30 GMT Content-Length: 0 ```  Exemple amb errors:  ```json localhost:8080/v1/history": HTTP/1.1 422 Unprocessable Entity Content-Type: application/json Date: Wed, 11 Jan 2023 17:07:36 GMT Content-Length: 55   {"error":"invalid character '{' after top-level value"} ```

en-us	#### Receiving notification  Now, with delivering notifications configured, it would be fun to actually receive one. To help with that, we might on purpose increase the load on our host - so that our [trigger](trigger#adding_trigger) "fires" and we receive a problem notification.  Open the console on your host and run:      cat /dev/urandom | md5sum  You may run one or several of [these processes](http://en.wikipedia.org/wiki/Md5sum).  Now go to *Monitoring → Latest data* and see how the values of 'CPU Load' have increased. Remember, for our trigger to *fire*, the 'CPU Load' value has to go over '2' for 3 minutes running. Once it does:  -   in *Monitoring → Problems* you should see the trigger with a     flashing 'Problem' status -   you should receive a problem notification in your email  ::: noteimportant If notifications do not work:  -   verify once again that both the email settings and the action have     been configured properly -   make sure the user you created has at least read permissions on the     host which generated the event, as noted in the *[Adding     user](login#adding_user)* step. The user, being part of the 'Zabbix     administrators' user group must have at least read access to 'Linux     servers' host group that our host belongs to. -   Additionally, you can check out the action log by going to *Reports     → Action log*.   :::
ca	#### Rebuda de notificacions  Ara, amb el lliurament de notificacions configurat, seria maco obtenir-ne una. Per provar-ho, podem augmentar la càrrega del nostre equip d'una manera específica, de manera que el nostre disparador "s'encén" i rebem una notificació de problema.  Obriu la consola al vostre equip i executeu:       cat /dev/urandom | md5sum  Podeu executar un o més d'[aquests processos](http://en.wikipedia.org/wiki/Md5sum).  Ara aneu a *Monitoratge → Dades més recents* i mireu com han augmentat els valors de 'Càrrega de CPU'. Tingueu en compte que perquè el nostre trigger s'activi, el valor de "Càrrega de CPU" ha de ser per damunt de '2' durant 3 minuts. Quan això passa:  - a *Monitoratge → Problemes* hauríeu de veure el disparador amb un estat de "Problema" intermitent - hauríeu de rebre una notificació de problema als vostres correus electrònics.  ::: noteimportant Si les notificacions no funcionen:  - Comproveu de nou que els paràmetres de correu electrònic i d'acció siguin configurats correctament. - Assegureu-vos que l'usuari que heu creat té almenys permís de lectura a l'equip que ha generat l'esdeveniment, tal com s'indica a la passa *[Afegir usuari](login#adding_user)*. L'usuari que forma part del grup d'usuaris 'Administradors Zabbix' ha de tindre almenys accés de lectura al grup d'equips 'Servidors Linux' al qual pertany el nostre equip. - A més, podeu veure el registre d'accions anant a *Informes → Registre d'accions*. :::

en-us	##### Recent change markers  Inward pointing red triangles around an element indicate a recent trigger status change - one that's happened within the last 30 minutes. These triangles are shown if the *Mark elements on trigger status change* check-box is marked in map [configuration](/manual/config/visualization/maps/map#creating_a_map).
ca	##### Marcadors de canvis recents  Els triangles vermells cap a dins al voltant d'un element indiquen un canvi d'estat d'activació, que s'ha produït durant els darrers 30 minuts. Aquests triangles es mostren si la casella de selecció *Marca els elements al canvi d'estat d'activació* és marcada a la [configuració](/manual/config/visualization/maps/map#creating_a_map) del mapa.

en-us	#### Recent data vs longer periods  For very recent data a **single** line is drawn connecting each received value. The single line is drawn as long as there is at least one horizontal pixel available for one value.  For data that show a longer period **three lines** are drawn - a dark green one shows the average, while a light pink and a light green line shows the maximum and minimum values at that point in time. The space between the highs and the lows is filled with yellow background.  Working time (working days) is displayed in graphs as a white background, while non-working time is displayed in gray (with the *Original blue* default frontend theme).  ![](../../../../../assets/en/manual/config/graph_working_time.png){width="550"}  Working time is always displayed in simple graphs, whereas displaying it in [custom graphs](custom#configuring_custom_graphs) is a user preference.  Working time is not displayed if the graph shows more than 3 months.
ca	#### Dades recents i períodes llargs  Per a dades molt recents, es dibuixa una línia **única** que connecta cada valor rebut. La línia única es dibuixa sempre que hi hagi almenys un píxel horitzontal disponible per a un valor.  Per a les dades que mostren un període més llarg, es dibuixen **tres línies**: una línia verda fosca indica la mitjana, mentre que una línia rosa clara i una línia verda clara indiquen els valors màxim i mínim en aquest moment. L'espai entre els alts i els baixos s'omple de fons groc.  El temps de treball (dies laborables) es mostra en gràfics amb un fons blanc, mentre que el temps no laborable es mostra en gris (amb el tema frontal predeterminat *Blau original*).  ![](../../../../../assets/en/manual/config/graph_working_time.png){width="550"}  El temps de treball sempre es mostra en gràfics senzills, mentre que mostrar-lo a [gràfics personalitzats](custom#configuring_custom_graphs) és una preferència de l'usuari.  El temps de treball no es mostra si el gràfic mostra més de 3 mesos.

en-us	#### Recovery operation details  ![](../../../../../assets/en/manual/config/recovery_operation_details.png){width="600"}  Three operation types are available for recovery events:  -   **Send message** - send recovery message to specified user. -   **Notify all involved** - send recovery message to all users who were notified on the problem event. -   **<remote command name>** - execute a remote command. Commands are available for execution if previously defined in [global scripts](/manual/web_interface/frontend_sections/alerts/scripts#configuring_a_global_script) with *Action operation* selected as its scope.  Parameters for each operation type are described below. All mandatory input fields are marked with a red asterisk. When done, click on *Add* to add operation to the list of *Recovery operations*.  ::: noteclassic Note that if the same recipient is defined in several operation types without specified *Custom message*, duplicate notifications are not sent. :::
ca	#### Detalls de l'operació de recuperació  ![](../../../../../assets/en/manual/config/recovery_operation_details.png){width="600"}  Hi ha tres tipus d'operacions disponibles per als esdeveniments de recuperació: - **Enviar missatge** - envia un missatge de recuperació a l'usuari especificat - **Notificar a tots els implicats** - envia un missatge de recuperació a tots els usuaris que van rebre una notificació de l'esdeveniment problemàtic - **\<nom de la comanda remota\>** - executa una comanda remota. Les ordres són disponibles per a l'execució si s'han definit prèviament a [scripts globals](/manual/web_interface/frontend_sections/alerts/scripts#configuring_a_global_script) amb *Action Operation* triat com a àmbit.  A continuació es descriuen els paràmetres per a cada tipus d'operació. Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Quan hagueu acabat, feu clic a *Afegir* per afegir una operació a la llista d'*Operacions de recuperació*.  :::noteclassic Tingueu en compte que si el mateix destinatari es defineix a diversos tipus de transaccions sense especificar un *missatge personalitzat*, no s'enviaran pas notificacions duplicades. :::

en-us	### Red Hat Enterprise Linux  Open the `/etc/yum.repos.d/zabbix.repo` file and set enabled=1 for the `zabbix-unstable` repo.    [zabbix-unstable]  name=Zabbix Official Repository (unstable) - $basearch  baseurl=https://repo.zabbix.com/zabbix/6.4/rhel/8/$basearch/  enabled=1  gpgcheck=1  gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591
ca	### Red Hat Enterprise Linux  Obriu l'arxiu `/etc/yum.repos.d/zabbix.repo` i definiu enabled=1 per al repositori `zabbix-unstable`.       [zabbix-unstable]     name=Zabbix Official Repository (unstable) - $basearch     baseurl=https://repo.zabbix.com/zabbix/6.4/rhel/8/$basearch/     enabled=1     gpgcheck=1     gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591

en-us	 ##### redis.config[connString,<password>,<pattern>]  <br> Gets the configuration parameters of a Redis instance that match the pattern.<br> Return value: *JSON* - if a glob-style pattern was used; single value - if a pattern did not contain any wildcard character.  Parameters:  -   **connString** - the URI or session name;<br> -   **password** - the Redis password;<br> -   **pattern** - a glob-style pattern (*\** by default).
ca	 ##### redis.config[connString,<password>,<pattern>]  <br> Obté els paràmetres de configuració d'una instància de Redis que coincideixen amb el patró.<br> Valor de retorn: *JSON* - si s'ha emprat un patró d'estil glob; valor únic: si un patró no contenia cap caràcter comodí.  Paràmetres:  - **connString** - URI o nom de la sessió;<br> - **mot de pas** - mot de pas de Redis;<br> - **patró** - un patró d'estil globus (*\** per defecte).

en-us	 ##### redis.info[connString,<password>,<section>]  <br> Gets the output of the INFO command.<br> Return value: *JSON* - the output is serialized as JSON.  Parameters:  -   **connString** - the URI or session name;<br> -   **password** - the Redis password;<br> -   **section** - the [section](https://redis.io/commands/info) of information (*default* by default).<br>
ca	 ##### redis.info[connString,<password>,<section>]  <br> Obté la sortida de l'ordre INFO.<br> Valor de retorn: *JSON* - la sortida es serialitza com a JSON.  Paràmetres:  - **connString** - URI o nom de la sessió;<br> - **mot de pas** - mot de pas de Redis;<br> - **secció** - [secció](https://redis.io/commands/info) d'informació (per defecte és *per defecte*).<br>

en-us	 ##### redis.ping[connString,<password>]  <br> Test if a connection is alive or not.<br> Return value: *1* - the connection is alive; *0* - the connection is broken (if there is any error presented including AUTH and configuration issues).  Parameters:  -   **connString** - the URI or session name;<br> -   **password** - the Redis password.<br>
ca	 ##### redis.ping[connString,<password>]  <br> Comprova si una connexió és activa o no.<br> Valor de retorn: *1* - la connexió és activa; *0*: la connexió és fallida (si es presenta algun error inclosos problemes d'AUTH i de configuració).  Paràmetres:  - **connString** - URI o el nom de la sessió;<br> - **mot de pas** - mot de pas de Redis.<br>

en-us	 ##### redis.slowlog.count[connString,<password>]  <br> The number of slow log entries since Redis was started.<br> Return value: *Integer*.  Parameters:  -   **connString** - the URI or session name;<br> -   **password** - the Redis password.<br>
ca	 ##### redis.slowlog.count[connString,<password>]  <br> Nombre d'entrades de registre lentes des que es va iniciar Redis.<br> Valor de retorn: *Enter*.  Paràmetres:  - **connString** - URI o nom de la sessió;<br> - **mot de pas** - mot de pas de Redis.<br>

en-us	##### Referencing a network map  Network maps can be referenced by both `sysmapid` and `mapname` GET parameters. For example,      http://zabbix/zabbix/zabbix.php?action=map.view&mapname=Local%20network  will open the map with that name (Local network).  If both `sysmapid` (map ID) and `mapname` (map name) are specified, `mapname` has higher priority.
ca	##### Referenciar un mapa de xarxa  Els adaptadors de xarxa es poden fer referència als paràmetres GET `sysmapid` i `mapname`. Per exemple,       http://zabbix/zabbix/zabbix.php?action=map.view&mapname=Local%20network  obrirà el mapa amb aquest nom (Xarxa local).  Si s'especifiquen `sysmapid' (ID del mapa) i `mapname' (nom del mapa), `mapname' té una prioritat més alta.

en-us	##### RefreshActiveChecks  How often the list of active checks is refreshed, in seconds. Note that after failing to refresh active checks the next refresh will be attempted in 60 seconds.  Default: `5`<br> Range: 1-86400
ca	##### RefreshActiveChecks  Amb quina freqüència s'actualitza la llista de comprovacions actives, en segons. Tingueu en compte que després de no poder actualitzar les comprovacions actives, la següent actualització es provarà en 60 segons.  Per defecte: `5`<br> Rang: 1-86400

en-us	##### RefreshActiveChecks  How often the list of active checks is refreshed, in seconds. Note that after failing to refresh active checks the next refresh will be attempted in 60 seconds.  Default: `5`<br> Range: 1-86400
ca	##### RefreshActiveChecks  Amb quina freqüència s'actualitza la llista de comprovacions actives, en segons. Tingueu en compte que després de no poder actualitzar les comprovacions actives, la següent actualització es provarà en 60 segons.  Per defecte: `5`<br> Rang: 1-86400

en-us	##### RefreshActiveChecks  How often the list of active checks is refreshed, in seconds. Note that after failing to refresh active checks the next refresh will be attempted in 60 seconds.  Default: `5`<br> Range: 1-86400
ca	##### RefreshActiveChecks  Amb quina freqüència s'actualitza la llista de comprovacions actives, en segons. Tingueu en compte que després de no poder actualitzar les comprovacions actives, la següent actualització es provarà en 60 segons.  Per defecte: `5`<br> Rang: 1-86400

en-us	##### RefreshActiveChecks  How often the list of active checks is refreshed, in seconds. Note that after failing to refresh active checks the next refresh will be attempted in 60 seconds.  Default: `5`<br> Range: 1-86400
ca	##### RefreshActiveChecks  Amb quina freqüència s'actualitza la llista de comprovacions actives, en segons. Tingueu en compte que després de no poder actualitzar les comprovacions actives, la següent actualització es provarà en 60 segons.  Per defecte: `5`<br> Rang: 1-86400

en-us	### 'Refresh proxy configuration' request object  The 'Refresh proxy configuration' task request object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |proxy_hostids|array|Proxy IDs.|
ca	### Objecte de consulta 'Recarrega la configuració del proxy'  Té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |proxy_hostids|array|Proxy IDs.|

en-us	# regexp.create
ca	# regexp.create

en-us	# regexp.delete
ca	# regexp.delete

en-us	# regexp.get
ca	# regexp.get

en-us	# regexp.update
ca	# regexp.update

en-us	# Register a new module  This section explains how to add a new module to Zabbix frontend.
ca	# Registrar un mòdul nou  Aquesta secció explica com afegir un mòdul nou a la interfície Zabbix.

en-us	 ###### Register request  A request sent by the agent during the agent startup phase to obtain provided metrics to register a plugin.  |   |   | |---|---| |direction|agent → plugin| |response|yes|  Parameters specific to register requests:  |Name|Type|Comments| |---------|--------|----------| |version|string|The protocol version <major>.<minor>|  *Example:*      {"id":1,"type":2,"version":"1.0"}
ca	###### Petició d'enregistrament  Petició enviada per l'agent durant la fase d'inici de l'agent per obtindre les mètriques proveïdes per enregistrar un plugin.  |   |   | |---|---| |direction|agent → plugin| |response|yes|  Paràmetres específics de les peticions d'enregistrament:  |Nom|Tipus|Comentaris| |---------|--------|----------| |version|string|La versió del protocol <major>.<minor>|  *Exemple:*      {"id":1,"type":2,"version":"1.0"}

en-us	 ###### Register response  Plugin's response to the register request.  |   |   | |---|---| |direction|plugin → agent| |response|n/a|  Parameters specific to register responses:  |Name|Type|Comments| |---------|--------|----------| |name|string|The plugin name.| |metrics|array of strings (optional)|The metrics with descriptions as used in the plugin. Returns RegisterMetrics(). Absent if error is returned.| |interfaces|uint32 (optional)|The bit mask of plugin's supported interfaces. Absent if error is returned.| |error|string (optional)|An error message returned if a plugin cannot be started. Absent, if metrics are returned.|  *Examples:*      {"id":2,"type":3,"metrics":["external.test", "External exporter Test."], "interfaces": 4}  or      {"id":2,"type":3,"error":"error message"}
ca	###### Resposta d'enregistrament  resposta del plug-in a la petició d'enregistrament.  |   |   | |---|---| |direction|plugin → agent| |réponse|n/a|  Paràmetres específics de les respostes d'enregistraments:  |Nom|Tipus|Comentaris| |---------|--------|----------| |name|string|El nom del plug-in.| |metrics|array of strings (optional)|Les mètriques amb les descripcions com s'empren al plug-in. Retorna RegisterMetrics(). Absent si es retorna un error.| |interfaces|uint32 (optional)|La màscara binària de les interfícies admeses per el plug-in. Absent si es retorna un error.| |error|string (optional)|Retorna un missatge d'error si no es pot engegar un plug-in. Absent si les mètriques són retornades.|  *Exemples:*      {"id":2,"type":3,"metrics":["external.test", "Test de l'exportateur externe."], "interfaces": 4}  ou      {"id":2,"type":3,"error":"message d'erreur"}

en-us	 ##### registry.data[key,<value name>] {#registry-data}  <br> Return data for the specified value name in the Windows Registry key.<br> Return value: *Integer*, *string* or *text* (depending on the value type)  Parameters:  -   **key** - the registry key including the root key; root abbreviations (e.g. HKLM) are allowed; -   **value name** - the registry value name in the key (empty string "" by default). The default value is returned if the value name is not supplied.  Comments:  -   Supported root abbreviations:<br>HKCR - HKEY_CLASSES_ROOT<br>HKCC - HKEY_CURRENT_CONFIG<br>HKCU - HKEY_CURRENT_USER<br>HKCULS - HKEY_CURRENT_USER_LOCAL_SETTINGS<br>HKLM - HKEY_LOCAL_MACHINE<br>HKPD - HKEY_PERFORMANCE_DATA<br>HKPN - HKEY_PERFORMANCE_NLSTEXT<br>HKPT - HKEY_PERFORMANCE_TEXT<br>HKU - HKEY_USERS<br> -   Keys with spaces must be double-quoted.  Examples:      registry.data["HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting"] #return the data of the default value of this key     registry.data["HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting","EnableZip"] #return the data of the value named "Enable Zip" in this key
ca	 ##### registry.data[key,<value name>] {#registry-data}  <br> Retorna les dades del nom del valor especificat a la clau del registre de Windows.<br> Valor de retorn: *Enter*, *cadena* o *text* (segons el tipus de valor)  Paràmetres:  - **clau** - clau del registre inclosa la clau arrel; es permeten abreujatures d'arrel (per exemple, HKLM); - **nom del valor** - nom del valor del registre a la clau (cadena buida "" per defecte). El valor per defecte es retorna si no es proporciona el nom del valor.  Comentaris:  - Abreujatures arrel admeses:<br>HKCR - HKEY_CLASSES_ROOT<br>HKCC - HKEY_CURRENT_CONFIG<br>HKCU - HKEY_CURRENT_USER<br>HKCULS - HKEY_CURRENT_USER_LOCAL_SETTINGS<br>HKLM - HKEY_LOCAL_MACHINE<br>HKPD - HKEY_PERFORMANCE_DATA<br>HKPN - HKEY_PERFORMANCE_NLSTEXT<br>HKPT - HKEY_PERFORMANCE_TEXT<br>HKU - HKEY_USERS<br> - Les claus amb espais han de ser entre cometes.  Exemples:       registry.data["HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting"] #retorna les dades del valor predeterminat d'aquesta clau      registry.data["HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting","EnableZip"] #retorna les dades del valor anomenat "Enable Zip" en aquesta clau

en-us	 ##### registry.get[key,<mode>,<name regexp>] {#registry-get}  <br> The list of Windows Registry values or keys located at given key.<br> Return value: *JSON object*.  Parameters:  -   **key** - the registry key including the root key; root abbreviations (e.g. HKLM) are allowed (see comments for registry.data\[\] to see full list of abbreviations);<br> -   **mode** - possible values:<br>*values* (default) or *keys*;<br> -   **name regexp** - only discover values with names that match the regexp (default - discover all values). Allowed only with *values* as `mode`.  Keys with spaces must be double-quoted.  Examples:      registry.get[HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall,values,"^DisplayName|DisplayVersion$"] #return the data of the values named "DisplayName" or "DisplayValue" in this key. The JSON will include details of the key, last subkey, value name, value type and value data.     registry.get[HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall,values] #return the data of the all values in this key. The JSON will include details of the key, last subkey, value name, value type and value data.     registry.get[HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall,keys] #return all subkeys of this key. The JSON will include details of the key and last subkey.
ca	 ##### registry.get[key,<mode>,<name regexp>] {#registry-get}  <br> Llistat de valors o claus del Registre de Windows que es troben a la clau determinada.<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **clau** - clau del registre inclosa la clau arrel; Les abrujatures arrel (per exemple, HKLM) es permeten (vegeu els comentaris de registry.data\[\] per veure el llistat d'abrujatures admeses);<br> - **mode** - valors possibles:<br>*valors* (per defecte) o *claus*;<br> - **name regexp** - només descobreix valors amb noms que coincideixen amb l'expressió regular (per defecte: descobreix tots els valors). Només es permet amb *valors* com a "mode".  Les claus amb espais han de ser entre cometes.  Exemples:       registry.get[HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall,values,"^DisplayName|DisplayVersion$"] #retorna les dades dels valors anomenats "DisplayName" o "DisplayValue" en aquesta clau. El JSON inclourà detalls de la clau, darrera subclau, nom del valor, tipus de valor i dades de valor.      registry.get[HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall,values] #retorna les dades de tots els valors d'aquesta clau. El JSON inclourà detalls de la clau, darrera subclau, nom del valor, tipus de valor i dades de valor.      registry.get[HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall,keys] #retorn totes les subclaus d'aquesta clau. El JSON inclourà detalls de la clau i la darrera subclau.

en-us	#### Regular expression limitations in Zabbix agent 2  Zabbix agent 2 does not support lookaheads and lookbehinds in regular expressions due to the standard Go regexp library limitations.
ca	#### Limitacions d'expressió regular a l'agent Zabbix 2  L'agent Zabbix 2 no admet els lookaheads i lookbacks a les expressions regulars degut a les limitacions estàndard de la biblioteca d'expressions regulars de Go.

en-us	# > Regular expression object  The following objects are directly related to the `regexp` API.
ca	# > Objecte d'expressió regular  Els següents objectes són relacionats amb l'API `regexp`.

en-us	#### - Regular expressions  This section allows creating custom regular expressions that can be used in several places in the frontend. See [Regular expressions](/manual/regular_expressions) section for details.
ca	#### - Expressions regulars  Aquesta secció us permet crear expressions regulars personalitzades que es poden emprar a diversos llocs de la interfície. Veieu [Expressions regulars](/manual/regular_expressions) per a més detalls.

en-us	#### Regular expression support by location  |Location|<|Regular expression|Global regular expression|Multiline matching|Comments| |-|----------|---------|---------|---------|--------------------| |**[Agent items](/manual/config/items/itemtypes/zabbix_agent)**|<|<|<|<|<| |<|eventlog\[\]|Yes|Yes|Yes|`regexp`, `severity`, `source`, `eventid` parameters| |^|log\[\]|^|^|^|`regexp` parameter| |^|log.count\[\]|^|^|^|^| |^|logrt\[\]|^|Yes/No|^|`regexp` parameter supports both, `file_regexp` parameter supports non-global expressions only| |^|logrt.count\[\]|^|^|^|^ |^|proc.cpu.util\[\]|^|No|No|`cmdline` parameter| |^|proc.get\[\]|^|^|^|^| |^|proc.mem\[\]|^|^|^|^| |^|proc.num\[\]|^|^|^|^| |^|sensor\[\]|^|^|^|`device` and `sensor` parameters on Linux 2.4| |^|system.hw.macaddr\[\]|^|^|^|`interface` parameter| |^|system.sw.packages\[\]|^|^|^|`regexp` parameter| |^|system.sw.packages.get\[\]|^|^|^|`regexp` parameter| |^|vfs.dir.count\[\]|^|^|^|`regex_incl`, `regex_excl`, `regex_excl_dir` parameters| |^|vfs.dir.get\[\]|^|^|^|`regex_incl`, `regex_excl`, `regex_excl_dir` parameters| |^|vfs.dir.size\[\]|^|^|^|`regex_incl`, `regex_excl`, `regex_excl_dir` parameters| |^|vfs.file.regexp\[\]|^|^|Yes|`regexp` parameter| |^|vfs.file.regmatch\[\]|^|^|^|^| |^|web.page.regexp\[\]|^|^|^|^| |**[SNMP traps](/manual/config/items/itemtypes/snmptrap)**|<|<|<|<|<| |<|snmptrap\[\]|Yes|Yes|No|`regexp` parameter| |**[Item value preprocessing](/manual/config/items/item#item_value_preprocessing)**|<|Yes|No|No|`pattern` parameter| |**[Functions for triggers/calculated items](/manual/appendix/functions)**|<|<|<|<|<| |<|count()|Yes|Yes|Yes|`pattern` parameter if `operator` parameter is *regexp* or *iregexp*| |<|countunique()|Yes|Yes|^|^| |<|find()|Yes|Yes|^|^| |^|logeventid()|Yes|Yes|No|`pattern` parameter| |^|logsource()|^|^|^|^| |**[Low-level discovery](/manual/discovery/low_level_discovery#discovery_rule_filter)**|<|<|<|<|<| |<|Filters|Yes|Yes|No|*Regular expression* field| |^|Overrides|Yes|No|^|In *matches*, *does not match* options for *Operation* conditions| |**[Action conditions](/manual/config/notifications/action/conditions)**|<|Yes|No|No|In *matches*, *does not match* options for *Host name* and *Host metadata* autoregistration conditions| |**[Web monitoring](/manual/web_monitoring#configuring_a_web_scenario)**|<|Yes|No|Yes|*Variables* with a **regex:** prefix<br>*Required string* field| |**[User macro context](/manual/config/macros/user_macros#user_macro_context)**|<|Yes|No|No|In macro context with a **regex:** prefix| |**[Macro functions](/manual/config/macros/macro_functions)**|<|<|<|<|<| |<|regsub()|Yes|No|No|`pattern` parameter| |^|iregsub()|^|^|^|^| |**[Icon mapping](/manual/web_interface/frontend_sections/administration/general#icon_mapping)**|<|Yes|Yes|No|*Expression* field| |**[Value mapping](/manual/config/items/mapping#configuration)**|<|Yes|No|No|*Value* field if mapping type is `regexp`|
ca	#### Suport de les expressions regulars per ubicació  |Ubicació|<|Expressió regular|Expressió regular global|Concordança multilínia|Comentaris| |-|----------|----------|----------|----------|------- ---------------| |**[Elements de l'agent](/manual/config/items/itemtypes/zabbix_agent)**|<|<|<|<|<| |<|eventlog\[\]|Sí|Sí|Sí|Paràmetres `regexp`, `severity`, `source`, `eventid`| |^|log\[\]|^|^|^|paràmetre `regexp`| |^|log.count\[\]|^|^|^|^| |^|logrt\[\]|^|Sí/No|^|El paràmetre `regexp` admet totes dues, el paràmetre `file_regexp` només admet expressions no globals| |^|logrt.count\[\]|^|^|^|^ |^|proc.cpu.util\[\]|^|No|No|paràmetre `cmdline`| |^|proc.mem\[\]|^|^|^|^| |^|proc.num\[\]|^|^|^|^| |^|sensor\[\]|^|^|^|paràmetres `dispositiu` i `sensor` a Linux 2.4| |^|system.hw.macaddr\[\]|^|^|^|paràmetre `interface`| |^|system.sw.packages\[\]|^|^|^|paràmetre `package`| |^|system.sw.packages.get\[\]|^|^|^|paràmetre `regexp`| |^|vfs.dir.count\[\]|^|^|^|Paràmetres `regex_incl`, `regex_excl`, `regex_excl_dir`| |^|vfs.dir.get\[\]|^|^|^|Paràmetres `regex_incl`, `regex_excl`, `regex_excl_dir`| |^|vfs.dir.size\[\]|^|^|^|Paràmetres `regex_incl`, `regex_excl`, `regex_excl_dir`| |^|vfs.file.regexp\[\]|^|^|Sí|paràmetre `regexp`| |^|vfs.file.regmatch\[\]|^|^|^|^| |^|web.page.regexp\[\]|^|^|^|^| |**[Traps SNMP](/manual/config/items/itemtypes/snmptrap)**|<|<|<|<|<| |<|snmptrap\[\]|Sí|Sí|No|paràmetre `regexp`| |**[Preprocessament del valor de l'element](/manual/config/items/item#item_value_preprocessing)**|<|Sí|No|No|paràmetre `pattern`| |**[Funcions per a triggers/elements calculats](/manual/apèndix/funcions)**|<|<|<|<|<| |<|count()|Yes|Yes|Yes|paràmetre `pattern` si el paràmetre `operator` és *regexp* o *iregexp*| |<|countunique()|sí|sí|^|^| |<|find()|Sí|Sí|^|^| |^|logeventid()|Sí|Sí|No|paràmetre `patró`| |^|logsource()|^|^|^|^| |**[Descoberta de baix nivell](/manual/discovery/low_level_discovery#discovery_rule_filter)**|<|<|<|<|<| |<|Filters|Sí|Sí|No|Camp *Expressió regular*| |^|Overrides|Sí|No|^|A les opcions *coincideix*, *no coincideix* per a les condicions de *operació*| |**[Condicions d'acció](/manual/config/notifications/action/conditions)**|<|Sí|No|No|A les opcions *coincideix*, *no coincideix* per a *Nom d'equip * i *Metadades de l'equip* de condicions d'autoinscripció| |**[Monitoratge web](/manual/web_monitoring#configuring_a_web_scenario)**|<|Sí|No|Sí|*Variables* amb un prefix **regex:**<br>Camp *String required*| |**[Context de macro d'usuari](/manual/config/macros/user_macros#user_macro_context)**|<|Sí|No|No|En un context de macro amb un prefix **regex:**| |**[Funcions de macro](/manual/config/macros/macro_functions)**|<|<|<|<|<| |<|regsub()|Sí|No|No|paràmetre `pattern`| |^|iregsub()|^|^|^|^| |**[Mapa d'icones](/manual/web_interface/frontend_sections/administration/general#icon_mapping)**|<|Sí|Sí|No|Camp *Expressió*| |**[Mapa de valors](/manual/config/items/mapping#configuration)**|<|Sí|No|No|Camp *Valor* si el tipus de mapatge és `regexp`|

en-us	#### Regular expressions  You may manually enter a regular expression in supported places. Note that the expression may not start with @ because that symbol is used in Zabbix for referencing global regular expressions.  ::: notewarning It's possible to run out of stack when using regular expressions. See the [pcrestack man page](http://pcre.org/original/doc/html/pcrestack.html) for more information. :::  Note that in multiline matching, the `^` and `$` anchors match at the beginning/end of each line respectively, instead of the beginning/end of the entire string.  See also examples for [correct escaping](/manual/appendix/escaping) in various contexts.
ca	#### Expressions regulars  Podeu introduir manualment una expressió regular a les ubicacions admeses. Tingueu en compte que l'expressió no pot començar amb @ perquè aquest símbol s'empra a Zabbix per fer referència a expressions regulars globals.  ::: notewarning És possible sortir de la pila quan s'empren expressions regulars. Consulteu la [pàgina man de pcrestack](http://pcre.org/original/doc/html/pcrestack.html) per obtindre més informació. :::  Tingueu en compte que a la concordança multilínia, les àncores `^` i `$` coincideixen amb l'inici/final de cada línia, respectivament, en lloc de l'inici/final de tota la cadena.  Veieu exemples d'[escapada correcta](/manual/appendix/escaping) a diferents contexts.

en-us	### Regular expression  The global regular expression object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |regexpid|string|ID of the regular expression.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the regular expression.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |test\_string|string|Test string.|
ca	### Expressió regultar  L'objecte d'expressió regular global té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |regexpid|string|ID de l'expressió regular.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions d'actualització| |name|string|Nom de l'expressió regular.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |test\_string|string|Cadena de caràcters de prova.|

en-us	# Regular expression  This class is designed to work with global regular expressions.  Object references:\  -   [Regular expression](/manual/api/reference/regexp/object)  Available methods:\  -   [regexp.create](/manual/api/reference/regexp/create) - creating new     regular expressions -   [regexp.delete](/manual/api/reference/regexp/delete) - deleting     regular expressions -   [regexp.get](/manual/api/reference/regexp/get) - retrieving regular     expressions -   [regexp.update](/manual/api/reference/regexp/update) - updating     regular expressions
ca	# Expressió regular  Aquesta classe és dissenyada per treballar amb expressions regulars globals.  Referències d'objectes:\  -   [Expressió regular](/manual/api/reference/regexp/object)  Mètodes disponibles:\  -   [regexp.create](/manual/api/reference/regexp/create) - crear noves expressions regulars -   [regexp.delete](/manual/api/reference/regexp/delete) - esborrar expressions regulars -   [regexp.get](/manual/api/reference/regexp/get) - recuperar expressions regulars -   [regexp.update](/manual/api/reference/regexp/update) - actualitzar expressions regulars

en-us	##### Remote command limit  Remote command limit after resolving all macros depends on the type of database and character set (non-ASCII characters require more than one byte to be stored):  |Database|Limit in characters|Limit in bytes| |---|---|---| |MySQL|65535|65535| |Oracle Database|2048|4000| |PostgreSQL|65535|not limited| |SQLite (only Zabbix proxy)|65535|not limited|  Remote command execution output (return value) is limited to 16MB (including trailing whitespace that is truncated). [IPMI remote command](#ipmi-remote-commands) limit is based on the installed IPMI library. Note that [database limits](/manual/config/items/item#text-data-limits) apply to all remote commands.
ca	##### Límit de les comandes remotes  El límit de comandes remotes després de resoldre totes les macros depèn del tipus de base de dades i del conjunt de caràcters (els caràcters no ASCII requereixen més d'un octet per emmagatzemar-los):  |Base de dades|Límit de caràcters|Límit en octets| |---|---|---| |MySQL|65535|65535| |Base de dades Oracle|2048|4000| |PostgreSQL|65535|il·limitat| |SQLite (només proxy Zabbix)|65535|il·limitat|  La sortida de l'execució d'ordres remots (valor de retorn) és limitada a 16 Mo (incloent els espais en blanc al final truncats). El límit de les [comandes remotes IPMI](#ipmi-remote-commands) es basa en la biblioteca IPMI instal·lada. També s'hi apliquen els [límits de la base de dades](/manual/config/items/item#text-data-limits).

en-us	#### Remote commands with multiple interfaces  If the target system has multiple interfaces of the selected type (Zabbix agent or IPMI), remote commands will be executed on the default interface.  It is possible to execute remote commands via SSH and Telnet using another interface than the Zabbix agent one. The available interface to use is selected in the following order:  * Zabbix agent default interface * SNMP default interface * JMX default interface * IPMI default interface
ca	#### Comandes remotes amb diverses interfícies  Si el sistema de destinació té diverses interfícies del tipus seleccionat (agent Zabbix o IPMI), les ordres remotes s'executaran a la interfície predeterminada.  És possible executar ordres de forma remota mitjançant SSH i Telnet mitjançant una altra interfície que l'agent Zabbix. La interfície disponible per emprar es tria en l'ordre següent:  * Interfície predeterminada de l'agent Zabbix * Interfície predeterminada SNMP * Interfície predeterminada JMX * Interfície per defecte IPMI

en-us	#### Remove token expiry  Remove expiry date from token.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "token.update",     "params": {         "tokenid": "2",         "expires_at": "0"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "tokenids": [             "2"         ]     },     "id": 1 } ```
ca	#### Esborrar la data de caducitat d'un token  Esborra la data de caducitat d'un token.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "token.update",     "params": {         "tokenid": "2",         "expires_at": "0"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "tokenids": [             "2"         ]     },     "id": 1 } ```

en-us	#### Removing hosts from host groups  Remove two hosts from the given host groups.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.massremove",     "params": {         "groupids": [             "5",             "6"         ],         "hostids": [             "30050",             "30001"         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "5",             "6"         ]     },     "id": 1 } ```
ca	#### Treure equips dels grups  Treu dos equips dels seus grups d'equips.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.massremove",     "params": {         "groupids": [             "5",             "6"         ],         "hostids": [             "30050",             "30001"         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "5",             "6"         ]     },     "id": 1 } ```

en-us	#### Removing interfaces  Remove the "127.0.0.1" SNMP interface from two hosts.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostinterface.massremove",     "params": {         "hostids": [             "30050",             "30052"         ],         "interfaces": {             "dns": "",             "ip": "127.0.0.1",             "port": "161"         }     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "interfaceids": [             "30069",             "30070"         ]     },     "id": 1 } ```
ca	#### Esborrar interfícies  Esborrar la interfície SNMP "127.0.0.1" de dos equips.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostinterface.massremove",     "params": {         "hostids": [             "30050",             "30052"         ],         "interfaces": {             "dns": "",             "ip": "127.0.0.1",             "port": "161"         }     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "interfaceids": [             "30069",             "30070"         ]     },     "id": 1 } ```

en-us	#### Removing templates from a group  Remove two templates from group "2".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "template.massremove",     "params": {         "templateids": [             "10085",             "10086"         ],         "groupids": "2"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "10085",             "10086"         ]     },     "id": 1 } ```
ca	#### Esborrar plantilles d'un grup  Esborrar dues plantilles del grup "2".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "template.massremove",     "params": {         "templateids": [             "10085",             "10086"         ],         "groupids": "2"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "10085",             "10086"         ]     },     "id": 1 } ```

en-us	#### Removing templates from template groups  Remove two templates from the given template groups.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.massremove",     "params": {         "groupids": [             "5",             "6"         ],         "templateids": [             "30050",             "30001"         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "5",             "6"         ]     },     "id": 1 } ```
ca	#### Esborra plantilles de grups de plantilles  Treu dues plantilles dels grups de plantilles donats.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.massremove",     "params": {         "groupids": [             "5",             "6"         ],         "templateids": [             "30050",             "30001"         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "5",             "6"         ]     },     "id": 1 } ```

en-us	#### Removing web server test page  It is recommended to remove the web server test page to avoid information exposure. By default, web server webroot contains a test page called index.html (Apache2 on Ubuntu is used as an example):  ![](../../../../assets/en/manual/installation/requirements/test_page.png)  The test page should be removed or should be made unavailable as part of the web server hardening process.
ca	#### Esborrar la pàgina de prova del servidor web  Es recomana esborrar la pàgina de prova del servidor web per evitar l'exposició de la informació. Per defecte, l'arrel del servidor web conté una pàgina de prova anomenada index.html (Apache2 a Ubuntu s'empra com a exemple):  ![](../../../../assets/en/manual/installation/requirements/test_page.png)  La pàgina de prova s'hauria d'esborrar o deixar que no sigui disponible com a part del procés de securització del servidor web.

en-us	#### Rename icon map  Rename an icon map to "OS icons".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "iconmap.update",     "params": {         "iconmapid": "1",         "name": "OS icons"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "iconmapids": [             "1"         ]     },     "id": 1 } ```
ca	#### Reanomenar el mapa d'icones  Reanomenar un mapa d'icones com a "Icones OS".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "iconmap.update",     "params": {         "iconmapid": "1",         "name": "Icones OS"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "iconmapids": [             "1"         ]     },     "id": 1 } ```

en-us	#### Rename image  Rename image to "Cloud icon".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "image.update",     "params": {         "imageid": "2",         "name": "Cloud icon"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "imageids": [             "2"         ]     },     "id": 1 } ```
ca	#### Reanomenar imatge  Reanomena la imatge a "Icona de núvol".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "image.update",     "params": {         "imageid": "2",         "name": "Icona de núvol"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "imageids": [             "2"         ]     },     "id": 1 } ```

en-us	#### Renaming a dashboard  Rename a dashboard to "SQL server status".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.update",     "params": {         "dashboardid": "2",         "name": "SQL server status"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "2"         ]     },     "id": 1 } ```
ca	#### Reanomenant un tauler  Reanomenar el tauler com a "Estat del servidor SQL".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.update",     "params": {         "dashboardid": "2",         "name": "SQL server status"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "2"         ]     },     "id": 1 } ```

en-us	#### Renaming a host group  Rename a host group to "Linux hosts."  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.update",     "params": {         "groupid": "7",         "name": "Linux hosts"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "7"         ]     },     "id": 1 } ```
ca	#### reanomenar un grup d'equips  Reanomena un grup d'equips cap a "Equips Linux".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.update",     "params": {         "groupid": "7",         "name": "Equips Linuxhosts"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "7"         ]     },     "id": 1 } ```

en-us	#### Renaming a template dashboard  Rename a template dashboard to "Performance graphs".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templatedashboard.update",     "params": {         "dashboardid": "23",         "name": "Performance graphs"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "23"         ]     },     "id": 1 } ```
ca	#### Reanomenar una plantilla de tauler  Reanomena una plantilla de tauler a "Gràfics de rendiment".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templatedashboard.update",     "params": {         "dashboardid": "23",         "name": "Gràfics de rendiment"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "23"         ]     },     "id": 1 } ```

en-us	#### Renaming a template group  Rename a template group to "Templates/Databases"  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.update",     "params": {         "groupid": "7",         "name": "Templates/Databases"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "7"         ]     },     "id": 1 } ```
ca	#### Reanometar un grup de plantilles  Reanomena un grup de plantilles a "Plantilles / Bases de dades".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.update",     "params": {         "groupid": "7",         "name": "Plantilles / Bases de Dades"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "7"         ]     },     "id": 1 } ```

en-us	#### Renaming a template  Rename the template to "Template OS Linux".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "template.update",     "params": {         "templateid": "10086",         "name": "Template OS Linux"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "10086"         ]     },     "id": 1 } ```
ca	#### Reanomenar una plantilla  Reanomenar la plantilla a "Plantilla OS Linux".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "template.update",     "params": {         "templateid": "10086",         "name": "Plantilla OS Linux"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "10086"         ]     },     "id": 1 } ```

en-us	#### Renaming a user  Rename a user to John Doe.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "user.update",     "params": {         "userid": "1",         "name": "John",         "surname": "Doe"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "userids": [             "1"         ]     },     "id": 1 } ```
ca	#### Reanomenar un usuari  Reanomena un usuari a "Josep Perarnau".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "user.update",     "params": {         "userid": "1",         "name": "Josep",         "surname": "Perarnau"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "userids": [             "1"         ]     },     "id": 1 } ```

en-us	 ##### repeat(value,count) {#repeat}  Repeat a string.<br> Supported value types: *String*, *Text*, *Log*.  Parameter:   -   **value** - the value to check;<br> -   **count** - the number of times to repeat.  Example:      repeat(last(/host/key),2) #repeat the value two times
ca	 ##### repeat(value,count) {#repeat}  Repeteix una cadena.<br> Tipus de valor admesos: *Cadena*, *Text*, *Log*.  Paràmetre:   -   **valor** - valor a comprovar;<br> -   **recompte** - nombre de vegades a repetir.  Exemple:      repeat(last(/host/key),2) #repeteix dos cops el valor

en-us	#### Replace conditions, but keep the evaluation method  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "correlation.update",     "params": {         "correlationid": "1",         "filter": {             "conditions": [                 {                     "type": 3,                     "oldtag": "error",                     "newtag": "ok"                 }             ]         }     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "correlationids": [             "1"         ]     },     "id": 1 } ```
ca	#### Reemplaçar condicions, mantinguent el mètode d'avaluació  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "correlation.update",     "params": {         "correlationid": "1",         "filter": {             "conditions": [                 {                     "type": 3,                     "oldtag": "error",                     "newtag": "ok"                 }             ]         }     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "correlationids": [             "1"         ]     },     "id": 1 } ```

en-us	 ##### replace(value,pattern,replacement) {#replace}  Find the pattern in the value and replace with replacement. All occurrences of the pattern will be replaced.<br> Supported value types: *String*, *Text*, *Log*.  Parameter:   -   **value** - the value to check;<br> -   **pattern** - the pattern to find;<br> -   **replacement** - the string to replace the pattern with.  Example:      replace(last(/host/key),"ibb","abb") - replace all 'ibb' with 'abb'
ca	 ##### replace(value,pattern,replacement) {#replace}  Troba el patró al valor i el substitueix. Es substituiran totes les ocurrències del patró.<br> Tipus de valors admesos: *Cadena*, *Text*, *Log*.  Paràmetre:  - **valor** - valor que cal comprovar;<br> - **patró** - patró a cercar;<br> - **reemplaçament** - cadena per substituir el patró.  Exemple:      replace(last(/host/key),"ibb","abb") - substitueix tots els 'ibb' amb 'abb'

en-us	#### Replacing dependencies  Replace dependencies for trigger.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "trigger.update",     "params": {         "triggerid": "22713",         "dependencies": [             {                 "triggerid": "22712"             },             {                 "triggerid": "22772"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "22713"         ]     },     "id": 1 } ```
ca	#### Reemplaçar dependències  Reemplaça dependències per tigger.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "trigger.update",     "params": {         "triggerid": "22713",         "dependencies": [             {                 "triggerid": "22712"             },             {                 "triggerid": "22772"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "22713"         ]     },     "id": 1 } ```

en-us	#### Replacing host interfaces  Replace all host interfaces with a single agent interface.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostinterface.replacehostinterfaces",     "params": {         "hostid": "30052",         "interfaces": {             "dns": "",             "ip": "127.0.0.1",             "main": 1,             "port": "10050",             "type": 1,             "useip": 1         }     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "interfaceids": [             "30081"         ]     },     "id": 1 } ```
ca	#### Reemplaçar interfícies d'equips  Reemplaçar totes les interfícies d'un equip per una sola interfície d'agent.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostinterface.replacehostinterfaces",     "params": {         "hostid": "30052",         "interfaces": {             "dns": "",             "ip": "127.0.0.1",             "main": 1,             "port": "10050",             "type": 1,             "useip": 1         }     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "interfaceids": [             "30081"         ]     },     "id": 1 } ```

en-us	#### Replacing hosts in a host group  Replace all hosts in a host group to ones mentioned host.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.massupdate",     "params": {         "groups": [             {                 "groupid": "6"             }         ],         "hosts": [             {                 "hostid": "30050"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "6",         ]     },     "id": 1 } ```
ca	#### Reemplaçar equips dins un grup d'equips  Reemplaça tots els equips d'un grup d'equips per els equips triats.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.massupdate",     "params": {         "groups": [             {                 "groupid": "6"             }         ],         "hosts": [             {                 "hostid": "30050"             }         ],     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "6",         ]     },     "id": 1 } ```

en-us	#### Replacing templates in a template group  Replace all templates in a template group to ones mentioned templates.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.massupdate",     "params": {         "groups": [             {                 "groupid": "8"             }         ],         "templates": [             {                 "templateid": "40050"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "8",         ]     },     "id": 1 } ```
ca	#### Reemplaçar plantilles d'un grup de plantilles  Reemplaça totes les plantilles d'un grup de plantilles per les plantilles anomenades.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.massupdate",     "params": {         "groups": [             {                 "groupid": "8"             }         ],         "templates": [             {                 "templateid": "40050"             }         ],     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "8",         ]     },     "id": 1 } ```

en-us	#### Replacing trigger prototype tags  Replace tags for one trigger prototype.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "triggerprototype.update",     "params": {         "triggerid": "17373",         "tags": [             {                 "tag": "volume",                 "value": "{#FSNAME}"             },             {                 "tag": "type",                 "value": "{#FSTYPE}"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "17373"         ]     },     "id": 1 } ```
ca	#### Reemplaçar les etiquetes de prototip de trigger  Reemplaça les etiquetes d'un prototip de trigger.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "triggerprototype.update",     "params": {         "triggerid": "17373",         "tags": [             {                 "tag": "volume",                 "value": "{#FSNAME}"             },             {                 "tag": "type",                 "value": "{#FSTYPE}"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "17373"         ]     },     "id": 1 } ```

en-us	#### Replacing triggers tags  Replace tags for trigger.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "trigger.update",     "params": {         "triggerid": "13938",         "tags": [             {                 "tag": "service",                 "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"             },             {                 "tag": "error",                 "value": ""             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "13938"         ]     },     "id": 1 } ```
ca	#### Reemplaçar etiquetes de triggers  Reemplaça les etiquetes d'un trigger.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "trigger.update",     "params": {         "triggerid": "13938",         "tags": [             {                 "tag": "service",                 "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"             },             {                 "tag": "error",                 "value": ""             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "13938"         ]     },     "id": 1 } ```

en-us	#### Replacing user macros  Replace all user macros with the given user macro on multiple templates.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "template.massupdate",     "params": {         "templates": [             {                 "templateid": "10074"             },             {                 "templateid": "10075"             },             {                 "templateid": "10076"             },             {                 "templateid": "10077"             }         ],         "macros": [             {                 "macro": "{$AGENT.TIMEOUT}",                 "value": "5m",                 "description": "Timeout after which agent is considered unavailable. Works only for agents reachable from Zabbix server/proxy (passive mode)."             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "10074",             "10075",             "10076",             "10077"         ]     },     "id": 1 } ```
ca	#### Reemplaçar macros d'usuari  Substitueix totes les macros d'usuari per la macro donada a diverses plantilles.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "template.massupdate",     "params": {         "templates": [             {                 "templateid": "10074"             },             {                 "templateid": "10075"             },             {                 "templateid": "10076"             },             {                 "templateid": "10077"             }         ],         "macros": [             {                 "macro": "{$AGENT.TIMEOUT}",                 "value": "5m",                 "description": "Timeout after which agent is considered unavailable. Works only for agents reachable from Zabbix server/proxy (passive mode)."             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "10074",             "10075",             "10076",             "10077"         ]     },     "id": 1 } ```

en-us	# report.create
ca	# report.create

en-us	# report.delete
ca	# report.delete

en-us	 ### Report details  If you click on the service name in the report, you can access another report  that displays a more detailed view.  ![](../../../../../assets/en/manual/web_interface/sla_report_details.png){width="600"}  Note that [negative problem duration](/manual/web_interface/frontend_sections/monitoring/problems#negative-problem-duration) does not affect SLA calculation or reporting.
ca	### Detalls de l'informe  Si feu clic al nom del servei de l'informe, podreu accedir a un altre informe amb una vista més detallada.  ![](../../../../../assets/en/manual/web_interface/sla_report_details.png){width="600"}  Tingueu en compte que la [durada del problema negatiu](/manual/web_interface/frontend_sections/monitoring/problems#negative-problem-duration) no afecta al càlcul ni als informes d'SLA.

en-us	# report.get
ca	# report.get

en-us	# > Report object  The following objects are directly related to the `report` API.
ca	# > Objecte informe  Els següents objectes són relacionats amb l'API `report`.

en-us	 ### Report  The filter allows to select the report based on the SLA name as well as the  service name. It is also possible to limit the displayed period.  ![](../../../../../assets/en/manual/web_interface/sla_report.png){width="600"}  Each column (period) displays the SLI for that period. SLIs that are in breach of the set  SLO are highlighted in red.  20 periods are displayed in the report. A maximum of 100 periods can be displayed, if  both the *From* date and *To* date are specified. 
ca	### Informe  El filtre us permet triar l'informe en funció del nom del SLA així com del nom del servei. També és possible limitar el període mostrat.  ![](../../../../../assets/en/manual/web_interface/sla_report.png){width="600"}  Cada columna (període) mostra l'SLI d'aquest període. Els SLI que no compleixen l'SLO definit es destaquen en vermell.  A l'informe es veuen 20 períodes. Es poden veure un màxim de 100 períodes, si s'especifica la data *Des de* i la data *Fins a*.

en-us	### Report  The report object has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |reportid|string|ID of the report.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |userid|string|ID of the user who created the report.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |name|string|Unique name of the report.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |dashboardid|string|ID of the dashboard that the report is based on.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |period|integer|Period for which the report will be prepared.<br><br>Possible values:<br>0 - *(default)* previous day;<br>1 - previous week;<br>2 - previous month;<br>3 - previous year.| |cycle|integer|Period repeating schedule.<br><br>Possible values:<br>0 - *(default)* daily;<br>1 - weekly;<br>2 - monthly;<br>3 - yearly.| |start\_time|integer|Time of the day, in seconds, when the report will be prepared for sending.<br><br>Default: 0.| |weekdays|integer|Days of the week for sending the report.<br><br>Days of the week are stored in binary form with each bit representing the corresponding week day. For example, 12 equals 1100 in binary and means that reports will be sent every Wednesday and Thursday.<br><br>Default: 0.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `cycle` is set to "weekly".| |active\_since|string|On which date to start.<br><br>Possible values:<br>empty string - *(default)* not specified (stored as 0);<br>specific date in YYYY-MM-DD format (stored as a timestamp of the beginning of a day (00:00:00)).| |active\_till|string|On which date to end.<br><br>Possible values:<br>empty string - *(default)* not specified (stored as 0);<br>specific date in YYYY-MM-DD format (stored as a timestamp of the end of a day (23:59:59)).| |subject|string|Report message subject.| |message|string|Report message text.| |status|integer|Whether the report is enabled or disabled.<br><br>Possible values:<br>0 - Disabled;<br>1 - *(default)* Enabled.| |description|text|Description of the report.| |state|integer|State of the report.<br><br>Possible values:<br>0 - *(default)* report was not yet processed;<br>1 - report was generated and successfully sent to all recipients;<br>2 - report generating failed; "info" contains error information;<br>3 - report was generated, but sending to some (or all) recipients failed; "info" contains error information.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |lastsent|timestamp|Unix timestamp of the last successfully sent report.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |info|string|Error description or additional information.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
ca	### Informe  L'objecte té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |reportid|string|ID de l'informe.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització| |userid|string|ID de l'usuari que ha creat l'informe.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |name|string|Nom únic de l'informe.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |dashboardid|string|ID del tauler de control en què es basa l'informe.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |period|integer|Període per al qual s'elaborarà l'informe.<br><br>Valors possibles:<br>0 - *(per defecte)* dia anterior;<br>1 - setmana anterior;<br>2 - anterior mes;<br>3 - any anterior.| |cycle|enter|Programació de repetició del període.<br><br>Valors possibles:<br>0 - *(per defecte)* diari;<br>1 - setmanal;<br>2 - mensual;<br >3 - anual.| |start\_time|integer|Hora del dia, en segons, en què es prepararà l'informe per enviar-lo.<br><br>Per defecte: 0.| |weekdays|integer|Dies de la setmana per enviar l'informe.<br><br>Només es requereix per als informes setmanals.<br><br>Els dies de la setmana s'emmagatzemen en forma binària, amb cada bit que representa el dia corresponent de la setmana. Per exemple, 12 és igual a 1100 en binari i vol dir que s'enviaran informes cada dimecres i dijous.<br><br>Per defecte: 0.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `cycle` és "weekly".| |active\_since|string|A quina data començar.<br><br>Valors possibles:<br>cadena buida - *(per defecte)* sense especificar (emmagatzemat com a 0);<br>data específica del format AAAA-MM -DD ​​(emmagatzemat com a marca de temps d'inici del dia (00:00:00)).| |active\_till|string|A quina data s'ha d'acabar.<br><br>Valors possibles:<br>cadena buida - *(per defecte)* sense especificar (emmagatzemat com a 0);<br>data específica per a YYYY-MM- Format DD (emmagatzemat com a marca de temps del final del dia (23:59:59)).| |subject|string|Assumpte del missatge de l'informe.| |message|string|Informa del text del missatge.| |status|ingeter|Indica si l'informe és actiu o desactivat.<br><br>Valors possibles:<br>0 - Desactivat;<br>1 - *(per defecte)* Activat.| |description|text|Descripció de l'informe.| |state|integer|*(només lectura)* Estat de l'informe.<br><br>Valors possibles:<br>0 - *(per defecte)* l'informe encara no s'ha processat;<br>1 - informe generat enviat correctament a tots els destinataris;<br>2 - no s'ha pogut generar l'informe; "info" conté informació d'error;<br>3: s'ha generat l'informe, però no s'ha pogut enviar a alguns (o a tots) els destinataris; "info" conté informació d'error.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |lastsent|timestamp|*(només lectura)* Marca de temps de Unix del darrer informe enviat correctament.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |info|string|*(només lectura)* Descripció de l'error o informació addicional.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|

en-us	# Report  This class is designed to work with scheduled reports.  Object references:\  -   [Report](/manual/api/reference/report/object#report) -   [Users](/manual/api/reference/report/object#users) -   [User groups](/manual/api/reference/report/object#user_groups)  Available methods:\  -   [report.create](/manual/api/reference/report/create) - create new     scheduled reports -   [report.delete](/manual/api/reference/report/delete) - delete     scheduled reports -   [report.get](/manual/api/reference/report/get) - retrieve scheduled     reports -   [report.update](/manual/api/reference/report/update) - update     scheduled reports
ca	# Informe  Aquesta classe és dissenyada per treballar amb informes programats.  Referències d'objectes:\  -   [Informe](/manual/api/reference/report/object#report) -   [Usuaris](/manual/api/reference/report/object#users) -   [Grups d'usuaris](/manual/api/reference/report/object#user_groups)  Mètodes disponibles:\  -   [report.create](/manual/api/reference/report/create) - crear nous informes programats -   [report.delete](/manual/api/reference/report/delete) - esborrar informes programats -   [report.get](/manual/api/reference/report/get) - recuperar informes programats -   [report.update](/manual/api/reference/report/update) - actualitzar informes programats

en-us	# report.update
ca	# report.update

en-us	##### - Repositories  Official Zabbix [repository](/manual/installation/install_from_packages/rhel) has been added to */etc/yum.repos.d*:      [zabbix]     name=Zabbix Official Repository - $basearch     baseurl=http://repo.zabbix.com/zabbix/6.4/rhel/8/$basearch/     enabled=1     gpgcheck=1     gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591
ca	##### - Repositoris  El [repositori](/manual/installation/install_from_packages/rhel) oficial de Zabbix s'ha afegit a */etc/yum.repos.d* :      [zabbix]     name=Zabbix Official Repository - $basearch     baseurl=http://repo.zabbix.com/zabbix/6.4/rhel/8/$basearch/     enabled=1     gpgcheck=1     gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591

en-us	#### Requesting authenticated user's information  Authenticate and return additional information about the user.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "user.login",     "params": {         "username": "Admin",         "password": "zabbix",         "userData": true     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "userid": "1",         "username": "Admin",         "name": "Zabbix",         "surname": "Administrator",         "url": "",         "autologin": "1",         "autologout": "0",         "lang": "ru_RU",         "refresh": "0",         "theme": "default",         "attempt_failed": "0",         "attempt_ip": "127.0.0.1",         "attempt_clock": "1355919038",         "rows_per_page": "50",         "timezone": "Europe/Riga",         "roleid": "3",         "userdirectoryid": "0",         "type": 3,         "userip": "127.0.0.1",         "debug_mode": 0,         "gui_access": "0",         "deprovisioned": false,         "auth_type": 0,         "sessionid": "5b56eee8be445e98f0bd42b435736e42",         "secret": "cd0ba923319741c6586f3d866423a8f4"     },     "id": 1 } ```
ca	#### Demanar informació de l'usuari autenticat  Autentica i reenvia la informació suplementària de l'usuari.  [Petició](/manual/api#performing-requests):  ```json { "jsonrpc": "2.0", "method": "user.login", "params": { "username": "Admin", "password": "zabbix", "userData": true }, "id": 1 } ```  Resposta:  ```json { "jsonrpc": "2.0", "result": { "userid": "1", "username": "Admin", "name": "Zabbix", "surname": "Administrator", "url": "", "autologin": "1", "autologout": "0", "lang": "ru_RU", "refresh": "0", "theme": "default", "attempt_failed": "0", "attempt_ip": "127.0.0.1", "attempt_clock": "1355919038", "rows_per_page": "50", "timezone": "Europe/Riga", "roleid": "3", "type": 3, "debug_mode": 0, "userip": "127.0.0.1", "gui_access": "0", "userdirectoryid": 0, "sessionid": "5b56eee8be445e98f0bd42b435736e42" }, "id": 1 } ```

en-us	 [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "sla.create",     "params": [         {             "name": "Database Uptime",             "slo": "99.9995",             "period": "1",             "timezone": "America/Toronto",             "description": "Provide excellent uptime for main database engines.",             "effective_date": 1672444800,             "status": 1,             "schedule": [                 {                     "period_from": 0,                     "period_to": 601200                 }             ],             "service_tags": [                 {                     "tag": "Database",                     "operator": "0",                     "value": "MySQL"                 },                 {                     "tag": "Database",                     "operator": "0",                     "value": "PostgreSQL"                 }             ],             "excluded_downtimes": [                 {                     "name": "Software version upgrade rollout",                     "period_from": "1648760400",                     "period_to": "1648764900"                 }             ]         }     ],     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "slaids": [             "5"         ]     },     "id": 1 } ```
ca	 [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "sla.create",     "params": [         {             "name": "Database Uptime",             "slo": "99.9995",             "period": "1",             "timezone": "America/Toronto",             "description": "Provide excellent uptime for main database engines.",             "effective_date": 1672444800,             "status": 1,             "schedule": [                 {                     "period_from": 0,                     "period_to": 601200                 }             ],             "service_tags": [                 {                     "tag": "Database",                     "operator": "0",                     "value": "MySQL"                 },                 {                     "tag": "Database",                     "operator": "0",                     "value": "PostgreSQL"                 }             ],             "excluded_downtimes": [                 {                     "name": "Software version upgrade rollout",                     "period_from": "1648760400",                     "period_to": "1648764900"                 }             ]         }     ],     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "slaids": [             "5"         ]     },     "id": 1 } ```

en-us	### Required mode
ca	### Mode obligatori

en-us	### Required mode
ca	### Mode obligatori

en-us	#### Required software  Zabbix is built around modern web servers, leading database engines, and PHP scripting language.
ca	#### Programari requerit  Zabbix és construït al voltant de servidors web moderns, motors de bases de dades de darrera generació i llenguatge de script PHP.

en-us	##### Requirements  The following is required to set up encryption:  -   Developer-supported operating system with OpenSSL >=1.1.X or     alternative.  ::: noteclassic  It is recommended to avoid OS in the end-of-life status, especially in the case of new installations  :::  -   Database engine (RDBMS) installed and maintained from the official     repository provided by developer. Operating systems often shipped     with outdated  database software versions for which encryption     support is not implemented, for example RHEL 7 based systems and     PostgreSQL 9.2, MariaDB 5.5 without encryption support. 
ca	##### Especificacions  Els elements següents són requerits per configurar el xifrat:  - El sistema d'explotació admès per els desenvolupadors amb OpenSSL >=1.1.X o alternatiu.  ::: noteclassic  Es recomana evitar els sistemes d'explotació prop de fi de vida, especialment a les noves instal·lacions :::  - El motor de base de dades (RDBMS) instal·lat i mantingut a partir del repositori oficial del desenvolupador. Els sistemes d'explotació sovint són lliurats amb vesrions de programari de base de dades obsoletes per aquelles on el suport de xifrat no és pas implementat, per exemple els sistemes basats en RHEL 7 i PostgreSQL 9.2, MariaDB 5.5 sense suport de xifrat.

en-us	### Reserved ID value "0"  Reserved ID value "0" can be used to filter elements and to remove referenced objects. For example, to remove a referenced proxy from a host, proxy\_hostid should be set to 0 ("proxy\_hostid": "0") or to filter hosts monitored by server option proxyids should be set to 0 ("proxyids": "0").
ca	### Valor d'ID reservat "0"  El valor "0" d'ID reservat es pot emprar per filtrar elements i esborrar objectes referenciats. Per exemple, per esborrar un proxy referenciat d'un equip, s'ha d'establir proxy\_hostid should a 0 ("proxy\_hostid": "0"), o per filtrar equips monitorats per l'opció del servidor, s'ha d'establir proxyids a 0 ("proxyids": "0").

en-us	#### Resize a map  Change the size of the map to 1200x1200 pixels.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "map.update",     "params": {         "sysmapid": "8",         "width": 1200,         "height": 1200     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "8"         ]     },     "id": 1 } ```
ca	#### Redimensionar un mapa  Canviar la mida del mapa a 1200x1200 píxels.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "map.update",     "params": {         "sysmapid": "8",         "width": 1200,         "height": 1200     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "8"         ]     },     "id": 1 } ```

en-us	#### Restricting allowed certificate Issuer and Subject  When two Zabbix components (e.g. server and agent) establish a TLS connection they both check each others certificates. If a peer certificate is signed by a trusted CA (with pre-configured top-level certificate in `TLSCAFile`), is valid, has not expired and passes some other checks then communication can proceed. Certificate issuer and subject are not checked in this simplest case.  Here is a risk - anybody with a valid certificate can impersonate anybody else (e.g. a host certificate can be used to impersonate server). This may be acceptable in small environments where certificates are signed by a dedicated in-house CA and risk of impersonating is low.  If your top-level CA is used for issuing other certificates which should not be accepted by Zabbix or you want to reduce risk of impersonating you can restrict allowed certificates by specifying their Issuer and Subject strings.  For example, you can write in Zabbix proxy configuration file:      TLSServerCertIssuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com     TLSServerCertSubject=CN=Zabbix server,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com  With these settings, an active proxy will not talk to Zabbix server with different Issuer or Subject string in certificate, a passive proxy will not accept requests from such server.  A few notes about Issuer or Subject string matching:  1.  Issuer and Subject strings are checked independently. Both are     optional. 2.  UTF-8 characters are allowed. 3.  Unspecified string means any string is accepted. 4.  Strings are compared "as-is", they must be exactly the same to     match. 5.  Wildcards and regexp's are not supported in matching. 6.  Only some requirements from [RFC 4514 Lightweight Directory Access     Protocol (LDAP): String Representation of Distinguished     Names](http://tools.ietf.org/html/rfc4514) are implemented:     1.  escape characters '"' (U+0022), '+' U+002B, ',' U+002C, ';'         U+003B, '<' U+003C, '>' U+003E, '\\' U+005C anywhere in         string.     2.  escape characters space (' ' U+0020) or number sign ('\#'         U+0023) at the beginning of string.     3.  escape character space (' ' U+0020) at the end of string. 7.  Match fails if a null character (U+0000) is encountered ([RFC     4514](http://tools.ietf.org/html/rfc4514) allows it). 8.  Requirements of [RFC 4517 Lightweight Directory Access Protocol     (LDAP): Syntaxes and Matching     Rules](http://tools.ietf.org/html/rfc4517) and [RFC 4518 Lightweight     Directory Access Protocol (LDAP): Internationalized String     Preparation](http://tools.ietf.org/html/rfc4518) are not supported     due to amount of work required.  Order of fields in Issuer and Subject strings and formatting are important! Zabbix follows [RFC 4514](http://tools.ietf.org/html/rfc4514) recommendation and uses "reverse" order of fields.  The reverse order can be illustrated by example:      TLSServerCertIssuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com     TLSServerCertSubject=CN=Zabbix proxy,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com  Note that it starts with low level (CN), proceeds to mid-level (OU, O) and ends with top-level (DC) fields.  *OpenSSL* by default shows certificate Issuer and Subject fields in "normal" order, depending on additional options used:      $ openssl x509 -noout -in /home/zabbix/zabbix_proxy.crt -issuer -subject     issuer= /DC=com/DC=zabbix/O=Zabbix SIA/OU=Development group/CN=Signing CA     subject= /DC=com/DC=zabbix/O=Zabbix SIA/OU=Development group/CN=Zabbix proxy      $ openssl x509 -noout -text -in /home/zabbix/zabbix_proxy.crt     Certificate:             ...             Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Signing CA         ...             Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Zabbix proxy  Here Issuer and Subject strings start with top-level (DC) and end with low-level (CN) field, spaces and field separators depend on options used. None of these values will match in Zabbix Issuer and Subject fields!  ::: noteimportant  To get proper Issuer and Subject strings usable in Zabbix invoke OpenSSL with special options\ (`-nameopt esc_2253,esc_ctrl,utf8,dump_nostr,dump_unknown,dump_der,sep_comma_plus,dn_rev,sname`):  :::      $ openssl x509 -noout -issuer -subject \             -nameopt esc_2253,esc_ctrl,utf8,dump_nostr,dump_unknown,dump_der,sep_comma_plus,dn_rev,sname \             -in /home/zabbix/zabbix_proxy.crt     issuer= CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com     subject= CN=Zabbix proxy,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com  Now string fields are in reverse order, fields are comma-separated, can be used in Zabbix configuration files and frontend.
ca	#### Restricció de l'emissor i receptor autoritzats  Quan dos components (per exemple, el servidor Zabbix i l'agent) estableixen una connexió TLS, cadascun comprova els certificats de l'altre. Si un certificat igual signat per una CA de confiança (amb un certificat de nivell superior preconfigurat a "TLSCAFile") és vàlid, no ha caducat i passa més comprovacions, la comunicació pot continuar. L'emissor i el subjecte del certificat no es comprova en aquest cas més senzill.  Hi ha el risc que qualsevol persona amb un certificat vàlid pugui suplantar la identitat d'una altra persona (per exemple, es pot emprar un certificat d'equip per suplantar la identitat d'un servidor). Això pot ser acceptable en entorns petits on els certificats són signats per una CA interna dedicada i el risc de suplantació d'identitat és baix.  Si la vostra CA de nivell superior s'empra per emetre altres certificats que Zabbix no hauria d'acceptar o si voleu reduir el risc de falsificació, podeu restringir els certificats permesos especificant-ne el remitent i l'assumpte.  Per exemple, podeu escriure al fitxer de configuració del proxy Zabbix:       TLSServerCertIssuer=CN=Signing CA,OU=Grup de desenvolupament,O=Zabbix SIA,DC=zabbix,DC=com      TLSServerCertSubject=CN=Servidor Zabbix,OU=Grup de desenvolupament,O=Zabbix SIA,DC=zabbix,DC=com  Amb aquesta configuració, el proxy actiu no es comunicarà amb el servidor Zabbix amb una cadena d'emissor o una cadena de subjecte diferent al certificat, i el proxy passiu no acceptarà peticions d'aquest servidor.  Algunes notes sobre la concordança de la cadena del remitent o de l'assumpte:  1. Les cadenes del remitent i del subjecte es comproven de manera independent. Tots dos són opcionals. 2. Es permeten caràcters UTF-8. 3. La cadena no especificada significa que s'accepta qualsevol cadena. 4. Les cadenes es comparen "tal com són", han de ser exactament iguals perquè coincideixin. 5. Els comodins i les expressions regulars no s'admeten a la concordança. 6. Només s'implementen certs requisits d'[RFC 4514 Lightweight Directory Access Protocol (LDAP): String Representation of Distinguished Names](http://tools.ietf.org/html/rfc4514):      1. caràcters d'escapada '"' (U+0022), '+' U+002B, ',' U+002C, ';' U+003B, '<' U+003C, '>' U+003E, '\' U+005C en qualsevol lloc de la cadena.      2. Caràcters d'escapada (' ' U+0020) o el signe de lletra ('#' U+0023) al principi de la cadena.      3. caràcters d'escapada (' ' U+0020) al final de la cadena. 7. La coincidència falla si es troba un caràcter nul (U+0000) ([[http://tools.ietf.org/html/rfc4514|RFC 4514]] ho permet). 8. Els requisits de [[http://tools.ietf.org/html/rfc4517|RFC 4517 Lightweight Directory Access Protocol (LDAP): sintaxis i regles de concordança]] i [[http://tools.ietf.org/ html/rfc4518|RFC 4518 Lightweight Directory Access Protocol (LDAP): preparació de cadenes internacionalitzades]] no s'admeten a causa de la quantitat de treball necessària.  L'ordre dels camps a les cadenes Entrega per i Assumpte i el format són importants! Zabbix segueix les recomanacions de [RFC 4514](http://tools.ietf.org/html/rfc4514) i empra l'ordre "inversa" dels camps.  L'ordre inversa es pot il·lustrar amb l'exemple següent:       TLSServerCertIssuer=CN=Signing CA,OU=Grup de desenvolupament,O=Zabbix SIA,DC=zabbix,DC=com      TLSServerCertSubject=CN=Proxy Zabbix,OU=Grup de desenvolupament,O=Zabbix SIA,DC=zabbix,DC=com  Tingueu en compte que comença amb el nivell baix (CN), va al nivell mitjà (OU, O) i acaba amb els camps de nivell superior (DC).  *OpenSSL* mostra per defecte els camps Emissor i Assumpte del certificat en ordre "normal", depenent de les opcions addicionals emprades:       $ openssl x509 -noout -in /home/zabbix/zabbix_proxy.crt -issuer -subject      emissor= /DC=com/DC=zabbix/O=Zabbix SIA/OU=Grup de desenvolupament/CN=Signing CA      subject= /DC=com/DC=zabbix/O=Zabbix SIA/OU=Grup de desenvolupament/CN=Proxy Zabbix       $ openssl x509 -noout -text -in /home/zabbix/zabbix_proxy.crt      Certificació:              ...              Emissor: DC=com, DC=zabbix, O=Zabbix SIA, OU=Grup de desenvolupament, CN=Signing CA          ...              Assumpte: DC=com, DC=zabbix, O=Zabbix SIA, OU=Grup de desenvolupament, CN=proxy Zabbix  Aquí les cadenes Emissor i Subject comencen amb el nivell superior (DC) i acaben amb un camp de nivell baix (CN), els espais i els separadors de camps depenen de les opcions emprades. Cap d'aquests valors coincidirà als camps Remitent i Assumpte de Zabbix!  ::: noteimportant   Per obtindre les cadenes correctes d'emissor i subjecte que es puguin emprar a Zabbix, executeu OpenSSL amb opcions especials\ (`-nameopt esc_2253,esc_ctrl,utf8,dump_nostr,dump_unknown,dump_der,sep_comma_plus,dn_rev,sname`):      $ openssl x509 -noout -issuer -subject \             -nameopt esc_2253,esc_ctrl,utf8,dump_nostr,dump_unknown,dump_der,sep_comma_plus,dn_rev,sname \             -in /home/zabbix/zabbix_proxy.crt     issuer= CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com     subject= CN=Zabbix proxy,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com :::  Ara els camps de cadena són en ordre invers, els camps són separats per comes, es poden emprar en fitxers de configuració i a la interfície Zabbix.

en-us	#### Retrieve alerts by action ID  Retrieve all alerts generated by action "3".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "alert.get",     "params": {         "output": "extend",         "actionids": "3"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": [         {             "alertid": "1",             "actionid": "3",             "eventid": "21243",             "userid": "1",             "clock": "1362128008",             "mediatypeid": "1",             "sendto": "support@company.com",             "subject": "PROBLEM: Zabbix agent on Linux server is unreachable for 5 minutes: ",             "message": "Trigger: Zabbix agent on Linux server is unreachable for 5 minutes: \nTrigger status: PROBLEM\nTrigger severity: Not classified",             "status": "0",             "retries": "3",             "error": "",             "esc_step": "1",             "alerttype": "0",             "p_eventid": "0",             "acknowledgeid": "0"         }     ],     "id": 1 } ```
ca	#### Recuperar les alertes per l'ID d'acció  Recuperar totes les alertes generades per l'acció "3".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "alert.get",     "params": {         "output": "extend",         "actionids": "3"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": [         {             "alertid": "1",             "actionid": "3",             "eventid": "21243",             "userid": "1",             "clock": "1362128008",             "mediatypeid": "1",             "sendto": "support@company.com",             "subject": "PROBLEM: Zabbix agent on Linux server is unreachable for 5 minutes: ",             "message": "Trigger: Zabbix agent on Linux server is unreachable for 5 minutes: \nTrigger status: PROBLEM\nTrigger severity: Not classified",             "status": "0",             "retries": "3",             "error": "",             "esc_step": "1",             "alerttype": "0",             "p_eventid": "0",             "acknowledgeid": "0"         }     ],     "id": 1 } ```

en-us	#### Retrieve all discovery rules  Retrieve all configured discovery rules and the discovery checks they use.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "drule.get",     "params": {         "output": "extend",         "selectDChecks": "extend"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": [         {             "druleid": "2",             "proxy_hostid": "0",             "name": "Local network",             "iprange": "192.168.3.1-255",             "delay": "5s",             "status": "0",             "dchecks": [                 {                     "dcheckid": "7",                     "druleid": "2",                     "type": "3",                     "key_": "",                     "snmp_community": "",                     "ports": "21",                     "snmpv3_securityname": "",                     "snmpv3_securitylevel": "0",                     "snmpv3_authpassphrase": "",                     "snmpv3_privpassphrase": "",                     "uniq": "0",                     "snmpv3_authprotocol": "0",                     "snmpv3_privprotocol": "0",                     "host_source": "1",                     "name_source": "0"                 },                 {                     "dcheckid": "8",                     "druleid": "2",                     "type": "4",                     "key_": "",                     "snmp_community": "",                     "ports": "80",                     "snmpv3_securityname": "",                     "snmpv3_securitylevel": "0",                     "snmpv3_authpassphrase": "",                     "snmpv3_privpassphrase": "",                     "uniq": "0",                     "snmpv3_authprotocol": "0",                     "snmpv3_privprotocol": "0",                     "host_source": "1",                     "name_source": "0"                 }             ]         },         {             "druleid": "6",             "proxy_hostid": "0",             "name": "Zabbix agent discovery",             "iprange": "192.168.1.1-255",             "delay": "1h",             "status": "0",             "dchecks": [                 {                     "dcheckid": "10",                     "druleid": "6",                     "type": "9",                     "key_": "system.uname",                     "snmp_community": "",                     "ports": "10050",                     "snmpv3_securityname": "",                     "snmpv3_securitylevel": "0",                     "snmpv3_authpassphrase": "",                     "snmpv3_privpassphrase": "",                     "uniq": "0",                     "snmpv3_authprotocol": "0",                     "snmpv3_privprotocol": "0",                     "host_source": "2",                     "name_source": "3"                 }             ]         }     ],     "id": 1 } ```
ca	#### Recuperar totes les regles de descoberta  Recupera totes les regles de descoberta configurades i els testos de descoberta que empren.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "drule.get",     "params": {         "output": "extend",         "selectDChecks": "extend"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": [         {             "druleid": "2",             "proxy_hostid": "0",             "name": "Xarxa local",             "iprange": "192.168.3.1-255",             "delay": "5s",             "nextcheck": "1348754327",             "status": "0",             "dchecks": [                 {                     "dcheckid": "7",                     "druleid": "2",                     "type": "3",                     "key_": "",                     "snmp_community": "",                     "ports": "21",                     "snmpv3_securityname": "",                     "snmpv3_securitylevel": "0",                     "snmpv3_authpassphrase": "",                     "snmpv3_privpassphrase": "",                     "uniq": "0",                     "snmpv3_authprotocol": "0",                     "snmpv3_privprotocol": "0",                     "host_source": "1",                     "name_source": "0"                                      },                 {                     "dcheckid": "8",                     "druleid": "2",                     "type": "4",                     "key_": "",                     "snmp_community": "",                     "ports": "80",                     "snmpv3_securityname": "",                     "snmpv3_securitylevel": "0",                     "snmpv3_authpassphrase": "",                     "snmpv3_privpassphrase": "",                     "uniq": "0",                     "snmpv3_authprotocol": "0",                     "snmpv3_privprotocol": "0",                     "host_source": "1",                     "name_source": "0"                                     }             ]         },         {             "druleid": "6",             "proxy_hostid": "0",             "name": "Zabbix agent discovery",             "iprange": "192.168.1.1-255",             "delay": "1h",             "nextcheck": "0",             "status": "0",             "dchecks": [                 {                     "dcheckid": "10",                     "druleid": "6",                     "type": "9",                     "key_": "system.uname",                     "snmp_community": "",                     "ports": "10050",                     "snmpv3_securityname": "",                     "snmpv3_securitylevel": "0",                     "snmpv3_authpassphrase": "",                     "snmpv3_privpassphrase": "",                     "uniq": "0",                     "snmpv3_authprotocol": "0",                     "snmpv3_privprotocol": "0",                     "host_source": "2",                     "name_source": "3"                                     }             ]         }     ],     "id": 1 } ```

en-us	#### Retrieve all proxies  Retrieve all configured proxies and their interfaces.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxy.get",     "params": {         "output": "extend",         "selectInterface": "extend"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": [         {             "host": "Active proxy",             "status": "5",             "description": "",             "tls_connect": "1",             "tls_accept": "1",             "tls_issuer": "",             "tls_subject": "",             "proxy_address": "",             "auto_compress": "0",             "version": "60400",             "compatibility": "1",             "proxyid": "30091",             "interface": []         },         {             "host": "Passive proxy",             "status": "6",             "description": "",             "tls_connect": "1",             "tls_accept": "1",             "tls_issuer": "",             "tls_subject": "",             "proxy_address": "",             "auto_compress": "0",             "lastaccess": "0",             "version": "0",             "compatibility": "0",             "proxyid": "30092",             "interface": {                 "interfaceid": "30109",                 "hostid": "30092",                 "main": "1",                 "type": "0",                 "useip": "1",                 "ip": "127.0.0.1",                 "dns": "",                 "port": "10051",                 "available": "0",                 "error": "",                 "errors_from": "0",                 "disable_until": "0",                 "details": []             }         }     ],     "id": 1 } ```
ca	#### Recuperar tots els proxys  Recuperar tots els proxys configurats i les seves interfícies.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxy.get",     "params": {         "output": "extend",         "selectInterface": "extend"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": [         {             "host": "Active proxy",             "status": "5",             "lastaccess": "0",             "description": "",             "tls_connect": "1",             "tls_accept": "1",             "tls_issuer": "",             "tls_subject": "",             "proxy_address": "",             "auto_compress": "0",             "proxyid": "30091",             "interface": []         },         {             "host": "Passive proxy",             "status": "6",             "lastaccess": "0",             "description": "",             "tls_connect": "1",             "tls_accept": "1",             "tls_issuer": "",             "tls_subject": "",             "proxy_address": "",             "auto_compress": "0",             "proxyid": "30092",             "interface": {                 "interfaceid": "30109",                 "hostid": "30092",                 "useip": "1",                 "ip": "127.0.0.1",                 "dns": "",                 "port": "10051"             ]         }     ],     "id": 1 } ```

en-us	#### Retrieve all scripts  Retrieve all configured scripts.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.get",     "params": {         "output": "extend"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": [         {             "scriptid": "1",             "name": "Ping",             "command": "/bin/ping -c 3 {HOST.CONN} 2>&1",             "host_access": "2",             "usrgrpid": "0",             "groupid": "0",             "description": "",             "confirmation": "",             "type": "0",             "execute_on": "1",             "timeout": "30s",             "scope": "2",             "port": "",             "authtype": "0",             "username": "",             "password": "",             "publickey": "",             "privatekey": "",             "menu_path": "",             "url": "",             "new_window": "1",             "parameters": []         },         {             "scriptid": "2",             "name": "Traceroute",             "command": "/usr/bin/traceroute {HOST.CONN} 2>&1",             "host_access": "2",             "usrgrpid": "0",             "groupid": "0",             "description": "",             "confirmation": "",             "type": "0",             "execute_on": "1",             "timeout": "30s",             "scope": "2",             "port": "",             "authtype": "0",             "username": "",             "password": "",             "publickey": "",             "privatekey": "",             "menu_path": "",             "url": "",             "new_window": "1",             "parameters": []         },         {             "scriptid": "3",             "name": "Detect operating system",             "command": "sudo /usr/bin/nmap -O {HOST.CONN} 2>&1",             "host_access": "2",             "usrgrpid": "7",             "groupid": "0",             "description": "",             "confirmation": "",             "type": "0",             "execute_on": "1",             "timeout": "30s",             "scope": "2",             "port": "",             "authtype": "0",             "username": "",             "password": "",             "publickey": "",             "privatekey": "",             "menu_path": "",             "url": "",             "new_window": "1",             "parameters": []         },         {             "scriptid": "4",             "name": "Webhook",             "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}",             "host_access": "2",             "usrgrpid": "7",             "groupid": "0",             "description": "",             "confirmation": "",             "type": "5",             "execute_on": "1",             "timeout": "30s",             "scope": "2",             "port": "",             "authtype": "0",             "username": "",             "password": "",             "publickey": "",             "privatekey": "",             "menu_path": "",             "url": "",             "new_window": "1",             "parameters": [                 {                     "name": "token",                     "value": "{$WEBHOOK.TOKEN}"                 },                 {                     "name": "host",                     "value": "{HOST.HOST}"                 },                 {                     "name": "v",                     "value": "2.2"                 }             ]         },         {             "scriptid": "5",             "name": "URL",             "command": "",             "host_access": "2",             "usrgrpid": "0",             "groupid": "0",             "description": "",             "confirmation": "Go to {HOST.NAME}?",             "type": "6",             "execute_on": "1",             "timeout": "30s",             "scope": "4",             "port": "",             "authtype": "0",             "username": "",             "password": "",             "publickey": "",             "privatekey": "",             "menu_path": "",             "url": "http://zabbix/ui/zabbix.php?action=latest.view&hostids[]={HOST.ID}",             "new_window": "0",             "parameters": []         }     ],     "id": 1 } ```
ca	#### Recuperar tots els scripts  Recupera tots els scripts configurats.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.get",     "params": {         "output": "extend"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": [             {             "scriptid": "1",             "name": "Ping",             "command": "/bin/ping -c 3 {HOST.CONN} 2>&1",             "host_access": "2",             "usrgrpid": "0",             "groupid": "0",             "description": "",             "confirmation": "",             "type": "0",             "execute_on": "1",             "timeout": "30s",             "parameters": []         },         {             "scriptid": "2",             "name": "Traceroute",             "command": "/usr/bin/traceroute {HOST.CONN} 2>&1",             "host_access": "2",             "usrgrpid": "0",             "groupid": "0",             "description": "",             "confirmation": "",             "type": "0",             "execute_on": "1",             "timeout": "30s",             "parameters": []         },         {             "scriptid": "3",             "name": "Detectar sistema operatiu",             "command": "sudo /usr/bin/nmap -O {HOST.CONN} 2>&1",             "host_access": "2",             "usrgrpid": "7",             "groupid": "0",             "description": "",             "confirmation": "",             "type": "0",             "execute_on": "1",             "timeout": "30s",             "parameters": []         },         {             "scriptid": "4",             "name": "Webhook",             "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.Log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.Log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}",             "host_access": "2",             "usrgrpid": "7",             "groupid": "0",             "description": "",             "confirmation": "",             "type": "5",             "execute_on": "1",             "timeout": "30s",             "parameters": [                 {                     "name": "token",                     "value": "{$WEBHOOK.TOKEN}"                 },                 {                     "name": "host",                     "value": "{HOST.HOST}"                 },                 {                     "name": "v",                     "value": "2.2"                 }             ]         }     ],     "id": 1 } ```

en-us	#### Retrieve a map  Retrieve all data about map "3".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "map.get",     "params": {         "output": "extend",         "selectSelements": "extend",         "selectLinks": "extend",         "selectUsers": "extend",         "selectUserGroups": "extend",         "selectShapes": "extend",         "selectLines": "extend",         "sysmapids": "3"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": [         {             "selements": [                 {                     "selementid": "10",                     "sysmapid": "3",                     "elementtype": "4",                     "evaltype": "0",                     "iconid_off": "1",                     "iconid_on": "0",                     "label": "Zabbix server",                     "label_location": "3",                     "x": "11",                     "y": "141",                     "iconid_disabled": "0",                     "iconid_maintenance": "0",                     "elementsubtype": "0",                     "areatype": "0",                     "width": "200",                     "height": "200",                     "tags": [                         {                             "tag": "service",                             "value": "mysqld",                             "operator": "0"                         }                     ],                     "viewtype": "0",                     "use_iconmap": "1",                     "urls": [],                     "elements": []                 },                 {                     "selementid": "11",                     "sysmapid": "3",                     "elementtype": "4",                     "evaltype": "0",                     "iconid_off": "1",                     "iconid_on": "0",                     "label": "Web server",                     "label_location": "3",                     "x": "211",                     "y": "191",                     "iconid_disabled": "0",                     "iconid_maintenance": "0",                     "elementsubtype": "0",                     "areatype": "0",                     "width": "200",                     "height": "200",                     "viewtype": "0",                     "use_iconmap": "1",                     "tags": [],                     "urls": [],                     "elements": []                 },                 {                     "selementid": "12",                     "sysmapid": "3",                     "elementtype": "0",                     "evaltype": "0",                     "iconid_off": "185",                     "iconid_on": "0",                     "label": "{HOST.NAME}\r\n{HOST.CONN}",                     "label_location": "0",                     "x": "111",                     "y": "61",                     "iconid_disabled": "0",                     "iconid_maintenance": "0",                     "elementsubtype": "0",                     "areatype": "0",                     "width": "200",                     "height": "200",                     "viewtype": "0",                     "use_iconmap": "0",                     "tags": [],                     "urls": [],                     "elements": [                         {                             "hostid": "10084"                         }                     ]                 }             ],             "links": [                 {                     "linkid": "23",                     "sysmapid": "3",                     "selementid1": "10",                     "selementid2": "11",                     "drawtype": "0",                     "color": "00CC00",                     "label": "",                     "linktriggers": []                 }             ],             "users": [                 {                     "sysmapuserid": "1",                     "userid": "2",                     "permission": "2"                 }             ],             "userGroups": [                 {                     "sysmapusrgrpid": "1",                     "usrgrpid": "7",                     "permission": "2"                 }             ],             "shapes":[                 {                     "sysmap_shapeid":"1",                     "type":"0",                     "x":"0",                     "y":"0",                     "width":"680",                     "height":"15",                     "text":"{MAP.NAME}",                     "font":"9",                     "font_size":"11",                     "font_color":"000000",                     "text_halign":"0",                     "text_valign":"0",                     "border_type":"0",                     "border_width":"0",                     "border_color":"000000",                     "background_color":"",                     "zindex":"0"                 }             ],             "lines":[                 {                     "sysmap_shapeid":"2",                     "x1": 30,                     "y1": 10,                     "x2": 100,                     "y2": 50,                     "line_type": 1,                     "line_width": 10,                     "line_color": "009900",                     "zindex":"1"                 }             ],             "sysmapid": "3",             "name": "Local network",             "width": "400",             "height": "400",             "backgroundid": "0",             "label_type": "2",             "label_location": "3",             "highlight": "1",             "expandproblem": "1",             "markelements": "0",             "show_unack": "0",             "grid_size": "50",             "grid_show": "1",             "grid_align": "1",             "label_format": "0",             "label_type_host": "2",             "label_type_hostgroup": "2",             "label_type_trigger": "2",             "label_type_map": "2",             "label_type_image": "2",             "label_string_host": "",             "label_string_hostgroup": "",             "label_string_trigger": "",             "label_string_map": "",             "label_string_image": "",             "iconmapid": "0",             "expand_macros": "0",             "severity_min": "0",             "userid": "1",             "private": "1",             "show_suppressed": "1"         }     ],     "id": 1 } ```
ca	#### Recuperar un mapa  Recuperar totes les dades relatives al mapa "3".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "map.get",     "params": {         "output": "extend",         "selectSelements": "extend",         "selectLinks": "extend",         "selectUsers": "extend",         "selectUserGroups": "extend",         "selectShapes": "extend",         "selectLines": "extend",         "sysmapids": "3"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": [         {             "selements": [                 {                     "selementid": "10",                     "sysmapid": "3",                     "elementtype": "4",                     "evaltype": "0",                     "iconid_off": "1",                     "iconid_on": "0",                     "label": "Zabbix server",                     "label_location": "3",                     "x": "11",                     "y": "141",                     "iconid_disabled": "0",                     "iconid_maintenance": "0",                     "elementsubtype": "0",                     "areatype": "0",                     "width": "200",                     "height": "200",                     "tags": [                         {                             "tag": "service",                             "value": "mysqld",                             "operator": "0"                         }                     ],                     "viewtype": "0",                     "use_iconmap": "1",                     "urls": [],                     "elements": []                 },                 {                     "selementid": "11",                     "sysmapid": "3",                     "elementtype": "4",                     "evaltype": "0",                     "iconid_off": "1",                     "iconid_on": "0",                     "label": "Web server",                     "label_location": "3",                     "x": "211",                     "y": "191",                     "iconid_disabled": "0",                     "iconid_maintenance": "0",                     "elementsubtype": "0",                     "areatype": "0",                     "width": "200",                     "height": "200",                     "viewtype": "0",                     "use_iconmap": "1",                     "tags": [],                     "urls": [],                     "elements": []                 },                 {                     "selementid": "12",                     "sysmapid": "3",                     "elementtype": "0",                     "evaltype": "0",                     "iconid_off": "185",                     "iconid_on": "0",                     "label": "{HOST.NAME}\r\n{HOST.CONN}",                     "label_location": "0",                     "x": "111",                     "y": "61",                     "iconid_disabled": "0",                     "iconid_maintenance": "0",                     "elementsubtype": "0",                     "areatype": "0",                     "width": "200",                     "height": "200",                     "viewtype": "0",                     "use_iconmap": "0",                     "tags": [],                     "urls": [],                     "elements": [                         {                             "hostid": "10084"                         }                     ]                 }             ],             "links": [                 {                     "linkid": "23",                     "sysmapid": "3",                     "selementid1": "10",                     "selementid2": "11",                     "drawtype": "0",                     "color": "00CC00",                     "label": "",                     "linktriggers": []                 }             ],             "users": [                 {                     "sysmapuserid": "1",                     "userid": "2",                     "permission": "2"                 }             ],             "userGroups": [                 {                     "sysmapusrgrpid": "1",                     "usrgrpid": "7",                     "permission": "2"                 }             ],             "shapes":[                   {                       "sysmap_shapeid":"1",                     "type":"0",                     "x":"0",                     "y":"0",                     "width":"680",                     "height":"15",                     "text":"{MAP.NAME}",                     "font":"9",                     "font_size":"11",                     "font_color":"000000",                     "text_halign":"0",                     "text_valign":"0",                     "border_type":"0",                     "border_width":"0",                     "border_color":"000000",                     "background_color":"",                     "zindex":"0"                 }             ],             "lines":[                 {                     "sysmap_shapeid":"2",                     "x1": 30,                     "y1": 10,                     "x2": 100,                     "y2": 50,                     "line_type": 1,                     "line_width": 10,                     "line_color": "009900",                     "zindex":"1"                 }             ],             "sysmapid": "3",             "name": "Local network",             "width": "400",             "height": "400",             "backgroundid": "0",             "label_type": "2",             "label_location": "3",             "highlight": "1",             "expandproblem": "1",             "markelements": "0",             "show_unack": "0",             "grid_size": "50",             "grid_show": "1",             "grid_align": "1",             "label_format": "0",             "label_type_host": "2",             "label_type_hostgroup": "2",             "label_type_trigger": "2",             "label_type_map": "2",             "label_type_image": "2",             "label_string_host": "",             "label_string_hostgroup": "",             "label_string_trigger": "",             "label_string_map": "",             "label_string_image": "",             "iconmapid": "0",             "expand_macros": "0",             "severity_min": "0",             "userid": "1",             "private": "1",             "show_suppressed": "1"         }     ],     "id": 1 } ```

en-us	#### Retrieve an icon map  Retrieve all data about icon map "3".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "iconmap.get",     "params": {         "iconmapids": "3",         "output": "extend",         "selectMappings": "extend"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": [         {             "mappings": [                 {                     "iconmappingid": "3",                     "iconmapid": "3",                     "iconid": "6",                     "inventory_link": "1",                     "expression": "server",                     "sortorder": "0"                 },                 {                     "iconmappingid": "4",                     "iconmapid": "3",                     "iconid": "10",                     "inventory_link": "1",                     "expression": "switch",                     "sortorder": "1"                 }             ],             "iconmapid": "3",             "name": "Host type icons",             "default_iconid": "2"         }     ],     "id": 1 } ```
ca	#### Recuperar un mapa d'icones  Recupera tota la informació del mapa d'icones "3".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "iconmap.get",     "params": {         "iconmapids": "3",         "output": "extend",         "selectMappings": "extend"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": [         {             "mappings": [                 {                     "iconmappingid": "3",                     "iconmapid": "3",                     "iconid": "6",                     "inventory_link": "1",                     "expression": "server",                     "sortorder": "0"                 },                 {                     "iconmappingid": "4",                     "iconmapid": "3",                     "iconid": "10",                     "inventory_link": "1",                     "expression": "switch",                     "sortorder": "1"                 }             ],             "iconmapid": "3",             "name": "Host type icons",             "default_iconid": "2"         }     ],     "id": 1 } ```

en-us	#### Retrieve an image  Retrieve all data for image with ID "2".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "image.get",     "params": {         "output": "extend",         "select_image": true,         "imageids": "2"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": [         {             "imageid": "2",             "imagetype": "1",             "name": "Cloud_(24)",             "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACmAAAApgBNtNH3wAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s+N5j9BIMEf4Hg/jWexD2ZEXQbC9tWUFZimtLhswuZiVujK1UJmYXW9PaCUdtb83enL3P7s6ss5f5dc7EUsmqkPuFH3M4/Ob7+V0OAgC0UyDENFEU03rh1uNOs/lFG75o2i2/rkd9Y3Tgyj3HiaezbukdH9A/rP4E9vWi0u+Y4fuGnMf3DRgYc3Z/84YrQSkD3mgKhFAC+KAEK74Y2Lj3MjPoOokQ3Xyx/1GHeXCifbfO6lRPH/wi+AvZQhGSsgKxdB5CCRkCGPbDgMXBMbukTc4vK5/WRHizsq7fZl2LFuvE4T0BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y/cfAENmHZF4XrY9Mc+X9HAFmoyXS2ddy1IOg6/KNyBcM0DFP/wFZFCcOy4N9Mw0YkCTOfhdL5AfZQXQBFn2t/ODXHC8FYVcoWjNEQ03qqwTJ5FdI44jg/msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNlWEf0nFxpCt16zcshTuLpGSwDDuPIfv0xzNyQYVGicC0cgUUDLM6Xp02lvvW/V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r+cn7Jc8c2eWrbM6Wbe6/aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAAASUVORK5CYII="         }     ],     "id": 1 } ```
ca	#### Recuperar una imatge  Recupera tota la informació de l'imatge amb ID "2".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "image.get",     "params": {         "output": "extend",         "select_image": true,         "imageids": "2"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": [         {             "imageid": "2",             "imagetype": "1",             "name": "Cloud_(24)",             "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACmAAAApgBNtNH3wAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s+N5j9BIMEf4Hg/jWexD2ZEXQbC9tWUFZimtLhswuZiVujK1UJmYXW9PaCUdtb83enL3P7s6ss5f5dc7EUsmqkPuFH3M4/Ob7+V0OAgC0UyDENFEU03rh1uNOs/lFG75o2i2/rkd9Y3Tgyj3HiaezbukdH9A/rP4E9vWi0u+Y4fuGnMf3DRgYc3Z/84YrQSkD3mgKhFAC+KAEK74Y2Lj3MjPoOokQ3Xyx/1GHeXCifbfO6lRPH/wi+AvZQhGSsgKxdB5CCRkCGPbDgMXBMbukTc4vK5/WRHizsq7fZl2LFuvE4T0BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y/cfAENmHZF4XrY9Mc+X9HAFmoyXS2ddy1IOg6/KNyBcM0DFP/wFZFCcOy4N9Mw0YkCTOfhdL5AfZQXQBFn2t/ODXHC8FYVcoWjNEQ03qqwTJ5FdI44jg/msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNlWEf0nFxpCt16zcshTuLpGSwDDuPIfv0xzNyQYVGicC0cgUUDLM6Xp02lvvW/V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r+cn7Jc8c2eWrbM6Wbe6/aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAAASUVORK5CYII="         }     ],     "id": 1 } ```

en-us	### Retrieve an item value via API  The widget should show the last value of an item of user's choice. For that, you need to add the ability to select items in the widget configuration.  In this section, you will learn how to add an item selection field to the widget form and how to add the visual part of this field to the configuration view. Then, the widget controller will be able to retrieve item data and its value via an API request. Once received, the value can be displayed in the widget view.  1. Open *includes/WidgetForm.php* and add the *CWidgetFieldMultiSelectItem* field. This will allow selecting an item in the configuration form.  **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**  ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Zabbix\Widgets\{     CWidgetField,     CWidgetForm };  use Zabbix\Widgets\Fields\{     CWidgetFieldMultiSelectItem,     CWidgetFieldTextBox };  /**  * Gauge chart widget form.  */ class WidgetForm extends CWidgetForm {      public function addFields(): self {         return $this             ->addField(                 (new CWidgetFieldMultiSelectItem('itemid', _('Item')))                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)                     ->setMultiple(false)             )             ->addField(                 new CWidgetFieldTextBox('description', _('Description'))             );     } } ```  2. Open *views/widget.edit.php* and add the field visual component to the configuration view.  **ui/modules/lesson_gauge_chart/views/widget.edit.php**  ```php <?php  /**  * Gauge chart widget form view.  *  * @var CView $this  * @var array $data  */  (new CWidgetFormView($data))     ->addField(         new CWidgetFieldMultiSelectItemView($data['fields']['itemid'], $data['captions']['items']['itemid'])     )     ->addField(         new CWidgetFieldTextBoxView($data['fields']['description'])     )     ->show(); ```  3. Return to the dashboard and click on the gear icon in the widget to open the widget configuration form.  4. The widget configuration form now contains a new input field *Item*. Select the host "Zabbix server" and the item "Load average (1m avg)".  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_item.png){width=600}  5. Click on *Apply* in the widget configuration form. Then click on *Save changes* in the top right corner to save the dashboard.  6. Open and modify *actions/WidgetView.php*.  From now on, the item ID will be available in the widget controller in *$this->fields\_values\['itemid'\]*. The *doAction()* controller method collects the item data (name, value type, units) using the API method *[item.get](/manual/api/reference/item/get)* and the item last value using the API method *[history.get](/manual/api/reference/history/get)*.  **ui/modules/lesson_gauge_chart/actions/WidgetView.php**  ```php <?php  namespace Modules\LessonGaugeChart\Actions;  use API,     CControllerDashboardWidgetView,     CControllerResponseData;  class WidgetView extends CControllerDashboardWidgetView {      protected function doAction(): void {         $db_items = API::Item()->get([             'output' => ['itemid', 'value_type', 'name', 'units'],             'itemids' => $this->fields_values['itemid'],             'webitems' => true,             'filter' => [                 'value_type' => [ITEM_VALUE_TYPE_UINT64, ITEM_VALUE_TYPE_FLOAT]             ]         ]);          $value = null;          if ($db_items) {             $item = $db_items[0];              $history = API::History()->get([                 'output' => API_OUTPUT_EXTEND,                 'itemids' => $item['itemid'],                 'history' => $item['value_type'],                 'sortfield' => 'clock',                 'sortorder' => ZBX_SORT_DOWN,                 'limit' => 1             ]);              if ($history) {                 $value = convertUnitsRaw([                     'value' => $history[0]['value'],                     'units' => $item['units']                 ]);             }         }          $this->setResponse(new CControllerResponseData([             'name' => $this->getInput('name', $this->widget->getName()),             'value' => $value,             'description' => $this->fields_values['description'],             'user' => [                 'debug_mode' => $this->getDebugMode()             ]         ]));     } } ```  7. Open *views/widget.view.php* and add the item value to the widget view.  **ui/modules/lesson_gauge_chart/views/widget.view.php**  ```php <?php  /**  * Gauge chart widget view.  *  * @var CView $this  * @var array $data  */  (new CWidgetView($data))     ->addItem([         new CTag('h1', true, $data['description']),         new CDiv($data['value'] !== null ? $data['value']['value'] : _('No data'))     ])     ->show(); ```  8. Refresh the dashboard page. The widget will display the latest item value.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_view_item.png){width="600"}
ca	### Recuperar el valor d'un element mitjançant l'API  El giny hauria de mostrar el darrer valor d'un element triat per l'usuari. Per això, heu d'afegir la possibilitat de triar elements a la configuració del giny.  En aquesta secció aprendreu a afegir un camp de selecció d'elements al formulari del giny i a afegir la part visual d'aquest camp a la vista de configuració. Aleshores, el controlador de ginys podrà recuperar les dades de lelement i el seu valor mitjançant una petició d'API. Un cop rebuda, el valor es pot mostrar a la vista del giny.  1. Obriu *includes/WidgetForm.php* i afegiu el camp *CWidgetFieldMultiSelectItem*. Això us permetrà triar un element al formulari de configuració.  **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**  ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Zabbix\Widgets\{     CWidgetField,     CWidgetForm };  use Zabbix\Widgets\Fields\{     CWidgetFieldMultiSelectItem,     CWidgetFieldTextBox };  /**  * Formulari de giny de gràfic de calibre.  */ classe WidgetForm amplia CWidgetForm {      public function addFields(): self {         return $this             ->addField(                 (newCWidgetFieldMultiSelectItem('itemid', _('Item')))                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)                     ->setMultiple (false)             )             ->addField(                 new CWidgetFieldTextBox('descripció', _('Descripció'))             );     } } ```  2. Obriu *views/widget.edit.php* i afegiu el component visual de camp a la vista de configuració.  **ui/modules/lesson_gauge_chart/views/widget.edit.php**  ```php <?php  /**  * Visualització del formulari del giny del gràfic de mesura.  *  * @var CView $this  * @var array $data  */  (new CWidgetFormView($data))     ->addField(         new CWidgetFieldMultiSelectItemView($data['fields']['itemid'], $data['captions']['items']['itemid'])     )     ->addField(         new CWidgetFieldTextBoxView($data['fields']['description'])     )     ->show(); ```  3. Torneu al tauler i feu clic a la icona d'engranatge del giny per obrir el formulari de configuració del giny.  4. El formulari de configuració del giny ara conté un camp d'entrada nou *Element*. Trieu l'equip "Servidor Zabbix" i l'element "Càrrega mitjana (1 m de mitjana)".  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_item.png){width=600}  5. Feu clic a *Aplicar* al formulari de configuració del gint. Tot seguit, feu clic a *Desar els canvis* a l'extrem superior dret per desar el tauler.  6. Obriu i modifiqueu *actions/WidgetView.php*.  A partir d'ara, l'identificador de l'element serà disponible al controlador del giny a *$this->fields\_values\['itemid'\]*. El mètode del controlador *doAction()* recopila les dades de l'element (nom, tipus de valor, unitats) mitjançant el mètode API *[item.get](/manual/api/reference/item/get)* i l'últim valor de l'element mitjançant el Mètode de l'API *[history.get](/manual/api/reference/history/get)*.  **ui/modules/lesson_gauge_chart/actions/WidgetView.php**  ```php <?php  namespace Modules\LessonGaugeChart\Actions;  use API,     CControllerDashboardWidgetView,     CCollerResponseData;  class WidgetView extendsCControllerDashboardWidgetView {      protected function doAction(): void {         $db_items = API::Item()->get([             'output' => ['itemid', 'value_type', 'nom', 'unitats'],             'itemids' => $this->fields_values['itemid'],             'webitems' => true,             'filtre' => [                 'value_type' => [ITEM_VALUE_TYPE_UINT64, ITEM_VALUE_TYPE_FLOAT]             ]         ]);          $value = nul;          if ($db_items) {             $element = $db_items[0];              $història = API::History()->get([                 'output' => API_OUTPUT_EXTEND,                 'itemids' => $item['itemid'],                 'history' => $item['value_type'],                 'sortfield' => 'rellotge',                 'sortorder' => ZBX_SORT_DOWN,                 'límit' => 1             ]);              si ($history) {                 $value = convertUnitsRaw([                     'valor' => $history[0]['valor'],                     'unitats' => $item['unitats']                 ]);             }         }          $this->setResponse(new CControllerResponseData([             'name' => $this->getInput('name', $this->widget->getName()),             'valor' => $value,             'description' => $this->fields_values['descripció'],             'usuari' => [                 'debug_mode' => $this->getDebugMode()             ]         ]));     } } ```  7. Obriu *views/widget.view.php* i afegiu el valor de l'element a la vista del giny.  **ui/modules/lesson_gauge_chart/views/widget.view.php**  ```php <?php  /**  * Visualització del giny del gràfic de mesura.  *  * @var CView $this  * @var array $data  */  (new CWidgetView($data))     ->addItem([         new CTag('h1', true, $data['descripció']),         CDiv new($data['valor'] !== nul ? $data['valor']['valor'] : _('Sense dades'))     ])     ->show(); ```  8. Actualitzeu la pàgina del tauler. El giny mostrarà el valor de l'element més recent.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_view_item.png){width="600"}

en-us	#### Retrieve a token  Retrieve all data for the token with ID "2".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "token.get",     "params": {         "output": "extend",         "tokenids": "2"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": [         {             "tokenid": "1",             "name": "The Token",             "description": "",             "userid": "1",             "lastaccess": "0",             "status": "0",             "expires_at": "1609406220",             "created_at": "1611239454",             "creator_userid": "1"         }     ],     "id": 1 } ```
ca	#### Recuperar un token  Recuperar tota la informació del token amb ID "2".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "token.get",     "params": {         "output": "extend",         "tokenids": "2"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": [         {             "tokenid": "1",             "name": "The Token",             "description": "",             "userid": "1",             "lastaccess": "0",             "status": "0",             "expires_at": "1609406220",             "created_at": "1611239454",             "creator_userid": "1"         }     ],     "id": 1 } ```

en-us	#### Retrieve audit log  Retrieve two latest audit log records.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "auditlog.get",     "params": {         "output": "extend",         "sortfield": "clock",         "sortorder": "DESC",         "limit": 2     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": [         {             "auditid": "cksstgfam0001yhdcc41y20q2",             "userid": "1",             "username": "Admin",             "clock": "1629975715",             "ip": "127.0.0.1",             "action": "1",             "resourcetype": "0",             "resourceid": "0",             "resourcename": "Jim",             "recordsetid": "cksstgfal0000yhdcso67ondl",             "details": "{\"user.name\":[\"update\",\"Jim\",\"\"],\"user.medias[37]\":[\"add\"],\"user.medias[37].\":[\"add\"],\"user.medias[37].mediatypeid\":[\"add\",\"1\"],\"user.medias[37].sendto\":[\"add\",\"support123@company.com\"]}"         },         {             "auditid": "ckssofl0p0001yhdcqxclsg8r",             "userid": "1",             "username": "Admin",             "clock": "1629967278",             "ip": "127.0.0.1",             "action": "0",             "resourcetype": "0",             "resourceid": "20",             "resourcename": "John",             "recordsetid": "ckssofl0p0000yhdcpxyo1jgo",             "details": "{\"user.username\":[\"add\",\"John\"], \"user.userid:\":[\"add\",\"20\"],\"user.usrgrps[28]\":[\"add\"],\"user.usrgrps[28].usrgrpid\":[\"add\", \"7\"]}"         }     ],     "id": 1 } ```
ca	#### Recuperar registre d'auditoria  Recupera els dos darrers registres del registre d'auditoria.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "auditlog.get",     "params": {         "output": "extend",         "sortfield": "clock",         "sortorder": "DESC",         "limit": 2     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": [         {             "auditid": "cksstgfam0001yhdcc41y20q2",             "userid": "1",             "username": "Admin",             "clock": "1629975715",             "ip": "127.0.0.1",             "action": "1",             "resourcetype": "0",             "resourceid": "0",             "resourcename": "Jim",             "recordsetid": "cksstgfal0000yhdcso67ondl",             "details": "{\"user.name\":[\"update\",\"Jim\",\"\"],\"user.medias[37]\":[\"add\"],\"user.medias[37].\":[\"add\"],\"user.medias[37].mediatypeid\":[\"add\",\"1\"],\"user.medias[37].sendto\":[\"add\",\"support123@company.com\"]}"                      },         {             "auditid": "ckssofl0p0001yhdcqxclsg8r",             "userid": "1",             "username": "Admin",             "clock": "1629967278",             "ip": "127.0.0.1",             "action": "0",             "resourcetype": "0",             "resourceid": "20",             "resourcename": "John",             "recordsetid": "ckssofl0p0000yhdcpxyo1jgo",             "details": "{\"user.username\":[\"add\",\"John\"], \"user.userid:\":[\"add\",\"20\"],\"user.usrgrps[28]\":[\"add\"],\"user.usrgrps[28].usrgrpid\":[\"add\", \"7\"]}"         }     ],     "id": 1 } ```

en-us	#### Retrieve correlations  Retrieve all configured correlations together with correlation conditions and operations. The filter uses the "and/or" evaluation type, so the `formula` property is empty and `eval_formula` is generated automatically.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "correlation.get",     "params": {         "output": "extend",         "selectOperations": "extend",         "selectFilter": "extend"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": [         {             "correlationid": "1",             "name": "Correlation 1",             "description": "",             "status": "0",             "filter": {                 "evaltype": "0",                 "formula": "",                 "conditions": [                     {                         "type": "3",                         "oldtag": "error",                         "newtag": "ok",                         "formulaid": "A"                     }                 ],                 "eval_formula": "A"             },             "operations": [                 {                     "type": "0"                 }             ]         }     ],     "id": 1 } ```
ca	#### Recuperar correlacions  Recupera totes les correlacions configurades juntament amb condicions i operacions. El filtre empra "i/o" tipus d'avaluació, pel que la propietat `formula` és buida i `eval_formula` es genera automàticament.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "correlation.get",     "params": {         "output": "extend",         "selectOperations": "extend",         "selectFilter": "extend"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": [         {             "correlationid": "1",             "name": "Correlation 1",             "description": "",             "status": "0",             "filter": {                 "evaltype": "0",                 "formula": "",                 "conditions": [                     {                         "type": "3",                         "oldtag": "error",                         "newtag": "ok",                         "formulaid": "A"                     }                 ],                 "eval_formula": "A"             },             "operations": [                 {                     "type": "0"                 }             ]         }     ],     "id": 1 } ```