en-us	#### Creating a host with PSK encryption  Create a host called "PSK host" with PSK encryption configured. Note that the host has to be [pre-configured to use PSK](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example).  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "PSK host",         "interfaces": [             {                 "type": 1,                 "ip": "192.168.3.1",                 "dns": "",                 "port": "10050",                 "useip": 1,                 "main": 1             }         ],         "groups": [             {                 "groupid": "2"             }         ],         "tls_accept": 2,         "tls_connect": 2,         "tls_psk_identity": "PSK 001",         "tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10590"         ]     },     "id": 1 } ```
ca	#### Crear un equip amb xifrat PSK  Crear un equip anomenat "equip PSK" amb xifrat PSK configurat. Fixeu-vos qu l'equip ha d'ésser [pre-configurat per emprar PSK](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example).  [Petició](/manual/api#performing-requests):  ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "PSK host", "interfaces": [ { "type": 1, "ip": "192.168.3.1", "dns": "", "port": "10050", "useip": 1, "main": 1 } ], "groups": [ { "groupid": "2" } ], "tls_accept": 2, "tls_connect": 2, "tls_psk_identity": "PSK 001", "tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952" }, "id": 1 } ```  Resposta:  ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10590" ] }, "id": 1 } ```

en-us	#### Creating a host with SNMP interface  Create a host called "SNMP host" with an SNMPv3 interface with details.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "SNMP host",         "interfaces": [             {                 "type": 2,                 "main": 1,                 "useip": 1,                 "ip": "127.0.0.1",                 "dns": "",                 "port": "161",                 "details": {                     "version": 3,                     "bulk": 0,                     "securityname": "mysecurityname",                     "contextname": "",                     "securitylevel": 1                 }             }         ],         "groups": [             {                 "groupid": "4"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10658"         ]     },     "id": 1 } ```
ca	#### Crear un equip amb una interfície SNMP  Crear un equip anomenat "equip SNMP" amb una interfície SNMPv3 i els seus detalls.  [Petició](/manual/api#performing-requests):  ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "SNMP host", "interfaces": [ { "type": 2, "main": 1, "useip": 1, "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": 3, "bulk": 0, "securityname": "mysecurityname", "contextname": "", "securitylevel": 1 } } ], "groups": [ { "groupid": "4" } ] }, "id": 1 } ```  Resposta:  ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10658" ] }, "id": 1 } ```

en-us	#### Creating a LLD rule with macro paths  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "LLD rule with LLD macro paths",         "key_": "lld",         "hostid": "10116",         "type": 0,         "interfaceid": "13",         "delay": "30s",         "lld_macro_paths": [             {                 "lld_macro": "{#MACRO1}",                 "path": "$.path.1"             },             {                 "lld_macro": "{#MACRO2}",                 "path": "$.path.2"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```
ca	#### Crear una regla LLD amb rutes de macros  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "LLD rule with LLD macro paths",         "key_": "lld",         "hostid": "10116",         "type": 0,         "interfaceid": "13",         "delay": "30s",         "lld_macro_paths": [             {                 "lld_macro": "{#MACRO1}",                 "path": "$.path.1"             },             {                 "lld_macro": "{#MACRO2}",                 "path": "$.path.2"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```

en-us	#### Creating a LLD rule with overrides  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Discover database host",         "key_": "lld.with.overrides",         "hostid": "10001",         "type": 0,         "value_type": 3,         "delay": "60s",         "interfaceid": "1155",         "overrides": [             {                 "name": "Discover MySQL host",                 "step": "1",                 "stop": "1",                 "filter": {                     "evaltype": "2",                     "conditions": [                         {                             "macro": "{#UNIT.NAME}",                             "operator": "8",                             "value": "^mysqld\\.service$"                         },                         {                             "macro": "{#UNIT.NAME}",                             "operator": "8",                             "value": "^mariadb\\.service$"                         }                     ]                 },                 "operations": [                     {                         "operationobject": "3",                         "operator": "2",                         "value": "Database host",                         "opstatus": {                             "status": "0"                         },                         "optemplate": [                             {                                 "templateid": "10170"                             }                         ],                         "optag": [                             {                                 "tag": "Database",                                 "value": "MySQL"                             }                         ]                     }                 ]             },             {                 "name": "Discover PostgreSQL host",                 "step": "2",                 "stop": "1",                 "filter": {                     "evaltype": "0",                     "conditions": [                         {                             "macro": "{#UNIT.NAME}",                             "operator": "8",                             "value": "^postgresql\\.service$"                         }                     ]                 },                 "operations": [                     {                         "operationobject": "3",                         "operator": "2",                         "value": "Database host",                         "opstatus": {                             "status": "0"                         },                         "optemplate": [                             {                                 "templateid": "10263"                             }                         ],                         "optag": [                             {                                 "tag": "Database",                                 "value": "PostgreSQL"                             }                         ]                     }                 ]             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "30980"         ]     },     "id": 1 } ```
ca	#### Crear una regla LLD amb substitucions  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Discover database host",         "key_": "lld.with.overrides",         "hostid": "10001",         "type": 0,         "value_type": 3,         "delay": "60s",         "interfaceid": "1155",         "overrides": [             {                 "name": "Discover MySQL host",                 "step": "1",                 "stop": "1",                 "filter": {                     "evaltype": "2",                     "conditions": [                         {                             "macro": "{#UNIT.NAME}",                             "operator": "8",                             "value": "^mysqld\\.service$"                         },                         {                             "macro": "{#UNIT.NAME}",                             "operator": "8",                             "value": "^mariadb\\.service$"                         }                     ]                 },                 "operations": [                     {                         "operationobject": "3",                         "operator": "2",                         "value": "Database host",                         "opstatus": {                             "status": "0"                         },                         "optemplate": [                             {                                 "templateid": "10170"                             }                         ],                         "optag": [                             {                                 "tag": "Database",                                 "value": "MySQL"                             }                         ]                     }                 ]             },             {                 "name": "Discover PostgreSQL host",                 "step": "2",                 "stop": "1",                 "filter": {                     "evaltype": "0",                     "conditions": [                         {                             "macro": "{#UNIT.NAME}",                             "operator": "8",                             "value": "^postgresql\\.service$"                         }                     ]                 },                 "operations": [                     {                         "operationobject": "3",                         "operator": "2",                         "value": "Database host",                         "opstatus": {                             "status": "0"                         },                         "optemplate": [                             {                                 "templateid": "10263"                             }                         ],                         "optag": [                             {                                 "tag": "Database",                                 "value": "PostgreSQL"                             }                         ]                     }                 ]             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "30980"         ]     },     "id": 1 } ```

en-us	#### Creating a LLD rule with preprocessing  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Discovery rule with preprocessing",         "key_": "lld.with.preprocessing",         "hostid": "10001",         "ruleid": "27665",         "type": 0,         "value_type": 3,         "delay": "60s",         "interfaceid": "1155",         "preprocessing": [             {                 "type": 20,                 "params": "20",                 "error_handler": 0,                 "error_handler_params": ""             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```
ca	#### Crear una regla LLD amb preprocessament  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Discovery rule with preprocessing",         "key_": "lld.with.preprocessing",         "hostid": "10001",         "ruleid": "27665",         "type": 0,         "value_type": 3,         "delay": "60s",         "interfaceid": "1155",         "preprocessing": [             {                 "type": 20,                 "params": "20",                 "error_handler": 0,                 "error_handler_params": ""             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```

en-us	#### Creating a maintenance  Create a maintenance with data collection for host group with ID "2" and with problem tags **service:mysqld** and **error**. It must be active from 22.01.2013 till 22.01.2014, come in effect each Sunday at 18:00 and last for one hour.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "maintenance.create",     "params": {         "name": "Sunday maintenance",         "active_since": 1358844540,         "active_till": 1390466940,         "tags_evaltype": 0,         "groups": [             {"groupid": "2"}         ],         "timeperiods": [             {                 "period": 3600,                 "timeperiod_type": 3,                 "start_time": 64800,                 "every": 1,                 "dayofweek": 64             }         ],         "tags": [             {                 "tag": "service",                 "operator": "0",                 "value": "mysqld"             },             {                 "tag": "error",                 "operator": "2",                 "value": ""             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "maintenanceids": [             "3"         ]     },     "id": 1 } ```
ca	#### Crear un manteniment  Crea un manteniment amb un recull de dades per al grup d'equips amb ID "2" i amb els tags de problema **service:mysqld** i **error**. Ha d'ésser actiu des de 22.01.2013 fins a 22.01.2014, entrar en vigor cada diumenge a les 6 de la tarda i durar una hora.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "maintenance.create",     "params": {         "name": "Sunday maintenance",         "active_since": 1358844540,         "active_till": 1390466940,         "tags_evaltype": 0,         "groups": [             {"groupid": "2"}         ],         "timeperiods": [             {                 "period": 3600,                 "timeperiod_type": 3,                 "start_time": 64800,                 "every": 1,                 "dayofweek": 64             }         ],         "tags": [             {                 "tag": "service",                 "operator": "0",                 "value": "mysqld"             },             {                 "tag": "error",                 "operator": "2",                 "value": ""             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "maintenanceids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Creating a map  To create a map, do the following:  -   Go to *Monitoring → Maps* -   Go to the view with all maps -   Click on *Create map*  You can also use the *Clone* and *Full clone* buttons in the configuration form of an existing map to create a new map. Clicking on *Clone* will retain general layout attributes of the original map, but no elements. *Full clone* will retain both the general layout attributes and all elements of the original map.  The **Map** tab contains general map attributes:  ![](../../../../../assets/en/manual/config/visualization/map_config.png)  All mandatory input fields are marked with a red asterisk.  General map attributes:  |Parameter|Description| |--|--------| |*Owner*|Name of map owner.| |*Name*|Unique map name.| |*Width*|Map width in pixels.| |*Height*|Map height in pixels.| |*Background image*|Use background image:<br>**No image** - no background image (white background)<br>**Image** - selected image to be used as a background image. No scaling is performed. You may use a geographical map or any other image to enhance your map.| |*Automatic icon mapping*|You can set to use an automatic icon mapping, configured in *Administration → General → Icon mapping*. Icon mapping allows mapping certain icons against certain host inventory fields.| |*Icon highlighting*|If you check this box, map elements will receive highlighting.<br>Elements with an active trigger will receive a round background, in the same color as the highest severity trigger. Moreover, a thick green line will be displayed around the circle, if all problems are acknowledged.<br>Elements with "disabled" or "in maintenance" status will get a square background, gray and orange respectively.<br>See also: [Viewing maps](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps)| |*Mark elements on trigger status change*|A recent change of trigger status (recent problem or resolution) will be highlighted with markers (inward-pointing red triangles) on the three sides of the element icon that are free of the label. Markers are displayed for 30 minutes.| |*Display problems*|Select how problems are displayed with a map element:<br>**Expand single problem** - if there is only one problem, the problem name is displayed. Otherwise, the total number of problems is displayed.<br>**Number of problems** - the total number of problems is displayed<br>**Number of problems and expand most critical one** - the name of the most critical problem and the total number of problems is displayed.<br>'Most critical' is determined based on problem severity and, if equal, problem event ID (higher ID or later problem displayed first). For a *trigger map element* it is based on problem severity and if equal, trigger position in the trigger list. In case of multiple problems of the same trigger, the most recent one will be displayed.| |*Advanced labels*|If you check this box you will be able to define separate label types for separate element types.| |*Map element label type*|Label type used for map elements:<br>**Label** - map element label<br>**IP address** - IP address<br>**Element name** - element name (for example, host name)<br>**Status only** - status only (OK or PROBLEM)<br>**Nothing** - no labels are displayed| |*Map element label location*|Label location in relation to the map element:<br>**Bottom** - beneath the map element<br>**Left** - to the left<br>**Right** - to the right<br>**Top** - above the map element| |*Problem display*|Display problem count as:<br>**All** - full problem count will be displayed<br>**Separated** - unacknowledged problem count will be displayed separated as a number of the total problem count<br>**Unacknowledged only** - only the unacknowledged problem count will be displayed| |*Minimum trigger severity*|Problems below the selected minimum severity level will not be displayed on the map.<br>For example, with *Warning* selected, changes with *Information* and *Not classified* level triggers will not be reflected in the map.<br>This parameter is supported starting with Zabbix 2.2.| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*URLs*|URLs for each element type can be defined (with a label). These will be displayed as links when a user clicks on the element in the map viewing mode.<br>Macros can be used in map URL names and values. For a full list, see [supported macros](/manual/appendix/macros/supported_by_location) and search for 'map URL names and values'.|
ca	#### Crear un mapa  Per crear un mapa, seguiu aquestes passes:  - Aneu a *Monitoratge → Mapes* - Aneu a veure tots els mapes - Feu clic a *Crea una tarja*  També podeu emprar els botons *Clonar* i *Clonar completament* al formulari de configuració del mapa existent per crear un mapa nou. Si feu clic a *Clonar*, es conservaran els atributs de disseny generals del mapa original, però sense elements. *El clon complet* conservarà tant els atributs de disseny general com tots els elements del mapa originals.  La pestanya **Mapa** conté els atributs generals del mapa:  ![](../../../../../assets/en/manual/config/visualization/map_config.png)  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  Atributs generals de la tarja:  |Paràmetre|Descripció| |--|---------| |*Propietari*|Nom del propietari de la tarja.| |*Nom*|Nom únic del mapa.| |*Amplada*|Amplada del mapa en píxels.| |*Alçada*|Alçada del mapa en píxels.| |*Imatge de fons*|Empra la imatge de fons:<br>**Sense imatge** - sense imatge de fons (fons blanc)<br>**Imatge** - imatge seleccionada per emprar-la com a imatge de fons. No es fa cap escalat. Podeu emprar un mapa o qualsevol altra imatge per millorar el vostre mapa.| |*Mapeig automàtic d'icones*|Podeu configurar l'ús de l'assignació automàtica d'icones, configurat a *Administració → General → Mapes d'icones*. L'assignació d'icones permet assignar certes icones a determinats camps d'inventari de l'equip.| |*Icona destacada*|Si marqueu aquesta casella, els elements del mapa es ressaltaran.<br>Els elements amb un trigger actiu rebran un fons rodó, del mateix color que el trigger de més gravetat. A més, es mostrarà una línia verda gruixuda al voltant del cercle, si es reconeixen tots els problemes.<br>Els elements amb estat "desactivat" o "en manteniment" tindran un fons quadrat, gris i carbassa respectivament.<br>Veieu també: [visualització de mapes](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps)| |*Marca els elements al canvi d'estat de trigger*|Un canvi d'estat de trigger recent (problema o resolució recent) es ressaltarà amb marcadors (triangles vermells cap a dins) als tres costats de la icona de l'element que no contenen l'etiqueta. Els marcadors es mostren durant 30 minuts.| |*Mostrar problemes*|Seleccioneu com es mostren els problemes amb un element del mapa:<br>**Detalleu el problema únic** - si només hi ha un problema, el nom del problema s'adjunta. En cas contrari, es mostra el nombre total de problemes.<br>**Nombre de problemes** - es mostra el nombre total de problemes<br>**Nombre de problemes i detall més crític** -: el nom del problema més crític i es mostra el nombre total de problemes.<br>El "Més crític" es determina en funció de la gravetat del problema i, si és igual, de l'identificador d'esdeveniment del problema (l'identificador superior o el problema es mostra més tard primer). Per a un *element del mapa trigger*, es basa en la gravetat del problema i, si és igual, la posició del trigger a la llista de trigger. En cas de diversos problemes del mateix trigger, es mostrarà el més recent.| |*Etiquetes avançades*|Si marqueu aquesta casella, podreu definir tipus d'etiquetes separats per a tipus d'elements separats.| |*Tipus d'etiqueta d'element del mapa*|Tipus d'etiqueta emprat per als elements del mapa:<br>**Etiqueta** - etiqueta de l'element del mapa<br>**Adreça IP** - Adreça IP<br>**Nom de l'element** - nom de l'element (p. ex., nom d'equip)<br>**Només estat** - només estat (BÉ o PROBLEMA)<br>** Res** - no es mostra cap etiqueta| |*Ubicació de l'etiqueta de l'element del mapa*|Ubicació de l'etiqueta en relació amb l'element del mapa:<br>**Sota** - a sota de l'element del mapa<br>**Esquerra** - esquerra<br>**Dreta** - dreta< br>**Sobre** - a sobre de l'element del mapa| |*Visualització del problema*|Mostra el nombre de problemes com a:<br>**Tots** - es mostrarà el nombre total de problemes<br>**Separats** - el nombre de problemes no reconeguts es mostrarà separat com un recompte del nombre total de problemes <br>**Només no reconegut** - només es mostrarà el nombre de problemes no reconeguts| |*Severitat mínima*|Els problemes per sota del nivell de gravetat mínima triada no es mostraran al mapa.<br>Per exemple, amb *Avís* triat, els canvis amb *Informació* i *Triggers de nivell no classificat* no es reflectiran al mapa. <br>Aquest paràmetre és compatible amb Zabbix 2.2.| |*Mostra els problemes esborrats*|Marqueu la casella per mostrar els problemes que, d'altra manera, s'esborrarien (no es mostren) a causa del manteniment d'equip.| |*URLs*|Es poden definir URL per a cada tipus d'element (amb una etiqueta). Aquests es mostraran com a enllaços quan un usuari faci clic a l'element en mode de visualització de mapa.<br>Les macros es poden emprar en els noms i els valors d'URL del mapa. Per obtindre una llista completa, veieu [macros compatibles](/manual/appendix/macros/supported_by_location) i cerqueu "noms i valors d'URL del mapa".|

en-us	#### Creating an email media type  Create a new email media type with a custom SMTP port and message templates.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "mediatype.create",     "params": {         "type": "0",         "name": "Email",         "smtp_server": "mail.example.com",         "smtp_helo": "example.com",         "smtp_email": "zabbix@example.com",         "smtp_port": "587",         "content_type": "1",         "message_templates": [             {                 "eventsource": "0",                 "recovery": "0",                 "subject": "Problem: {EVENT.NAME}",                 "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" started at {EVENT.TIME}."             },             {                 "eventsource": "0",                 "recovery": "1",                 "subject": "Resolved in {EVENT.DURATION}: {EVENT.NAME}",                 "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE}."             },             {                 "eventsource": "0",                 "recovery": "2",                 "subject": "Updated problem in {EVENT.AGE}: {EVENT.NAME}",                 "message": "{USER.FULLNAME} {EVENT.UPDATE.ACTION} problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}."             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "mediatypeids": [             "7"         ]     },     "id": 1 } ```
ca	#### Crear un nou tipus de suport correu-e  Crear un nou tipus de suport correu-e amb un port SMTP a mida i els models de missatge.  [Petició](/manual/api#performing-requests):  ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "0", "name": "Email", "smtp_server": "mail.exemple.cat", "smtp_helo": "exemple.cat", "smtp_email": "zabbix@exemple.cat", "smtp_port": "587", "content_type": "1", "message_templates": [ { "eventsource": "0", "recovery": "0", "subject": "Problema: {EVENT.NAME}", "message": "Problema \"{EVENT.NAME}\" a l'equip \"{HOST.NAME}\" iniciat {EVENT.TIME}." }, { "eventsource": "0", "recovery": "1", "subject": "Resolt el {EVENT.DURATION}: {EVENT.NAME}", "message": "Problema \"{EVENT.NAME}\" a l'equip \"{HOST.NAME}\" s'ha resolt a les {EVENT.RECOVERY.TIME} de {EVENT.RECOVERY.DATE}." }, { "eventsource": "0", "recovery": "2", "subject": "Updated problem in {EVENT.AGE}: {EVENT.NAME}", "message": "{USER.FULLNAME} {EVENT.UPDATE.ACTION} problema \"{EVENT.NAME}\" a l'equip \"{HOST.NAME}\" a {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}." } ] }, "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "mediatypeids": [             "9"         ]     },     "id": 1 } ```

en-us	#### Creating a new global regular expression.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "regexp.create",     "params": {       "name": "Storage devices for SNMP discovery",       "test_string": "/boot",       "expressions": [         {           "expression": "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$",           "expression_type": "4",           "case_sensitive": "1"         }       ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "regexpids": [             "16"         ]     },     "id": 1 } ```
ca	#### Crear una nova expressió regular global.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "regexp.create",     "params": {       "name": "Dispositius d'emmagatzematge per descoberta SNMP",       "test_string": "/boot",       "expressions": [         {           "expression": "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$",           "expression_type": "4",           "case_sensitive": "1"         }       ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "regexpids": [             "16"         ]     },     "id": 1 } ```

en-us	#### Creating a new item  Now, create a new [item](/manual/api/reference/item/object) on the host "Zabbix server" using the data you have obtained from the previous `host.get` request. This can be done using the [item.create](/manual/api/reference/item/create) method:  ```bash curl --request POST \   --url 'https://example.com/zabbix/api_jsonrpc.php' \   --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \   --header 'Content-Type: application/json-rpc' \   --data '{"jsonrpc":"2.0","method":"item.create","params":{"name":"Free disk space on /home/joe/","key_":"vfs.fs.size[/home/joe/,free]","hostid":"10084","type":0,"value_type":3,"interfaceid":"1","delay":30},"id":3}' ```  A successful response will contain the ID of the newly created item, which can be used to reference the item in the following requests:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "24759"         ]     },     "id": 3 } ```  ::: notetip The `item.create` method as well as other *create methods* can also accept arrays of objects and create multiple items with one API call. :::
ca	#### Creació d'un element nou  Creem un nou [element](/manual/api/reference/item/object) a l'equip "Servidor Zabbix" emprant les dades que vam obtindre de la petició `host.get` anterior. Això es pot fer mitjançant el mètode [item.create](/manual/api/reference/item/create):  ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"item.create","params":{"name":"Free disk space on /home/joe/","key_":"vfs.fs.size[/home/joe/,free]","hostid":"10084","type":0,"value_type":3,"interfaceid":"1","delay":30},"id":3}' ```  Una resposta correcta contindrà l'ID de l'element que s'acaba de crear, que es pot emprar per fer referència a l'element en peticions posteriors:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "24759"         ]     },     "id": 3 } ```  ::: notetip El mètode `item.create` i altres mètodes de creació també poden admetre matrius d'objectes i crear diversos elements amb una única crida a l'API. :::

en-us	#### Creating an item  Create a numeric Zabbix agent item with 2 item tags to monitor free disk space on host with ID "30074".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "Free disk space on /home/joe/",         "key_": "vfs.fs.size[/home/joe/,free]",         "hostid": "30074",         "type": 0,         "value_type": 3,         "interfaceid": "30084",         "tags": [             {                 "tag": "Disk usage"             },             {                 "tag": "Equipment",                 "value": "Workstation"             }         ],         "delay": "30s"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "24758"         ]     },     "id": 1 } ```
ca	#### Crear un element  Crear un element d'agent Zabbix numèric amb dues etiquetes d'element per monitorar l'espai en disc lliure de l'equip amb ID "30074".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "Free disk space on /home/joe/",         "key_": "vfs.fs.size[/home/joe/,free]",         "hostid": "30074",         "type": 0,         "value_type": 3,         "interfaceid": "30084",         "tags": [             {                 "tag": "Disc usage"             },             {                 "tag": "Equipment",                 "value": "Workstation"             }         ],         "delay": "30s"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "24758"         ]     },     "id": 1 } ```

en-us	#### Creating an item prototype  Create an item prototype to monitor free disk space on a discovered file system. Discovered items should be numeric Zabbix agent items updated every 30 seconds.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "name": "Free disk space on {#FSNAME}",         "key_": "vfs.fs.size[{#FSNAME},free]",         "hostid": "10197",         "ruleid": "27665",         "type": 0,         "value_type": 3,         "interfaceid": "112",         "delay": "30s"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27666"         ]     },     "id": 1 } ```
ca	#### Crear un prototip d'element  Crear un prototip d'element per monitorar l'espai lliure de disc d'un sistema d'arxius descobert. Els elements trobats han de tindre els elements numèrics de l'agent de Zabbix actualitzats cada 30 segons.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "name": "Free disk space on {#FSNAME}",         "key_": "vfs.fs.size[{#FSNAME},free]",         "hostid": "10197",         "ruleid": "27665",         "type": 0,         "value_type": 3,         "interfaceid": "112",         "delay": "30s"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27666"         ]     },     "id": 1 } ```

en-us	#### Creating an item prototype with preprocessing  Create an item using change per second and a custom multiplier as a second step.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "name": "Incoming network traffic on {#IFNAME}",         "key_": "net.if.in[{#IFNAME}]",         "hostid": "10001",         "ruleid": "27665",         "type": 0,         "value_type": 3,         "delay": "60s",         "units": "bps",         "interfaceid": "1155",         "preprocessing": [             {                 "type": 10,                 "params": "",                 "error_handler": 0,                 "error_handler_params": ""             },             {                 "type": 1,                 "params": "8",                 "error_handler": 2,                 "error_handler_params": "10"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```
ca	#### Crear un prototip d'elememt amb preprocessament  Crear un element emprant el canvi per segon i un multiplicador a mida com a segona passa.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "name": "Incoming network traffic on {#IFNAME}",         "key_": "net.if.in[{#IFNAME}]",         "hostid": "10001",         "ruleid": "27665",         "type": 0,         "value_type": 3,         "delay": "60s",         "units": "bps",         "interfaceid": "1155",         "preprocessing": [             {                 "type": 10,                 "params": "",                 "error_handler": 0,                 "error_handler_params": ""             },             {                 "type": 1,                 "params": "8",                 "error_handler": 2,                 "error_handler_params": "10"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```

en-us	#### Creating an item with preprocessing  Create an item using custom multiplier.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "Device uptime",         "key_": "sysUpTime",         "hostid": "11312",         "type": 4,         "snmp_oid": "SNMPv2-MIB::sysUpTime.0",         "value_type": 1,         "delay": "60s",         "units": "uptime",         "interfaceid": "1156",         "preprocessing": [             {                 "type": 1,                 "params": "0.01",                 "error_handler": 1,                 "error_handler_params": ""             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44210"         ]     },     "id": 1 } ```
ca	#### Crear un element nou amb preprocessament  Crear un element emprant un multiplicador a mida.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "Device uptime",         "key_": "sysUpTime",         "hostid": "11312",         "type": 4,         "snmp_oid": "SNMPv2-MIB::sysUpTime.0",         "value_type": 1,         "delay": "60s",         "units": "uptime",         "interfaceid": "1156",         "preprocessing": [             {                 "type": 1,                 "params": "0.01",                 "error_handler": 1,                 "error_handler_params": ""             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44210"         ]     },     "id": 1 } ```

en-us	#### Creating an LLD rule  Create a Zabbix agent LLD rule to discover mounted file systems. Discovered items will be updated every 30 seconds.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Mounted filesystem discovery",         "key_": "vfs.fs.discovery",         "hostid": "10197",         "type": 0,         "interfaceid": "112",         "delay": "30s"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```
ca	#### Crear una regla LLD  Crear una regla de descoberta de baix nivell per descobrir els sistemes d'arxius muntats. Els objectes descoberts seran actualitzats cada 30 segons.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Descoberta de sistemes d'arxius muntats",         "key_": "vfs.fs.discovery",         "hostid": "10197",         "type": 0,         "interfaceid": "112",         "delay": "30s"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```

en-us	#### Creating an SLA  Instruct to create an SLA entry for: * tracking uptime for SQL-engine related services; * custom schedule of all weekdays excluding last hour on Saturday; * an effective date of the last day of the year 2022; * with 1 hour and 15 minutes long planned downtime starting at midnight on the 4th of July; * SLA weekly report calculation will be on; * the minimum acceptable SLO will be 99.9995%.
ca	#### Creació d'un SLA  Cal crear una entrada d'SLA: * per fer un seguiment de la disponibilitat de serveis relacionats amb el motor SQL; * amb horari personalitzat tots els dies de la setmana excepte la darrera hora de dissabte; * amb data efectiva el darrer dia de l'any 2022; * amb 1 hora i 15 minuts d'inactivitat programada a partir de la mitjanit del 4 de juliol; * S'habilitarà el càlcul setmanal d'informes de SLA; * SLO mínim acceptable serà del 99,9995%.

en-us	 ##### Creating application  1\. Log into your account at [Microsoft Azure](https://portal.azure.com). For testing purposes, you may create a free trial account in Microsoft Azure.  2\. From the main menu (see top left of the screen) select *Azure Active Directory*.  3\. Select *Enterprise applications* -> *Add new application* -> *Create your own application*.  4\. Add the name of your app and select the *Integrate any other application...* option. After that, click on *Create*.  ![](../../../../assets/en/manual/appendix/install/azure_create_app.png){width="600"}
ca	 ##### Crear aplicació  1\. Inicieu sessió al vostre compte de [Microsoft Azure](https://portal.azure.com). Amb finalitats de prova, podeu crear un compte de prova de franc a Microsoft Azure.  2\. Al menú principal (veieu la part superior esquerra de la pantalla) trieu *Azure Active Directory*.  3\. Trieu *Aplicacions empresarials* -> *Afegir una aplicació nova* -> *Creeu la vostra pròpia aplicació*.  4\. Afegiu el nom de la vostra aplicació i trieu l'opció *Integra qualsevol altra aplicació...*. Després d'això, feu clic a *Crear*.  ![](../../../../assets/en/manual/appendix/install/azure_create_app.png){width="600"}

en-us	 ##### Creating application  1\. Log into your account at OneLogin. For testing purposes, you may create a free developer account in OneLogin.  2\. In the OneLogin web interface navigate to *Applications → Applications*.  3\. Click on "Add App" and search for the appropriate app. The guidelines in this page are based on the *SCIM Provisioner with SAML (SCIM v2 Enterprise, full SAML)* app example.  4\. To begin with, you may want to customize the display name of your app. You may also want to add the icon and app details. After that, click on *Save*.
ca	 ##### Crear una aplicació  1\. Inicieu sessió al vostre compte a OneLogin. Amb finalitats de prova, podeu crear un compte de desenvolupador gratuït a OneLogin.  2\. A la interfície web de OneLogin, navegueu a *Aplicacions → Aplicacions*.  3\. Feu clic a "Afegir aplicació" i cerqueu l'aplicació adequada. Les directrius d'aquesta pàgina es basen en l'exemple de l'aplicació *SCIM Provisioner amb SAML (SCIM v2 Enterprise, SAML complet)*.  4\. Per començar, és possible que vulgueu personalitzar el nom de visualització de la vostra aplicació. També podeu afegir la icona i els detalls de l'aplicació. Després d'això, feu clic a *Desar*.

en-us	#### Creating a role  Create a role with type "User" and denied access to two UI elements.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "role.create",     "params": {         "name": "Operator",         "type": "1",         "rules": {             "ui": [                 {                     "name": "monitoring.hosts",                     "status": "0"                 },                 {                     "name": "monitoring.maps",                     "status": "0"                 }             ]         }     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "roleids": [             "5"         ]     },     "id": 1 } ```
ca	#### Crear un rol  Crear un rol amb el tipus "Usuari" i prohibir l'accés a dos elements de la interfície d'usuari.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "role.create",     "params": {         "name": "Operator",         "type": "1",         "rules": {             "ui": [                 {                     "name": "monitoring.hosts",                     "status": "0"                 },                 {                     "name": "monitoring.maps",                     "status": "0"                 }             ]         }     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "roleids": [             "5"         ]     },     "id": 1 } ```

en-us	#### Creating a scheduled report  Create a weekly report that will be prepared for the previous week every Monday-Friday at 12:00 from 2021-04-01 to 2021-08-31.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "report.create",     "params": {         "userid": "1",         "name": "Weekly report",         "dashboardid": "1",         "period": "1",         "cycle": "1",         "start_time": "43200",         "weekdays": "31",         "active_since": "2021-04-01",         "active_till": "2021-08-31",         "subject": "Weekly report",         "message": "Report accompanying text",         "status": "1",         "description": "Report description",         "users": [             {                 "userid": "1",                 "access_userid": "1",                 "exclude": "0"             },             {                 "userid": "2",                 "access_userid": "0",                 "exclude": "1"             }         ],         "user_groups": [             {                 "usrgrpid": "7",                 "access_userid": "0"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "reportids": [             "1"         ]     },     "id": 1 } ```
ca	#### Crear un informe planificat  Crear un informe setmanal que es prepararà per la setmana anterior tots els dies de dilluns a divendres a les 1 del migdia des de l'01.04.2021 fins al 31.08.2021.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "report.create",     "params": {         "userid": "1",         "name": "Weekly report",         "dashboardid": "1",         "period": "1",         "cycle": "1",         "start_time": "43200",         "weekdays": "31",         "active_since": "2021-04-01",         "active_till": "2021-08-31",         "subject": "Weekly report",         "message": "Report accompanying text",         "status": "1",         "description": "Report description",         "users": [             {                 "userid": "1",                 "access_userid": "1",                 "exclude": "0"             },             {                 "userid": "2",                 "access_userid": "0",                 "exclude": "1"             }         ],         "user_groups": [             {                 "usrgrpid": "7",                 "access_userid": "0"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "reportids": [             "1"         ]     },     "id": 1 } ```

en-us	#### Creating a script media type  Create a new script media type with a custom value for the number of attempts and the interval between them.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "mediatype.create",     "params": {         "type": "1",         "name": "Push notifications",         "exec_path": "push-notification.sh",         "maxattempts": "5",         "attempt_interval": "11s",         "parameters": [             {                 "sortorder": "0",                 "value": "{ALERT.SENDTO}"             },             {                 "sortorder": "1",                 "value": "{ALERT.SUBJECT}"             },             {                 "sortorder": "2",                 "value": "{ALERT.MESSAGE}"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "mediatypeids": [             "8"         ]     },     "id": 1 } ```
ca	#### Crear un tipus de suport de script  Crear un nou tipus de suport de script amb un valor personalitzat per al nombre d'intents i l'interval entre elles.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "mediatype.create",     "params": {         "type": "1",         "name": "Push notifications",         "exec_path": "push-notification.sh",         "exec_params": "{ALERT.SENDTO}\n{ALERT.SUBJECT}\n{ALERT.MESSAGE}\n",         "maxattempts": "5",         "attempt_interval": "11s"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "mediatypeids": [             "8"         ]     },     "id": 1 } ```

en-us	#### Creating a service  Create a service that will be switched to problem state, if at least one child has a problem.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "service.create",     "params": {         "name": "Server 1",         "algorithm": 1,         "sortorder": 1     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "serviceids": [             "5"         ]     },     "id": 1 } ```
ca	#### Crear un servei  Crea un servei que passarà a l'estat de problema si, com a mínim, un procés fill té un problema.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "service.create",     "params": {         "name": "Server 1",         "algorithm": 1,         "sortorder": 1     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "serviceids": [             "5"         ]     },     "id": 1 } ```

en-us	#### Creating a slideshow  A slideshow will run automatically if the dashboard contains two or more pages (see [Adding pages](#adding_pages)) and if one of the following is true:  -   The *Start slideshow automatically* option is marked in dashboard     properties -   The dashboard URL contains a `slideshow=1` parameter  The pages rotate according to the intervals given in the properties of the dashboard and individual pages. Click on:  -   *Stop slideshow* - to stop the slideshow -   *Start slideshow* - to start the slideshow  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_tabs.png)  Slideshow-related controls are also available in [kiosk mode](#viewing_and_editing_a_dashboard) (where only the page content is shown):  -   ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/slideshow_stop_kiosk.png) -     stop slideshow -   ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/slideshow_start_kiosk.png) -     start slideshow -   ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/slideshow_back_kiosk.png) -     go back one page -   ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/slideshow_next_kiosk.png) -     go to the next page
ca	#### Crear una diapositiva  Una presentació de diapositives s'executarà automàticament si el tauler de control conté dues o més pàgines (veieu [Afegir pàgines](#adding_pages)) i si una de les accions següents és certa:  - L'opció *Inicia la presentació de diapositives automàticament* és marcada a les propietats del tauler - L'URL del tauler de control conté un paràmetre `slideshow=1`  Les pàgines giren segons els intervals indicats a les propietats del tauler i pàgines individuals. Feu clic a:  - *Atura la presentació de diapositives* - per aturar la presentació de diapositives - *Inicia la presentació de diapositives* - per iniciar la presentació de diapositives  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_tabs.png)  Els controls relacionats amb la presentació de diapositives també són disponibles al [mode quiosc](#viewing_and_editing_a_dashboard) (on només es veu el contingut de la pàgina):  - ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/slideshow_stop_kiosk.png) - atura la presentació - ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/slideshow_start_kiosk.png) - inicia la presentació - ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/slideshow_back_kiosk.png) - torna una pàgina enrere - ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/slideshow_next_kiosk.png) - aneu a la pàgina següent

en-us	#### Creating a task  Create a task `Execute now` for two items. One is an item, the other is a low-level discovery rule.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "task.create",     "params": [         {             "type": 6,             "request": {                 "itemid": "10092"             }         },         {             "type": 6,             "request": {                 "itemid": "10093"             }         }     ],     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "taskids": [             "1",             "2"         ]     },     "id": 1 } ```  Create a task `Refresh proxy configuration` for two proxies.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "task.create",     "params": [         {             "type": 2,             "request": {                 "proxy_hostids": ["10459", "10460"]             }         }     ],     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "taskids": [             "1"         ]     },     "id": 1 } ```  Create a task `diagnostic information`.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "task.create",     "params": [         {             "type": 1,             "request": {                 "alerting": {                     "stats": [                         "alerts"                     ],                     "top": {                         "media.alerts": 10                     }                 },                 "lld": {                     "stats": "extend",                     "top": {                         "values": 5                     }                 }             },             "proxy_hostid": 0         }     ],     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "taskids": [             "3"         ]     },     "id": 1 } ```
ca	#### Crear una tasca  Crear una tasca `check now` per a dos elements. Un es un element, l'altre és una regla de descoberta de baix nivell.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "task.create",     "params": [         {             "type": 6,             "request": {                 "itemid": "10092"             }         },         {             "type": "6",             "request": {                 "itemid": "10093"             }         }     ],     "auth": "700ca65537074ec963db7efabda78259",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "taskids": [             "1",             "2"         ]     },     "id": 1 } ```  Crear una tasca `diagnostic information`.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "task.create",     "params": [         {             "type": 1,             "request": {                 "alerting": {                     "stats": [                         "alerts"                     ],                     "top": {                         "media.alerts": 10                     }                 },                 "lld": {                     "stats": "extend",                     "top": {                         "values": 5                     }                 }             },             "proxy_hostid": 0         }     ],     "id": 2 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "taskids": [             "3"         ]     },     "id": 2 } ```

en-us	#### Creating a template  Create a template with tags and link two templates to this template.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "template.create",     "params": {         "host": "Linux template",         "groups": {             "groupid": 1         },         "templates": [             {                 "templateid": "11115"             },             {                 "templateid": "11116"             }         ],         "tags": [             {                 "tag": "Host name",                 "value": "{HOST.NAME}"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "11117"         ]     },     "id": 1 } ```
ca	#### Crear una plantilla  Crea una plantilla amb etiquetes, i enllaçar-hi dues plantilles a la plantilla.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "template.create",     "params": {         "host": "Linux template",         "groups": {             "groupid": 1         },         "templates": [             {                 "templateid": "11115"             },             {                 "templateid": "11116"             }         ],         "tags": [             {                 "tag": "Host name",                 "value": "{HOST.NAME}"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "11117"         ]     },     "id": 1 } ```

en-us	#### Creating a template dashboard  Create a template dashboard named “Graphs” with one Graph widget on a single dashboard page.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templatedashboard.create",     "params": {         "templateid": "10318",         "name": "Graphs",         "pages": [             {                 "widgets": [                     {                         "type": "graph",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 6,                                 "name": "graphid",                                 "value": "1123"                             }                         ]                     }                 ]              }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "32"         ]     },     "id": 1 } ```
ca	#### Crear una plantilla de tauler  Crear una plantilla de tauler anomenada “Graphs” amb un giny gràfic, a una sola pàgina de tauler.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templatedashboard.create",     "params": {         "templateid": "10318",         "name": "Graphs",         "pages": [             {                 "widgets": [                     {                         "type": "graph",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 6,                                 "name": "graphid",                                 "value": "1123"                             }                         ]                     }                 ]                              }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "32"         ]     },     "id": 1 } ```

en-us	#### Creating a template group  Create a template group called "Templates/Databases".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.create",     "params": {         "name": "Templates/Databases"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "107820"         ]     },     "id": 1 } ```
ca	#### Crear un grup de plantilles  Crea un grup de plantilles anomenat "Plantilles / Bases de dades".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.create",     "params": {         "name": "Plantilles / Bases de Dades"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "107820"         ]     },     "id": 1 } ```

en-us	#### Creating a template group  ::: noteimportant Only Super Admin users can create template groups. :::  To create a template group in Zabbix frontend, do the following:  1. Go to: *Data collection → Template groups*. 2. Click on *Create template group* in the upper right corner of the screen. 3. Enter the group name in the form.  ![](../../../../assets/en/manual/config/template_group.png)  To create a nested template group, use the '/' forward slash separator, for example `Linux servers/Databases/MySQL`. You can create this group even if none of the two parent template groups (`Linux servers/Databases/`) exist. In this case creating these parent template groups is up to the user; they will not be created automatically.<br>Leading and trailing slashes, several slashes in a row are not allowed. Escaping of '/' is not supported.
ca	#### Crear un grup de plantilles  ::: noteimportant Només els usuaris superadministradors poden crear grups de plantilles. :::  Per crear un grup de plantilles a la interfície de Zabbix, feu el següent:  1. Aneu a: *Recollida de dades → Grups de plantilles*. 2. Feu clic a *Crea un grup de plantilles* a la cantonada superior dreta de la pantalla. 3. Introduïu el nom del grup al formulari.  ![](../../../../assets/en/manual/config/template_group.png)  Per crear un grup de plantilles niuat, empreu el separador de barra inclinada '/', per exemple `Linux servers/Databases/MySQL'. Podeu crear aquest grup encara que no existeixi cap dels dos grups de plantilles principals (`Linux servers/Databases/`). En aquest cas, la creació d'aquests grups de plantilles pare depèn de l'usuari; no es crearan automàticament.<br>Les barres inclinades inicials i posteriors no es permeten diverses barres inclinades seguides. L'escapament de "/" no és compatible.

en-us	#### Creating a template  To create a template, do the following:  1. Go to *Data collection* → *Templates*. 2. Click on *Create template*. 3. Edit template attributes.  The **Template** tab contains general template attributes.  ![](../../../../assets/en/manual/config/template_a.png){width=600}  All mandatory input fields are marked with a red asterisk.  Template attributes:  |Parameter|Description| |--|--------| |*Template name*|Unique template name.<br>Alphanumerics, spaces, dots, dashes, and underscores are allowed.<br>Leading and trailing spaces are not allowed.| |*Visible name*|If you set this name, it will be the one visible in lists, maps, etc.| |*Templates*|Link one or more templates to this template. All entities (items, triggers, etc.) will be inherited from the linked templates.<br>To link a new template, start typing the template name in the *Link new templates* field. A list of matching templates will appear; scroll down to select. Alternatively, you may click on *Select* next to the field and select templates from the list in a pop-up window. The templates that are selected in the *Link new templates* field will be linked to the template when the template configuration form is saved or updated.<br>To unlink a template, use one of the two options in the *Linked templates* block:<br>*Unlink* - unlink the template, but preserve its entities (items, triggers, etc.);<br>*Unlink and clear* - unlink the template and remove all of its entities (items, triggers, etc.).| |*Template groups*|Groups the template belongs to. | |*Description*|Template description.| |*Vendor and version*|Template vendor and version; displayed only when updating existing templates ([out-of-the-box templates](/manual/config/templates_out_of_the_box) provided by Zabbix, [imported templates](/manual/xml_export_import/templates#importing), or templates modified through the [Template API](/manual/api/reference/template)) if the template configuration contains such information.<br>Cannot be modified in Zabbix frontend.<br>For out-of-the-box templates, version is displayed as follows: major version of Zabbix, delimiter ("-"), revision number (increased with each new version of the template, and reset with each major version of Zabbix). For example, 6.4-0, 6.4-5, 7.0-0, 7.0-3.|  The **Tags** tab allows you to define template-level [tags](/manual/config/tagging). All problems of hosts linked to this template will be tagged with the values entered here.  ![](../../../../assets/en/manual/config/template_c.png)  User macros, {INVENTORY.\*} macros, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros are supported in tags.  The **Macros** tab allows you to define template-level [user macros](/manual/config/macros/user_macros) as a name-value pairs. Note that macro values can be kept as plain text, secret text, or Vault secret. Adding a description is also supported.  ![](../../../../assets/en/manual/config/template_d1.png)  If you select the *Inherited and template macros* option, you may also view macros from linked templates and global macros that the template will inherit, as well as the values that the macros will resolve to.  ![](../../../../assets/en/manual/config/template_d2.png)  For convenience, links to the respective templates, as well as a link to global macro configuration is provided. It is also possible to edit a linked template macro or global macro on the template level, effectively creating a copy of the macro on the template.  The **Value mapping** tab allows to configure human-friendly representation of item data in [value mappings](/manual/config/items/mapping).  Buttons:  |   |   | |--|--------| |![](../../../../assets/en/manual/config/button_add.png)|Add the template. The added template should appear in the list.| |![](../../../../assets/en/manual/config/button_update.png)|Update the properties of an existing template.| |![](../../../../assets/en/manual/config/button_clone.png)|Create another template based on the properties of the current template, including the entities (items, triggers, etc.) inherited from linked templates, but excluding template vendor and version.| |![](../../../../assets/en/manual/config/button_full.png)|Create another template based on the properties of the current template, including the entities (items, triggers, etc.) both inherited from linked templates and directly attached to the current template, but excluding template vendor and version.| |![](../../../../assets/en/manual/config/button_delete.png)|Delete the template; entities of the template (items, triggers, etc.) remain with the linked hosts.| |![](../../../../assets/en/manual/config/button_clear.png)|Delete the template and all its entities from linked hosts.| |![](../../../../assets/en/manual/config/button_cancel.png)|Cancel the editing of template properties.|
ca	#### Crear una plantilla  Per crear una plantilla, feu el següent:  1. Aneu a *Recull de dades * → *Plantilles* 2.  Feu clic a *Crear plantilla* 3.  Editeu els atributs de la plantilla  La pestanya **Plantilla** conté atributs generals de plantilla.  ![](../../../../assets/en/manual/config/template_a.png){width="600"}  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  Atributs de la plantilla:  |Paràmetre|Descripció| |--|---------| |*Nom de la plantilla*|Nom únic de la plantilla.<br>Es permet l'alfabet alfanumèric, els espais, els punts, els guions i els guions baixos. Tanmateix, no es permeten els espais inicials i posteriors.| |*Nom visible*|Si establiu aquest nom, serà el visible a les llistes, mapes, etc.| |*Plantilles*|Enllaça una o més plantilles heretades a aquesta plantilla. Totes les entitats (elements, triggers, gràfics, etc.) s'heretaran de les plantilles enllaçades.<br>Per enllaçar una plantilla nova, comenceu a escriure el nom de la plantilla al camp *Plantilles*. Apareixerà un reguitzell de plantilles coincidents; desplaça't cap avall per triar. Alternativament, podeu fer clic a *Triar* al costat del camp *Plantilles*; després, primer trieu el grup d'equip fent clic a *Triar* al costat del camp *Grups d'equips*; marqueu la casella de selecció davant d'una o diverses plantilles de la llista que es mostra tot seguit; feu clic a *Triar*. Les plantilles triades al camp *Plantilles* s'enllaçaran a l'equip quan es desi o s'actualitzi el formulari de configuració de l'equip.<br>Per desenllaçar una plantilla, empreu una de les dues opcions del bloc *Plantilles*. :<br>*Desenllaça* - desenllaça la plantilla, però conserva els seus elements, triggers i gràfics<br>*Desenllaça i esborra*: desenllaça la plantilla i esborra tots els seus elements, triggers i gràfics| |*Grups de plantilles*|Equips/grups de plantilles als quals pertany la plantilla.| |*Descripció*|Introduïu la descripció de la plantilla.| |*Proveïdor i versió*|Proveïdor i versió de la plantilla; només es mostra quan s'actualitzen les plantilles existents ([plantilles fora de la caixa](/manual/config/templates_out_of_the_box) proporcionades per Zabbix, [plantilles importades](/manual/xml_export_import/templates#importing) o plantilles modificades mitjançant [ Template API](/manual/api/reference/template)) si la configuració de la plantilla conté aquesta informació.<br>No es pot modificar a l'interfície de Zabbix.<br>Per a les plantilles noves, la versió es mostra de la següent manera: versió principal de Zabbix, delimitador ("-"), nombre de revisió (augmentat amb cada versió nova de la plantilla i restabliment amb cada versió principal de Zabbix). Per exemple, 6.4-0, 6.4-5, 7.0-0, 7.0-3.|  La pestanya **Etiquetes** us permet definir [etiquetes] a nivell de plantilla (/manual/config/tagging). Tots els problemes dels equips vinculats a aquesta plantilla s'etiquetaran amb els valors introduïts aquí.  ![](../../../../assets/en/manual/config/template_c.png)  Les macros d'usuari i les macros {INVENTORY.\*}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} i {HOST.ID} són compatibles amb les etiquetes.  La pestanya **Macros** us permet definir les [macros d'usuari](/manual/config/macros/user_macros) a nivell de plantilla com a parelles nom-valor. Tingueu en compte que els valors de macro es poden mantindre com a text sense format, text secret o secret de Vault. També s'admet afegir una descripció.  ![](../../../../assets/en/manual/config/template_d1.png)  També podeu veure aquí macros de plantilles enllaçades i macros globals si trieu l'opció *Macros heretades i de plantilla*. Aquí és on es mostren totes les macros d'usuari definides per a la plantilla amb el valor al qual es resolen, així com el seu origen.  ![](../../../../assets/en/manual/config/template_d2.png)  Per comoditat, es proporcionen enllaços a les plantilles respectives i la configuració global de macros. També és possible editar una plantilla heretada/macro global a nivell de plantilla, creant una còpia de la macro a la plantilla.  La pestanya **Mapatge de valors** permet configurar una representació amigable per a les persones de les dades d'elements al [mapatge de valors](/manual/config/items/mapping).  Botons:  | | | |--|---------| |![](../../../../assets/en/manual/config/button_add.png)|Afegir la plantilla. La plantilla afegida hauria d'aparèixer a la llista.| |![](../../../../assets/en/manual/config/button_update.png)|Actualitzar les propietats d'una plantilla existent.| |![](../../../../assets/en/manual/config/button_clone.png)|Crear una altra plantilla basada en les propietats de la plantilla actual, incloses les entitats (elements, triggers, etc) heretades de plantilles enllaçades.| |![](../../../../assets/en/manual/config/button_full.png)|Crear una altra plantilla basada en les propietats de la plantilla actual, incloses les entitats (elements, triggers, etc.) tant heretades de plantilles enllaçades com directament adjuntes a la plantilla actual.| |![](../../../../assets/en/manual/config/button_delete.png)|Suprimir la plantilla; les entitats de la plantilla (elements, triggers, etc.) romanen amb els equips enllaçats.| |![](../../../../assets/en/manual/config/button_clear.png)|Suprimir la plantilla i totes les seves entitats dels equips enllaçats.| |![](../../../../assets/en/manual/config/button_cancel.png)|Cancel·lar l'edició de les propietats de la plantilla.|

en-us	#### Creating a trigger  Create a trigger with a single trigger dependency.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "trigger.create",     "params": [         {             "description": "Processor load is too high on {HOST.NAME}",             "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5",             "dependencies": [                 {                     "triggerid": "17367"                 }             ]         },         {             "description": "Service status",             "expression": "length(last(/Linux server/log[/var/log/system,Service .* has stopped]))<>0",             "dependencies": [                 {                     "triggerid": "17368"                 }             ],             "tags": [                 {                     "tag": "service",                     "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"                 },                 {                     "tag": "error",                     "value": ""                 }             ]         }     ],     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "17369",             "17370"         ]     },     "id": 1 } ```
ca	#### Crear trigger  Crea un trigger amb una sola dependència de trigger.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "trigger.create",     "params": [         {             "description": "La càrrega del processador és massa alta a l'equip {HOST.NAME}",             "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5",             "dependencies": [                 {                     "triggerid": "17367"                 }             ]         },         {             "description": "Estat del servei",             "expression": "length(last(/Linux server/log[/var/log/system,Service .* has stopped]))<>0",             "dependencies": [                 {                     "triggerid": "17368"                 }             ],             "tags": [                 {                     "tag": "servei",                     "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"                 },                 {                     "tag": "error",                     "value": ""                 }             ]         }     ],     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "17369",             "17370"         ]     },     "id": 1 } ```

en-us	#### Creating a trigger prototype  Create a trigger prototype to detect when a file system has less than 20% free disk space.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "triggerprototype.create",     "params": {         "description": "Free disk space is less than 20% on volume {#FSNAME}",         "expression": "last(/Zabbix server/vfs.fs.size[{#FSNAME},pfree])<20",         "tags": [             {                 "tag": "volume",                 "value": "{#FSNAME}"             },             {                 "tag": "type",                 "value": "{#FSTYPE}"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "17372"         ]     },     "id": 1 } ```
ca	#### Crear un prototip de trigger  Crear un prototip de trigger per detectar quan un sistema d'arxius disposi de menys del 20% d'espai lliure de disc.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "triggerprototype.create",     "params": {         "description": "L'espai lliure de disc és inferior al 20% al volum {#FSNAME}",         "expression": "last(/Zabbix server/vfs.fs.size[{#FSNAME},pfree])<20",         "tags": [             {                 "tag": "volum",                 "value": "{#FSNAME}"             },             {                 "tag": "tipus",                 "value": "{#FSTYPE}"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "17372"         ]     },     "id": 1 } ```

en-us	#### Creating a user  Create a new user, add him to a user group and create a new media for him.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "user.create",     "params": {         "username": "John",         "passwd": "Doe123",         "roleid": "5",         "usrgrps": [             {                 "usrgrpid": "7"             }         ],         "medias": [             {                 "mediatypeid": "1",                 "sendto": [                     "support@company.com"                 ],                 "active": 0,                 "severity": 63,                 "period": "1-7,00:00-24:00"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "userids": [             "12"         ]     },     "id": 1 } ```
ca	#### Crear un usuari  Crea un usuari nou, l'afegeix a un grup d'usuaris i crea un nou suport per a ell.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "user.create",     "params": {         "username": "Xenaro",         "passwd": "Doe123",         "roleid": "5",         "usrgrps": [             {                 "usrgrpid": "7"             }         ],         "medias": [             {                 "mediatypeid": "1",                 "sendto": [                     "suport@nogueiras.gl"                 ],                 "active": 0,                 "severity": 63,                 "period": "1-7,00:00-24:00"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "userids": [             "12"         ]     },     "id": 1 } ```

en-us	##### Creating a user directory  Create a user directory to authenticate users with StartTLS over LDAP. Note that to authenticate users over LDAP, [LDAP authentication](/manual/api/reference/authentication/object#authentication-object) must be enabled.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "userdirectory.create",     "params": {         "idp_type": "1",         "name": "LDAP API server #1",         "host": "ldap://local.ldap",         "port": "389",         "base_dn": "ou=Users,dc=example,dc=org",         "bind_dn": "cn=ldap_search,dc=example,dc=org",         "bind_password": "ldapsecretpassword",         "search_attribute": "uid",         "start_tls": "1"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "userdirectoryids": [             "3"         ]     },     "id": 1 } ```
ca	##### Crear un directori d'usuari  Crea un directori d'usuari per autenticar usuaris amb StartTLS sobre LDAP. Veieu que per autenticar els usuaris sobre LDAP, s'ha d'activar l'[autenticació LDAP](/manual/api/reference/authentication/object#authentication-object).  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "userdirectory.create",     "params": {         "idp_type": "1",         "name": "LDAP API server #1",         "host": "ldap://local.ldap",         "port": "389",         "base_dn": "ou=Users,dc=example,dc=org",         "bind_dn": "cn=ldap_search,dc=example,dc=org",         "bind_password": "ldapsecretpassword",         "search_attribute": "uid",         "start_tls": "1"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "userdirectoryids": [             "3"         ]     },     "id": 1 } ```

en-us	##### Creating a user directory (JIT provisioning enabled)  Create a user directory to authenticate users over LDAP (with JIT provisioning enabled). Note that to authenticate users over LDAP, [LDAP authentication](/manual/api/reference/authentication/object#authentication-object) must be enabled.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "userdirectory.create",     "params": {             "idp_type": "1",             "name": "AD server",             "provision_status": "1",             "description": "",             "host": "host.example.com",             "port": "389",             "base_dn": "DC=zbx,DC=local",             "search_attribute": "sAMAccountName",             "bind_dn": "CN=Admin,OU=Users,OU=Zabbix,DC=zbx,DC=local",             "start_tls": "0",             "search_filter": "",             "group_basedn": "OU=Zabbix,DC=zbx,DC=local",             "group_name": "CN",             "group_member": "member",             "group_filter": "(%{groupattr}=CN=%{ref},OU=Users,OU=Zabbix,DC=zbx,DC=local)",             "group_membership": "",             "user_username": "givenName",             "user_lastname": "sn",             "user_ref_attr": "CN",             "provision_media": [                 {                     "name": "example.com",                     "mediatypeid": "1",                     "attribute": "user@example.com"                 }             ],             "provision_groups": [                 {                     "name": "*",                     "roleid": "4",                     "user_groups": [                         {                             "usrgrpid": "8"                         }                     ]                 },                 {                     "name": "Zabbix administrators",                     "roleid": "2",                     "user_groups": [                         {                             "usrgrpid": "7"                         },                         {                             "usrgrpid": "8"                         }                     ]                 }             ]         },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "userdirectoryids": [             "2"         ]     },     "id": 1 } ```
ca	##### Crear un directori d'usuari (amb aprovisionament JIT activat)  Crea un directori d'usuari per autenticar usuaris sobre LDAP (amb aprovisionament JIT actiu). Veieu que per autenticar els usuaris amb LDAP, s'ha d'hactivar l'[autenticació LDAP](/manual/api/reference/authentication/object#authentication-object).  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "userdirectory.create",     "params": {             "idp_type": "1",             "name": "AD server",             "provision_status": "1",             "description": "",             "host": "equip.exemple.cat",             "port": "389",             "base_dn": "DC=zbx,DC=local",             "search_attribute": "sAMAccountName",             "bind_dn": "CN=Admin,OU=Users,OU=Zabbix,DC=zbx,DC=local",             "start_tls": "0",             "search_filter": "",             "group_basedn": "OU=Zabbix,DC=zbx,DC=local",             "group_name": "CN",             "group_member": "member",             "group_filter": "(%{groupattr}=CN=%{ref},OU=Users,OU=Zabbix,DC=zbx,DC=local)",             "group_membership": "",             "user_username": "givenName",             "user_lastname": "sn",             "user_ref_attr": "CN",             "provision_media": [                 {                     "name": "exemple.cat",                     "mediatypeid": "1",                     "attribute": "usuari@exemple.cat"                 }             ],             "provision_groups": [                 {                     "name": "*",                     "roleid": "4",                     "user_groups": [                         {                             "usrgrpid": "8"                         }                     ]                 },                 {                     "name": "Administradors de Zabbix",                     "roleid": "2",                     "user_groups": [                         {                             "usrgrpid": "7"                         },                         {                             "usrgrpid": "8"                         }                     ]                 }             ]         },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "userdirectoryids": [             "2"         ]     },     "id": 1 } ```

en-us	#### Creating a user group  Create a user group *Operation managers* with denied access to host group "2", and add a user to it.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "usergroup.create",     "params": {         "name": "Operation managers",         "hostgroup_rights": {             "id": "2",             "permission": 0         },         "users": [             {                 "userid": "12"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "usrgrpids": [             "20"         ]     },     "id": 1 } ```
ca	#### Crear un grup d'usuaris  Crea un grup d'usuaris que no permeti pas l'accés al grup d'equips "2", i hi afegeix un usuari.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "usergroup.create",     "params": {         "name": "Operation managers",         "rights": {             "permission": 0,             "id": "2"         },         "users": [             {"userid": "12"}         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "usrgrpids": [             "20"         ]     },     "id": 1 } ```

en-us	#### Creating a value map  Create one value map with two mappings.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "valuemap.create",     "params": {         "hostid": "50009",         "name": "Service state",         "mappings": [             {                 "type": "1",                 "value": "1",                 "newvalue": "Up"             },             {                 "type": "5",                 "newvalue": "Down"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "valuemapids": [             "1"         ]     },     "id": 1 } ```
ca	#### Crear un mapa de valors  Crea un mapa de valors amb dues correspondències.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "valuemap.create",     "params": {         "hostid": "50009",         "name": "Service state",         "mappings": [             {                 "type": "1",                 "value": "1",                 "newvalue": "Up"             },             {                 "type": "5",                 "newvalue": "Down"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "valuemapids": [             "1"         ]     },     "id": 1 } ```

en-us	#### Creating a webhook media type  Create a new webhook media type.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "mediatype.create",     "params": {         "type": "4",         "name": "Webhook",         "script": "var Webhook = {\r\n    token: null,\r\n    to: null,\r\n    subject: null,\r\n    message: null,\r\n\r\n    sendMessage: function() {\r\n        // some logic\r\n    }\r\n}",         "parameters": [             {                 "name": "Message",                 "value": "{ALERT.MESSAGE}"             },             {                 "name": "Subject",                 "value": "{ALERT.SUBJECT}"             },             {                 "name": "To",                 "value": "{ALERT.SENDTO}"             },             {                 "name": "Token",                 "value": "<Token>"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "mediatypeids": [             "9"         ]     },     "id": 1 } ```
ca	#### Crear un nou tipus de suport webhook  Crear un nou tipus de suport webhook.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "mediatype.create",     "params": {         "type": "4",         "name": "Webhook",         "script": "var Webhook = {\r\n    token: null,\r\n    to: null,\r\n    subject: null,\r\n    message: null,\r\n\r\n    sendMessage: function() {\r\n        // some logic\r\n    }\r\n}",         "parameters": [             {                 "name": "Message",                 "value": "{ALERT.MESSAGE}"             },             {                 "name": "Subject",                 "value": "{ALERT.SUBJECT}"             },             {                 "name": "To",                 "value": "{ALERT.SENDTO}"             },             {                 "name": "Token",                 "value": "<Token>"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "mediatypeids": [             "9"         ]     },     "id": 1 } ```

en-us	#### Creating a web scenario  Create a web scenario to monitor the company home page. The scenario will have two steps, to check the home page and the "About" page and make sure they return the HTTP status code 200.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "httptest.create",     "params": {         "name": "Homepage check",         "hostid": "10085",         "steps": [             {                 "name": "Homepage",                 "url": "http://example.com",                 "status_codes": "200",                 "no": 1             },             {                 "name": "Homepage / About",                 "url": "http://example.com/about",                 "status_codes": "200",                 "no": 2             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "httptestids": [             "5"         ]     },     "id": 1 } ```
ca	#### Crear un escenari Web  Crea un escenari Web monitorar la pàgina d'inici d'una empresa. L'escenari constarà de dues passes: verificar la pàgina d'inici i la pàgina "Quant a", i garantirà que reenvien el codi d'estat HTTP 200.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "httptest.create",     "params": {         "name": "Homepage check",         "hostid": "10085",         "steps": [             {                 "name": "Homepage",                 "url": "http://example.com",                 "status_codes": "200",                 "no": 1             },             {                 "name": "Homepage / Quant a",                 "url": "http://example.com/quanta",                 "status_codes": "200",                 "no": 2             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "httptestids": [             "5"         ]     },     "id": 1 } ```

en-us	### Creating custom LLD rules  It is also possible to create a completely custom LLD rule, discovering any type of entities - for example, databases on a database server.  To do so, a custom item should be created that returns JSON, specifying found objects and optionally - some properties of them. The amount of macros per entity is not limited - while the built-in discovery rules return either one or two macros (for example, two for filesystem discovery), it is possible to return more.  The required JSON format is best illustrated with an example. Suppose we are running an old Zabbix 1.8 agent (one that does not support "vfs.fs.discovery"), but we still need to discover file systems. Here is a simple Perl script for Linux that discovers mounted file systems and outputs JSON, which includes both file system name and type. One way to use it would be as a UserParameter with key "vfs.fs.discovery\_perl":  ``` {.perl} #!/usr/bin/perl  $first = 1;  print "[\n";  for (`cat /proc/mounts`) {     ($fsname, $fstype) = m/\S+ (\S+) (\S+)/;      print "\t,\n" if not $first;     $first = 0;      print "\t{\n";     print "\t\t\"{#FSNAME}\":\"$fsname\",\n";     print "\t\t\"{#FSTYPE}\":\"$fstype\"\n";     print "\t}\n"; }  print "]\n"; ```  ::: noteimportant Allowed symbols for LLD macro names are **0-9** , **A-Z** , **\_** , **.**\ \ Lowercase letters are not supported in the names. :::  An example of its output (reformatted for clarity) is shown below. JSON for custom discovery checks has to follow the same format.  ``` {.javascript} [     { "{#FSNAME}":"/",                           "{#FSTYPE}":"rootfs"   },     { "{#FSNAME}":"/sys",                        "{#FSTYPE}":"sysfs"    },     { "{#FSNAME}":"/proc",                       "{#FSTYPE}":"proc"     },     { "{#FSNAME}":"/dev",                        "{#FSTYPE}":"devtmpfs" },     { "{#FSNAME}":"/dev/pts",                    "{#FSTYPE}":"devpts"   },     { "{#FSNAME}":"/lib/init/rw",                "{#FSTYPE}":"tmpfs"    },     { "{#FSNAME}":"/dev/shm",                    "{#FSTYPE}":"tmpfs"    },     { "{#FSNAME}":"/home",                       "{#FSTYPE}":"ext3"     },     { "{#FSNAME}":"/tmp",                        "{#FSTYPE}":"ext3"     },     { "{#FSNAME}":"/usr",                        "{#FSTYPE}":"ext3"     },     { "{#FSNAME}":"/var",                        "{#FSTYPE}":"ext3"     },     { "{#FSNAME}":"/sys/fs/fuse/connections",    "{#FSTYPE}":"fusectl"  } ] ```  In previous example it is required that the keys match the LLD macro names used in prototypes, the alternative is to extract LLD macro values using JSONPath `{#FSNAME}` → `$.fsname` and `{#FSTYPE}` → `$.fstype`, thus making such script possible:  ``` {.perl} #!/usr/bin/perl   $first = 1;   print "[\n";   for (`cat /proc/mounts`) {     ($fsname, $fstype) = m/\S+ (\S+) (\S+)/;       print "\t,\n" if not $first;     $first = 0;       print "\t{\n";     print "\t\t\"fsname\":\"$fsname\",\n";     print "\t\t\"fstype\":\"$fstype\"\n";     print "\t}\n"; }   print "]\n"; ```  An example of its output (reformatted for clarity) is shown below. JSON for custom discovery checks has to follow the same format.  ``` {.javascript} [     { "fsname":"/",                           "fstype":"rootfs"   },     { "fsname":"/sys",                        "fstype":"sysfs"    },     { "fsname":"/proc",                       "fstype":"proc"     },     { "fsname":"/dev",                        "fstype":"devtmpfs" },     { "fsname":"/dev/pts",                    "fstype":"devpts"   },     { "fsname":"/lib/init/rw",                "fstype":"tmpfs"    },     { "fsname":"/dev/shm",                    "fstype":"tmpfs"    },     { "fsname":"/home",                       "fstype":"ext3"     },     { "fsname":"/tmp",                        "fstype":"ext3"     },     { "fsname":"/usr",                        "fstype":"ext3"     },     { "fsname":"/var",                        "fstype":"ext3"     },     { "fsname":"/sys/fs/fuse/connections",    "fstype":"fusectl"  } ] ```  Then, in the discovery rule's "Filter" field, we could specify "{\#FSTYPE}" as a macro and "rootfs|ext3" as a regular expression.  ::: noteclassic You don't have to use macro names FSNAME/FSTYPE with custom LLD rules, you are free to use whatever names you like. In case JSONPath is used then LLD row will be an array element that can be an object, but it can be also another array or a value.  :::  Note that, if using a user parameter, the return value is limited to 16MB. For more details, see [data limits for LLD return values](/manual/discovery/low_level_discovery/notes#data-limits-for-return-values).
ca	### Creació de regles LLD personalitzades  També és possible crear una regla LLD completament personalitzada, descobrint qualsevol tipus d'entitats, per exemple, bases de dades en un servidor de bases de dades.  Per fer-ho, s'ha de crear un element personalitzat que retorni JSON, especificant els objectes trobats i, opcionalment, algunes de les seves propietats. El nombre de macros per entitat no és limitat; encara que les regles de descoberta integrades retornen una o dues macros (per exemple, dues per a la descoberta del sistema de fitxers), és possible tornar-ne més.  El format JSON requerit s'il·lustra millor amb un exemple. Suposem que som executant un antic agent Zabbix 1.8 (que no admet "vfs.fs.discovery"), però encara hem de descobrir sistemes de fitxers. Aquí hi ha un senzill script Perl per a Linux que descobreix sistemes de fitxers muntats i genera un JSON, que inclou tant el nom com el tipus del sistema de fitxers. Una manera d'emprar-lo seria com a UserParameter amb la clau "vfs.fs.discovery\_perl":  ``` {.perl} #!/usr/bin/perl  $first = 1;  print "[\n";  for (`cat /proc/mounts`) {     ($fsname, $fstype) = m/\S+ (\S+) (\S+)/;      print "\t,\n" if not $first;     $first = 0;      print "\t{\n";     print "\t\t\"{#FSNAME}\":\"$fsname\",\n";     print "\t\t\"{#FSTYPE}\":\"$fstype\"\n";     print "\t}\n"; }  print "]\n"; ```  ::: noteimportant Els símbols permesos com a noms de macro LLD són **0-9** , **A-Z** , **\_** , **.**\ \ Les lletres minúscules no s'admeten als noms. :::  A continuació es mostra un exemple de la seva sortida (reformatat per a més claredat). El JSON per a comprovacions de descoberta personalitzades hauria de seguir el mateix format.  ``` {.javascript} [     { "{#FSNAME}":"/",                           "{#FSTYPE}":"rootfs"   },     { "{#FSNAME}":"/sys",                        "{#FSTYPE}":"sysfs"    },     { "{#FSNAME}":"/proc",                       "{#FSTYPE}":"proc"     },     { "{#FSNAME}":"/dev",                        "{#FSTYPE}":"devtmpfs" },     { "{#FSNAME}":"/dev/pts",                    "{#FSTYPE}":"devpts"   },     { "{#FSNAME}":"/lib/init/rw",                "{#FSTYPE}":"tmpfs"    },     { "{#FSNAME}":"/dev/shm",                    "{#FSTYPE}":"tmpfs"    },     { "{#FSNAME}":"/home",                       "{#FSTYPE}":"ext3"     },     { "{#FSNAME}":"/tmp",                        "{#FSTYPE}":"ext3"     },     { "{#FSNAME}":"/usr",                        "{#FSTYPE}":"ext3"     },     { "{#FSNAME}":"/var",                        "{#FSTYPE}":"ext3"     },     { "{#FSNAME}":"/sys/fs/fuse/connections",    "{#FSTYPE}":"fusectl"  } ] ```  A l'exemple anterior, les claus han de coincidir amb els noms de macro LLD emprats als prototips, l'alternativa és extreure els valors de macro LLD mitjançant JSONPath `{#FSNAME}` → `$.fsname` i `{#FSTYPE} ` → `$.fstype` d'aquesta manera, fent possible aquest script:  ``` {.perl} #!/usr/bin/perl   $first = 1;   print "[\n";   for (`cat /proc/mounts`) {     ($fsname, $fstype) = m/\S+ (\S+) (\S+)/;       print "\t,\n" if not $first;     $first = 0;       print "\t{\n";     print "\t\t\"fsname\":\"$fsname\",\n";     print "\t\t\"fstype\":\"$fstype\"\n";     print "\t}\n"; }   print "]\n"; ```  A continuació es mostra un exemple de la seva sortida (reformatat per a més claredat). El JSON per a comprovacions de descoberta personalitzades hauria de seguir el mateix format.  ``` {.javascript} [     { "fsname":"/",                           "fstype":"rootfs"   },     { "fsname":"/sys",                        "fstype":"sysfs"    },     { "fsname":"/proc",                       "fstype":"proc"     },     { "fsname":"/dev",                        "fstype":"devtmpfs" },     { "fsname":"/dev/pts",                    "fstype":"devpts"   },     { "fsname":"/lib/init/rw",                "fstype":"tmpfs"    },     { "fsname":"/dev/shm",                    "fstype":"tmpfs"    },     { "fsname":"/home",                       "fstype":"ext3"     },     { "fsname":"/tmp",                        "fstype":"ext3"     },     { "fsname":"/usr",                        "fstype":"ext3"     },     { "fsname":"/var",                        "fstype":"ext3"     },     { "fsname":"/sys/fs/fuse/connections",    "fstype":"fusectl"  } ] ```  Aleshores, al camp "Filtre" de la regla de descoberta, podríem especificar "{\#FSTYPE}" com a macro i "rootfs|ext3" com a expressió regular.  :::noteclassic No cal que empreu els noms de macro FSNAME/FSTYPE amb regles LLD personalitzades, podeu emprar els noms que vulgueu. En cas que s'empri JSONPath, la línia LLD serà un element de matriu que pot ésser un objecte, però també pot ésser una altra matriu o un valor. :::  Tingueu en compte que si feu servir un paràmetre d'usuari, el valor de retorn és limitat a 16Mo. Per obtindre més informació, consulteu els [límits de dades per als valors de retorn d'LLD](/manual/discovery/low_level_discovery/notes#data_limits_for_return_values).

en-us	##### Creating database  [Create](/manual/appendix/install/db_scripts) a separate database for Zabbix proxy.  Zabbix server and Zabbix proxy cannot use the same database. If they are installed on the same host, the proxy database must have a different name.
ca	##### Creació de bases de dades  [Creeu](/manual/appendix/install/db_scripts) una base de dades diferent per al proxy Zabbix.  El servidor Zabbix i el proxy Zabbix no poden emprar la mateixa base de dades. Si són instal·lats al mateix equip, la base de dades proxy ha de tindre un nom diferent.

en-us	##### Creating database  [Create](/manual/appendix/install/db_scripts) a separate database for Zabbix proxy.  Zabbix server and Zabbix proxy cannot use the same database. If they are installed on the same host, the proxy database must have a different name.
ca	##### Creació de bases de dades  [Creeu](/manual/appendix/install/db_scripts) una base de dades diferent per al proxy Zabbix.  El servidor Zabbix i el proxy Zabbix no poden emprar la mateixa base de dades. Si són instal·lats al mateix equip, la base de dades proxy ha de tindre un nom diferent.

en-us	#### Creating database  Zabbix [server](/manual/concepts/server) and [proxy](/manual/concepts/proxy) daemons require a database. Zabbix [agent](/manual/concepts/agent) does not need a database.  To create a database, follow the instructions for [MySQL](/manual/appendix/install/db_scripts#mysql) or [PostgreSQL](/manual/appendix/install/db_scripts#postgresql). An SQLite3 database (supported for Zabbix proxy only) will be created automatically and does not require additional installation steps.  ::: notewarning Separate databases are required for Zabbix server and Zabbix proxy; they cannot share the same database. If a server and a proxy are installed on the same host, their databases must be created with different names! :::
ca	#### Creació de base de dades  Els dimonis de Zabbix [servidor](/manual/concepts/server) i [proxy](/manual/concepts/proxy) requereixen una base de dades. L'[agent](/manual/concepts/agent) Zabbix no ha de menester cap base de dades.  Per crear una base de dades, seguiu les instruccions per a [MySQL](/manual/appendix/install/db_scripts#mysql) o [PostgreSQL](/manual/appendix/install/db_scripts#postgresql). Una base de dades SQLite3 (només compatible amb el proxy Zabbix) es crearà automàticament i no requereix passes addicionals d'instal·lació.  ::: notewarning Calen bases de dades separades per al servidor Zabbix i el proxy Zabbix; no poden emprar la mateixa base de dades. Per tant, si són instal·lats al mateix equip, les seves bases de dades s'han de crear amb noms diferents! :::

en-us	#### Creating dependent item  Create a dependent item for the master item with ID 24759. Only dependencies on the same host are allowed, therefore master and the dependent item should have the same hostid.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {       "hostid": "30074",       "name": "Dependent test item",       "key_": "dependent.item",       "type": 18,       "master_itemid": "24759",       "value_type": 2     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```
ca	#### Crear un element dependent  Crea un element dependent per l'element principal amb ID 24759. Només es permeten les dependències sobre el mateix equip. Per tant, l'element principal i l'element dependent hauran de tindre el mateix hostid.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {       "hostid": "30074",       "name": "Dependent test item",       "key_": "dependent.item",       "type": 18,       "master_itemid": "24759",       "value_type": 2     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```

en-us	#### Creating dependent item prototype  Create Dependent item prototype for Master item prototype with ID 44211. Only dependencies on same host (template/discovery rule) are allowed, therefore Master and Dependent item should have same hostid and ruleid.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {       "hostid": "10001",       "ruleid": "27665",       "name": "Dependent test item prototype",       "key_": "dependent.prototype",       "type": 18,       "master_itemid": "44211",       "value_type": 3     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44212"         ]     },     "id": 1 } ```
ca	#### Crear un prototipus d'element dependent  Crea un prototipus d'element dependent pel prototipus d'element principal amb l'ID 44211. Només són permeses les dependències del mateix equip (plantilla / regla de descoberta). Per tant, l'element principal i el dependent hauran de tindre els mateixos ID d'equip i de regla.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {       "hostid": "10001",       "ruleid": "27665",       "name": "Dependent test item prototype",       "key_": "dependent.prototype",       "type": 18,       "master_itemid": "44211",       "value_type": 3     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44212"         ]     },     "id": 1 } ```

en-us	#### Creating interfaces  Create an interface on two hosts.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostinterface.massadd",     "params": {         "hosts": [             {                 "hostid": "30050"             },             {                 "hostid": "30052"             }         ],         "interfaces": {             "dns": "",             "ip": "127.0.0.1",             "main": 0,             "port": "10050",             "type": 1,             "useip": 1         }     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "interfaceids": [             "30069",             "30070"         ]     },     "id": 1 } ```
ca	#### Crear interfície  Crear una interfície a dos equips.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostinterface.massadd",     "params": {         "hosts": [             {                 "hostid": "30050"             },             {                 "hostid": "30052"             }         ],         "interfaces": {             "dns": "",             "ip": "127.0.0.1",             "main": 0,             "port": "10050",             "type": 1,             "useip": 1         }     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "interfaceids": [             "30069",             "30070"         ]     },     "id": 1 } ```

en-us	#### Creating multiple triggers  Thus, if *create methods* accept arrays, you can add multiple [triggers](/manual/api/reference/trigger/object), for example, this one:   ```bash curl --request POST \   --url 'https://example.com/zabbix/api_jsonrpc.php' \   --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \   --header 'Content-Type: application/json-rpc' \   --data '{"jsonrpc":"2.0","method":"trigger.create","params":[{"description":"Processor load is too high on {HOST.NAME}","expression":"last(/Linux server/system.cpu.load[percpu,avg1])>5",},{"description":"Too many processes on {HOST.NAME}","expression":"avg(/Linux server/proc.num[],5m)>300",}],"id":4}' ```  The successful response will contain the IDs of the newly created triggers:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "17369",             "17370"         ]     },     "id": 4 } ```
ca	#### Crear múltiples triggers  Si els *mètodes de creació* admeten matrius, podem afegir diversos [triggers](/manual/api/reference/trigger/object), com ara:  ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"trigger.create","params":[{"description":"Processor load is too high on {HOST.NAME}","expression":"last(/Linux server/system.cpu.load[percpu,avg1])>5",},{"description":"Too many processes on {HOST.NAME}","expression":"avg(/Linux server/proc.num[],5m)>300",}],"id":4}' ```  Una resposta correcta contindrà els IDs dels triggers acabats de crear:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "17369",             "17370"         ]     },     "id": 4 } ```

en-us	##### - Credentials (login:password)  System:  -   root:zabbix  Zabbix frontend:  -   Admin:zabbix  Database:  -   root:<random> -   zabbix:<random>  ::: noteclassic Database passwords are randomly generated during the installation process.\ Root password is stored inside the /root/.my.cnf file. It is not required to input a password under the "root" account. :::  To change the database user password, changes have to be made in the following locations:  -   MySQL; -   /etc/zabbix/zabbix\_server.conf; -   /etc/zabbix/web/zabbix.conf.php.  ::: noteclassic  Separate users `zabbix_srv` and `zabbix_web` are defined for the server and the frontend respectively.  :::
ca	##### - Credencials (login:password)  Sistema:  -   root:zabbix  Interfície Web Zabbix:  -   Admin:zabbix  Base de dades:  -   root:<random> -   zabbix:<random>  ::: noteclassic Els mots de pas de la base de dades es generen de manera aleatòria durant el procés d'instal·lació.\ El mot de pas root s'emmagatzema a l'arxiu /root/.my.cnf. No al pas inserir u mot de pas al compte "root". :::  Per modificar el mot de pas de l'usuari de la base de dades, heu de modificar-ho als següents llocs:  -   MySQL; -   /etc/zabbix/zabbix\_server.conf; -   /etc/zabbix/web/zabbix.conf.php.  ::: noteclassic  Els usuaris `zabbix_srv` i `zabbix_web` són per al servidor i la interfície Web, respectivament. :::

en-us	#### CRL expired or expires during server operation  [*OpenSSL*]{.underline}, in server log:  -   before expiration:  ```{=html} <!-- --> ```     cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\         SSL_connect() returned SSL_ERROR_SSL: file s3_clnt.c line 1253: error:14090086:\         SSL routines:ssl3_get_server_certificate:certificate verify failed:\         TLS write fatal alert "certificate revoked"  -   after expiration:  ```{=html} <!-- --> ```     cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\         SSL_connect() returned SSL_ERROR_SSL: file s3_clnt.c line 1253: error:14090086:\         SSL routines:ssl3_get_server_certificate:certificate verify failed:\         TLS write fatal alert "certificate expired"  The point here is that with valid CRL a revoked certificate is reported as "certificate revoked". When CRL expires the error message changes to "certificate expired" which is quite misleading.  [*GnuTLS*]{.underline}, in server log:  -   before and after expiration the same:  ```{=html} <!-- --> ```     cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\           invalid peer certificate: The certificate is NOT trusted. The certificate chain is revoked.
ca	#### CRL caducada o caducarà durant el funcionament del servidor  [*OpenSSL*]{.underline}, al registre del servidor:  -   abans de caducar:  ```{=html} <!-- --> ```     cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\         SSL_connect() returned SSL_ERROR_SSL: file s3_clnt.c line 1253: error:14090086:\         SSL routines:ssl3_get_server_certificate:certificate verify failed:\         TLS write fatal alert "certificate revoked"  -   després de caducar:  ```{=html} <!-- --> ```     cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\         SSL_connect() returned SSL_ERROR_SSL: file s3_clnt.c line 1253: error:14090086:\         SSL routines:ssl3_get_server_certificate:certificate verify failed:\         TLS write fatal alert "certificate expired"  Cal apuntar que amb una CRL vàlida, un certificat revocat és marcat com a "certificat revocat". Quan la CRL caduqui, el missatge d'error esdevé "certificat caducat", que és força enganyós.  [*GnuTLS*]{.underline}, al registre del servidor:  -   abans i després de caducar:  ```{=html} <!-- --> ```     cannot connect to proxy "proxy-openssl-1.0.1e": TCP successful, cannot establish TLS to [[127.0.0.1]:20004]:\           invalid peer certificate: The certificate is NOT trusted. The certificate chain is revoked.

en-us	### Cryptography
ca	### Criptografia

en-us	 #### CSRF tokens  For enhanced security against CSRF (Cross Site Request Forgery) attacks, Zabbix frontend now uses randomly generated CSRF tokens instead of static session-based tokens.
ca	 #### Tokens CSRF  Per millorar la seguretat contra els atacs CSRF (Cross Site Request Forgery), la interfície de Zabbix ara fa servir fitxes CSRF generades aleatòriament en lloc de fitxes estàtiques basades en sessions.

en-us	#### CSRF tokens   For enhanced security against CSRF (Cross Site Request Forgery) attacks,  Zabbix frontend now uses randomly generated CSRF tokens instead of static session-based tokens. If your installation uses an IDS/IPS that checks for specific token names, it may be necessary to update its configuration to recognize the new token name,  `_csrf_token`, in order to avoid false positive detections.
ca	##### Tokens CSRF   Per millorar la seguretat contra els atacs CSRF (Cross Site Request Forgery), la interfície de Zabbix ara fa servir fitxes CSRF generades aleatòriament en lloc de fitxes estàtiques basades en sessions. Si la vostra instal·lació empra un IDS/IPS que comprova noms de tokens específics, pot ser que sigui necessari actualitzar la seva configuració per reconèixer el nou nom de token, `_csrf_token`, per tal d'evitar deteccions de falsos positius.

en-us	 ##### CSS styles  CSS files may contain a custom attribute `theme` to define different style for a specific frontend themes.  Available themes and their attribute values:  -   **Blue** - [theme='blue-theme'] -   **Dark** - [theme='dark-theme'] -   **High-contrast light** - [theme='hc-light'] -   **High-contrast dark** - [theme='hc-dark']  Example:  ```css .widget {     background-color: red; }   [theme='dark-theme'] .widget {     background-color: green; } ```
ca	##### estils CSS  Els fitxers CSS poden contindre un atribut personalitzat "tema" per definir un estil diferent per a temes d'interfície específics.  Els temes disponibles i els seus valors d'atributs són:  -   **Blau** - [theme='blue-theme'] -   **Fosc** - [theme='dark-theme'] -   **Lluminós d'alt contrast** - [theme='hc-light'] -   **Fosc d'alt contrast** - [theme='hc-dark']  Exemple:  ```css .widget {     background-color: red; }   [theme='dark-theme'] .widget {     background-color: green; } ```

en-us	##### Custom copyright notice  To set a custom copyright notice, add `BRAND_FOOTER` to the array from the first listing. Please be aware that HTML is not supported here. Setting `BRAND_FOOTER` to an empty string will hide the copyright notice completely (but the footer will stay in place).  ```php 'BRAND_FOOTER' => '{text}', ```
ca	##### Copyright a mida  Per establir un avís de drets d'autor personalitzat, afegiu `BRAND_FOOTER' a la matriu de la primera llista. Tingueu en compte que aquí no s'admet HTML. Si establiu `BRAND_FOOTER` a una cadena buida, s'amagarà completament l'avís de drets d'autor (però el peu de pàgina es mantindrà al seu lloc).  ```php 'BRAND_FOOTER' => '{text}', ```

en-us	##### Custom help location  To replace the default *Help* link with a link of your choice, add `BRAND_HELP_URL` to the array from the first listing.  ```php 'BRAND_HELP_URL' => '{URL}' ```
ca	##### Ubicació personalitzada de l'ajuda  Per canviar l'enllaç per defecte de l'*Ajuda* amb un enllaç personalitzat, afegiu `BRAND_HELP_URL` a la taula de la primera llista.  ```php 'BRAND_HELP_URL' => '{URL}' ```

en-us	### Custom interface  Custom interfaces are supported if `custom_interfaces` of [Host prototype object](#host-prototype) is set to "use host prototypes custom interfaces". The custom interface object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |type|integer|Interface type.<br><br>Possible values:<br>1 - Agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |useip|integer|Whether the connection should be made via IP.<br><br>Possible values:<br>0 - connect using host DNS name;<br>1 - connect using host IP address.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |ip|string|IP address used by the interface.<br>Can contain macros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `useip` is set to "connect using host IP address"| |dns|string|DNS name used by the interface.<br>Can contain macros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `useip` is set to "connect using host DNS name"| |port|string|Port number used by the interface.<br>Can contain user and LLD macros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |main|integer|Whether the interface is used as default on the host.<br>Only one interface of some type can be set as default on a host.<br><br>Possible values:<br>0 - not default;<br>1 - default.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |details|array|Additional object for interface.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SNMP"|
ca	### Interfície personalitzada  Les interfícies personalitzades s'admeten si `custom_interfaces` de l'[objecte de prototip d'equip](#host-prototype) s'estableix per "emprar interfícies personalitzades de prototipus d'equips".  L'objecte d'interfície personalitzada té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |tipus|enter|Tipus d'interfície.<br><br>Els valors possibles són:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI ;<br>4 - JMX.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |useip|enter|Indica si la connexió s'ha d'establir mitjançant IP.<br><br>Els valors possibles són:<br>0 - connecteu-vos amb el nom DNS de l'equip;<br>1 - connecteu-vos mitjançant l'adreça IP de l'equip per a aquesta interfície d'equip.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |ip|cadena|adreça IP emprada per la interfície.<br>Pot contindre macros.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `useip` s'ha definit com a "connectar emprant adreça IP de l'equip"| |dns|cadena|Nom DNS emprat per la interfície.<br><br>Pot contindre macros.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `useip` s'ha definit com a "connectar emprant nom DNS de l'equip"| |port|cadena|Nombre de port emprat per la interfície.<br>Pot contindre macros d'usuari i LLD.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |main|enter|Indica si la interfície s'empra per defecte a l'equip.<br>Només es pot establir una interfície d'un determinat tipus com a predeterminada en un equip.<br><br>Els valors possibles són:<br>0 - no per defecte;<br>1 - per defecte.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |details|array|Objecte addicional per a la interfície.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `tipus` s'ha establert a "SNMP"|

en-us	### Custom interface details  The details object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |version|integer|SNMP interface version.<br><br>Possible values:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values:<br>0 - don't use bulk requests;<br>1 - *(default)* - use bulk requests.| |community|string|SNMP community.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `version` is set to "SNMPv1" or "SNMPv2c"| |max_repetitions|integer|Max repetition value for [native SNMP bulk requests](#native-snmp-bulk-requests) (GetBulkRequest-PDUs).<br>Used only for `discovery[]` and `walk[]` items in SNMPv2 and v3.<br><br>Default: 10.| |securityname|string|SNMPv3 security name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3"| |securitylevel|integer|SNMPv3 security level.<br><br>Possible values:<br>0 - *(default)* - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3"| |authpassphrase|string|SNMPv3 authentication passphrase.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3" and `securitylevel` is set to "authNoPriv" or "authPriv"| |privpassphrase|string|SNMPv3 privacy passphrase.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3" and `securitylevel` is set to "authPriv"| |authprotocol|integer|SNMPv3 authentication protocol.<br><br>Possible values:<br>0 - *(default)* - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3" and `securitylevel` is set to "authNoPriv" or "authPriv"| |privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values:<br>0 - *(default)* - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3" and `securitylevel` is set to "authPriv"| |contextname|string|SNMPv3 context name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `version` is set to "SNMPv3"|
ca	### Detalls de la interfície personalitzada  L'objecte de detalls té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |version|enter|Versió de la interfície SNMP.<br><br>Els valors possibles són:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br> 3 - SNMPv3.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |bulk|enter|Indica si s'han d'emprar consultes SNMP massives.<br><br>Els valors possibles són:<br>0 - no empreu consultes massives;<br>1 - *(per defecte )* - empreu sol·licituds massives.| |community|cadena|Comunitat SNMP.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `version` s'ha establert a "SNMPv1" o "SNMPv2c"| |max_repetitions|enter|Valor de repetició màxima per [peticions massives d'SNMP nadiues](#native-snmp-bulk-requests) (GetBulkRequest-PDUs).<br>Emprat només per els elements `discovery[]` i `walk[]` a SNMPv2 i v3.<br><br>Per defecte: 10.| |securityname|cadena|Nom de seguretat SNMPv3.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `version` s'ha establert a "SNMPv3"| |securitylevel|enter|Nivell de seguretat SNMPv3.<br><br>Els valors possibles són:<br>0 - *(per defecte)* - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `version` s'ha establert a "SNMPv3"| |authpassphrase|string|Mot de pas d'autenticació SNMPv3.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `version` s'ha establert a "SNMPv3" i `securitylevel` s'ha fixat a "authNoPriv" o "authPriv"| |privpassphrase|string|Frase de pas de privadesa SNMPv3.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `version` s'ha establert a "SNMPv3" i `securitylevel` s'ha fixat a "authPriv"| |authprotocol|integer|Protocol d'autenticació SNMPv3.<br><br>Els valors possibles són:<br>0 - *(per defecte)* - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `version` s'ha establert a "SNMPv3" i `securitylevel` s'ha fixat a "authNoPriv" o "authPriv"| |privprotocol|integer|Protocol de privadesa SNMPv3.<br><br>Els valors possibles són:<br>0 - *(per defecte)* - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `version` s'ha establert a "SNMPv3" i `securitylevel` s'ha fixat a "authPriv"| |contextname|string|Nom de context SNMPv3.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `version` s'ha establert a "SNMPv3"|

en-us	 **Custom links**  [Host context menu](/manual/web_interface/menu/host_menu) and [event context menu](/manual/web_interface/menu/event_menu) can be customized further by adding custom links. In the *Alerts → [Scripts](/manual/web_interface/frontend_sections/alerts/scripts)* menu section, it is now possible to add a global script of the new type URL. If configured, such links will be visible in the context menu of matching hosts/problem events.
ca	 **Enllaços personalitzats**  El [menú contextual de l'equip](/manual/web_interface/menu/host_menu) i el [menú contextual de l'esdeveniment](/manual/web_interface/menu/event_menu) es poden personalitzar encara més afegint enllaços personalitzats. A la secció de menú *Alertes → [Scripts](/manual/web_interface/frontend_sections/alerts/scripts)*, ara és possible afegir un script global del nou tipus d'URL. Si es configuren, aquests enllaços seran visibles al menú contextual dels equips/esdeveniments problemàtics coincidents.

en-us	##### Custom logo  To use a custom logo, add the following line to the array from the previous listing:  ```php 'BRAND_LOGO' => '{Path to an image on the disk or URL}', ```  Note that the path to the image on the disk should be relative to the Zabbix frontend root directory. So, for example, if the image is located in the same directory as the *brand.conf.php* file, then the path to the image should be: `'./local/conf/custom_logo.png'`.  There are two additional images of the Zabbix logo that can be overridden:  -   `BRAND_LOGO_SIDEBAR` - displayed when the sidebar is expanded; -   `BRAND_LOGO_SIDEBAR_COMPACT` - displayed when the sidebar is collapsed.  To override:  ```php 'BRAND_LOGO_SIDEBAR' => '{Path to an image on the disk or URL}', 'BRAND_LOGO_SIDEBAR_COMPACT' => '{Path to an image on the disk or URL}', ```  Any image format supported by modern browsers can be used: JPG, PNG, SVG, BMP, WebP, and GIF.  ::: noteclassic Custom logos will not be scaled, resized or modified in any other way, and will be displayed in their original size and proportions, except for the `BRAND_LOGO_SIDEBAR_COMPACT` that will be cropped (width: 24px; height: the same as `BRAND_LOGO_SIDEBAR`) to fit the collapsed sidebar. For reference, the following dimensions are used for Zabbix logos:<br><br>  -   `BRAND_LOGO`: 114x30px -   `BRAND_LOGO_SIDEBAR`: 91x24px -   `BRAND_LOGO_SIDEBAR_COMPACT`: 24x24px :::
ca	##### Logotip personalitzat  Per emprar un logotip personalitzat, afegiu la segúent línia a la taula del llistat previ:  ```php 'BRAND_LOGO' => '{Camí a la imatge del disc o URL}', ```  Tingueu en compte que el camí a la imatge del disc hauria de ser relatiu al directori arrel de la interfície de Zabbix. Així, per exemple, si la imatge es troba al mateix directori que el fitxer *brand.conf.php*, el camí a la imatge hauria de ser: `'./local/conf/custom_logo.png'`.  Hi ha dues imatges addicionals del logotip de Zabbix que es poden substituir:  - `BRAND_LOGO_SIDEBAR` - es mostra quan la barra lateral s'amplia; - `BRAND_LOGO_SIDEBAR_COMPACT`: es mostra quan la barra lateral és col·lapsada.  Per anul·lar:  ```php 'BRAND_LOGO_SIDEBAR' => '{Camí a una imatge al disc o URL}', 'BRAND_LOGO_SIDEBAR_COMPACT' => '{Camí a una imatge al disc o URL}', ```  Es pot emprar qualsevol format d'imatge compatible amb els navegadors moderns: JPG, PNG, SVG, BMP, WebP i GIF.  ::: noteclassic Els logotips personalitzats no seran escalats, redimensionats ni modificats de cap altra manera, i es mostraran en la seva mida i proporcions originals; excepte el `BRAND_LOGO_SIDEBAR_COMPACT` que es retallarà (amplada: 24 píxels; alçada: el mateix que `BRAND_LOGO_SIDEBAR`) per adaptar-se a la barra lateral replegada. Com a referència, s'empren les dimensions següents per als logotips de Zabbix:<br><br>  -   `BRAND_LOGO`: 114x30px -   `BRAND_LOGO_SIDEBAR`: 91x24px -   `BRAND_LOGO_SIDEBAR_COMPACT`: 24x24px :::

en-us	#### Custom macros  The **LLD macros** tab allows to specify custom low-level discovery macros.  Custom macros are useful in cases when the returned JSON does not have the required macros already defined. So, for example:  -   The native `vfs.fs.discovery` key for filesystem discovery returns a     JSON with some pre-defined LLD macros such as {\#FSNAME},     {\#FSTYPE}. These macros can be used in item, trigger prototypes     (see subsequent sections of the page) directly; defining custom     macros is not needed; -   The `vfs.fs.get` agent item also returns a JSON with [filesystem     data](/manual/discovery/low_level_discovery/examples/mounted_filesystems),     but without any pre-defined LLD macros. In this case you may define     the macros yourself, and map them to the values in the JSON using     JSONPath:  ![](../../../assets/en/manual/discovery/low_level_discovery/lld_fs_c.png)  The extracted values can be used in discovered items, triggers, etc. Note that values will be extracted from the result of discovery and any preprocessing steps so far.  |Parameter|Description| |--|--------| |*LLD macro*|Name of the low-level discovery macro, using the following syntax: {\#MACRO}.| |*JSONPath*|Path that is used to extract LLD macro value from a LLD row, using JSONPath syntax.<br>For example, `$.foo` will extract "bar" and "baz" from this JSON: `[{"foo":"bar"}, {"foo":"baz"}]`<br>The values extracted from the returned JSON are used to replace the LLD macros in item, trigger, etc. prototype fields.<br>JSONPath can be specified using the dot notation or the bracket notation. Bracket notation should be used in case of any special characters and Unicode, like `$['unicode + special chars #1']['unicode + special chars #2']`.|
ca	#### Macros personalitzades  La pestanya **Macros LLD** us permet especificar macros personalitzades de descoberta de baix nivell.  Les macros personalitzades són útils en els casos en què el JSON retornat no té les macros necessàries ja definides. Així, per exemple:  - La clau nadiua `vfs.fs.discovery` per a la descoberta del sistema de fitxers retorna un JSON amb macros LLD predefinides com {\#FSNAME}, {\#FSTYPE}. Aquestes macros es poden emprar a l'element, activar prototips (vegeu les seccions següents de la pàgina) directament; no cal definir macros personalitzades; - L'element d'agent `vfs.fs.get` també retorna JSON amb [dades del sistema de fitxers](/manual/discovery/low_level_discovery/examples/mounted_filesystems), però sense macros LLD predefinides. En aquest cas, podeu definir les macros vosaltres mateixos i assignar-les als valors JSON mitjançant JSONPath:  ![](../../../assets/en/manual/discovery/low_level_discovery/lld_fs_c.png)  Els valors extrets es poden emprar en elements descoberts, triggers, etc. Tingueu en compte que els valors es prendran del resultat de la descoberta i de totes les passes de preprocessament processades fins ara.  |Paràmetre|Descripció| |--|---------| |*Macro LLD*|Nom de la macro de descoberta de baix nivell, emprant la sintaxi següent: {\#MACRO}.| |*JSONPath*|Camí emprat per extreure el valor de la macro LLD d'una línia LLD, emprant la sintaxi JSONPath.<br>Per exemple, `$.foo` extreu "bar" i "baz" d'aquest JSON: `[{" foo":"bar"}, {"foo":"baz"}]`<br>Els valors extrets del JSON retornat s'empren per substituir les macros LLD al prototip d'element, trigger, etc.<br>Es pot especificar JSONPath emprant la notació de punts o la notació de parèntesis. La notació entre parèntesis s'ha d'emprar en el cas de caràcters especials i Unicode, com ara `$['unicode + caràcters especials #1']['unicode + caràcters especials #2']`.|

en-us	#### Custom script limit  Available custom script length depends on the database used:  |Database|Limit in characters|Limit in bytes| |---|---|---| |*MySQL*|65535|65535| |*PostgreSQL*|65535|not limited| |*Oracle*|2048|4000| |*SQLite (only Zabbix proxy)*|65535|not limited|
ca	#### Límit d'script personalitzat  La longitud disponible d'script personalitzat depèn de la base de dades emprada:  | | | | |---|---|---| |*Base de dades*|*Límit en caràcters*|*Límit en octets*| |*MySQL*|65535|65535| |**PostgreSQL**|65535|no limitat| |*Oracle*|2048|4000| |**SQLite (només proxy Zabbix)**|65535|no limitat|

en-us	##### Custom themes  It is possible to change Zabbix frontend visual appearance by using custom themes. See the [instructions](/manual/web_interface/theming) on creating and applying your own themes.
ca	##### Temes personalitzats  És possible canviar l'aspecte visual de la interfície de Zabbix emprant temes personalitzats. Veieu les [instruccions](/manual/web_interface/theming) per crear i aplicar els vostres propis temes.

en-us	### CWidgetField  Base class, from which all form field classes (CWidgetFieldCheckBox, CWidgetFieldTextArea, CWidgetFieldRadioButtonList, etc.) are inherited.  Classes extending CWidgetField are responsible for receiving, saving, and validating widget configuration values.  The following CWidgetField classes are available:  |CWidgetField class |Database field type |Description | |----|--|------------| |CWidgetFieldCheckBox |int32 |Single checkbox. | |CWidgetFieldCheckBoxList |array of int32 |Multiple checkboxes under a single configuration field. | |CWidgetFieldColor |string |Color selection field. | |CWidgetFieldDatePicker |string |Date selection field. | |CWidgetFieldHostPatternSelect |string |Multiselect field that allows to select one or multiple hosts. Supports defining host name patterns (all matching hosts will be selected). | |CWidgetFieldIntegerBox |int32 |Field to enter an integer. Can be used to configure minimum and maximum values. | |CWidgetFieldLatLng |string |Text box that allows to enter comma-separated latitude, longitude, and map zoom level. | |CWidgetFieldMultiSelectAction |ID |Multiselect field for selecting actions (from the list of actions defined in the *Alerts->Actions*). | |CWidgetFieldMultiSelectGraph |ID |Multiselect field for selecting custom graphs. | |CWidgetFieldMultiSelectGraphPrototype |ID |Multiselect field for selecting custom graph prototypes. | |CWidgetFieldMultiSelectGroup |ID |Multiselect field for selecting host groups. | |CWidgetFieldMultiSelectHost |ID |Multiselect field for selecting hosts. | |CWidgetFieldMultiSelectItem |ID |Multiselect field for selecting items. | |CWidgetFieldMultiSelectItemPrototype |ID |Multiselect field for selecting item prototypes. | |CWidgetFieldMultiSelectMediaType |ID |Multiselect field for selecting media types. | |CWidgetFieldMultiSelectService |ID |Multiselect field for selecting services. | |CWidgetFieldMultiSelectSla |ID |Multiselect field for selecting SLAs. | |CWidgetFieldMultiSelectUser |ID |Multiselect field for selecting users. | |CWidgetFieldNumericBox |string |Field to enter a float number. | |CWidgetFieldRadioButtonList |int32 |Radio box group that consists of one or more radio boxes. | |CWidgetFieldRangeControl |int32 |Slider to select an integer type value. | |CWidgetFieldSelect |int32 |Dropdown select box. | |CWidgetFieldSeverities |array of int32 |CWidgetFieldCheckBoxList preset with trigger severities. | |CWidgetFieldTags |array of (string, int32, string) |Allows to configure one or more tag filter rows. | |CWidgetFieldTextArea |string |Text area for entering multi-line text. | |CWidgetFieldTextBox |string |Text box for entering single-line text. | |CWidgetFieldTimeZone |string |Dropdown with timezones. | |CWidgetFieldUrl |string |Text box that allows to enter URLs. |  The CWidgetField classes listed below have been created for particular widgets. These classes have very specific use cases, but they can also be reused if needed:  |CWidgetField class |Database field type |Description | |----|--|------------| |CWidgetFieldColumnsList |array of (multiple mixed) |For top host widget. Create a table with custom columns of allowed types. | |CWidgetFieldGraphDataSet |array of (multiple mixed) |For graph widget. Setup dataset configuration and all related options. | |CWidgetFieldGraphOverride |array of (multiple mixed) |For graph widget. Setup overrides for specific hosts/items. Any dataset configuration can be overridden. | |CWidgetFieldNavTree |string |For map navigation tree widget. Replaces widget view in edit mode with the map selection tree. | |CWidgetFieldReference |string |For map navigation tree widget. Creates a unique identifier for this widget on dashboard. It is used to reference this widget from other widgets. | |CWidgetFieldSelectResource |ID |For map widget. Allows to select Zabbix network map. | |CWidgetFieldThresholds |array of (string, string) |For top hosts widget. Allows to configure color and number pairs. | |CWidgetFieldWidgetSelect |string |For map widget. Allows to select a map navigation tree from the current dashboard. Must be used in combination with CWidgetFieldReference in the Map Navigation Tree widget. |
ca	### CWidgetField  Classe base, de la qual s'hereten totes les classes de camp de formulari (CWidgetFieldCheckBox, CWidgetFieldTextArea, CWidgetFieldRadioButtonList, etc.).  Les classes que estenen CWidgetField són les responsables de rebre, desar i validar els valors de configuració del giny.  Les següents classes CWidgetField estan disponibles:  |Classe CWidgetField |Tipus de camp de base de dades |Descripció | |----|--|-------------| |CWidgetFieldCheckBox |int32 |Caixa de verificació única. | |CWidgetFieldCheckBoxList |matriu d'int32 |Múltiples caselles de selecció sota un sol camp de configuració. | |CWidgetFieldColor |cadena |Camp de selecció de color. | |CWidgetFieldDatePicker |cadena |Camp de selecció de data. | |CWidgetFieldHostPatternSelect |cadena |Camp de selecció múltiple que permet triar un o diversos amfitrions. Admet la definició de patrons de nom d'equip (se triaran tots els amfitrions coincidents). | |CWidgetFieldIntegerBox |int32 |Camp per introduir un nombre enter. Es pot emprar per configurar valors mínims i màxims. | |CWidgetFieldLatLng |cadena |Quadre de text que permet introduir la latitud, la longitud i el nivell de zoom del mapa separats per comes. | |CWidgetFieldMultiSelectAction |ID |Camp de selecció múltiple per triar accions (de la llista d'accions definides a *Alertes->Accions*). | |CWidgetFieldMultiSelectGraph |ID |Camp de selecció múltiple per triar gràfics personalitzats. | |CWidgetFieldMultiSelectGraphPrototype |ID |Camp de selecció múltiple per triar prototips de gràfics personalitzats. | |CWidgetFieldMultiSelectGroup |ID |Camp de selecció múltiple per triar grups d'equips. | |CWidgetFieldMultiSelectHost |ID |Camp de selecció múltiple per triar equips. | |CWidgetFieldMultiSelectItem |ID |Camp de selecció múltiple per triar elements. | |CWidgetFieldMultiSelectItemPrototype |ID |Camp de selecció múltiple per triar prototips d'elements. | |CWidgetFieldMultiSelectMediaType |ID |Camp de selecció múltiple per triar tipus de suports. | |CWidgetFieldMultiSelectService |ID |Camp de selecció múltiple per triar serveis. | |CWidgetFieldMultiSelectSla |ID |Camp de selecció múltiple per triar SLA. | |CWidgetFieldMultiSelectUser |ID |Camp de selecció múltiple per triar usuaris. | |CWidgetFieldNumericBox |cadena |Camp per introduir un número flotant. | |CWidgetFieldRadioButtonList |int32 |Grup de caixes de ràdio que consta d'una o més caixes de ràdio. | |CWidgetFieldRangeControl |int32 |Lliscant per triar un valor de tipus enter. | |CWidgetFieldSelect |int32 |Caixa de selecció desplegable. | |CWidgetFieldSeverities |matriu d'int32 |CWidgetFieldCheckBoxList predefinit amb gravetats de l'activador. | |CWidgetFieldTags |matriu de (cadena, int32, cadena) |Permet configurar una o més files de filtre d'etiquetes. | |CWidgetFieldTextArea |cadena |Àrea de text per introduir text de diverses línies. | |CWidgetFieldTextBox |cadena |Quadre de text per introduir text d'una sola línia. | |CWidgetFieldTimeZone |cadena |Menú desplegable amb zones horàries. | |CWidgetFieldUrl |cadena |Caixa de text que permet introduir URL. |  Les classes CWidgetField que es llisten tot seguit s'han creat per a ginys concrets. Aquestes classes tenen casos d'ús molt específics, però també es poden reutilitzar si cal:  |Classe CWidgetField |Tipus de camp de base de dades |Descripció | |----|--|-------------| |CWidgetFieldColumnsList |matriu de (múltiples mixtes) |Per al giny de l'equip superior. Creeu una taula amb columnes personalitzades dels tipus permesos. | |CWidgetFieldGraphDataSet |matriu de (múltiples mixtes) |Per al giny de gràfics. Configuració del conjunt de dades i totes les opcions relacionades. | |CWidgetFieldGraphOverride |matriu de (múltiples mixtes) |Per al giny de gràfics. Substitucions de configuració per a equips/elements específics. Qualsevol configuració de conjunt de dades es pot anul·lar. | |CWidgetFieldNavTree |cadena |Per al giny de l'arbre de navegació del mapa. Substitueix la vista del giny en mode d'edició per l'arbre de selecció del mapa. | |CWidgetFieldReference |cadena |Per al giny de l'arbre de navegació del mapa. Crea un identificador únic per a aquest giny al tauler. S'empra per fer referència a aquest giny des d'altres ginys. | |CWidgetFieldSelectResource |ID |Per al giny de mapa. Permet triar el mapa de la xarxa Zabbix. | |CWidgetFieldThresholds |matriu de (cadena, cadena) |Per al giny dels principals equips. Permet configurar parells de colors i nombres. | |CWidgetFieldWidgetSelect |cadena |Per al giny de mapa. Permet triar un arbre de navegació del mapa del tauler de control actual. S'ha d'emprar en combinació amb CWidgetFieldReference al giny de l'arbre de navegació del mapa. |

en-us	### CWidgetField  The *CWidgetField* class is a base class from which all form field classes (*CWidgetFieldCheckBox*, *CWidgetFieldTextArea*, *CWidgetFieldRadioButtonList*, etc.) are inherited. Classes extending *CWidgetField* are responsible for receiving, saving, and validating widget configuration values.  The following *CWidgetField* classes are available.  |CWidgetField class|Database field type|Description| |----|--|------------| |*CWidgetFieldCheckBox*|int32|Single checkbox.| |*CWidgetFieldCheckBoxList*|array of int32|Multiple checkboxes under a single configuration field.| |*CWidgetFieldColor*|string|Color selection field.| |*CWidgetFieldDatePicker*|string|Date selection field.| |*CWidgetFieldHostPatternSelect*|string|Multiselect field that allows to select one or multiple hosts. Supports defining host name patterns (all matching hosts will be selected).| |*CWidgetFieldIntegerBox*|int32|Field to enter an integer. Can be used to configure minimum and maximum values.| |*CWidgetFieldLatLng*|string|Text box that allows to enter comma-separated latitude, longitude, and map zoom level.| |*CWidgetFieldMultiSelectAction*|ID|Multiselect field for selecting actions (from the list of actions defined in the *Alerts → Actions*).| |*CWidgetFieldMultiSelectGraph*|ID|Multiselect field for selecting custom graphs.| |*CWidgetFieldMultiSelectGraphPrototype*|ID|Multiselect field for selecting custom graph prototypes.| |*CWidgetFieldMultiSelectGroup*|ID|Multiselect field for selecting host groups.| |*CWidgetFieldMultiSelectHost*|ID|Multiselect field for selecting hosts.| |*CWidgetFieldMultiSelectItem*|ID|Multiselect field for selecting items.| |*CWidgetFieldMultiSelectItemPrototype*|ID|Multiselect field for selecting item prototypes.| |*CWidgetFieldMultiSelectMediaType*|ID|Multiselect field for selecting media types.| |*CWidgetFieldMultiSelectService*|ID|Multiselect field for selecting services.| |*CWidgetFieldMultiSelectSla*|ID|Multiselect field for selecting SLAs.| |*CWidgetFieldMultiSelectUser*|ID|Multiselect field for selecting users.| |*CWidgetFieldNumericBox*|string|Field to enter a float number.| |*CWidgetFieldRadioButtonList*|int32|Radio box group that consists of one or more radio boxes.| |*CWidgetFieldRangeControl*|int32|Slider to select an integer type value.| |*CWidgetFieldSelect*|int32|Dropdown select box.| |*CWidgetFieldSeverities*|array of int32|*CWidgetFieldCheckBoxList* preset with trigger severities.| |*CWidgetFieldTags*|array of (string, int32, string)|Allows to configure one or more tag filter rows.| |*CWidgetFieldTextArea*|string|Text area for entering multi-line text.| |*CWidgetFieldTextBox*|string|Text box for entering single-line text.| |*CWidgetFieldTimeZone*|string|Dropdown with timezones.| |*CWidgetFieldUrl*|string|Text box that allows to enter URLs.|  The following *CWidgetField* classes have been created for particular widgets. These classes have very specific use cases, but they can also be reused if needed.  |CWidgetField class|Database field type|Description| |----|--|------------| |*CWidgetFieldColumnsList*|array of (multiple mixed)|For *Top hosts* widget. Create a table with custom columns of allowed types.| |*CWidgetFieldGraphDataSet*|array of (multiple mixed)|For *Graph* widget. Setup dataset configuration and all related options.| |*CWidgetFieldGraphOverride*|array of (multiple mixed)|For *Graph* widget. Setup overrides for specific hosts/items. Any dataset configuration can be overridden.| |*CWidgetFieldNavTree*|string|For *Map navigation tree* widget. Replaces widget view in edit mode with the map selection tree.| |*CWidgetFieldReference*|string|For *Map navigation tree* widget. Creates a unique identifier for this widget on dashboard. It is used to reference this widget from other widgets.| |*CWidgetFieldSelectResource*|ID|For *Map* widget. Allows to select Zabbix network map.| |*CWidgetFieldThresholds*|array of (string, string)|For *Top hosts* widget. Allows to configure color and number pairs.| |*CWidgetFieldWidgetSelect*|string|For *Map* widget. Allows to select a map navigation tree from the current dashboard. Must be used in combination with *CWidgetFieldReference* in the *Map navigation tree* widget.|
ca	### CWidgetField  La classe *CWidgetField* és una classe base de la qual s'hereten totes les classes de camp de formulari (*CWidgetFieldCheckBox*, *CWidgetFieldTextArea*, *CWidgetFieldRadioButtonList*, etc.). Les classes que estenen *CWidgetField* són les responsables de rebre, desar i validar els valors de configuració del giny.  Les següents classes *CWidgetField* estan disponibles.  |Classe CWidgetField|Tipus de camp de base de dades|Descripció| |----|--|-------------| |*CWidgetFieldCheckBox*|int32|Caixa de verificació única.| |*CWidgetFieldCheckBoxList*|array of int32|Múltiples caselles de verificació sota un sol camp de configuració.| |*CWidgetFieldColor*|cadena|Camp de selecció de color.| |*CWidgetFieldDatePicker*|string|Camp de selecció de data.| |*CWidgetFieldHostPatternSelect*|string|Camp de selecció múltiple que permet seleccionar un o diversos amfitrions. Admet la definició de patrons de nom d'amfitrió (se seleccionaran tots els amfitrions coincidents).| |*CWidgetFieldIntegerBox*|int32|Camp per introduir un nombre enter. Es pot utilitzar per configurar valors mínims i màxims.| |*CWidgetFieldLatLng*|string|Quadre de text que permet introduir la latitud, la longitud i el nivell de zoom del mapa separats per comes.| |*CWidgetFieldMultiSelectAction*|ID|Camp de selecció múltiple per seleccionar accions (de la llista d'accions definides a *Alertes → Accions*).| |*CWidgetFieldMultiSelectGraph*|ID|Camp de selecció múltiple per seleccionar gràfics personalitzats.| |*CWidgetFieldMultiSelectGraphPrototype*|ID|Camp de selecció múltiple per seleccionar prototips de gràfics personalitzats.| |*CWidgetFieldMultiSelectGroup*|ID|Camp de selecció múltiple per seleccionar grups d'amfitrió.| |*CWidgetFieldMultiSelectHost*|ID|Camp de selecció múltiple per seleccionar amfitrions.| |*CWidgetFieldMultiSelectItem*|ID|Camp de selecció múltiple per seleccionar elements.| |*CWidgetFieldMultiSelectItemPrototype*|ID|Camp de selecció múltiple per seleccionar prototips d'elements.| |*CWidgetFieldMultiSelectMediaType*|ID|Camp de selecció múltiple per seleccionar tipus de suports.| |*CWidgetFieldMultiSelectService*|ID|Camp de selecció múltiple per seleccionar serveis.| |*CWidgetFieldMultiSelectSla*|ID|Camp de selecció múltiple per seleccionar SLA.| |*CWidgetFieldMultiSelectUser*|ID|Camp de selecció múltiple per seleccionar usuaris.| |*CWidgetFieldNumericBox*|string|Camp per introduir un número flotant.| |*CWidgetFieldRadioButtonList*|int32|Grup de caixes de ràdio que consta d'una o més caixes de ràdio.| |*CWidgetFieldRangeControl*|int32|Lliscant per triar un valor de tipus enter.| |*CWidgetFieldSelect*|int32|Caixa de selecció desplegable.| |*CWidgetFieldSeverities*|matriu d'int32|*CWidgetFieldCheckBoxList* predefinit amb gravetats de trigger.| |*CWidgetFieldTags*|matriu de (cadena, int32, cadena)|Permet configurar una o més files de filtre d'etiquetes.| |*CWidgetFieldTextArea*|string|Àrea de text per introduir text de diverses línies.| |*CWidgetFieldTextBox*|string|Quadre de text per introduir text d'una sola línia.| |*CWidgetFieldTimeZone*|string|Menú desplegable amb zones horàries.| |*CWidgetFieldUrl*|string|Caixa de text que permet introduir URL.|  Les següents classes *CWidgetField* s'han creat per a ginys concrets. Aquestes classes tenen casos d'ús molt concrets, però també es poden reutilitzar si cal.  |Classe CWidgetField|Tipus de camp de base de dades|Descripció| |----|--|-------------| |*CWidgetFieldColumnsList*|matriu de (múltiples mixtes)|Per al giny *Equips principals*. Creeu una taula amb columnes personalitzades dels tipus permesos.| |*CWidgetFieldGraphDataSet*|matriu de (múltiples mixtes)|Per al giny *Graph*. Configura la configuració del conjunt de dades i totes les opcions relacionades.| |*CWidgetFieldGraphOverride*|matriu de (múltiples mixtes)|Per al giny *Graph*. Substitucions de configuració per a equips/elements específics. Qualsevol configuració de conjunt de dades es pot anul·lar.| |*CWidgetFieldNavTree*|string|Per al giny *Arbre de navegació del mapa*. Substitueix la vista del giny en mode d'edició per l'arbre de selecció del mapa.| |*CWidgetFieldReference*|string|Per al giny *Arbre de navegació del mapa*. Crea un identificador únic per a aquest giny al tauler. S'empra per fer referència a aquest gint des d'altres ginys.| |*CWidgetFieldSelectResource*|ID|Per al giny *Map*. Permet seleccionar el mapa de la xarxa Zabbix.| |*CWidgetFieldThresholds*|matriu de (cadena, cadena)|Per al giny *Equips principals*. Permet configurar parells de colors i números.| |*CWidgetFieldWidgetSelect*|cadena|Per al giny *Map*. Permet seleccionar un arbre de navegació del mapa del tauler de control actual. S'ha d'utilitzar en combinació amb *CWidgetFieldReference* al giny *Arbre de navegació del mapa*.|

en-us	### CWidgetFormView  The *CWidgetFormView* class is required for specifying the presentation logic of the fields defined in the *WidgetForm* class, determining their appearance and behavior when rendered in the configuration view.  The *CWidgetFormView* class supports the following methods:  -   *addField()* - receives an instance of the *CWidgetFieldView* class as a parameter;     each [*CWidgetField*](#cwidgetfield) class, has a respective *CWidgetFieldView* class for using in the widget configuration view. -   *includeJsFile()* - allows to add a JavaScript file to the widget configuration view. -   *addJavaScript()* - allows to add inline JavaScript that will be executed as soon as the widget configuration view is loaded.  The *CWidgetFormView* class should be located in the *views* directory.  **views/widget.edit.php example**  ```php <?php      /**  * My custom widget form view.  *  * @var CView $this  * @var array $data  */  use Zabbix\Widgets\Fields\CWidgetFieldGraphDataSet;  (new CWidgetFormView($data))     ->addField(         new CWidgetFieldMultiSelectItemView($data['fields']['itemid'], $data['captions']['items']['itemid'])     )     ->addField(         new CWidgetFieldTextBoxView($data['fields']['description']),         'js-advanced-configuration'     )     ->addField(         new CWidgetFieldColorView($data['fields']['chart_color']),         'js-advanced-configuration'     )     ->includeJsFile('widget.edit.js.php')     ->addJavaScript('my_widget_form.init('.json_encode([         'color_palette' => CWidgetFieldGraphDataSet::DEFAULT_COLOR_PALETTE     ], JSON_THROW_ON_ERROR).');')     ->show(); ```
ca	### CWidgetFormView  La classe *CWidgetFormView* és necessària per especificar la lògica de presentació dels camps definits a la classe *WidgetForm*, determinant-ne l'aparença i el comportament quan es representen a la vista de configuració.  La classe *CWidgetFormView* admet els mètodes següents:  -*addField()* - rep una instància de la classe *CWidgetFieldView* com a paràmetre; cada classe [*CWidgetField*](#cwidgetfield) té una classe respectiva *CWidgetFieldView* per emprar-la a la vista de configuració del giny. -*includeJsFile()* - permet afegir un fitxer JavaScript a la vista de configuració del giny. -*addJavaScript()* - permet afegir JavaScript en línia que s'executarà tan bon punt es carregui la vista de configuració del giny.  La classe *CWidgetFormView* s'ha d'ubicar al directori *views*.  **exemple de views/widget.edit.php**  ```php <?php      /**  * La meva vista de formulari de giny personalitzada.  *  * @var CView $this  * @var array $data  */  use Zabbix\Widgets\Fields\CWidgetFieldGraphDataSet;  (new CWidgetFormView($data))     ->addField(         new CWidgetFieldMultiSelectItemView($data['fields']['itemid'], $data['captions']['items']['itemid'])     )     ->addField(         new CWidgetFieldTextBoxView($data['fields']['description']),         'js-advanced-configuration'     ) ->addField(    new CWidgetFieldColorView($data['fields']['chart_color']), 'js-advanced-configuration' )          ->includeJsFile('widget.edit.js.php')     ->addJavaScript('my_widget_form.init('.json_encode([             'color_palette' => CWidgetFieldGraphDataSet::DEFAULT_COLOR_PALETTE         ], JSON_THROW_ON_ERROR).');')     ->show();    ```

en-us	# dashboard.create
ca	# dashboard.create

en-us	# dashboard.delete
ca	# dashboard.delete

en-us	# dashboard.get
ca	# dashboard.get

en-us	# > Dashboard object  The following objects are directly related to the `dashboard` API.
ca	# > Objecte de tauler  Els objectes següents tenen relació directa amb l'API `dashboard`.

en-us	### Dashboard page  The dashboard page object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dashboard\_pageid|string|ID of the dashboard page.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |name|string|Dashboard page name.<br><br>Default: empty string.| |display\_period|integer|Dashboard page display period (in seconds).<br><br>Possible values: 0, 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 0 (will use the default page display period).| |widgets|array|Array of the [dashboard widget](object#dashboard-widget) objects.|
ca	### Pàgina de tauler  L'objecte de pàgina de tauler té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dashboard\_pageid|string|ID de la pàgina del tauler..<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |name|string|Nom de la pàgina del tauler.<br><br>Per defecte: cadena buida.| |display\_period|integer|Temps de mostra de la pàgina del tauler (en segons).<br><br>Valors possibles: 0, 10, 30, 60, 120, 600, 1800, 3600.<br><br>Per defecte: 0 (empra el període de mostra de pàgina per defecte).| |widgets|array|Matriu dels objectes [ginys de tauler](object#dashboard_widget).|

en-us	 ##### Dashboard size  The minimum width of a dashboard is 1200 pixels. The dashboard will not shrink below this width; instead a  horizontal scrollbar is displayed if the browser window is smaller than that.  The maximum width of a dashboard is the browser window width. Dashboard widgets stretch horizontally to fit the window.  At the same time, a dashboard widget cannot be stretched horizontally beyond the window limits.  Technically the dashboard consists of 12 horizontal columns of always equal width that stretch/shrink dynamically (but  not to less than 1200 pixels total).  Vertically the dashboard may contain a maximum of 64 rows. Each row has a fixed height of 70 pixels. A widget may be  up to 32 rows high.
ca	##### Mida del tauler  L'amplada mínima d'un tauler és de 1200 píxels. El tauler de comandament no es reduirà per sota d'aquesta amplada; en canvi, es mostra una barra de desplaçament horitzontal si la finestra del navegador és més petita que això.  L'amplada màxima d'un tauler és l'amplada de la finestra del navegador. Els ginys del tauler s'estenen horitzontalment per adaptar-se a la finestra. Al mateix temps, un giny del tauler de control no es pot estirar horitzontalment més enllà dels límits de la finestra.  Tècnicament, el tauler consta de 12 columnes horitzontals d'amplada sempre igual que s'estiren / s'arronssen dinàmicament (però no a menys de 1200 píxels en total).  Verticalment, el tauler pot contindre un màxim de 64 files. Cada filera té una alçada fixa de 70 píxels. Un giny pot tenir fins a 32 fileres d'alçada.

en-us	#### Dashboards  Manage dashboards and make scheduled reports based on them.  [Dashboard API](/manual/api/reference/dashboard) | [Template dashboard API](/manual/api/reference/templatedashboard) | [Report API](/manual/api/reference/report)
ca	#### Taulers  Gestionar els taulers i crear informes planificats basats en aquests taulers.  [API Tauler](/manual/api/reference/dashboard) | [API Model de tauler](/manual/api/reference/templatedashboard) | [API Informe](/manual/api/reference/report)

en-us	### Dashboard  The dashboard object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dashboardid|string|ID of the dashboard.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the dashboard.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |userid|string|Dashboard owner user ID.| |private|integer|Type of dashboard sharing.<br><br>Possible values:<br>0 - public dashboard;<br>1 - *(default)* private dashboard.| |display\_period|integer|Default page display period (in seconds).<br><br>Possible values: 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 30.| |auto\_start|integer|Auto start slideshow.<br><br>Possible values:<br>0 - do not auto start slideshow;<br>1 - *(default)* auto start slideshow.|
ca	### Tauler  L'objecte tauler té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dashboardid|string|*(només lectura)* ID del tauler.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització| |name|string|Nom del tauler.| |userid|string|ID de l'usuari propietari del tauler.| |private|integer|Tipus de compartició del tauler.<br><br>Valors possibles:<br>0 - tauler públic;<br>1 - *(per defecte)* tauler privat.| |display\_period|integer|Període (en segons) de mstra de la pàgina per defecte.<br><br>Valors possibles: 10, 30, 60, 120, 600, 1800, 3600.<br><br>Per defecte: 30.| |auto\_start|integer|Iniciar presentació automàticament.<br><br>Valors possibles:<br>0 - no iniciar-la automàticament;<br>1 - *(per defecte)* iniciar-la automàticament.|

en-us	# Dashboard  This class is designed to work with dashboards.  Object references:\  -   [Dashboard](/manual/api/reference/dashboard/object#dashboard) -   [Dashboard     page](/manual/api/reference/dashboard/object#dashboard_page) -   [Dashboard     widget](/manual/api/reference/dashboard/object#dashboard_widget) -   [Dashboard widget     field](/manual/api/reference/dashboard/object#dashboard_widget_field) -   [Dashboard     user](/manual/api/reference/dashboard/object#dashboard_user) -   [Dashboard user     group](/manual/api/reference/dashboard/object#dashboard_user_group)  Available methods:\  -   [dashboard.create](/manual/api/reference/dashboard/create) -     creating new dashboards -   [dashboard.delete](/manual/api/reference/dashboard/delete) -     deleting dashboards -   [dashboard.get](/manual/api/reference/dashboard/get) - retrieving     dashboards -   [dashboard.update](/manual/api/reference/dashboard/update) -     updating dashboards
ca	# Tauler  Aquesta classe és dissenyada per treballar amb taulers.  Referències d'objectes:\  -   [Dashboard](/manual/api/reference/dashboard/object#dashboard) -   [Dashboard     page](/manual/api/reference/dashboard/object#dashboard_page) -   [Dashboard     widget](/manual/api/reference/dashboard/object#dashboard_widget) -   [Dashboard widget     field](/manual/api/reference/dashboard/object#dashboard_widget_field) -   [Dashboard     user](/manual/api/reference/dashboard/object#dashboard_user) -   [Dashboard user     group](/manual/api/reference/dashboard/object#dashboard_user_group)  Mètodes disponibles:\  -   [dashboard.create](/manual/api/reference/dashboard/create) -     crear nous taulers -   [dashboard.delete](/manual/api/reference/dashboard/delete) -     esborrar taulers -   [dashboard.get](/manual/api/reference/dashboard/get) - retrieving     taulers -   [dashboard.update](/manual/api/reference/dashboard/update) -     actualitzar taulers

en-us	# dashboard.update
ca	# dashboard.update

en-us	### Dashboard user group  List of dashboard permissions based on user groups. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |usrgrpid|string|User group ID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |permission|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Grup d'usuaris del tauler  Llistat dels permisos del tauler en funció dels grups d'usuaris. L'objecte té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |usrgrpid|string|ID del grup d'usuaris.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |permission|integer|Tipus del nivell de permisos.<br><br>Valors possibles:<br>2 - només lectura;<br>3 - lectura i escriptura.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### Dashboard user  List of dashboard permissions based on users. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |userid|string|User ID.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |permission|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Usuaris del tauler  Llistat dels permisos del tauler en funció dels usuaris. L'objecte té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |userid|string|ID de l'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |permission|integer|Tipus del nivell de permisos.<br><br>Valors possibles:<br>2 - només lectura;<br>3 - lectura i escriptura.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	# Dashboard widget fields
ca	# Camps de giny de tauler

en-us	### Dashboard widget field  The dashboard widget field object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |type|integer|Type of the widget field.<br><br>Possible values:<br>0 - Integer;<br>1 - String;<br>2 - Host group;<br>3 - Host;<br>4 - Item;<br>5 - Item prototype;<br>6 - Graph;<br>7 - Graph prototype;<br>8 - Map;<br>9 - Service;<br>10 - SLA;<br>11 - User;<br>12 - Action;<br>13 - Media type.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |name|string|Widget field name.<br><br>Possible values: see [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|mixed|Widget field value depending on the type.<br><br>Possible values: see [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Camp del giny de tauler  L'objecte de camp de giny del tauler té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |tipus|integer|Tipus de camp de giny.<br><br>Valors possibles:<br>0 - Enter;<br>1 - Cadena;<br>2 - Grup d'equips;<br>3 - Equip;<br>4 - Element;<br>5 - Prototipus d'elements;<br>6 - Gràfic;<br>7 - Prototipus de gràfics;<br>8 - Mapa;<br>9 - Servei;<br>10 - SLA;<br>11 - Uusari;<br>12 - Acció;<br>13 - Tipus de suport.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |name|string|Nom del camp de giny.<br><br>Valors possibles: veieu [Camps de giny de tauler](/manual/api/reference/dashboard/widget_fields).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |value|mixed|Valor del camp de giny depenent segons el tipus.<br><br>Valors possibles: veieu [Camps de giny de tauler](/manual/api/reference/dashboard/widget_fields).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	#### Dashboard widgets
ca	#### Ginys de tauler

en-us	### Dashboard widget  The dashboard widget object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |widgetid|string|ID of the dashboard widget.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |type|string|Type of the dashboard widget.<br><br>Possible values:<br>actionlog - Action log;<br>clock - Clock;<br>*(deprecated)* dataover - Data overview;<br>discovery - Discovery status;<br>favgraphs - Favorite graphs;<br>favmaps - Favorite maps;<br>graph - Graph (classic);<br>graphprototype - Graph prototype;<br>hostavail - Host availability;<br>item - Item value;<br>map - Map;<br>navtree - Map Navigation Tree;<br>plaintext - Plain text;<br>problemhosts - Problem hosts;<br>problems - Problems;<br>problemsbysv - Problems by severity;<br>slareport - SLA report;<br>svggraph - Graph;<br>systeminfo - System information;<br>tophosts - Top hosts;<br>trigover - Trigger overview;<br>url - URL;<br>web - Web monitoring.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |name|string|Custom widget name.| |x|integer|A horizontal position from the left side of the dashboard.<br><br>Valid values range from 0 to 23.| |y|integer|A vertical position from the top of the dashboard.<br><br>Valid values range from 0 to 62.| |width|integer|The widget width.<br><br>Valid values range from 1 to 24.| |height|integer|The widget height.<br><br>Valid values range from 2 to 32.| |view\_mode|integer|The widget view mode.<br><br>Possible values:<br>0 - *(default)* default widget view;<br>1 - with hidden header;| |fields|array|Array of the [dashboard widget field](object#dashboard-widget-field) objects.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- see individual widgets in [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields)|
ca	### Giny de tauler  L'objecte  giny de tauler té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |widgetid|string|ID del giny de tauler.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |tipus|string|Tipus de giny de tauler.<br><br>Valors possibles:<br>actionlog - Registre d'acció;<br>clock - Rellotge;<br>*(obsolet)* dataover - Vista general d'informació;<br>discovery - Estat de descoberta;<br>favgraphs - Gràfics preferits;<br>favmaps - Mapes preferits;<br>graph - Gràfic (clàssic);<br>graphprototype - Prototipus de gràfic;<br>hostavail - Disponibilitat de l'equip;<br>item - Valor d'element;<br>map - Mapa;<br>navtree - Arbre de navegació del mapa;<br>plaintext - Text pla;<br>problemhosts - Equips amb problemes;<br>problems - Problemes;<br>problemsbysv - Problemes per gravetat;<br>slareport - Informe d'SLA;<br>svggraph - Gràfic;<br>systeminfo - Informació del sistema;<br>tophosts - Millors equips;<br>trigover - Vista general dels triggers;<br>url - URL;<br>web - Monitoratge Web.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |name|string|Nom del giny personalitzat.| |x|integer|Posició horitzontal des de l'esquerra del tauler.<br><br>Interval vàlid des de 0 a 23.| |y|integer|Posició vertical des de dalt del tauler.<br><br>Valors vàlids entre 0 i 62.| |width|integer|Amplada del giny.<br><br>Valors vàlids entre 1 i 24.| |height|integer|Alçada del giny.<br><br>Valors vàlids entre 2 i 32.| |view\_mode|integer|Mode de vista del giny.<br><br>Valors possibles:<br>0 - *(per defecte)* vista del giny per defecte;<br>1 - amb capçalera oculta;| |fields|array|Taula dels objectes [camp del giny del tauler](object#dashboard-widget-field).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- veieu els ginys individuals al [Tauler de camps de giny](/manual/api/reference/dashboard/widget_fields)|

en-us	#### dashboard  [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) Added new [dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field) types (11 - User, 12 - Action, 13 - Media type).\  Added new possible value combinations of the dashboard widget field object properties for different widget types:\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Added `"type": 11, "name": "userids", "value": <user ID>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Added `"type": 12, "name": "actionids", "value": <action ID>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Added `"type": 13, "name": "mediatypeids", "value": <media type ID>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Added `"type": 0, "name": "statuses", "value": <0 - In progress; 1 - Sent/Executed; 2 - Failed>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Added `"type": 1, "name": "message", "value": "<any string value>"`.\ [ZBXNEXT-7661](https://support.zabbix.com/browse/ZBXNEXT-7661) `item`: Added `"type": 1, "name": "thresholds.color.<N>", "value": "<hexadecimal color code>"`.\ [ZBXNEXT-7661](https://support.zabbix.com/browse/ZBXNEXT-7661) `item`: Added `"type": 1, "name": "thresholds.threshold.<N>", "value": "<any string value>"`.\ [ZBXNEXT-5491](https://support.zabbix.com/browse/ZBXNEXT-5491) `svggraph`: Added `"type": 1, "name": "ds.data_set_label.<N>", "value": "<any string value>"`.\ [ZBXNEXT-8165](https://support.zabbix.com/browse/ZBXNEXT-8165) `tophosts`: Added `"type": 0, "name": "columns.decimal_places.<N>", "value": <valid values range: 0-10>`.\
ca	#### dashboard  [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) Afegit els nous tipus (11 - User, 12 - Action, 13 - Media type) de [camp de giny del tauler](/manual/api/reference/dashboard/object#dashboard-widget-field).\  Afegides noves combinacions de valors possibles de les propietats d'objecte del camp d'estris del tauler per a diferents tipus de giny:\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Afegits `"tipus": 11, "nom": "userids", "valor": <user ID>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Afegits `"tipus": 12, "nom": "actionids", "valor": <action ID>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Afegits `"tipus": 13, "nom": "mediatypeids", "valor": <media type ID>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Afegits `"tipus": 0, "nom": "statuses", "valor": <0 - In progress; 1 - Sent/Executed; 2 - Failed>`.\ [ZBXNEXT-4714](https://support.zabbix.com/browse/ZBXNEXT-4714) `actionlog`: Afegits `"tipus": 1, "nom": "missatge", "valor": "<any string value>"`.\ [ZBXNEXT-7661](https://support.zabbix.com/browse/ZBXNEXT-7661) `item`: Afegits `"tipus": 1, "nom": "thresholds.color.<N>", "valor": "<hexadecimal color code>"`.\ [ZBXNEXT-7661](https://support.zabbix.com/browse/ZBXNEXT-7661) `item`: Afegits `"tipus": 1, "nom": "thresholds.threshold.<N>", "valor": "<any string value>"`.\ [ZBXNEXT-5491](https://support.zabbix.com/browse/ZBXNEXT-5491) `svggraph`: Afegits `"tipus": 1, "nom": "ds.data_set_label.<N>", "valor": "<any string value>"`.\ [ZBXNEXT-8165](https://support.zabbix.com/browse/ZBXNEXT-8165) `tophosts`: Afegits `"tipus": 0, "nom": "columns.decimal_places.<N>", "valor": <valid values range: 0-10>`.\

en-us	### Database creation  We assume that a *zabbix* database user with *password* password exists and has permissions to create database objects in ORCL service located on the *host* Oracle database server. Zabbix requires a Unicode database character set and a `UTF8` national character set. Check current settings:      sqlplus> select parameter,value from v$nls_parameters where parameter='NLS_CHARACTERSET' or parameter='NLS_NCHAR_CHARACTERSET';  Now prepare the database:      shell> cd /path/to/zabbix-sources/database/oracle     shell> sqlplus zabbix/password@oracle_host/ORCL     sqlplus> @schema.sql     # stop here if you are creating database for Zabbix proxy     sqlplus> @images.sql     sqlplus> @data.sql  ::: notetip Please set the initialization parameter CURSOR\_SHARING=FORCE for best performance. :::
ca	### Creació de la base de dades  Suposem que existeix un usuari *zabbix* de la base de dades, amb paraula de pas *password*; i que té permisos necessaris per crear un objecte de base de dades al servei ORCL que és a l'equip del servidor de base de dades Oracle. A Zabbix li cal un joc de caràcters Unicode de base de dades, i un joc de caràcters nacional `UTF8`.  Verifiqueu la configuració actual:      sqlplus> select parameter,value from v$nls_parameters where parameter='NLS_CHARACTERSET' or parameter='NLS_NCHAR_CHARACTERSET';  Prepareu la base de dades:      shell> cd /path/to/zabbix-sources/database/oracle     shell> sqlplus zabbix/password@oracle_host/ORCL     sqlplus> @schema.sql     # arrêtez-vous ici si vous créez une base de données pour le proxy Zabbix     sqlplus> @images.sql     sqlplus> @data.sql  ::: notetip Definiu el paràmetre d'inicialització CURSOR\_SHARING=FORCE per tindre més bon rendiment. :::

en-us	### Database credentials  Access to a secret with database credentials is configured for each Zabbix component separately.   #### Server and proxies  To obtain database credentials from the vault for Zabbix [server](/manual/appendix/config/zabbix_server) or [proxy](/manual/appendix/config/zabbix_proxy), specify the following configuration parameters in the configuration file:  -   `Vault` - which vault provider should be used; -   `VaultToken` - vault authentication token (see Zabbix server/proxy configuration file for details); -   `VaultURL` - vault server HTTP\[S\] URL; -   `VaultDBPath` - path to the vault secret containing database credentials; Zabbix server or proxy will retrieve the credentials by keys "password" and "username".  :::noteimportant Zabbix server also uses the `Vault`, `VaultToken` and `VaultURL` configuration parameters for vault authentication when processing vault secret macros. :::  Zabbix server and Zabbix proxy read the vault-related configuration parameters from *zabbix_server.conf* and *zabbix_proxy.conf* upon startup. Additionally, Zabbix server and Zabbix proxy will read the `VAULT_TOKEN` environment variable once during startup and will unset it so that it would not be available through forked scripts; it is an error if both `VaultToken` and `VAULT_TOKEN` parameters contain a value.
ca	### Credencials de Base de dades  L'accés a un secret amb credencials de base de dades es configura per a cada component Zabbix per separat.  #### Servidor i proxys Per obtindre les credencials de la base de dades del [servidor](/manual/appendix/config/zabbix_server) o [proxy](/manual/appendix/config/zabbix_proxy) Zabbix des de la vault, especifiqueu els paràmetres de configuració següents al fitxer de configuració:  - `Vault` - quin proveïdor de vault s'ha d'emprar. - `VaultToken` - testimoni d'autenticació de vault (veieu el fitxer de configuració del servidor/proxy Zabbix per a més informació). -  VaultURL` - URL HTTP[S] del servidor de vault. - `VaultDBPath` - camí al secret de la vault que conté les credencials de la base de dades. El servidor o el proxy Zabbix recuperaran les credencials mitjançant les claus "mot de pas" i "nom d'usuari".  :::noteimportant El servidor Zabbix també empra aquests paràmetres de configuració (excepte VaultDBPath) per a l'autenticació de vault quan es processen macros secretes de vault. :::  El servidor Zabbix i el proxy Zabbix llegeixen els paràmetres de configuració relacionats amb la vault de zabbix_server.conf i zabbix_proxy.conf en iniciar-se.  El servidor Zabbix i el proxy Zabbix també llegiran la variable d'entorn `VAULT_TOKEN` una vegada durant l'inici i la desactivaran de manera que no sigui disponible mitjançant scripts bifurcats; és un error si tant `VaultToken` com `VAULT_TOKEN` contenen valor.

en-us	### Database credentials  Access to a secret with database credentials is configured for each Zabbix component separately.  #### Server and proxies  To obtain database credentials from the vault for Zabbix [server](/manual/appendix/config/zabbix_server) or [proxy](/manual/appendix/config/zabbix_proxy), specify the following configuration parameters in the configuration file:  -   `Vault` - which vault provider should be used; -   `VaultURL` - vault server HTTP\[S\] URL; -   `VaultDBPath` - query to the vault secret containing database credentials which will be retrieved by keys "Content" and "UserName"; -   `VaultTLSCertFile`, `VaultTLSKeyFile` - SSL certificate and key file names; setting up these options is not mandatory, but highly recommended.  :::noteimportant Zabbix server also uses the `Vault`, `VaultURL`, `VaultTLSCertFile` and `VaultTLSKeyFile` configuration parameters for vault authentication when processing vault secret macros. :::  Zabbix server and Zabbix proxy read the vault-related configuration parameters from *zabbix_server.conf* and *zabbix_proxy.conf* files upon startup.
ca	### Credencials de Base de dades  L'accés a un secret amb credencials de base de dades es configura per a cada component Zabbix per separat.  #### Servidor i proxys  Per obtindre les credencials de la base de dades del [servidor](/manual/appendix/config/zabbix_server) o [proxy](/manual/appendix/config/zabbix_proxy) Zabbix des de la caixa de seguretat, especifiqueu els paràmetres de configuració següents al fitxer de configuració:  - *Vault* - quin proveïdor de vault s'ha d'emprar. - *VaultURL* - URL HTTP\[S\] del servidor de vault. - *VaultDBPath* - consulta al secret de la caixa forta que conté les credencials de la base de dades. Les credencials es recuperaran mitjançant les claus "Contingut" i "Nom d'usuari". - *VaultTLSCertFile*, *VaultTLSKeyFile* - Noms dels fitxers de clau i certificat SSL. Configurar aquestes opcions no és obligatori, però molt recomanable.  :::noteimportant El servidor Zabbix també empra aquests paràmetres de configuració (excepte VaultDBPath) per a l'autenticació de vault quan es processen macros secretes de vault. :::  El servidor Zabbix i el proxy Zabbix llegeixen els paràmetres de configuració relacionats amb la vault de zabbix_server.conf i zabbix_proxy.conf en iniciar-se.

en-us	## Databases
ca	## Bases de dades

en-us	## Databases
ca	## Bases de dades

en-us	## Databases
ca	## Bases de dades

en-us	## Databases
ca	## Bases de dades

en-us	## Databases
ca	## Bases de dades

en-us	#### Database size  Zabbix configuration data require a fixed amount of disk space and do not grow much.  Zabbix database size mainly depends on these variables, which define the amount of stored historical data:  -   Number of processed values per second  This is the average number of new values Zabbix server receives every second. For example, if we have 3000 items for monitoring with a refresh rate of 60 seconds, the number of values per second is calculated as 3000/60 = **50**.  It means that 50 new values are added to Zabbix database every second.  -   Housekeeper settings for history  Zabbix keeps values for a fixed period of time, normally several weeks or months. Each new value requires a certain amount of disk space for data and index.  So, if we would like to keep 30 days of history and we receive 50 values per second, the total number of values will be around (**30**\*24\*3600)\* **50** = 129.600.000, or about 130M of values.  Depending on the database engine used, type of received values (floats, integers, strings, log files, etc), the disk space for keeping a single value may vary from 40 bytes to hundreds of bytes. Normally it is around 90 bytes per value for numeric items^**2**^. In our case, it means that 130M of values will require 130M \* 90 bytes = **10.9GB** of disk space.  ::: noteclassic The size of text/log item values is impossible to predict exactly, but you may expect around 500 bytes per value. :::  -   Housekeeper setting for trends  Zabbix keeps a 1-hour max/min/avg/count set of values for each item in the table **trends**. The data is used for trending and long period graphs. The one hour period can not be customized.  Zabbix database, depending on the database type, requires about 90 bytes per each total. Suppose we would like to keep trend data for 5 years. Values for 3000 items will require 3000\*24\*365\* **90** = **2.2GB** per year, or **11GB** for 5 years.  -   Housekeeper settings for events  Each Zabbix event requires approximately 250 bytes of disk space^**1**^. It is hard to estimate the number of events generated by Zabbix daily. In the worst-case scenario, we may assume that Zabbix generates one event per second.  For each recovered event, an event\_recovery record is created. Normally most of the events will be recovered so we can assume one event\_recovery record per event. That means additional 80 bytes per event.  Optionally events can have tags, each tag record requiring approximately 100 bytes of disk space^**1**^. The number of tags per event (\#tags) depends on configuration. So each will need an additional \#tags \* 100 bytes of disk space.  It means that if we want to keep 3 years of events, this would require 3\*365\*24\*3600\* (250+80+\#tags\*100) = **\~30GB**+\#tags\*100B disk space^**2**^.  ::: noteclassic  ^**1**^ More when having non-ASCII event names, tags and values.\ ^**2**^ The size approximations are based on MySQL and might be different for other databases.  :::  The table contains formulas that can be used to calculate the disk space required for Zabbix system:  |Parameter|Formula for required disk space (in bytes)| |---------|------------------------------------------| |*Zabbix configuration*|Fixed size. Normally 10MB or less.| |*History*|days\*(items/refresh rate)\*24\*3600\*bytes<br>items : number of items<br>days : number of days to keep history<br>refresh rate : average refresh rate of items<br>bytes : number of bytes required to keep single value, depends on database engine, normally \~90 bytes.| |*Trends*|days\*(items/3600)\*24\*3600\*bytes<br>items : number of items<br>days : number of days to keep history<br>bytes : number of bytes required to keep single trend, depends on the database engine, normally \~90 bytes.| |*Events*|days\*events\*24\*3600\*bytes<br>events : number of event per second. One (1) event per second in worst-case scenario.<br>days : number of days to keep history<br>bytes : number of bytes required to keep single trend, depends on the database engine, normally \~330 + average number of tags per event \* 100 bytes.|  So, the total required disk space can be calculated as:\ **Configuration + History + Trends + Events**\ The disk space will NOT be used immediately after Zabbix installation. Database size will grow then it will stop growing at some point, which depends on housekeeper settings.
ca	#### Mida de la base de dades  Les dades de configuració de Zabbix requereixen una quantitat fixa d'espai en disc i no creixen gaire.  La mida de la base de dades Zabbix depèn principalment d'aquestes variables, que defineixen la quantitat de dades històriques emmagatzemades:  - Nombre de valors processats per segon  Aquest és el nombre mitjà de valors nous que rep el servidor Zabbix cada segon. Per exemple, si teniu 3000 elements per monitorar amb una freqüència d'actualització de 60 segons, el nombre de valors per segon es calcula com a 3000/60 = **50**. Significa que s'afegeixen 50 valors nous a la base de dades de Zabbix cada segon.  - Configuració de la neteja de l'històric  Zabbix manté els valors durant un període de temps determinat, normalment diverses setmanes o mesos. Cada valor nou requereix una certa quantitat d'espai de disc per a les dades i l'índex.  Per tant, si voleu conservar 30 dies d'historial i rebeu 50 valors per segon, el nombre total de valors serà al voltant de (**30**\*24\*3600)\* **50** = 129.600 .000, o uns 130M de valors.  Depenent del motor de base de dades emprat, del tipus de valors rebuts (flotants, nombres enters, cadenes, fitxers de registre, etc.), l'espai en disc per mantindre un valor únic pot variar des de 40 octets fins a centenars d'octets. Normalment és d'uns 90 octets per valor per als elements numèrics^**2**^.  En aquest cas, vol dir que 130 M de valors requeriran 130 M \* 90 octets = **10,9 Go** d'espai en disc.  ::: noteclassic La mida dels valors dels elements de text/registre és impossible de predir amb exactitud, però és possible que sigui d'uns 500 octets per valor. :::  - Configuració de la neteja per tendències  Zabbix manté un conjunt de valors màxim/min/mitjana/compte d'1 hora per a cada element de la taula **tendències**. Les dades s'empren per a gràfics de tendències i de períodes llargs. El període d'una hora no es pot personalitzar.  La base de dades Zabbix, depenent del tipus de base de dades, requereix uns 90 octets per cada total.  Suposem que voleu conservar les dades de tendències durant 5 anys. Els valors de 3.000 elements requeriran 3.000\*24\*365\* **90** = **2,2 Go** per any o **11 Go** durant 5 anys.  - Configuració de la neteja per a esdeveniments  Cada esdeveniment Zabbix requereix aproximadament 250 octets d'espai en disc^**1**^.  És difícil estimar el nombre d'esdeveniments generats per Zabbix diàriament. En el pitjor dels casos, podeu suposar que Zabbix genera un esdeveniment per segon. Per a cada esdeveniment recuperat, es crea un registre `event_recovery`. Normalment, la majoria dels esdeveniments es recuperaran. Per tant, podeu suposar un registre `event_recovery` per esdeveniment. Això significa 80 octets addicionals per esdeveniment.  Opcionalment, els esdeveniments poden tindre etiquetes, cada registre d'etiquetes requereix aproximadament 100 octets d'espai en disc^**1**^. El nombre d'etiquetes per esdeveniment (\#tags) depèn de la configuració.  Per tant, cadascun necessitarà \#etiquetes \* 100 octets addicionals d'espai en disc.  Vol dir que si voleu mantindre 3 anys d'esdeveniments, caldria 3\*365\*24\*3600\* (250+80+\#tags\*100) = **\~30Go**+\ #etiquetes\*100o d'espai en disc^**2**^.  ::: noteclassic  ^**1**^ Més quan tens noms, etiquetes i valors d'esdeveniments que no són ASCII.\ ^**2**^ Les aproximacions de mida es basen en MySQL i poden ser diferents per a altres bases de dades. :::  La taula conté fórmules que es poden emprar per calcular l'espai de disc necessari per al sistema Zabbix:  |Paràmetre|Fórmula per a l'espai de disc necessari (en octets)| |---------|---------------------------------------- ---| |*Configuració Zabbix*|Mida fixa. Normalment 10 Mo o menys.| |*Historial*|dies\*(elements/freqüència d'actualització)\*24\*3600\*octets<br>elements : nombre d'elements<br>dies : nombre de dies per mantindre l'historial<br>freqüència d'actualització : actualització mitjana taxa d'elements<br>octets : nombre d'octets necessaris per mantindre un valor únic, depèn del motor de base de dades, normalment \~90 octets.| |*Tendències*|dies\*(elements/3600)\*24\*3600\*octets<br>elements : nombre d'elements<br>dies : nombre de dies per conservar l'historial<br>octets : nombre d'octets necessaris per mantindre una tendència única, depèn del motor de base de dades, normalment \~90 octets.| |*Esdeveniments*|dies\*esdeveniments\*24\*3600\*octets<br>esdeveniments : nombre d'esdeveniments per segon. Un (1) esdeveniment per segon en el pitjor dels casos.<br>dies : nombre de dies per mantindre l'historial<br>octets : nombre d'octets necessaris per mantindre una tendència única, depèn del motor de base de dades, normalment \~330 + mitjana nombre d'etiquetes per esdeveniment \* 100 octets.|  Per tant, l'espai total de disc necessari es pot calcular com:\ **Configuració + Historial + Tendències + Esdeveniments**\ L'espai de disc NO s'emprarà immediatament després de la instal·lació de Zabbix. La mida de la base de dades creixerà i després deixarà de créixer en algun moment, cosa que depèn de la configuració de la neteja.

en-us	## Databases  #### Supported versions  PostgreSQL **16** and MariaDB **11.1** are now supported. See also: [Requirements](/manual/installation/requirements#third-party-external-surrounding-software).
ca	## Bases de dades  #### Versions admeses  Ara s'admeten PostgreSQL **16** i MariaDB **11.1**. Veieu també: [Requisits](/manual/installation/requirements#third-party-external-surrounding-software).

en-us	##### Database storage  All configuration information as well as the data gathered by Zabbix is stored in a database.
ca	##### Emmagatzematge de dades  Tota la informació de configuració així com les dades recollides per el Zabbix s'emmagatzemen a una base de dades.

en-us	#### Database TLS connection for MySQL on SLES 12  The packages for server/proxy installation on SUSE Linux Enterprise Server version 12 are now built using MariaDB Connector/C library, thus enabling the encryption of connection to MySQL using the DBTLSConnect [parameter](/manual/appendix/config/zabbix_server). The supported encryption values are "required" and "verify\_full".
ca	#### Connexió TLS de base de dades per a MySQL a SLES 12  Els paquets per a la instal·lació de servidor/proxy a SUSE Linux Enterprise Server versió 12 es creen ara amb la biblioteca MariaDB Connector/C, permetent així el xifrat de la connexió a MySQL emprant el [paràmetre] DBTLSConnect (/manual/appendix/config/zabbix_server). Els valors de xifrat admesos són "required" i "verify\_full".

en-us	#### Database TLS connection with MariaDB  Database TLS connection is not supported with the 'verify\_ca' option for the DBTLSConnect [parameter](/manual/appendix/config/zabbix_server) if MariaDB is used.
ca	#### Connexió TLS a la base de dades amb MariaDB  La connexió TLS a la base de dades no s'admet pas amb l'opció 'verify\_ca' per al [paràmeetre](/manual/appendix/config/zabbix_server) DBTLSConnect si s'empra MariaDB.

en-us	## Data collection  The Zabbix API allows you to manage the configuration of your monitoring system.
ca	### Recollida de dades  L'API Zabbix ens permet gestionar la configuració del nostre sistema de monitoratge.

en-us	#### Data collection  Virtual machine monitoring consists of two steps:  1. Zabbix *vmware collector* processes collect virtual machine data - the processes obtain necessary information from VMware web services over the SOAP protocol, pre-process it, and store it in Zabbix server shared memory.  2. Zabbix *poller* processes retrieve data using Zabbix simple check [VMware monitoring item keys](/manual/vm_monitoring/vmware_keys).  Zabbix divides collected data into VMware configuration data and VMware performance counter data. Both types of data are collected independently by the *vmware collector* processes.  The following statistics are available based on the VMware performance counter information:  - Datastore - Disk device - CPU - Power - Network interface - Custom performance counter items  For the complete list of items that obtain data from VMware performance counters, see [*VMware monitoring item keys*](/manual/vm_monitoring/vmware_keys#footnotes).
ca	#### Detalls  el monitoratge de la màquina virtual es fa en dues passes:  1. *vmware collector* de Zabbix recullen les dades de les màquines virtuals - aquests processos obtenen la informació necessària dels serveis web de VMware mitjançant el protocol SOAP, la processen prèviament i l'emmagatzemen a la memòria compartida del servidor Zabbix.  2. Els *enquestadors* recuperen aquesta informació mitjançant les [claus de monitoratge d'elements VMware](/manual/config/items/itemtypes/simple_checks/vmware_keys) de comprovacions simples de Zabbix.  Zabbix divideix les dades recollides en dades de configuració de VMware i dades de comptadors de rendiment de VMware. Tots dos tipus es recullen de manera independent pels *col·lectors de vmware*.  Les següents estadístiques són disponibles en base a la informació del comptador de rendiment de VMWare:  - Datastore - Disk device - CPU - Power - Network interface - Custom performance counter items  Veieu [*elements clau de monitoratge de VMware*](/manual/vm_monitoring/vmware_keys#footnotes) per obtindre el llistat complet d'elements que poden obtindre informació dels comptadors de rendiment de VMware.

en-us	#### Data collection with custom commands
ca	#### Recollida de dades amb comandes personalitzades

en-us	##### Data collection with parameters  Collect the content of a specific page and make use of parameters:   - Create an item with type "Script" and two parameters:     - **url : {$DOMAIN}** (the user macro {$DOMAIN} should be defined, preferably on the host level)     - **subpage : /release_notes**  ![](../../../../../assets/en/manual/config/items/itemtypes/script_example1.png){width=600}  - In the *Script* field, enter:   ```javascript var obj = JSON.parse(value); var url = obj.url; var subpage = obj.subpage; var request = new HttpRequest(); return request.get(url + subpage); ```
ca	##### Recollida de dades amb paràmetres  Recollir el contingut d'una pàgina específica i emprar els paràmetres:  - Crear un element de tipus "Script" i dos paràmetres:    - **url : {$DOMAIN}** (la macro d'usuari {$DOMAIN} s'ha de definir, preferiblement a nivell d'equip)    - **subpage : /release_notes**  ![](../../../../../assets/en/manual/config/items/itemtypes/script_example1.png){width=600}  - Al camp *Script*, posar-hi el codi següent:  ```javascript var obj = JSON.parse(value); var url = obj.url; var subpage = obj.subpage; var request = new HttpRequest(); return request.get(url + subpage); ```

en-us	#### Data flow  In addition it is important to take a step back and have a look at the overall data flow within Zabbix. In order to create an item that gathers data you must first create a host. Moving to the other end of the Zabbix spectrum you must first have an item to create a trigger. You must have a trigger to create an action. Thus if you want to receive an alert that your CPU load is too high on *Server X* you must first create a host entry for *Server X* followed by an item for monitoring its CPU, then a trigger which activates if the CPU is too high, followed by an action which sends you an email. While that may seem like a lot of steps, with the use of templating it really isn't. However, due to this design it is possible to create a very flexible setup.
ca	#### Flux de dades  A més, és important fer una passa enrere i fer una ullada al flux de dades general de Zabbix. Per crear un element que reculli dades, primer heu de crear un equip. Passant a l'altre extrem de l'espectre de Zabbix, primer heu de tindre un element per crear un triger. Heu de tindre un trigger per crear una acció. Per tant, si voleu rebre una alerta quan la vostra càrrega de CPU sigui massa alta al *Servidor X*, primer heu de crear una entrada d'equip per al *Servidor X* seguida d'un element per monitorar la seva CPU i, a continuació, un trigger que s'activarà si la CPU és massa enfeinada, seguida d'una acció que us envia un correu electrònic. Tot i que poden semblar moltes passes, amb l'ús de plantilles realment no ho són. Tanmateix, gràcies a aquest disseny, és possible crear una configuració molt flexible.

en-us	#### Data limits for return values  There is no limit for low-level discovery rule JSON data if it is received directly by Zabbix server. This is because the return values are processed without being stored in a database.  There is also no limit for custom low-level discovery rules. However, if custom low-level discovery rule data is retrieved using a user parameter, the user parameter [return value limit](/manual/config/items/userparameters#command-result) applies.  If data has to go through Zabbix proxy, it has to store this data in the database. In such a case, [database limits](/manual/config/items/item#text-data-limits) apply.
ca	#### Límit de dades per els valors de retorn  No hi ha límit per a les dades JSON de la regla de descoberta de baix nivell si es reben directament pel servidor Zabbix. Això és així perquè els valors de retorn es processen sense emmagatzemar-se en una base de dades.  Tampoc hi ha límit per a les regles de descoberta de baix nivell personalitzades. Però si es pretén aconseguir dades LLD personalitzades mitjançant un paràmetre d'usuari, s'aplica el [valor límit](/manual/config/items/userparameters#command-result) de la configuració d'usuari.  Si les dades han de passar pel proxy Zabbix, s'han d'emmagatzemar a la base de dades perquè s'hi apliquin els [límits de la base de dades](/manual/config/items/item#text-data-limits).

en-us	##### Data request  The `proxy data` request is sent by proxy to provide host interface availability, history, discovery and autoregistration data. This request is sent every `DataSenderFrequency` (proxy configuration parameter) seconds. Note that active proxy will still poll Zabbix server every second for remote command tasks (with an empty `proxy data` request).  |name|<|value type|description| |-|----------|----------|----------------------------------------| |proxy→server:|<|<|<| |**request**|<|*string*|'proxy data'| |**host**|<|*string*|Proxy name.| |**session**|<|*string*|Data session token.| |**interface availability**|<|*array*|*(optional)* Array of interface availability data objects.| | |**interfaceid**|*number*|Interface identifier.| |^|**available**|*number*|Interface availability:<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - unknown<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - available<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - unavailable| |^|**error**|*string*|Interface error message or empty string.| |**history data**|<|*array*|*(optional)* Array of history data objects.| | |**itemid**|*number*|Item identifier.| |^|**clock**|*number*|Item value timestamp (seconds).| |^|**ns**|*number*|Item value timestamp (nanoseconds).| |^|**value**|*string*|*(optional)* Item value.| |^|**id**|*number*|Value identifier (ascending counter, unique within one data session).| |^|**timestamp**|*number*|*(optional)* Timestamp of log type items.| |^|**source**|*string*|*(optional)* Eventlog item source value.| |^|**severity**|*number*|*(optional)* Eventlog item severity value.| |^|**eventid**|*number*|*(optional)* Eventlog item eventid value.| |^|**state**|*string*|*(optional)* Item state:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(optional)* Last log size of log type items.| |^|**mtime**|*number*|*(optional)* Modification time of log type items.| |**discovery data**|<|*array*|*(optional)* Array of discovery data objects.| | |**clock**|*number*|Discovery data timestamp.| |^|**druleid**|*number*|Discovery rule identifier.| |^|**dcheckid**|*number*|Discovery check identifier or null for discovery rule data.| |^|**type**|*number*|Discovery check type:<br><br>**-1** discovery rule data<br>**0**, *SVC\_SSH* - SSH service check<br>**1**, *SVC\_LDAP* - LDAP service check<br>**2**, *SVC\_SMTP* - SMTP service check<br>**3**, *SVC\_FTP* - FTP service check<br>**4**, *SVC\_HTTP* - HTTP service check<br>**5**, *SVC\_POP* - POP service check<br>**6**, *SVC\_NNTP* - NNTP service check<br>**7**, *SVC\_IMAP* - IMAP service check<br>**8**, *SVC\_TCP* - TCP port availability check<br>**9**, *SVC\_AGENT* - Zabbix agent<br>**10**, *SVC\_SNMPv1* - SNMPv1 agent<br>**11**, *SVC\_SNMPv2* - SNMPv2 agent<br>**12**, *SVC\_ICMPPING* - ICMP ping<br>**13**, *SVC\_SNMPv3* - SNMPv3 agent<br>**14**, *SVC\_HTTPS* - HTTPS service check<br>**15**, *SVC\_TELNET* - Telnet availability check| |^|**ip**|*string*|Host IP address.| |^|**dns**|*string*|Host DNS name.| |^|**port**|*number*|*(optional)* Service port number.| |^|**key\_**|*string*|*(optional)* Item key for discovery check of type **9** *SVC\_AGENT*| |^|**value**|*string*|*(optional)* Value received from the service, can be empty for most services.| |^|**status**|*number*|*(optional)* Service status:<br><br>**0**, *DOBJECT\_STATUS\_UP* - Service UP<br>**1**, *DOBJECT\_STATUS\_DOWN* - Service DOWN| |**autoregistration**|<|*array*|*(optional)* Array of autoregistration data objects.| | |**clock**|*number*|Autoregistration data timestamp.| |^|**host**|*string*|Host name.| |^|**ip**|*string*|*(optional)* Host IP address.| |^|**dns**|*string*|*(optional)* Resolved DNS name from IP address.| |^|**port**|*string*|*(optional)* Host port.| |^|**host\_metadata**|*string*|*(optional)* Host metadata sent by agent (based on HostMetadata or HostMetadataItem agent configuration parameter).| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - remote command result| |^|**status**|*number*|Remote-command execution status:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - remote command completed successfully<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - remote command failed| |^|**error**|*string*|*(optional)* Error message.| |^|**parent\_taskid**|*number*|Parent task ID.| |**more**|<|*number*|*(optional)* 1 - there are more history data to send| |**clock**|<|*number*|*(optional)* Data transfer timestamp (seconds).| |**ns**|<|*number*|*(optional)* Data transfer timestamp (nanoseconds).| |**version**|<|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Request success information ('success' or 'failed').| |**upload**|<|*string*|Upload control for historical data (history, autoregistration, host availability, network discovery).<br><br>Possible values:<br>**enabled** - normal operation<br>**disabled** - server is not accepting data (possibly due to internal cache over limit)| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - remote command| |^|**clock**|*number*|Task creation time.| |^|**ttl**|*number*|Time in seconds after which the task expires.| |^|**commandtype**|*number*|Remote-command type:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - use custom script<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - use IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - use SSH<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - use Telnet<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - use global script (currently functionally equivalent to custom script)| |^|**command**|*string*|Remote command to execute.| |^|**execute\_on**|*number*|Execution target for custom scripts:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - execute script on agent<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - execute script on server<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - execute script on proxy| |^|**port**|*number*|*(optional)* Port for Telnet and SSH commands.| |^|**authtype**|*number*|*(optional)* Authentication type for SSH commands.| |^|**username**|*string*|*(optional)* User name for Telnet and SSH commands.| |^|**password**|*string*|*(optional)* Password for Telnet and SSH commands.| |^|**publickey**|*string*|*(optional)* Public key for SSH commands.| |^|**privatekey**|*string*|*(optional)* Private key for SSH commands.| |^|**parent\_taskid**|*number*|Parent task ID.| |^|**hostid**|*number*|Target host ID.|  Example:  proxy→server:  ``` {.javascript} {  "request": "proxy data",  "host": "Zabbix proxy",  "session": "818cdd1b537bdc5e50c09ed4969235b6",  "interface availability": [{   "interfaceid": 1,   "available": 1,   "error": ""  }],  "history data": [{   "id": 1114,   "itemid": 44162,   "clock": 1665730632,   "ns": 798953105,   "value": "1"  }, {   "id": 1115,   "itemid": 44161,   "clock": 1665730633,   "ns": 811684663,   "value": "58"  }],  "auto registration": [{   "clock": 1665730633,   "host": "Zabbix server",   "ip": "127.0.0.1",   "dns": "localhost",   "port": "10053",   "host_metadata": "58",   "tls_accepted": 1  }],  "discovery data": [{   "clock": 1665732232,   "drule": 2,   "dcheck": 2,   "ip": "127.0.0.1",   "dns": "localhost",   "port": 10052,   "status": 1  }, {   "clock": 1665732232,   "drule": 2,   "dcheck": null,   "ip": "127.0.0.1",   "dns": "localhost",   "status": 1  }],  "host data": [{   "hostid": 10084,   "active_status": 1  }],  "tasks": [{   "type": 3,   "clock": 1665730985,   "ttl": 0,   "status": -1,   "info": "Remote commands are not enabled",   "parent_taskid": 3  }],  "version": "6.4.0",  "clock": 1665730643,  "ns": 65389964 } ```  server→proxy:  ``` {.javascript} {  "upload": "enabled",  "response": "success",  "tasks": [{   "type": 2,   "clock": 1665730986,   "ttl": 600,   "commandtype": 0,   "command": "ping -c 3 127.0.0.1; case $? in [01]) true;; *) false;; esac",   "execute_on": 2,   "port": 0,   "authtype": 0,   "username": "",   "password": "",   "publickey": "",   "privatekey": "",   "alertid": 0,   "parent_taskid": 4,   "hostid": 10084  }] } ```
ca	##### Petició de dades del proxy  Les peticions `proxy data` s'envien per el proxy per proporcionar dades de disponibilitat, històric, descoberta i autoregistre de la interfície de l'equip. Aquesta patició s'envia cada `DataSenderFrequency` segons (paràmetre de configuració del proxy). Veieu que el proxy actiu anirà informant al servidor Zabbix cada segon de tasques de comandes remotes (amb una petició `proxy data` buida).  |nom|<|tipus de valor|descripció| |-|----------|----------|----------------------------------------| |proxy→server:|<|<|<| |**request**|<|*string*|'proxy data'| |**host**|<|*string*|Nom del proxy.| |*session*|<|*string*|Fitxa de sessió de dades.| |**interface availability**|<|*array*|*(opcional)* Matriu d'objectes de dades de disponibilitat de la interfície.| | |**interfaceid**|*number*|Identificador de la interfície.| |^|**available**|*number*|Disponibilitat de la interfície:<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - desconegut<br>**1**, *INTERFACE\_AVAILABLE \_TRUE* - disponible<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - no disponible| |^|**error**|*string*|Missatge d'error de la interfície o cadena buida.| |**history data**|<|*array*|*(opcional)* Matriu d'objectes de dades de l'historial.| | |**itemid**|*number*|Identificador de l'element.| |^|**clock**|*number*|Marca de temps del valor de l'element (segons).| |^|**ns**|*number*|Marca de temps del valor de l'element (nanosegons).| |^|*value*|*string*|*(opcional)* Valor de l'element.| |^|**id**|*number*|Identificador del valor (comptador ascendent, únic en una sessió de dades).| |^|**timestamp**|*number*|*(opcional)* Marca de temps dels elements del tipus de registre.| |^|**source**|*string*|*(opcional)* Valor font de l'element del registre d'esdeveniments.| |^|**severity**|*number*|*(opcional)* Valor de gravetat de l'element del registre d'esdeveniments.| |^|**eventid**|*number*|*(opcional)* Valor d'event de l'element del registre d'esdeveniments.| |^|**status**|*string*|*(opcional)* Estat de l'element:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE \_NO SUPORT*| |^|**lastlogsize**|*number*|*(opcional)* Mida del darrer registre dels elements del tipus de registre.| |^|**mtime**|*number*|*(opcional)* Hora de modificació dels elements del tipus de registre.| |**discovery data**|<|*array*|*(opcional)* Matriu d'objectes de dades de descoberta.| | |**clock**|*number*|Marca de temps de les dades de descoberta.| |^|**druleid**|*number*|Identificador de la regla de descoberta.| |^|**dcheckid**|*number*|Identificador de comprovació de descoberta o nul per a les dades de la regla de descoberta.| |^|**type**|*number*|Tipus de comprovació de descoberta:<br><br>**-1** dades de la regla de descoberta<br>**0**, *SVC\_SSH* - Comprovació del servei SSH <br>**1**, *SVC\_LDAP* - Comprovació del servei LDAP<br>**2**, *SVC\_SMTP* - Comprovació del servei SMTP<br>**3**, *SVC\_FTP* - Comprovació del servei FTP<br>**4**, *SVC\_HTTP* - Comprovació del servei HTTP<br>**5**, *SVC\_POP* - Comprovació del servei POP<br>**6**, * SVC\_NNTP* - Comprovació del servei NNTP<br>**7**, *SVC\_IMAP* - Comprovació del servei IMAP<br>**8**, *SVC\_TCP* - Comprovació de la disponibilitat del port TCP<br>** 9**, *SVC\_AGENT* - agent Zabbix<br>**10**, *SVC\_SNMPv1* - agent SNMPv1<br>**11**, *SVC\_SNMPv2* - agent SNMPv2<br>* *12**, *SVC\_ICMPPING* - Ping ICMP<br>**13**, *SVC\_SNMPv3* - Agent SNMPv3<br>**14**, *SVC\_HTTPS* - Comprovació del servei HTTPS<br >**15**, *SVC\_TELNET* - Comprovació de disponibilitat de Telnet| |^|**ip**|*string*|Adreça IP de l'equip.| |^|**dns**|*string*|Nom DNS de l'equip.| |^|**port**|*number*|*(opcional)* Número de port de servei.| |^|**key\_**|*string*|*(opcional)* Clau d'element per a la comprovació de descoberta de tipus **9** *SVC\_AGENT*| |^|*value*|*string*|*(opcional)* Valor rebut del servei, pot estar buit per a la majoria de serveis.| |^|**status**|*number*|*(opcional)* Estat del servei:<br><br>**0**, *DOBJECT\_STATUS\_UP* - Servei UP<br>**1* *, *DOBJECT\_STATUS\_DOWN* - Servei DOWN| |**autoregistration**|<|*array*|*(opcional)* Matriu d'objectes de dades d'autoregistre.| | |**clock**|*number*|Marca de temps de dades de registre automàtic.| |^|**host**|*string*|Nom de l'equip.| |^|**ip**|*string*|*(opcional)* Adreça IP de l'equip.| |^|**dns**|*string*|*(opcional)* S'ha resolt el nom DNS des de l'adreça IP.| |^|**port**|*string*|*(opcional)* Port equip.| |^|**host\_metadata**|*string*|*(opcional)* Metadades de l'equip enviades per l'agent (segons el paràmetre de configuració de l'agent HostMetadata o HostMetadataItem).| |**tasks**|<|*array*|*(opcional)* Matriu de tasques.| | |**type**|*number*|Tipus de tasca:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - resultat de la comanda remota| |^|**status**|*number*|Estat d'execució de l'ordre remot:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED*: l'ordre remota s'ha completat correctament<br> **1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - l'ordre remota ha fallat| |^|**error**|*string*|*(opcional)* Missatge d'error.| |^|**parent\_taskid**|*number*|ID de la tasca principal.| |**more**|<|*number*|*(opcional)* 1 - hi ha més dades de l'historial per enviar.| |**clock**|<|*number*|*(opcional)* Marca de temps de transferència de dades (segons).| |**ns**|<|*number*|*(opcional)* Marca de temps de transferència de dades (nanosegons).| |**version**|<|*string*|Versió del proxy (<major>.<menor>.<build>).| |servidor→proxy:|<|<|<| |**response**|<|*string*|Demanar informació sobre l'èxit ('èxit' o 'error').| |**upload**|<|*string*|Control de càrrega de dades històriques (historial, registre automàtic, disponibilitat de l'equip, descoberta de xarxa).<br><br>Valors possibles:<br>**activat** - funcionament normal <br>**desactivat**: el servidor no admet dades (possiblement a causa del límit de la memòria cau interna)| |**tasks**|<|*array*|*(opcional)* Matriu de tasques.| | |**type**|*number*|Tipus de tasca:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - comanda remota| |^|**clock**|*number*|Hora de creació de la tasca.| |^|**ttl**|*number*|Temps en segons després del qual caduca la tasca.| |^|**commandtype**|*number*|Tipus de comanda remota:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT*: utilitzeu un script personalitzat<br>** 1**, *ZBX\_SCRIPT\_TIP\_IPMI*: utilitza IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH*: utilitza SSH<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET*: utilitza Telnet<br> **4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - utilitza script global (actualment equival a un script personalitzat)| |^|**ordre**|*string*|Ordre remota per executar.| |^|**execute\_on**|*number*|Destí d'execució per a scripts personalitzats:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - executa l'script a l'agent< br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - executa l'script al servidor<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - executa l'script al proxy| |^|**port**|*number*|*(opcional)* Port per a ordres Telnet i SSH.| |^|**authtype**|*number*|*(opcional)* Tipus d'autenticació per a ordres SSH.| |^|**username**|*string*|*(opcional)* Nom d'usuari per a ordres Telnet i SSH.| |^|**password**|*string*|*(opcional)* Mot de pas per a ordres Telnet i SSH.| |^|**publickey**|*string*|*(opcional)* Clau pública per a ordres SSH.| |^|**privatekey**|*string*|*(opcional)* Clau privada per a ordres SSH.| |^|**parent\_taskid**|*number*|ID de la tasca principal.| |^|**hostid**|*number*|ID de l'equip objectiu.|  Exemple:  proxy→server:  ``` {.javascript} { "request": "proxy data", "host": "Zabbix proxy", "session": "818cdd1b537bdc5e50c09ed4969235b6", "interface availability": [{ "interfaceid": 1, "available": 1, "error": "" }], "history data": [{ "id": 1114, "itemid": 44162, "clock": 1665730632, "ns": 798953105, "value": "1" }, { "id": 1115, "itemid": 44161, "clock": 1665730633, "ns": 811684663, "value": "58" }], "auto registration": [{ "clock": 1665730633, "host": "Zabbix server", "ip": "127.0.0.1", "dns": "localhost", "port": "10053", "host_metadata": "58", "tls_accepted": 1 }], "discovery data": [{ "clock": 1665732232, "drule": 2, "dcheck": 2, "ip": "127.0.0.1", "dns": "localhost", "port": 10052, "status": 1 }, { "clock": 1665732232, "drule": 2, "dcheck": null, "ip": "127.0.0.1", "dns": "localhost", "status": 1 }], "host data": [{ "hostid": 10084, "active_status": 1 }], "tasks": [{ "type": 3, "clock": 1665730985, "ttl": 0, "status": -1, "info": "Remote commands are not enabled", "parent_taskid": 3 }], "version": "6.4.0", "clock": 1665730643, "ns": 65389964 } ```  server→proxy:  ``` {.javascript} { "upload": "enabled", "response": "success", "tasks": [{ "type": 2, "clock": 1665730986, "ttl": 600, "commandtype": 0, "command": "ping -c 3 127.0.0.1; case $? in [01]) true;; *) false;; esac", "execute_on": 2, "port": 0, "authtype": 0, "username": "", "password": "", "publickey": "", "privatekey": "", "alertid": 0, "parent_taskid": 4, "hostid": 10084 }] } ```

en-us	##### Data request  The `proxy data` request is used to obtain host interface availability, historical, discovery and autoregistration data from proxy. This request is sent every `ProxyDataFrequency` (server configuration parameter) seconds.  |name|<|value type|description| |-|----------|----------|----------------------------------------| |server→proxy:|<|<|<| |**request**|<|*string*|'proxy data'| |proxy→server:|<|<|<| |**session**|<|*string*|Data session token.| |**interface availability**|<|*array*|*(optional)* Array of interface availability data objects.| | |**interfaceid**|*number*|Interface identifier.| |^|**available**|*number*|Interface availability:<br><br>**0**, *INTERFACE\_AVAILABLE\_UNKNOWN* - unknown<br>**1**, *INTERFACE\_AVAILABLE\_TRUE* - available<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - unavailable| |^|**error**|*string*|Interface error message or empty string.| |**history data**|<|*array*|*(optional)* Array of history data objects.| | |**itemid**|*number*|Item identifier.| |^|**clock**|*number*|Item value timestamp (seconds).| |^|**ns**|*number*|Item value timestamp (nanoseconds).| |^|**value**|*string*|*(optional)* Item value.| |^|**id**|*number*|Value identifier (ascending counter, unique within one data session).| |^|**timestamp**|*number*|*(optional)* Timestamp of log type items.| |^|**source**|*string*|*(optional)* Eventlog item source value.| |^|**severity**|*number*|*(optional)* Eventlog item severity value.| |^|**eventid**|*number*|*(optional)* Eventlog item eventid value.| |^|**state**|*string*|*(optional)* Item state:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE\_NOTSUPPORTED*| |^|**lastlogsize**|*number*|*(optional)* Last log size of log type items.| |^|**mtime**|*number*|*(optional)* Modification time of log type items.| |**discovery data**|<|*array*|*(optional)* Array of discovery data objects.| | |**clock**|*number*|Discovery data timestamp.| |^|**druleid**|*number*|Discovery rule identifier.| |^|**dcheckid**|*number*|Discovery check identifier or null for discovery rule data.| |^|**type**|*number*|Discovery check type:<br><br>**-1** discovery rule data<br>**0**, *SVC\_SSH* - SSH service check<br>**1**, *SVC\_LDAP* - LDAP service check<br>**2**, *SVC\_SMTP* - SMTP service check<br>**3**, *SVC\_FTP* - FTP service check<br>**4**, *SVC\_HTTP* - HTTP service check<br>**5**, *SVC\_POP* - POP service check<br>**6**, *SVC\_NNTP* - NNTP service check<br>**7**, *SVC\_IMAP* - IMAP service check<br>**8**, *SVC\_TCP* - TCP port availability check<br>**9**, *SVC\_AGENT* - Zabbix agent<br>**10**, *SVC\_SNMPv1* - SNMPv1 agent<br>**11**, *SVC\_SNMPv2* - SNMPv2 agent<br>**12**, *SVC\_ICMPPING* - ICMP ping<br>**13**, *SVC\_SNMPv3* - SNMPv3 agent<br>**14**, *SVC\_HTTPS* - HTTPS service check<br>**15**, *SVC\_TELNET* - Telnet availability check| |^|**ip**|*string*|Host IP address.| |^|**dns**|*string*|Host DNS name.| |^|**port**|*number*|*(optional)* Service port number.| |^|**key\_**|*string*|*(optional)* Item key for discovery check of type **9** *SVC\_AGENT*| |^|**value**|*string*|*(optional)* Value received from the service, can be empty for most of services.| |^|**status**|*number*|*(optional)* Service status:<br><br>**0**, *DOBJECT\_STATUS\_UP* - Service UP<br>**1**, *DOBJECT\_STATUS\_DOWN* - Service DOWN| |**auto registration**|<|*array*|*(optional)* Array of autoregistration data objects.| | |**clock**|*number*|Autoregistration data timestamp.| |^|**host**|*string*|Host name.| |^|**ip**|*string*|*(optional)* Host IP address.| |^|**dns**|*string*|*(optional)* Resolved DNS name from IP address.| |^|**port**|*string*|*(optional)* Host port.| |^|**host\_metadata**|*string*|*(optional)* Host metadata sent by agent (based on HostMetadata or HostMetadataItem agent configuration parameter).| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - remote command result| |^|**status**|*number*|Remote-command execution status:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED* - remote command completed successfully<br>**1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - remote command failed| |^|**error**|*string*|*(optional)* Error message.| |^|**parent\_taskid**|*number*|Parent task ID.| |**more**|<|*number*|*(optional)* 1 - there are more history data to send.| |**clock**|<|*number*|*(optional)* Data transfer timestamp (seconds).| |**ns**|<|*number*|*(optional)* Data transfer timestamp (nanoseconds).| |**version**|<|*string*|Proxy version (<major>.<minor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Request success information ('success' or 'failed').| |**tasks**|<|*array*|*(optional)* Array of tasks.| | |**type**|*number*|Task type:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - remote command| |^|**clock**|*number*|Task creation time.| |^|**ttl**|*number*|Time in seconds after which the task expires.| |^|**commandtype**|*number*|Remote-command type:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT* - use custom script<br>**1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - use IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - use SSH<br>**3**, *ZBX\_SCRIPT\_TYPE\_TELNET* - use Telnet<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT* - use global script (currently functionally equivalent to custom script)| |^|**command**|*string*|Remote command to execute.| |^|**execute\_on**|*number*|Execution target for custom scripts:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - execute script on agent<br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - execute script on server<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - execute script on proxy| |^|**port**|*number*|*(optional)* Port for Telnet and SSH commands.| |^|**authtype**|*number*|*(optional)* Authentication type for SSH commands.| |^|**username**|*string*|*(optional)* User name for Telnet and SSH commands.| |^|**password**|*string*|*(optional)* Password for Telnet and SSH commands.| |^|**publickey**|*string*|*(optional)* Public key for SSH commands.| |^|**privatekey**|*string*|*(optional)* Private key for SSH commands.| |^|**parent\_taskid**|*number*|Parent task ID.| |^|**hostid**|*number*|Target host ID.|  Example:  server→proxy:  ``` {.javascript} {   "request": "proxy data" } ```  proxy→server:  ``` {.javascript} {     "session": "12345678901234567890123456789012"     "interface availability": [         {             "interfaceid": 1,             "available": 1,             "error": ""     },         {             "interfaceid": 2,             "available": 2,             "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused"     },         {             "interfaceid": 3,             "available": 1,             "error": ""     },         {             "interfaceid": 4,             "available": 1,             "error": ""     }     ],     "history data":[         {             "itemid":"12345",             "clock":1478609647,             "ns":332510044,             "value":"52956612",             "id": 1         },         {             "itemid":"12346",             "clock":1478609647,             "ns":330690279,             "state":1,             "value":"Cannot find information for this network interface in /proc/net/dev.",             "id": 2         }     ],     "discovery data":[         {             "clock":1478608764,             "drule":2,             "dcheck":3,             "type":12,             "ip":"10.3.0.10",             "dns":"vdebian",             "status":1         },         {             "clock":1478608764,             "drule":2,             "dcheck":null,             "type":-1,             "ip":"10.3.0.10",             "dns":"vdebian",             "status":1         }     ],     "auto registration":[         {             "clock":1478608371,             "host":"Logger1",             "ip":"10.3.0.1",             "dns":"localhost",             "port":"10050"         },         {             "clock":1478608381,             "host":"Logger2",             "ip":"10.3.0.2",             "dns":"localhost",             "port":"10050"         }     ],     "tasks":[         {             "type": 0,             "status": 0,             "parent_taskid": 10         },         {             "type": 0,             "status": 1,             "error": "No permissions to execute task.",             "parent_taskid": 20         }     ],     "version":"6.4.0" } ```  server→proxy:  ``` {.javascript} {   "response": "success",   "tasks":[       {          "type": 1,          "clock": 1478608371,          "ttl": 600,          "commandtype": 2,          "command": "restart_service1.sh",          "execute_on": 2,          "port": 80,          "authtype": 0,          "username": "userA",          "password": "password1",          "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",          "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",          "parent_taskid": 10,          "hostid": 10070       },       {          "type": 1,          "clock": 1478608381,          "ttl": 600,          "commandtype": 1,          "command": "restart_service2.sh",          "execute_on": 0,          "authtype": 0,          "username": "",          "password": "",          "publickey": "",          "privatekey": "",          "parent_taskid": 20,          "hostid": 10084       }   ] } ```
ca	##### Petició del proxy  La petició de `proxy data` s'empra per obtindre dades de disponibilitat de la interfície d'equip, dades històriques, de descobriment i registre automàtic del proxy. Aquesta petició s'envia cada `ProxyDataFrequency` segons (paràmetre de configuració del servidor).  |nom|<|tipus de valor|descripció| |-|-----------|-----------|--------------------------- ----------------| |server→proxy:|<|<|<| |**sol·licitud**|<|*string*|'informació del proxy'| |proxy→server:|<|<|<| |**session**|<|*string*|Fitxa de sessió de dades.| |**interface availability**|<|*array*|*(opcional)* Matriu d'objectes de dades de disponibilitat de la interfície.| | |**interfaceid**|*number*|Identificador de la interfície.| |^|**available**|*number*|Disponibilitat de la interfície:<br><br>**0**, *INTERFACE\_AVAILABLE\UNKNOWN* - desconegut<br>**1**, *INTERFACE\_AVAILABLE \_TRUE* - disponible<br>**2**, *INTERFACE\_AVAILABLE\_FALSE* - no disponible| |^|**error**|*string*|Missatge d'error de la interfície o cadena buida.| |**history data**|<|*array*|*(opcional)* Matriu d'objectes de dades de l'historial.| | |**itemid**|*number*|Identificador de l'element.| |^|**clock**|*number*|Marca de temps del valor de l'element (segons).| |^|**ns**|*number*|Marca de temps del valor de l'element (nanosegons).| |^|**value**|*string*|*(opcional)* Valor de l'element.| |^|**id**|*number*|Identificador del valor (comptador ascendent, únic en una sessió de dades).| |^|**timestamp**|*number*|*(opcional)* Marca de temps dels elements del tipus de registre.| |^|**source**|*string*|*(opcional)* Valor font de l'element del registre d'esdeveniments.| |^|**severity**|*number*|*(opcional)* Valor de gravetat de l'element del registre d'esdeveniments.| |^|**eventid**|*number*|*(opcional)* Valor d'event de l'element del registre d'esdeveniments.| |^|**status**|*string*|*(opcional)* Estat de l'element:<br>**0**, *ITEM\_STATE\_NORMAL*<br>**1**, *ITEM\_STATE \_NO SUPORT*| |^|**lastlogsize**|*number*|*(opcional)* Mida del darrer registre dels elements del tipus de registre.| |^|**mtime**|*number*|*(opcional)* Hora de modificació dels elements del tipus de registre.| |**discovery data**|<|*array*|*(opcional)* Matriu d'objectes de dades de descoberta.| | |**clock**|*number*|Marca de temps de les dades de descoberta.| |^|**druleid**|*number*|Identificador de la regla de descoberta.| |^|**dcheckid**|*number*|Identificador de comprovació de descoberta o res per a les dades de la regla de descoberta.| |^|**type**|*number*|Tipus de comprovació de descoberta:<br><br>**-1** dades de la regla de descoberta<br>**0**, *SVC\_SSH* - Comprovació del servei SSH <br>**1**, *SVC\_LDAP* - Comprovació del servei LDAP<br>**2**, *SVC\_SMTP* - Comprovació del servei SMTP<br>**3**, *SVC\_FTP* - Comprovació del servei FTP<br>**4**, *SVC\_HTTP* - Comprovació del servei HTTP<br>**5**, *SVC\_POP* - Comprovació del servei POP<br>**6**, * SVC\_NNTP* - Comprovació del servei NNTP<br>**7**, *SVC\_IMAP* - Comprovació del servei IMAP<br>**8**, *SVC\_TCP* - Comprovació de la disponibilitat del port TCP<br>** 9**, *SVC\_AGENT* - agent Zabbix<br>**10**, *SVC\_SNMPv1* - agent SNMPv1<br>**11**, *SVC\_SNMPv2* - agent SNMPv2<br>* *12**, *SVC\_ICMPPING* - Ping ICMP<br>**13**, *SVC\_SNMPv3* - Agent SNMPv3<br>**14**, *SVC\_HTTPS* - Comprovació del servei HTTPS<br >**15**, *SVC\_TELNET* - Comprovació de disponibilitat de Telnet| |^|**ip**|*string*|Adreça IP de l'equip.| |^|**dns**|*string*|Nom DNS de l'equip.| |^|**port**|*number*|*(opcional)* Nombre de port de servei.| |^|**key\_**|*string*|*(opcional)* Clau d'element per a la comprovació de descoberta de tipus **9** *SVC\_AGENT*| |^|**value**|*string*|*(opcional)* Valor rebut del servei, pot estar buit per a la majoria de serveis.| |^|**status**|*number*|*(opcional)* Estat del servei:<br><br>**0**, *DOBJECT\_STATUS\_UP* - Servei UP<br>**1* *, *DOBJECT\_STATUS\_DOWN* - Servei DOWN| |**auto registration**|<|*array*|*(opcional)* Matriu d'objectes de dades de registre automàtic.| | |**clock**|*number*|Marca de temps de dades de registre automàtic.| |^|**host**|*string*|Nom de l'equip.| |^|**ip**|*string*|*(opcional)* Adreça IP de l'equip.| |^|**dns**|*string*|*(opcional)* S'ha resolt el nom DNS des de l'adreça IP.| |^|**port**|*string*|*(opcional)* Port de l'equip.| |^|**host\_metadata**|*string*|*(opcional)* Metadades de l'equip enviades per l'agent (basades en el paràmetre de configuració de l'agent HostMetadata o HostMetadataItem).| |**tasks**|<|*array*|*(opcional)* Matriu de tasques.| | |**type**|*number*|Tipus de tasca:<br><br>**0**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND\_RESULT* - resultat de la comanda remota| |^|**status**|*number*|Estat d'execució de l'ordre remota:<br><br>**0**, *ZBX\_TM\_REMOTE\_COMMAND\_COMPLETED*: l'ordre remota s'ha completat correctament<br> **1**, *ZBX\_TM\_REMOTE\_COMMAND\_FAILED* - l'ordre remota ha fallat| |^|**error**|*string*|*(opcional)* Missatge d'error.| |^|**parent\_taskid**|*number*|ID de la tasca principal.| |**more**|<|*number*|*(opcional)* 1 - hi ha més dades de l'historial per enviar.| |**clock**|<|*number*|*(opcional)* Marca de temps de transferència de dades (segons).| |**ns**|<|*number*|*(opcional)* Marca de temps de transferència de dades (nanosegons).| |**version**|<|*string*|Versió del proxy (<major>.<menor>.<build>).| |server→proxy:|<|<|<| |**response**|<|*string*|Demanar informació sobre l'èxit ('èxit' o 'error').| |**tasks**|<|*array*|*(opcional)* Matriu de tasques.| | |**type**|*number*|Tipus de tasca:<br><br>**1**, *ZBX\_TM\_TASK\_PROCESS\_REMOTE\_COMMAND* - comanda remota| |^|**clock**|*number*|Hora de creació de la tasca.| |^|**ttl**|*number*|Temps en segons després del qual caduca la tasca.| |^|**commandtype**|*number*|Tipus de comanda remota:<br><br>**0**, *ZBX\_SCRIPT\_TYPE\_CUSTOM\_SCRIPT*: empreu un script personalitzat<br>** 1**, *ZBX\_SCRIPT\_TYPE\_IPMI* - emprar IPMI<br>**2**, *ZBX\_SCRIPT\_TYPE\_SSH* - emprar SSH<br>**3**, *ZBX\_SCRIPT \_TYPE\_TELNET*: empra Telnet<br>**4**, *ZBX\_SCRIPT\_TYPE\_GLOBAL\_SCRIPT*: empra un script lobal (actualment equivalent funcionalment a script personalitzat)| |^|**command**|*string*|Ordre remota per executar.| |^|**execute\_on**|*number*|Destí d'execució per a scripts personalitzats:<br><br>**0**, *ZBX\_SCRIPT\_EXECUTE\_ON\_AGENT* - executa l'script a l'agent< br>**1**, *ZBX\_SCRIPT\_EXECUTE\_ON\_SERVER* - executa l'script al servidor<br>**2**, *ZBX\_SCRIPT\_EXECUTE\_ON\_PROXY* - executa l'script al proxy| |^|**port**|*number*|*(opcional)* Port per a ordres Telnet i SSH.| |^|**authtype**|*number*|*(opcional)* Tipus d'autenticació per a ordres SSH.| |^|**username**|*string*|*(opcional)* Nom d'usuari per a ordres Telnet i SSH.| |^|**password**|*string*|*(opcional)* Mot de pas per a ordres Telnet i SSH.| |^|**publickey**|*string*|*(opcional)* Clau pública per a ordres SSH.| |^|**privatekey**|*string*|*(opcional)* Clau privada per a ordres SSH.| |^|**parent\_taskid**|*number*|ID de la tasca principal.| |^|**hostid**|*number*|ID de l'equip objectiu.|  Exemple:  server→proxy:  ``` {.javascript} {   "request": "proxy data" } ```  proxy→server:  ``` {.javascript} {     "session": "12345678901234567890123456789012"     "interface availability": [         {             "interfaceid": 1,             "available": 1,             "error": ""     },         {             "interfaceid": 2,             "available": 2,             "error": "Get value from agent failed: cannot connect to [[127.0.0.1]:10049]: [111] Connection refused"     },         {             "interfaceid": 3,             "available": 1,             "error": ""     },         {             "interfaceid": 4,             "available": 1,             "error": ""     }     ],     "history data":[         {             "itemid":"12345",             "clock":1478609647,             "ns":332510044,             "value":"52956612",             "id": 1         },         {             "itemid":"12346",             "clock":1478609647,             "ns":330690279,             "state":1,             "value":"Cannot find information for this network interface in /proc/net/dev.",             "id": 2         }     ],     "discovery data":[         {             "clock":1478608764,             "drule":2,             "dcheck":3,             "type":12,             "ip":"10.3.0.10",             "dns":"vdebian",             "status":1         },         {             "clock":1478608764,             "drule":2,             "dcheck":null,             "type":-1,             "ip":"10.3.0.10",             "dns":"vdebian",             "status":1         }     ],     "auto registration":[         {             "clock":1478608371,             "host":"Logger1",             "ip":"10.3.0.1",             "dns":"localhost",             "port":"10050"         },         {             "clock":1478608381,             "host":"Logger2",             "ip":"10.3.0.2",             "dns":"localhost",             "port":"10050"         }     ],     "tasks":[         {             "type": 0,             "status": 0,             "parent_taskid": 10         },         {             "type": 0,             "status": 1,             "error": "No permissions to execute task.",             "parent_taskid": 20         }     ],         "version":"5.4.0" } ```  server→proxy:  ``` {.javascript} {   "response": "success",   "tasks":[       {          "type": 1,          "clock": 1478608371,          "ttl": 600,          "commandtype": 2,          "command": "restart_service1.sh",          "execute_on": 2,          "port": 80,          "authtype": 0,          "username": "userA",          "password": "password1",          "publickey": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCqGKukO1De7zhZj6+H0qtjTkVxwTCpvKe",          "privatekey": "lsuusFncCzWBQ7RKNUSesmQRMSGkVb1/3j+skZ6UtW+5u09lHNsj6tQ5QCqGKukO1De7zhd",          "parent_taskid": 10,          "hostid": 10070       },       {          "type": 1,          "clock": 1478608381,          "ttl": 600,          "commandtype": 1,          "command": "restart_service2.sh",          "execute_on": 0,          "authtype": 0,          "username": "",          "password": "",          "publickey": "",          "privatekey": "",          "parent_taskid": 20,          "hostid": 10084       }   ] } ```

en-us	##### DataSenderFrequency  The proxy will send collected data to the server every N seconds. Note that an active proxy will still poll Zabbix server every second for remote command tasks.<br>Active proxy parameter. Ignored for passive proxies (see ProxyMode parameter).  Default: `1`<br> Range: 1-3600
ca	##### DataSenderFrequency  El proxy enviarà les dades recollides al servidor cada N segons. Tingueu en compte que un proxy actiu seguirà consultant el servidor Zabbix cada segon per a tasques d'ordres remotes.<br>Paràmetre de proxy actiu. S'ignora per als proxys passius (veieu el paràmetre ProxyMode).  Per defecte: `1`<br> Rang: 1-3600

en-us	 ##### Data set configuration details  The *host pattern* and *item pattern* fields in the *Data set* tab both recognize full names or patterns containing a wildcard symbol (\*). This functionality enables to select all the host names and item names containing the selected pattern. Most importantly, while typing the item name or item pattern in the *item pattern* field, only the items that belong to the selected host name(s) are displayed on a drop-down list. For example, having typed a pattern **z\*** in the *host pattern* field, the drop-down list displays all the host names containing this pattern: z\*, Zabbix server, and Zabbix proxy. After pressing *Enter*, this pattern is accepted and is displayed as **z\***. Similarly, the pattern can be created in the *item pattern* field. For example, having typed the pattern **a\*** in the *item pattern* field, the drop-down list displays all the item names containing this pattern: a\*, Available memory, Available memory in %.  See the image of the *Data set* tab below.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/graph_widget_it_host_pattern_1.png){width="600"}  After pressing *Enter*, this pattern is accepted and is displayed as **a\***, and all the selected items that belong to the selected host name(s) are displayed above the *Data set* tab. See the image of the *Data set* tab below.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/graph_widget_it_host_pattern_2.png){width="600"}
ca	 ##### Detalls de la configuració del conjunt de dades  Els camps *patró d'equip* i *patró d'elements* de la pestanya *Conjunt de dades* reconeixen tots dos noms complets o patrons que contenen un símbol de comodí (\*). Aquesta funcionalitat permet triar tots els noms d'equip i els noms d'elements que contenen el patró seleccionat. El més important és que mentre s'escriu el nom de l'element o el patró de l'element al camp *patró d'element*, només es mostren en una llista desplegable els elements que pertanyen als noms d'equip seleccionats. Per exemple, després d'haver escrit un patró **z\*** al camp *patró d'equip*, la llista desplegable mostra tots els noms d'equip que contenen aquest patró: z\*, servidor Zabbix i proxy Zabbix. Després de prémer *Enter*, aquest patró s'accepta i es mostra com a **z\***. De la mateixa manera, el patró es pot crear al camp *patró d'elements*. Per exemple, després d'haver escrit el patró **a\*** al camp *patró d'elements*, la llista desplegable mostra tots els noms d'elements que contenen aquest patró: a\*, Memòria disponible, Memòria disponible en %.  Veieu la imatge de la pestanya *Conjunt de dades* a continuació.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/graph_widget_it_host_pattern_1.png){width="600"}  Després de prémer *Retorn*, aquest patró s'accepta i es mostra com a **a\***, i tots els elements seleccionats que pertanyen als noms d'equip seleccionats es mostren a sobre de la pestanya *Conjunt de dades*. Veieu la imatge de la pestanya *Conjunt de dades* tot seguit.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/graph_widget_it_host_pattern_2.png){width="600"}