en-us	#### Create a webhook script  Create a webhook script that sends HTTP request to external service.  Request:  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "Webhook script",         "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.Log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.Log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}",         "type": 5,         "timeout": "40s",         "parameters": [             {                 "name": "token",                 "value": "{$WEBHOOK.TOKEN}"             },             {                 "name": "host",                 "value": "{HOST.HOST}"             },             {                 "name": "v",                 "value": "2.2"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "3"         ]     },     "id": 1 } ```
ca	#### Crear un script de webhook  Crear un script de webhook que envia una consulta HTTP a un servei extern.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "Webhook script",         "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.Log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.Log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}",         "type": 5,         "timeout": "40s",         "parameters": [             {                 "name": "token",                 "value": "{$WEBHOOK.TOKEN}"             },             {                 "name": "host",                 "value": "{HOST.HOST}"             },             {                 "name": "v",                 "value": "2.2"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Create HTTP agent item  Create POST request method item with JSON response preprocessing.  Request:  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "url": "http://127.0.0.1/http.php",         "query_fields": [             {                 "mode": "json"             },             {                 "min": "10"             },             {                 "max": "100"             }         ],         "interfaceid": "1",         "type": 19,         "hostid": "10254",         "delay": "5s",         "key_": "json",         "name": "HTTP agent example JSON",         "value_type": 0,         "output_format": 1,         "preprocessing": [             {                 "type": 12,                 "params": "$.random",                 "error_handler": 0,                 "error_handler_params": ""             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 2 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 3 } ```
ca	#### Crear un element d'agent HTTP  Crear un element de mètode de petició POST amb el pretractament de la resposta JSON.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "url": "http://127.0.0.1/http.php",         "query_fields": [             {                 "mode": "json"             },             {                 "min": "10"             },             {                 "max": "100"             }         ],         "interfaceid": "1",         "type": 19,         "hostid": "10254",         "delay": "5s",         "key_": "json",         "name": "HTTP agent example JSON",         "value_type": 0,         "output_format": 1,         "preprocessing": [             {                 "type": 12,                 "params": "$.random",                 "error_handler": 0,                 "error_handler_params": ""             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 2 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 3 } ```

en-us	#### Create HTTP agent item prototype  Create item prototype with URL using user macro, query fields and custom headers.  Request:  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "type": "19",         "hostid": "10254",         "ruleid": "28256",         "interfaceid": "2",         "name": "api item prototype example",         "key_": "api_http_item",         "value_type": 3,         "url": "{$URL_PROTOTYPE}",         "query_fields": [             {                 "min": "10"             },             {                 "max": "100"             }         ],         "headers": {             "X-Source": "api"         },         "delay": "35"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "28305"         ]     },     "id": 1 } ```
ca	#### Crear un prototiups d'element d'agent HTTP agent  Crear un prototip d'element amb una URL emprant una macro d'usuari, camps de cerca i capçaleres a mida.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "type": "19",         "hostid": "10254",         "ruleid": "28256",         "interfaceid": "2",         "name": "api item prototype example",         "key_": "api_http_item",         "value_type": 3,         "url": "{$URL_PROTOTYPE}",         "query_fields": [             {                 "min": "10"             },             {                 "max": "100"             }         ],         "headers": {             "X-Source": "api"         },         "delay": "35"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "28305"         ]     },     "id": 1 } ```

en-us	#### Create script item  Create a simple data collection using a script item.  Request:  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "Script example",         "key_": "custom.script.item",         "hostid": "12345",         "type": 21,         "value_type": 4,         "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",         "parameters": [             {                 "name": "host",                 "value": "{HOST.CONN}"             }         ],         "timeout": "6s",         "delay": "30s"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 2 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 3 } ```
ca	#### Crear un element d'script  Crea una col·lecció senzilla e dades emprant un element d'script.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "Script example",         "key_": "custom.script.item",         "hostid": "12345",         "type": 21,         "value_type": 4,         "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",         "parameters": [             {                 "name": "host",                 "value": "{HOST.CONN}"             }         ],         "timeout": "6s",         "delay": "30s"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 2 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 3 } ```

en-us	#### Create script item prototype  Create a simple data collection using a script item prototype.  Request:  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "name": "Script example",         "key_": "custom.script.itemprototype",         "hostid": "12345",         "type": 21,         "value_type": 4,         "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",         "parameters": [             {                 "name": "host",                 "value": "{HOST.CONN}"             }         ],         "timeout": "6s",         "delay": "30s"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 2 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 3 } ```
ca	#### Crear un prototipus d'element d'script  Crear una col·lecció de dades simple emprant un prototipus d'element d'script.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "name": "Script example",         "key_": "custom.script.itemprototype",         "hostid": "12345",         "type": 21,         "value_type": 4,         "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",         "parameters": [             {                 "name": "host",                 "value": "{HOST.CONN}"             }         ],         "timeout": "6s",         "delay": "30s"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 2 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 3 } ```

en-us	#### Create script LLD rule  Create a simple data collection using a script LLD rule.  Request:  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Script example",         "key_": "custom.script.lldrule",         "hostid": "12345",         "type": 21,         "value_type": 4,         "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",         "parameters": [             {                 "name": "host",                 "value": "{HOST.CONN}"             }         ],         "timeout": "6s",         "delay": "30s"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 2 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 3 } ```
ca	#### Creear una regla LLD script  Crear una recollida simple de dades mercès a una regla LLD script.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Script example",         "key_": "custom.script.lldrule",         "hostid": "12345",         "type": 21,         "value_type": 4,         "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",         "parameters": [             {                 "name": "host",                 "value": "{HOST.CONN}"             }         ],         "timeout": "6s",         "delay": "30s"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 2 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 3 } ```

en-us	#### Creating a dashboard  Create a dashboard named "My dashboard" with one Problems widget with tags and using two types of sharing (user group and user) on a single dashboard page.  Request:  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "problems",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "tags.tag.0",                                 "value": "service"                             },                             {                                 "type": 0,                                 "name": "tags.operator.0",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "tags.value.0",                                 "value": "zabbix_server"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": "7",                 "permission": 2             }         ],         "users": [             {                 "userid": "4",                 "permission": 3             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "2"         ]     },     "id": 1 } ```
ca	#### Creant un tauler  Crea un tauler amb el nom de "El meu tauler" amb un giny de Problemes amb tags, i emprant dos tipus de comparticions (grups d'usuaris i usuari) en una única pàgina del tauler.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "Problems",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "tags.tag.0",                                 "value": "service"                             },                             {                                 "type": 0,                                 "name": "tags.operator.0",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "tags.value.0",                                 "value": "zabbix_server"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": "7",                 "permission": 2             }         ],         "users": [             {                 "userid": "4",                 "permission": 3             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "2"         ]     },     "id": 1 } ```

en-us	#### Creating a dashboard  It is possible to create a new dashboard in two ways:  -   Click on *Create dashboard*, when viewing all dashboards -   Select *Create new* from the action menu, when viewing a single     dashboard  You will be first asked to enter general dashboard parameters:  ![dashboard\_properties.png](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_properties.png)  |Parameter|Description| |--|--------| |*Owner*|Select system user that will be the dashboard owner.| |*Name*|Enter dashboard name.| |*Default page display period*|Select period for how long a dashboard page is displayed before rotating to the next page in a [slideshow](#creating_a_slideshow).| |*Start slideshow automatically*|Mark this checkbox to run a slideshow automatically one more than one dashboard page exists.|  When you click on *Apply*, an empty dashboard is opened:  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_add.png){width="600"}  To populate the dashboard, you can add widgets and pages.  Click on the *Save changes* button to save the dashboard. If you click on *Cancel*, the dashboard will not be created.
ca	#### Créació d'un tauler  És possible crear un tauler nou de dues maneres:  - Feu clic a *Crear un tauler de control* quan es mostrin tots els taulers de control - Trieu *Crear nou* al menú d'accions, quan visualitzeu un únic tauler  Primer se us demanarà que introduïu la configuració general del tauler:  ![tauler\_properties.png](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_properties.png)  |Paràmetre|Descripció| |--|---------| |*Propietari*|Trieu l'usuari del sistema que serà el propietari del tauler.| |*Nom*|Introduïu el nom del tauler.| |*Temps de visualització de la pàgina predeterminat*|Trieu quant de temps es mostrarà una pàgina del tauler abans de passar a la pàgina següent en una [presentació de diapositives](#creating_a_slideshow).| |*Inicia la presentació de diapositives automàticament*|Marqueu aquesta casella per executar una presentació de diapositives automàticament si existeixen diverses pàgines del tauler de control.|  Quan feu clic a *Aplicar*, s'obre un tauler de control buit:  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_add.png){width="600"}  Per omplir el tauler, podeu afegir ginys i pàgines.  Feu clic al botó *Desar canvis* per desar el tauler. Si feu clic a *Cancel·lar*, el tauler no es crearà.

en-us	#### Creating a global macro  Create a global macro "{$SNMP\_COMMUNITY}" with value "public".  Request:  ```json {     "jsonrpc": "2.0",     "method": "usermacro.createglobal",     "params":  {         "macro": "{$SNMP_COMMUNITY}",         "value": "public"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "globalmacroids": [             "6"         ]     },     "id": 1 } ```
ca	#### Crear una macro global  Crear una macro global "{$SNMP\_COMMUNITY}" amb el valor "public".  Petició:  ```json {     "jsonrpc": "2.0",     "method": "usermacro.createglobal",     "params":  {         "macro": "{$SNMP_COMMUNITY}",         "value": "public"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "globalmacroids": [             "6"         ]     },     "id": 1 } ```

en-us	#### Creating a graph  Create a graph with two items.  Request:  ```json {     "jsonrpc": "2.0",     "method": "graph.create",     "params": {         "name": "MySQL bandwidth",         "width": 900,         "height": 200,         "gitems": [             {                 "itemid": "22828",                 "color": "00AA00"             },             {                 "itemid": "22829",                 "color": "3333FF"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "graphids": [             "652"         ]     },     "id": 1 } ```
ca	#### Crear un gràfic  Crear un gràfic amb dos elements.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "graph.create",     "params": {         "name": "MySQL bandwidth",         "width": 900,         "height": 200,         "gitems": [             {                 "itemid": "22828",                 "color": "00AA00"             },             {                 "itemid": "22829",                 "color": "3333FF"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "graphids": [             "652"         ]     },     "id": 1 } ```

en-us	#### Creating a graph prototype  Create a graph prototype with two items.  Request:  ```json {     "jsonrpc": "2.0",     "method": "graphprototype.create",     "params": {         "name": "Disk space usage {#FSNAME}",         "width": 900,         "height": 200,         "gitems": [             {                 "itemid": "22828",                 "color": "00AA00"             },             {                 "itemid": "22829",                 "color": "3333FF"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "graphids": [             "652"         ]     },     "id": 1 } ```
ca	#### Crear un prototipus de gràfic  Crear un prototipus de gràfic amb dos elements.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "graphprototype.create",     "params": {         "name": "Disk space usage {#FSNAME}",         "width": 900,         "height": 200,         "gitems": [             {                 "itemid": "22828",                 "color": "00AA00"             },             {                 "itemid": "22829",                 "color": "3333FF"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "graphids": [             "652"         ]     },     "id": 1 } ```

en-us	#### Creating a host  Create a host called "Linux server" with an IP interface and tags, add it to a group, link a template to it and set the MAC addresses in the host inventory.  Request:  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "Linux server",         "interfaces": [             {                 "type": 1,                 "main": 1,                 "useip": 1,                 "ip": "192.168.3.1",                 "dns": "",                 "port": "10050"             }         ],         "groups": [             {                 "groupid": "50"             }         ],         "tags": [             {                 "tag": "Host name",                 "value": "Linux server"             }         ],         "templates": [             {                 "templateid": "20045"             }         ],         "macros": [             {                 "macro": "{$USER_ID}",                 "value": "123321"             },             {                 "macro": "{$USER_LOCATION}",                 "value": "0:0:0",                 "description": "latitude, longitude and altitude coordinates"             }         ],         "inventory_mode": 0,         "inventory": {             "macaddress_a": "01234",             "macaddress_b": "56768"         }     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "107819"         ]     },     "id": 1 } ```
ca	#### Crear un equip  Crear un equip anomenat "Linux server" amb una interfície IP i etiquetes; afegir-lo a un grup, vincular-lo a una plantilla i establir les adreces MAC dins de l'inventari d'equips.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "Linux server",         "interfaces": [             {                 "type": 1,                 "main": 1,                 "useip": 1,                 "ip": "192.168.3.1",                 "dns": "",                 "port": "10050"             }         ],         "groups": [             {                 "groupid": "50"             }         ],         "tags": [             {                 "tag": "Host name",                 "value": "Linux server"             }         ],         "templates": [             {                 "templateid": "20045"             }         ],         "macros": [             {                 "macro": "{$USER_ID}",                 "value": "123321"             },             {                 "macro": "{$USER_LOCATION}",                 "value": "0:0:0",                 "description": "latitude, longitude and altitude coordinates"             }         ],         "inventory_mode": 0,         "inventory": {             "macaddress_a": "01234",             "macaddress_b": "56768"         }     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "107819"         ]     },     "id": 1 } ```

en-us	#### Creating a host group  Create a host group called "Linux servers".  Request:  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.create",     "params": {         "name": "Linux servers"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "107819"         ]     },     "id": 1 } ```
ca	#### Crear un grup d'equips  Crea un grup d'equips anomenat "Servidors Linux".  Petició:  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.create",     "params": {         "name": "Servidors Linux"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "107819"         ]     },     "id": 1 } ```

en-us	#### Creating a host group  ::: noteimportant Only Super Admin users can create host groups. :::  To create a host group in Zabbix frontend, do the following:  -   Go to: *Configuration → Host groups* -   Click on *Create Group* in the upper right corner of the screen -   Enter parameters of the group in the form  ![](../../../../assets/en/manual/config/host_group.png)  All mandatory input fields are marked with a red asterisk.  |Parameter|Description| |---------|-----------| |*Group name*|Enter a unique host group name.<br>To create a nested host group, use the '/' forward slash separator, for example `Europe/Latvia/Riga/Zabbix servers`. You can create this group even if none of the three parent host groups (`Europe/Latvia/Riga`) exist. In this case creating these parent host 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.<br>Nested representation of host groups is supported since Zabbix 3.2.0.| |*Apply permissions and tag filters to all subgroups*|Checkbox is available to Super Admin users only and only when editing an existing host group.<br>Mark this checkbox and click on *Update* to apply the same level of permissions/tag filters to all nested host groups. For user groups that may have had differing [permissions](/manual/config/users_and_usergroups/usergroup#configuration) assigned to nested host groups, the permission level of the parent host group will be enforced on the nested groups.<br>This is a one-time option that is not saved in the database.<br>This option is supported since Zabbix 3.4.0.|  **Permissions to nested host groups**  -   When creating a child host group to an existing parent host group,     [user group](/manual/config/users_and_usergroups/usergroup)     permissions to the child are inherited from the parent (for example,     when creating `Riga/Zabbix servers` if `Riga` already exists) -   When creating a parent host group to an existing child host group,     no permissions to the parent are set (for example, when creating     `Riga` if `Riga/Zabbix servers` already exists)
ca	#### Creació d'un grup d'equips  ::: noteimportant Només els usuaris superadministradors poden crear grups d'equips. :::  Per crear un grup d'equips a la interfície Zabbix, feu el següent:  - Vés a: *Configuració → Grups d'equips* - Feu clic a *Crea un grup* a la cantonada superior dreta de la pantalla - Introduïu els paràmetres del grup al formulari  ![](../../../../assets/en/manual/config/host_group.png)  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  |Paràmetre|Descripció| |---------|-----------| |*Nom del grup*|Introduïu un nom de grup d'equips únic.<br>Per crear un grup d'equips niuat, empreu el separador de barra inclinada '/', per exemple, `Europe/Latvia/Riga/Zabbix`. Podeu crear aquest grup encara que no existeixi cap dels tres grups d'equips principals ('Europe/Latvia/Riga'). En aquest cas, la creació d'aquests grups d'equips pare depèn de l'usuari; no es crearan automàticament.<br>No es permeten barres inclinades inicials i finals, ni barres inclinades múltiples consecutives. No s'admet l'escapament de '/'.<br>La representació niuada de grups d'equips és compatible des de Zabbix 3.2.0.| |*Aplica permisos i filtres d'etiquetes a tots els subgrups*|La casella de selecció només és disponible per a usuaris superadministradors i només quan editeu un grup d'equips existent.<br>Marqueu aquesta casella i feu clic a *Actualitzar* per aplicar el mateix nivell de permisos/etiqueta a tots els grups d'equips niuats. Per als grups d'usuaris que poden tindre diferents [permisos](/manual/config/users_and_usergroups/usergroup#configuration) assignats a grups d'equips niuats, el nivell de permís del grup d'equips principal s'aplicarà als grups niuats.<br>Aquesta és una opció única que no es desa a la base de dades.<br>Aquesta opció és compatible des de Zabbix 3.4.0.|  **Permisos per a grups d'equips niuats**  - Quan es crea un grup d'equips secundari en un grup d'equips principal existent, els permisos de [grup d'usuaris](/manual/config/users_and_usergroups/usergroup) del fill s'hereten del pare (per exemple, quan es creen "servidors Riga/Zabbix" si "Riga" ja existeix). - Quan es crea un grup d'equips principal per a un grup d'equips fill existent, no s'estableix cap permís per al pare (per exemple, quan es crea "Riga" si "servidors Riga/Zabbix" ja existeix).

en-us	#### Creating a host inventory item  Create a Zabbix agent item to populate the host's "OS" inventory field.  Request:  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "uname",         "key_": "system.uname",         "hostid": "30021",         "type": 0,         "interfaceid": "30007",         "value_type": 1,         "delay": "10s",         "inventory_link": 5     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "24759"         ]     },     "id": 1 } ```
ca	#### Crear un element d'inventari d'equip  Crear un element d'agent Zabbix peremplenar el camp d'inventari "OS" de l'equip.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "uname",         "key_": "system.uname",         "hostid": "30021",         "type": 0,         "interfaceid": "30007",         "value_type": 1,         "delay": "10s",         "inventory_link": 5     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "24759"         ]     },     "id": 1 } ```

en-us	#### Creating a host macro  Create a host macro "{$SNMP\_COMMUNITY}" with the value "public" on host "10198".  Request:  ```json {     "jsonrpc": "2.0",     "method": "usermacro.create",     "params": {         "hostid": "10198",         "macro": "{$SNMP_COMMUNITY}",         "value": "public"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostmacroids": [             "11"         ]     },     "id": 1 } ```
ca	#### Crear una macro d'equip  Crear una macro d'equip "{$SNMP\_COMMUNITY}" amb el valor "public" a l'equip "10198".  Petició:  ```json {     "jsonrpc": "2.0",     "method": "usermacro.create",     "params": {         "hostid": "10198",         "macro": "{$SNMP_COMMUNITY}",         "value": "public"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostmacroids": [             "11"         ]     },     "id": 1 } ```

en-us	#### Creating a host prototype  Create a host prototype "{\#VM.NAME}" on LLD rule "23542" with a group prototype "{\#HV.NAME}", tag pair "Datacenter": "{\#DATACENTER.NAME}" and custom SNMPv2 interface 127.0.0.1:161 with community {$SNMP\_COMMUNITY}. Link it to host group "2".  Request:  ```json {     "jsonrpc": "2.0",     "method": "hostprototype.create",     "params": {         "host": "{#VM.NAME}",         "ruleid": "23542",         "custom_interfaces": "1",         "groupLinks": [             {                 "groupid": "2"             }         ],         "groupPrototypes": [             {                 "name": "{#HV.NAME}"             }         ],         "tags": [             {                 "tag": "Datacenter",                 "value": "{#DATACENTER.NAME}"             }         ],         "interfaces": [             {                 "main": "1",                 "type": "2",                 "useip": "1",                 "ip": "127.0.0.1",                 "dns": "",                 "port": "161",                 "details": {                     "version": "2",                     "bulk": "1",                     "community": "{$SNMP_COMMUNITY}"                 }             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10103"         ]     },     "id": 1 } ```
ca	#### Crear un prototip d'equip  Crear un prototip d'equip "{\#VM.NAME}" sobre la regla LLD "23542" amb un prototip de grup "{\#HV.NAME}", un parell d'etiquetes "Datacenter": "{\#DATACENTER.NAME}" i una interfície SNMPv2 personalitzada 127.0.0.1:161 amb la comunitat {$SNMP\_COMMUNITY}. Enllaçar-lo al grup d'equips "2".  Petició:  ```json {     "jsonrpc": "2.0",     "method": "hostprototype.create",     "params": {         "host": "{#VM.NAME}",         "ruleid": "23542",         "custom_interfaces": "1",         "groupLinks": [             {                 "groupid": "2"             }         ],         "groupPrototypes": [             {                 "name": "{#HV.NAME}"             }         ],         "tags": [             {                 "tag": "Datacenter",                 "value": "{#DATACENTER.NAME}"             }         ],         "interfaces": [             {                 "main": "1",                 "type": "2",                 "useip": "1",                 "ip": "127.0.0.1",                 "dns": "",                 "port": "161",                 "details": {                     "version": "2",                     "bulk": "1",                     "community": "{$SNMP_COMMUNITY}"                 }             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10103"         ]     },     "id": 1 } ```

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:  ```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"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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 el xifrat PSK configurat. Tingueu en compte que l'equip ha d'ésser [preconfigurat per emprar PSK](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example).  Petició:  ```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"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```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"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "equip SNMP",         "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"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10658"         ]     },     "id": 1 } ```

en-us	#### Creating a LLD rule with macro paths  Request:  ```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"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```
ca	#### Crear una regla LLD amb rutes de macros  Petició:  ```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"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```

en-us	#### Creating a LLD rule with overrides  Request:  ```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"                             }                         ]                     }                 ]             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "30980"         ]     },     "id": 1 } ```
ca	#### Crear una regla LLD amb reemplaçaments  Petició:  ```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"                             }                         ]                     }                 ]             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "30980"         ]     },     "id": 1 } ```

en-us	#### Creating a LLD rule with preprocessing  Request:  ```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": ""             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```
ca	#### Crear una regla LLD amb preprocessament  Petició:  ```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": ""             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```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": ""             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "maintenanceids": [             "3"         ]     },     "id": 1 } ```
ca	#### Crear un manteniment  Crear 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 a22.01.2014, entrar en vigor cada diumenge a les 6 de la tarda i durar una hora.  Petició:  ```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": ""             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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 e-mail media type  Create a new e-mail media type with a custom SMTP port and message templates.  Request:  ```json {     "jsonrpc": "2.0",     "method": "mediatype.create",     "params": {         "type": "0",         "name": "E-mail",         "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}."             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```json {     "jsonrpc": "2.0",     "method": "mediatype.create",     "params": {         "type": "0",         "name": "E-mail",         "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}."             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "mediatypeids": [             "7"         ]     },     "id": 1 } ```

en-us	#### Creating a new global regular expression.  Request:  ```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"         }       ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "regexpids": [             "16"         ]     },     "id": 1 } ```
ca	#### Crear una nova expressió regular global.  Petició:  ```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"         }       ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "regexpids": [             "16"         ]     },     "id": 1 } ```

en-us	#### Creating a new item  Let's create a new [item](/manual/api/reference/item/object) on "Zabbix server" using the data we've obtained from the previous `host.get` request. This can be done by using the [item.create](/manual/api/reference/item/create) method:  ```json {     "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     },     "auth": "0424bd59b807674191e7d77572075f33",     "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):  ```json {     "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     },     "auth": "0424bd59b807674191e7d77572075f33",     "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:  ```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"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```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"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```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"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```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"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```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"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```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"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```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": ""             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```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": ""             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Mounted filesystem discovery",         "key_": "vfs.fs.discovery",         "hostid": "10197",         "type": 0,         "interfaceid": "112",         "delay": "30s"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Mounted filesystem discovery",         "key_": "vfs.fs.discovery",         "hostid": "10197",         "type": 0,         "interfaceid": "112",         "delay": "30s"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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 a role  Create a role with type "User" and denied access to two UI elements.  Request:  ```json {     "jsonrpc": "2.0",     "method": "role.create",     "params": {         "name": "Operator",         "type": "1",         "rules": {             "ui": [                 {                     "name": "monitoring.hosts",                     "status": "0"                 },                 {                     "name": "monitoring.maps",                     "status": "0"                 }             ]         }     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```json {     "jsonrpc": "2.0",     "method": "role.create",     "params": {         "name": "Operator",         "type": "1",         "rules": {             "ui": [                 {                     "name": "monitoring.hosts",                     "status": "0"                 },                 {                     "name": "monitoring.maps",                     "status": "0"                 }             ]         }     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```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"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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 del 01.04.2021 fins a 31.08.2021.  Petició:  ```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"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```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"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```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"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```json {     "jsonrpc": "2.0",     "method": "service.create",     "params": {         "name": "Server 1",         "algorithm": 1,         "sortorder": 1     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "serviceids": [             "5"         ]     },     "id": 1 } ```
ca	#### Crear un servei  Crear un servei que passarà a l'estat de problema si, com a mínim, un procés fill té un problema.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "service.create",     "params": {         "name": "Server 1",         "algorithm": 1,         "sortorder": 1     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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/monitoring/dashboard/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/monitoring/dashboard/slideshow_stop_kiosk.png) -     stop slideshow -   ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/slideshow_start_kiosk.png) -     start slideshow -   ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/slideshow_back_kiosk.png) -     go back one page -   ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/slideshow_next_kiosk.png) -     go to the next page
ca	#### Crear una presentació  Una presentació de diapositives s'executarà automàticament si el tauler de control té dues o més pàgines (veieu [Afegir pàgines](#adding_pages)) i si es compleix una de les condicions següents:  - L'opció *Engegar la presentació de diapositives automàticament* és marcada a les propietats del tauler - L'URL del tauler conté un paràmetre `slideshow=1`  Les pàgines giren als intervals especificats a les propietats del tauler i de les pàgines individuals. Feu clic a:  - *Aturar la presentació de diapositives* - per aturar la presentació de diapositives - *Iniciar la presentació de diapositives* - per iniciar la presentació de diapositives  ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/dashboard_page_tabs.png)  Les ordres relacionades amb la presentació de diapositives també són disponibles al [mode quiosc](#viewing_and_editing_a_dashboard) (on només es mostra el contingut de la pàgina):  - ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/slideshow_stop_kiosk.png) - atura la presentació de diapositives - ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/slideshow_start_kiosk.png) - inicia la presentació de diapositives - ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/slideshow_back_kiosk.png) - torna una pàgina enrere - ![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/dashboard/slideshow_next_kiosk.png) - avança a la pàgina següent

en-us	#### Creating a task  Create a task `check now` for two items. One is an item, the other is a low-level discovery rule.  Request:  ```json {     "jsonrpc": "2.0",     "method": "task.create",     "params": [         {             "type": 6,             "request": {                 "itemid": "10092"             }         },         {             "type": "6",             "request": {                 "itemid": "10093"             }         }     ],     "auth": "700ca65537074ec963db7efabda78259",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "taskids": [             "1",             "2"         ]     },     "id": 1 } ```  Create a task `diagnostic information` task.  Request:  ```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         }     ],     "auth": "700ca65537074ec963db7efabda78259",     "id": 2 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "taskids": [             "3"         ]     },     "id": 2 } ```
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ó:  ```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         }     ],     "auth": "700ca65537074ec963db7efabda78259",     "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:  ```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}"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "templateids": [             "11117"         ]     },     "id": 1 } ```
ca	#### Crear una plantilla  Crear una plantilla amb etiquetes, i enllaçar-hi dues plantilles a la plantilla.  Petició:  ```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}"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```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"                             }                         ]                     }                 ]                              }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```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"                             }                         ]                     }                 ]                              }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "32"         ]     },     "id": 1 } ```

en-us	#### Creating a template  To create a template, do the following:  -   Go to *Configuration → Templates* -   Click on *Create template* -   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. Alphanumerics, spaces, dots, dashes, and underscores are allowed. However, leading and trailing spaces are disallowed.| |*Visible name*|If you set this name, it will be the one visible in lists, maps, etc.| |*Templates*|Link one or more "nested" templates to this template. All entities (items, triggers, graphs, etc.) will be inherited from the linked templates.<br>To link a new template, start typing the template name in the *Templates* field. A list of matching templates will appear; scroll down to select. Alternatively, you may click on *Select* next to the *Templates* field; then, first select the host group by clicking on *Select* next to the *Host groups* field; mark the checkbox in front of one or multiple templates from the list displayed below; click on *Select*. The template(s) that are selected in the *Templates* field will be linked to the host when the host configuration form is saved or updated.<br>To unlink a template, use one of the two options in the *Templates* block:<br>*Unlink* - unlink the template, but preserve its items, triggers, and graphs<br>*Unlink and clear* - unlink the template and remove all its items, triggers, and graphs| |*Groups*|Host/template groups the template belongs to.| |*Description*|Enter the template description.|  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)  You may also view here macros from linked templates and global macros if you select the *Inherited and template macros* option. That is where all defined user macros for the template are displayed with the value they resolve to as well as their origin.  ![](../../../../assets/en/manual/config/template_d2.png)  For convenience, links to respective templates and global macro configuration are provided. It is also possible to edit a nested template/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.| |![](../../../../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.| |![](../../../../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.|  With a template created, it is time to add some entities to it.  ::: noteimportant Items have to be added to a template first. Triggers and graphs cannot be added without the corresponding item. :::
ca	#### Crear una plantilla  Per crear una plantilla, feu el següent:  - Aneu a *Configuració → Plantilles* - Feu clic a *Crear plantilla* - 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. 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*|Equips/grups de plantilles als quals pertany la plantilla.| |*Descripció*|Introduïu la descripció de la plantilla.|  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 **Mapa 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.|  Amb una plantilla creada, és hora d'afegir-hi algunes entitats.  ::: nota important Primer s'han d'afegir elements a una plantilla. No es poden afegir triggers i gràfics sense l'element corresponent. :::

en-us	#### Creating a trigger  Create a trigger with a single trigger dependency.  Request:  ```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": ""                 }             ]         }     ],     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "triggerids": [             "17369",             "17370"         ]     },     "id": 1 } ```
ca	#### Crear trigger  Crear un trigger amb una sola dependència de trigger.  Petició:  ```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": ""                 }             ]         }     ],     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```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}"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```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}"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```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"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "userids": [             "12"         ]     },     "id": 1 } ```
ca	#### Crear un usuari  Crear un usuari nou, afegir-lo a un grup d'usuaris i crear un nou suport per a ell.  Petició:  ```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"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "userids": [             "12"         ]     },     "id": 1 } ```

en-us	#### Creating a user group  Create a user group, which denies access to host group "2", and add a user to it.  Request:  ```json {     "jsonrpc": "2.0",     "method": "usergroup.create",     "params": {         "name": "Operation managers",         "rights": {             "permission": 0,             "id": "2"         },         "users": [             {"userid": "12"}         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "usrgrpids": [             "20"         ]     },     "id": 1 } ```
ca	#### Crear un grup d'usuaris  Crear un grup d'usuaris que no permeti pas l'accés al grup d'equips "2", i afegir-hi un usuari.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "usergroup.create",     "params": {         "name": "Operation managers",         "rights": {             "permission": 0,             "id": "2"         },         "users": [             {"userid": "12"}         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```json {     "jsonrpc": "2.0",     "method": "valuemap.create",     "params": {         "hostid": "50009",         "name": "Service state",         "mappings": [             {                 "type": "1",                 "value": "1",                 "newvalue": "Up"             },             {                 "type": "5",                 "newvalue": "Down"             }         ]     },     "auth": "57562fd409b3b3b9a4d916d45207bbcb",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "valuemapids": [             "1"         ]     },     "id": 1 } ```
ca	#### Crear un mapa de valors  Crear un mapa de valors amb dues correspondències.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "valuemap.create",     "params": {         "hostid": "50009",         "name": "Service state",         "mappings": [             {                 "type": "1",                 "value": "1",                 "newvalue": "Up"             },             {                 "type": "5",                 "newvalue": "Down"             }         ]     },     "auth": "57562fd409b3b3b9a4d916d45207bbcb",     "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:  ```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>"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```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>"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```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             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```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             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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 512 KB. 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 512 Ko. 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  For Zabbix [server](/manual/concepts/server) and [proxy](/manual/concepts/proxy) daemons a database is required. It is not needed to run Zabbix [agent](/manual/concepts/agent).  ::: notewarning Separate databases are needed for Zabbix server and Zabbix proxy; they cannot use the same database. Therefore, if they are installed on the same host, their databases must be created with different names! :::  Create the database using the provided instructions for [MySQL](/manual/appendix/install/db_scripts#mysql) or [PostgreSQL](/manual/appendix/install/db_scripts#postgresql).
ca	#### Creació de base de dades  Per als dimonis Zabbix [servidor](/manual/concepts/server) i [proxy](/manual/concepts/proxy) cal una base de dades. No cal executar l'[agent](/manual/concepts/agent) Zabbix.  ::: notadvert 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! :::  Creeu la base de dades seguint les instruccions proporcionades per a [MySQL](/manual/appendix/install/db_scripts#mysql) o [PostgreSQL](/manual/appendix/install/db_scripts#postgresql).

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:  ```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     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```
ca	#### Crear un element dependent  Crear 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ó:  ```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     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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:  ```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     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```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     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44212"         ]     },     "id": 1 } ```

en-us	#### Creating hosts from Monitoring  It is now also possible to create new hosts from *Monitoring* → *[Hosts](/manual/web_interface/frontend_sections/monitoring/hosts)*.  ![](../../../assets/en/manual/introduction/monitoring_create_host.png)  The *Create host* button is available for Admin and Super Admin users.
ca	##### Creació d'equips des de Monitoratge  Es poden crear nous equips des de *Monitoratge* → *[Equips](/manual/web_interface/frontend_sections/monitoring/hosts)*.  ![](../../../assets/en/manual/introduction/monitoring_create_host.png)  El botó *Crear equip* és disponible per als usuaris administradors i superadministradors.

en-us	#### Creating interfaces  Create an interface on two hosts.  Request:  ```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         }     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "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ó:  ```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         }     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "interfaceids": [             "30069",             "30070"         ]     },     "id": 1 } ```

en-us	#### Creating multiple triggers  So if create methods accept arrays, we can add multiple [triggers](/manual/api/reference/trigger/object) like so:  ```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",         },         {             "description": "Too many processes on {HOST.NAME}",             "expression": "avg(/Linux server/proc.num[],5m)>300",         }     ],     "auth": "0424bd59b807674191e7d77572075f33",     "id": 4 } ```  A 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:  ```json {     "jsonrpc": "2.0",     "method": "trigger.create",     "params": [         {             "description": "La càrrega del processador és massa alta a {HOST.NAME}",             "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5",         },         {             "description": "Massa processos a {HOST.NAME}",             "expression": "avg(/Linux server/proc.num[],5m)>300",         }     ],     "auth": "0424bd59b807674191e7d77572075f33",     "id": 4 } ```  Una resposta correcta contindrà els identificadors 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	### Critical  To complete successful Zabbix server upgrade on MySQL and MariaDB, you may require to set `GLOBAL log_bin_trust_function_creators = 1` in MySQL  if binary logging is enabled, there are no superuser privileges and `log_bin_trust_function_creators = 1` is not set in MySQL configuration file.   To set the variable using the MySQL console, run:      mysql> SET GLOBAL log_bin_trust_function_creators = 1;  Once the upgrade has been successfully completed, `log_bin_trust_function_creators` can be disabled:      mysql> SET GLOBAL log_bin_trust_function_creators = 0;
ca	### Crítica  Per completar amb èxit l'actualització del servidor Zabbix a MySQL i MariaDB, és possible que calgui establir `GLOBAL log_bin_trust_function_creators = 1` a MySQL si el registre binari és habilitat, no hi ha privilegis de superusuari i `log_bin_trust_function_creators = 1` no és establert al fitxer de configuració de MySQL.  Per configurar la variable mitjançant la consola MySQL, executeu:       mysql> SET GLOBAL log_bin_trust_function_creators = 1;  Un cop l'actualització s'hagi completat amb èxit, `log_bin_trust_function_creators` es pot desactivar:      mysql> SET GLOBAL log_bin_trust_function_creators = 0;

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	##### 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 details  The details object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**version**<br>(required)|integer|SNMP interface version.<br><br>Possible values are:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values are:<br>0 - don't use bulk requests;<br>1 - *(default)* - use bulk requests.| |community|string|SNMP community. Used only by SNMPv1 and SNMPv2 interfaces.| |securityname|string|SNMPv3 security name. Used only by SNMPv3 interfaces.| |securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - *(default)* - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|SNMPv3 authentication passphrase. Used only by SNMPv3 interfaces.| |privpassphrase|string|SNMPv3 privacy passphrase. Used only by SNMPv3 interfaces.| |authprotocol|integer|SNMPv3 authentication protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - *(default)* - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - *(default)* - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |contextname|string|SNMPv3 context name. Used only by SNMPv3 interfaces.|
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**<br>(obligatori)|integer|Versió de la interfície SNMP.<br><br>Els valors possibles són:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br> 3 - SNMPv3| |bulk|integer|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|string|Comunitat SNMP. Només l'empren les interfícies SNMPv1 i SNMPv2.| |securityname|string|Nom de seguretat SNMPv3. Emprat només per interfícies SNMPv3.| |securitylevel|integer|Nivell de seguretat SNMPv3. Només l'empren les interfícies SNMPv3.<br><br>Els valors possibles són:<br>0 - *(per defecte)* - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|Mot de pas d'autenticació SNMPv3. Emprat només per interfícies SNMPv3.| |privpassphrase|string|Frase de pas de privadesa SNMPv3. Emprat només per interfícies SNMPv3.| |authprotocol|integer|Protocol d'autenticació SNMPv3. Només s'empra a les interfícies 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.| |privprotocol|integer|Protocol de privadesa SNMPv3. Només s'empra les interfícies 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.| |contextname|string|Nom de context SNMPv3. Emprat només per interfícies SNMPv3.|

en-us	### Custom interface  The custom interface object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dns|string|DNS name used by the interface.<br><br>**Required** if the connection is made via DNS. Can contain macros.| |ip|string|IP address used by the interface.<br><br>**Required** if the connection is made via IP. Can contain macros.| |**main**<br>(required)|integer|Whether the interface is used as default on the host. Only one interface of some type can be set as default on a host.<br><br>Possible values are:<br>0 - not default;<br>1 - default.| |**port**<br>(required)|string|Port number used by the interface. Can contain user and LLD macros.| |**type**<br>(required)|integer|Interface type.<br><br>Possible values are:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>| |**useip**<br>(required)|integer|Whether the connection should be made via IP.<br><br>Possible values are:<br>0 - connect using host DNS name;<br>1 - connect using host IP address for this host interface.| |details|array|Additional object for interface. **Required** if interface 'type' is SNMP.|
ca	### Interfície personalitzada  L'objecte d'interfície personalitzada té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dns|string|Nom DNS emprat per la interfície.<br><br>**Obligatori** si us connecteu mitjançant DNS. Pot contenir macros.| |ip|string|adreça IP emprada per la interfície.<br><br>**Obligatori** si us connecteu mitjançant IP. Pot contenir macros.| |**main**<br>(obligatori)|integer|Indica si la interfície s'empra per defecte a l'equip. 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.| |**port**<br>(obligatori)|string|Nombre de port emprat per la interfície. Pot contenir macros d'usuari i LLD.| |**tipus**<br>(obligatori)|integer|Tipus d'interfície.<br><br>Els valors possibles són:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI ;<br>4 - JMX.<br>| |**useip**<br>(obligatori)|integer|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.| |details|array|Objecte addicional per a la interfície. **Obligatori** si el "tipus" d'interfície és SNMP.|

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 línia següent a la matriu de la llista anterior:  ```php 'BRAND_LOGO' => '{Ruta a una imatge al disc o URL}', ```  Tingueu en compte que la ruta a la imatge del disc hauria de ser relativa al directori arrel de la interfície de Zabbix. Així, per exemple, si la imatge és al mateix directori que el fitxer *brand.conf.php*, la ruta 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 plegada.  Per anul·lar:  ```php 'BRAND_LOGO_SIDEBAR' => '{Ruta a una imatge al disc o URL}', 'BRAND_LOGO_SIDEBAR_COMPACT' => '{Ruta 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": 114 x 30px - `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| |**Oracle Database**|2048|4000| |**PostgreSQL**|65535|not limited| |**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| |**Base de dades Oracle**|2048|4000| |**PostgreSQL**|65535|no limitat| |**SQLite (només proxy Zabbix)**|65535|no limitat|

en-us	#### dashboard Changes:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) added new widget type `slareport` and widget field types *(9 - Service, 10 - SLA)*.\ [ZBXNEXT-6966](https://support.zabbix.com/browse/ZBXNEXT-6966) added new widget type `item`.\
ca	#### tauler Canvis:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) afegit el nou giny `slareport` i els tipus de camps *(9 - Service, 10 - SLA)*.\ [ZBXNEXT-6966](https://support.zabbix.com/browse/ZBXNEXT-6966) afegit un nou tipus de giny `item`.\

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|*(readonly)* ID of the dashboard page.| |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|*(només lectura)* ID de la pàgina del tauler.| |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|*(readonly)* ID of the dashboard.| |**name**<br>(required)|string|Name of the dashboard.| |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.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
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.| |**name**<br>(obligatori)|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.|  Veieu que per alguns mètodes (actualitzar, esborrar) la combinació de paràmetres necessaris o opcionals és diferent.

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**<br>(required)|string|User group ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;|
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**<br>(obligatori)|string|ID del grup d'usuaris.| |**permission**<br>(obligatori)|integer|Tipus del nivell de permisos.<br><br>Valors possibles:<br>2 - només lectura;<br>3 - lectura i escriptura;|

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**<br>(required)|string|User ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;|
ca	### Usuari de tauler  Llista dels permisos del tauler en funció dels usuaris. L'objecte té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**userid**<br>(obligatori)|string|ID d'usuari.| |**permission**<br>(obligatori)|integer|Nivell de permisos.<br><br>Valors possibles:<br>2 - només lectura;<br>3 - lectura i escriptura;|

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**<br>(required)|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.| |**name**<br>(required)|string|Widget field name.<br><br>Possible values: see [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).| |**value**<br>(required)|mixed|Widget field value depending on the type.<br><br>Possible values: see [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).|
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ó| |--|--|------| |**type**<br>(obligatori)|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.| |**name**<br>(obligatori)|string|Nom del camp de giny.<br><br>Valors possibles: veieu [Camps de giny de tauler](/manual/api/reference/dashboard/widget_fields).| |**value**<br>(obligatori)|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).|

en-us	### Dashboard widget  The dashboard widget object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |widgetid|string|*(readonly)* ID of the dashboard widget.| |**type**<br>(required)|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.| |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>Required for specific widgets; 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|*(només lectura)* ID del giny de tauler.| |**type**<br>(obligatori)|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.| |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).|

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:      cd /path/to/zabbix-sources/database/oracle     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:      cd /path/to/zabbix-sources/database/oracle     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  It is supported to store database credentials used by Zabbix server, proxies and frontend secretly in Vault:  -   Vault-related parameters for retrieving database credentials can be     optionally entered in the frontend [installation     wizard](/manual/installation/frontend).  Database credentials retrieved from Vault will be cached by the frontend. Note that the filesystem temporary file directory is used for database credential caching in frontend. You may use the ZBX\_DATA\_CACHE\_TTL [constant](/manual/web_interface/definitions) to control how often the data cache is refreshed/invalidated.  -   For server/proxy the VaultDBPath configuration parameter may be used     to specify the path from where credentials for database will be     retrieved by keys 'password' and 'username' (for example:     secret/zabbix/database).  The following commands may be used to set the values for the path mentioned in example:      # Enable "secret/" mount point if not already enabled, note that "kv-v2" must be used     vault secrets enable -path=secret/ kv-v2      # Put new secrets with keys username and password under mount point "secret/" and path "secret/zabbix/database"     vault kv put secret/zabbix/database username=zabbix password=<password>      # Test that secret is successfully added     vault kv get secret/zabbix/database      # Finally test with Curl, note that "data" need to be manually added after mount point and "/v1" before the mount point, also see --capath parameter     curl --header "X-Vault-Token: <VaultToken>" https://127.0.0.1:8200/v1/secret/data/zabbix/database
ca	#### Credencials de la base de dades  És possible emmagatzemar en secret les credencials de la base de dades emprades pel servidor Zabbix, proxys i interfície a Vault:  - La configuració relacionada amb el magatzem per recuperar les credencials de la base de dades es pot introduir opcionalment a la interfície [assistent d'instal·lació](/manual/installation/frontend).  La interfície emmagatzemarà a la memòria cau les credencials de la base de dades recuperades de Vault. Tingueu en compte que el directori de fitxers temporals del sistema de fitxers s'empra per a la memòria cau de les credencials de la base de dades a la interfície. Podeu emprar la [constant](/manual/web_interface/definitions) ZBX\_DATA\_CACHE\_TTL per controlar amb quina freqüència s'actualitza/invalida la memòria cau de dades.  - Per al servidor/proxy, el paràmetre de configuració VaultDBPath es pot emprar per especificar el camí des del qual es recuperaran les credencials de la base de dades mitjançant les claus "mot de pas" i "nom d'usuari" (per exemple: secret/zabbix/base de dades).  Les ordres següents es poden emprar per establir els valors del camí esmentat a l'exemple:       # Habiliteu el punt de muntatge "secret/" si encara no és habilitat, tingueu en compte que s'ha d'emprar "kv-v2"      vault secrets enable -path=secret/ kv-v2       # Poseu nous secrets amb les claus de nom d'usuari i mot de pas al punt de muntatge "secret/" i al camí "secret/zabbix/base de dades"      vault kv put secret/zabbix/database username=zabbix password=<mot_de_pas>       # Comprova que el secret s'ha afegit correctament      vault kv get secret/zabbix/database       # Finalment, proveu amb Curl, tingueu en compte que les "dades" s'han d'afegir manualment després del punt de muntatge i "/v1" abans del punt de muntatge, vegeu també el paràmetre --capath      curl --header "X-Vault-Token: <VaultToken>" https://127.0.0.1:8200/v1/secret/data/zabbix/database

en-us	#### Database engine  This is probably the most important part of Zabbix tuning. Zabbix heavily depends on the availability and performance of database engine.  -   use fastest database engine, i.e. MySQL or PostgreSQL -   use stable release of a database engine -   rebuild MySQL or PostgreSQL from sources to get maximum performance -   follow performance tuning instructions taken from MySQL or     PostgreSQL documentation -   for MySQL, use InnoDB table structure -   ZABBIX works at least 1.5 times faster (comparing to MyISAM) if     InnoDB is used. This is because of increased parallelism. However,     InnoDB requires more CPU power. -   tuning the database server for the best performance is highly     recommended. -   keep database tables on different hard disks -   'history', 'history\_str, 'items' 'functions', triggers', and     'trends' are most heavily used tables. -   for large installations keeping MySQL temporary files in tmpfs is:     -   MySQL >= 5.5: not recommended ([MySQL bug         \#58421](https://bugs.mysql.com/bug.php?id=58421))     -   MySQL < 5.5: recommended
ca	#### Motor de base de dades  Aquesta és probablement la part més important de l'afinació de Zabbix. Zabbix depèn en gran mesura de la disponibilitat i el rendiment del motor de base de dades.  - Empreu el motor de base de dades més ràpid (és a dir, MySQL o PostgreSQL) - Empreu la versió estable del motor de base de dades - Munteu MySQL o PostgreSQL des de la font per obtindre el màxim rendiment - Seguiu les instruccions d'ajustament del rendiment extretes de la documentació de MySQL o PostgreSQL - Amb MySQL, empreu una estructura de taula InnoDB - ZABBIX s'executa almenys 1,5 vegades més ràpid (en comparació amb MyISAM) si s'empra InnoDB. Això es deu a l'augment del paral·lelisme. Tanmateix, InnoDB requereix més potència de CPU. - Es recomana optimitzar el servidor de bases de dades per obtindre el millor rendiment. - Mantingueu les taules de bases de dades en diferents discs durs - 'history', 'history\_str, 'items' 'functions', triggers', i 'trends' són les taules més emprades. - Per a instal·lacions grans, mantindre els fitxers temporals de MySQL a tmpfs és:      - MySQL >= 5.5: no recomanat ([error MySQL \#58421](https://bugs.mysql.com/bug.php?id=58421))      - MySQL < 5.5: recomanat

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 you 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 you would like to keep 30 days of history and you 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 this 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 you 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, you 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, you 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 you 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. :::  - La netaja que marca 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 neteaja 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	## Databases  To create the optimal user experience and ensure the best Zabbix performance in various production environments, the support of some older database releases has been dropped. This primarily applies to the database versions that are nearing their end of service life point and versions with unfixed issues that may interfere with normal performance.  Starting from Zabbix 6.0, the following [database](/manual/installation/requirements#required-software) versions are officially supported:  -   *MySQL/Percona* 8.0.X -   *MariaDB* 10.5.X - 10.6.X -   *PostgreSQL* 13.X - 14.X -   *Oracle* 19c - 21c -   *TimescaleDB* 2.0.1-2.3 -   *SQLite* 3.3.5-3.34.X  By default, Zabbix server and proxy will not start if an unsupported database version is detected. It is now possible, though not recommended, to turn off DB version check by modifying AllowUnsupportedDBVersions configuration parameter for the [server](/manual/appendix/config/zabbix_server) or [proxy](/manual/appendix/config/zabbix_proxy).
ca	### Bases de dades  Per crear l'experiència d'usuari òptima i garantir el millor rendiment de Zabbix en diversos entorns de producció, s'ha abandonat el suport d'algunes versions de bases de dades anteriors. Això s'aplica principalment a les versions de la base de dades que s'apropen al fi de vida útil i a les versions amb problemes no corregits que poden interferir amb el rendiment normal.  Des de Zabbix 6.0, les versions següents de [bases de dades](/manual/installation/requirements#required-software) són oficialment compatibles:  - *MySQL/Percona* 8.0.X - *MariaDB* 10.5.X - 10.6.X - *PostgreSQL* 13.X - 14.X - *Oracle* 19c - 21c - *TimescaleDB* 2.0.1-2.3 - *SQLite* 3.3.5-3.34.X  De manera predeterminada, el servidor Zabbix i el proxy no s'iniciaran si es detecta una versió de base de dades no compatible. És possible, encara que no es recomana, desactivar la comprovació de la versió de la base de dades modificant el paràmetre de configuració AllowUnsupportedDBVersions al [servidor](/manual/appendix/config/zabbix_server) o [proxy](/manual/appendix/config/zabbix_proxy).

en-us	##### Databases  To create the optimal user experience and ensure the best Zabbix performance in various production environments, the support of some older database releases has been dropped. This primarily applies to the database versions that are nearing their end of service life point and versions with unfixed issues that may interfere with normal performance.  Starting from Zabbix 6.0, the following [database](/manual/installation/requirements#required-software) versions are officially supported:  -   *MySQL/Percona* 8.0.X -   *MariaDB* 10.5.X - 10.6.X -   *PostgreSQL* 13.X -   *Oracle* 19c - 21c -   *TimescaleDB* 2.0.1-2.3 -   *SQLite* 3.3.5-3.34.X  By default, Zabbix server and proxy will not start if an unsupported database version is detected. It is now possible, though not recommended, to turn off DB version check by modifying AllowUnsupportedDBVersions configuration parameter for the [server](/manual/appendix/config/zabbix_server) or [proxy](/manual/appendix/config/zabbix_proxy).
ca	##### Bases de dades  Per crear l'experiència d'usuari òptima i garantir el millor rendiment de Zabbix en diversos entorns de producció, s'ha tret el suport d'algunes versions de bases de dades anteriors. Això s'aplica principalment a les versions de la base de dades que s'apropen al final de vida útil i a les versions amb problemes no corregits que poden interferir amb el rendiment normal.  A partir de Zabbix 6.0, les versions següents de [base de dades](/manual/installation/requirements#required-software) són oficialment compatibles:  - *MySQL/Percona* 8.0.X - *MariaDB* 10.5.X - 10.6.X - *PostgreSQL* 13.X - *Oracle* 19c - 21c - *TimescaleDB* 2.0.1-2.3 - *SQLite* 3.3.5-3.34.X  De manera predeterminada, el servidor Zabbix i el proxy no s'iniciaran si es detecta una versió de base de dades no compatible. Ara és possible, encara que no es recomana, desactivar la comprovació de la versió de la base de dades modificant el paràmetre de configuració AllowUnsupportedDBVersions per al [servidor](/manual/appendix/config/zabbix_server) o [proxy](/manual/appendix/config/zabbix_proxy).

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 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 set  The following parameters are supported for configuring a *Data set*.  ::: noteclassic The first number in the property name (e.g. ds.hosts.0.0, ds.items.0.0) represents the particular data set, while the second number, if present, represents the configured host or item. :::  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |***Host pattern***<br>(required)|1|ds.hosts.0.0|[Host](/manual/api/reference/host/get) name or pattern (e.g. `Zabbix*`).| |***Item pattern***<br>(required)|1|ds.items.0.0|[Item](/manual/api/reference/item/get) name or pattern (e.g. `*: Number of processed *values per second`).| |*Color*|1|ds.color.0|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `FF465C`.| |*Draw*|0|ds.type.0|0 - *(default)* Line;<br>1 - Points;<br>2 - Staircase;<br>3 - Bar.| |*Width*|0|ds.width.0|Valid values range from 1-10.<br><br>Default: 1.<br><br>Parameter *Width* not available if *Draw* is set to "Points" or "Bar".| |*Point size*|0|ds.pointsize.0|Valid values range from 1-10.<br><br>Default: 3.<br><br>Parameter *Point size* not available if *Draw* is set to "Line", "Staircase" or "Bar".| |*Transparency*|0|ds.transparency.0|Valid values range from 1-10.<br><br>Default: 5.| |*Fill*|0|ds.fill.0|Valid values range from 1-10.<br><br>Default: 3.<br><br>Parameter *Fill* not available if *Draw* is set to "Points" or "Bar".| |*Missing data*|0|ds.missingdatafunc.0|0 - *(default)* None;<br>1 - Connected;<br>2 - Treat as 0.<br><br>Parameter *Missing data* not available if *Draw* is set to "Points" or "Bar".| |*Y-axis*|0|ds.axisy.0|0 - *(default)* Left;<br>1 - Right.| |*Time shift*|1|ds.timeshift.0|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes). Negative values are also allowed.<br><br>Default: `""` (empty).| |*Aggregation function*|0|ds.aggregate_function.0|0 - *(default)* none;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Aggregation interval*|1|ds.aggregate_interval.0|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes).<br><br>Default: `1h`.| |*Aggregate*|0|ds.aggregate_grouping.0|0 - *(default)* Each item;<br>1 - Data set.<br><br>Parameter *Aggregate* not available if *Aggregation function* is set to "none".|
ca	#### Conjunt de dades  Els paràmetres següents són compatibles per configurar un *conjunt de dades*.  ::: noteclassic El primer nombre del nom de la propietat (p. ex., ds.hosts.0.0, ds.items.0.0) representa el conjunt de dades concret. mentre que el segon nombre, si h iés present, representa l'equip o l'element configurat. :::  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |***Patró d'equip***<br>(obligatori)|1|ds.hosts.0.0|[Host](/manual/api/reference/host/get) nom o patró (p. ex., `Zabbix*`). | |***Patró d'element***<br>(obligatori)|1|ds.items.0.0|[Item](/manual/api/reference/item/get) nom o patró (p. ex. `*: Nombre de processats *valors per segon`).| |*Color*|1|ds.color.0|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `FF465C`.| |*Dibuix*|0|ds.type.0|0 - *(per defecte)* Línia;<br>1 - Punts;<br>2 - Escala;<br>3 - Barra.| |*Amplada*|0|ds.width.0|Els valors vàlids oscil·len entre 1 i 10.<br><br>Per defecte: 1.<br><br>El paràmetre *Amplada* no està disponible si *Dibuix* s'estableix a "Punts" o "Barra".| |*Mida del punt*|0|ds.pointsize.0|Els valors vàlids oscil·len entre 1 i 10.<br><br>Per defecte: 3.<br><br>El paràmetre *Mida del punt* no està disponible si *Draw* és establir a "Línia", "Escala" o "Bar".| |*Transparència*|0|ds.transparency.0|Els valors vàlids van d'1 a 10.<br><br>Per defecte: 5.| |*Fill*|0|ds.fill.0|Els valors vàlids van d'1 a 10.<br><br>Per defecte: 3.<br><br>El paràmetre *Fill* no està disponible si *Draw* està establert en "Punts" o "Barra".| |*Falten dades*|0|ds.missingdatafunc.0|0 - *(per defecte)* Cap;<br>1 - Connectat;<br>2 - Tracta com a 0.<br><br>Paràmetre *Falquen dades* no disponible si *Draw* està establert a "Punts" o "Barra".| |*Eix Y*|0|ds.axisy.0|0 - *(per defecte)* Esquerra;<br>1 - Dreta.| |*Time shift*|1|ds.timeshift.0|Cadena de temps vàlida (per exemple, `3600`, `1h`, etc.).<br>Podeu utilitzar [sufixos de temps](/manual/appendix/suffixes#time -sufixos). També es permeten valors negatius.<br><br>Per defecte: `""` (buida).| |*Funció d'agregació*|0|ds.aggregate_function.0|0 - *(per defecte)* cap;<br>1 - mín;<br>2 - màxim;<br>3 - mitjana;<br>4 - recompte ;<br>5 - suma;<br>6 - primer;<br>7 - darrer.| |*Interval d'agregació*|1|ds.aggregate_interval.0|Cadena de temps vàlida (p. ex., `3600`, `1h`, etc.).<br>Podeu utilitzar [sufixos de temps](/manual/appendix/suffixes#time -sufixos).<br><br>Per defecte: `1h`.| |*Afegit*|0|ds.aggregate_grouping.0|0 - *(per defecte)* Cada element;<br>1 - Conjunt de dades.<br><br>El paràmetre *Afegit* no és pas disponible si la *funció d'agregació* és establerta a "cap".|

en-us	#### Data types  The Zabbix API supports the following data types as input:  |Type|Description| |--|--------| |boolean|A boolean value, accepts either `true` or `false`.| |flag|The value is considered to be `true` if it is passed and not equal to `null`; otherwise, it is considered to be `false`.| |integer|A whole number.| |float|A floating point number.| |string|A text string.| |text|A longer text string.| |timestamp|A Unix timestamp.| |array|An ordered sequence of values, that is, a plain array.| |object|An associative array.| |query|A value which defines, what data should be returned.<br><br>Can be defined as an array of property names to return only specific properties, or as one of the predefined values:<br>`extend` - returns all object properties;<br>`count` - returns the number of retrieved records, supported only by certain subselects.|  ::: noteimportant Zabbix API always returns values as strings or arrays only. :::
ca	#### Tipus de dades  L'API de Zabbix suporta, com a dades d'entrada, els següents tipus:  |Tipus|Descripció| |--|--------| |boolean|Un valor booleà accepta tant `true` com `false`.| |flag|El valor es considera `true` si no és igual a `null`, i `false` en cas contrari.| |integer|Un nombre sencer.| |float|Un nombre de coma flotant.| |string|Una cadena de text.| |text|Una cadena llarga de text.| |timestamp|Una marca de temps de Unix.| |array|Una seqüència ordenada de valors; o sia, una matriu simple.| |object|Una matriu associativa.| |query|Un valor que defineix quina informació ha de retornar.<br><br>Es pot definir com una matriu de noms de propietats, per tal de retornar només propietats específiques; o com un dels valors predefinits:<br>`extend` - retorna totes les propietats de l'objecte;<br>`count` - retorna el nombre de registres recuperats, suportats només per algunes subseleccions.|  ::: notaimportant L'API de Zabbix sempre retorna com a valors valors strings o arrays. :::

en-us	 ### DB schema update  A new column *name_upper* has been added to the database table **items**. The column contains a capitalized version of the item name or the LLD rule name. This change has been implemented to allow the use of the index with case-insensitive search for API query [optimization](#optimized-api-queries).
ca	### Actualització de l'esquema de la BBDD  S'ha afegit una nova columna *name_upper* a la taula de base de dades **elements**. La columna conté una versió en majúscula del nom de l'element o del nom de la regla LLD. Aquest canvi es va implementar per permetre l'ús de l'índex amb una cerca que no distingeix entre majúscules i minúscules per a les API de consulta [optimitzades](#optimized-api-queries).

en-us	# dcheck.get
ca	# dcheck.get

en-us	### Debian/Ubuntu  Open the `/etc/apt/sources.list.d/zabbix.list` and uncomment "Zabbix unstable repository".       # Zabbix unstable repository     deb https://repo.zabbix.com/zabbix/5.5/debian bullseye main     deb-src https://repo.zabbix.com/zabbix/5.5/debian bullseye main
ca	### Debian/Ubuntu  Obriu l'arxiu `/etc/apt/sources.list.d/zabbix.list` i descomenteu la línia "Zabbix unstable repository".       # Zabbix unstable repository     deb https://repo.zabbix.com/zabbix/5.5/debian bullseye main     deb-src https://repo.zabbix.com/zabbix/5.5/debian bullseye main

en-us	### Debug  Debug information of executed webhook script. The debug object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |logs|array|Array of [log entries](/manual/api/reference/script/object#Log entry).| |ms|string|Script execution duration in milliseconds.|
ca	### Depuració  Informació de depuració de l'script Webhook executat. L'objecte depuració té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |logs|array|Matriu d'[entrades de registre](/manual/api/reference/script/object#Log entry).| |ms|string|Temps d'execució de l'script en mil·lisegons.|

en-us	#### Debugging Java gateway  In case there are any problems with Java gateway or an error message that you see about an item in the frontend is not descriptive enough, you might wish to take a look at Java gateway log file.  By default, Java gateway logs its activities into /tmp/zabbix\_java.log file with log level "info". Sometimes that information is not enough and there is a need for information at log level "debug". In order to increase logging level, modify file lib/logback.xml and change the level attribute of <root> tag to "debug":      <root level="debug">       <appender-ref ref="FILE" />     </root>  Note that unlike Zabbix server or Zabbix proxy, there is no need to restart Zabbix Java gateway after changing logback.xml file - changes in logback.xml will be picked up automatically. When you are done with debugging, you can return the logging level to "info".  If you wish to log to a different file or a completely different medium like database, adjust logback.xml file to meet your needs. See [Logback Manual](http://logback.qos.ch/manual/) for more details.  Sometimes for debugging purposes it is useful to start Java gateway as a console application rather than a daemon. To do that, comment out PID\_FILE variable in settings.sh. If PID\_FILE is omitted, startup.sh script starts Java gateway as a console application and makes Logback use lib/logback-console.xml file instead, which not only logs to console, but has logging level "debug" enabled as well.  Finally, note that since Java gateway uses SLF4J for logging, you can replace Logback with the framework of your choice by placing an appropriate JAR file in lib directory. See [SLF4J Manual](http://www.slf4j.org/manual.html) for more details.
ca	#### Depuració de la passarel·la Java  En cas que hi hagi un problema amb la passarel·la de Java o si el missatge d'error sobre un element de la interfície no és prou descriptiu, potser voldreu fer una ullada al fitxer de registre de la passarel·la de Java.  Per defecte, la passarel·la de Java registra les seves activitats al fitxer /tmp/zabbix\_java.log amb el nivell de registre "info". De vegades aquesta informació no és suficient i cal tindre informació de nivell "depuració". Per augmentar el nivell de registre, editeu el fitxer lib/logback.xml i canvieu l'atribut level de l'etiqueta <root> a "debug":       <root level="debug">        <appender-ref ref="FILE" />      </root>  Tingueu en compte que, a diferència del servidor Zabbix o el proxy Zabbix, no cal reiniciar Zabbix Java Gateway després d'editar el fitxer logback.xml. Els canvis fets a logback.xml es tenen en compte automàticament. Quan hagueu acabat de depurar, podeu tornar a canviar el nivell de registre a "informació".  Si voleu iniciar sessió en un altre fitxer o en un suport completament diferent, com ara una base de dades, ajusteu el fitxer logback.xml segons les vostres necessitats. Consulteu el [manual de retrocés](http://logback.qos.ch/manual/) per obtindre més detalls.  De vegades, amb finalitats de depuració, és útil iniciar la passarel·la de Java com una aplicació de consola en lloc d'un dimoni. Per fer-ho, comenteu la variable PID\_FILE a settings.sh. Si s'omet PID\_FILE, l'script startup.sh inicia la passarel·la Java com una aplicació de consola i obliga a Logback a emprar el fitxer lib/logback-console.xml, que no només retorna els seus registres a la consola, sinó que també té el nivell de registre "depuració".  Finalment, tingueu en compte que, com Java Gateway utilitza SLF4J per al registre, podeu substituir Logback amb l'estructura que vulgueu col·locant un fitxer JAR adequat al directori lib. Consulteu el [manual SLF4J](http://www.slf4j.org/manual.html) per a més detalls.

en-us	#### Debugging Java gateway  Zabbix Java gateway log file is:      /var/log/zabbix/zabbix_java_gateway.log  If you like to increase the logging, edit the file:      /etc/zabbix/zabbix_java_gateway_logback.xml  and change `level="info"` to "debug" or even "trace" (for deep troubleshooting):      <configuration scan="true" scanPeriod="15 seconds">     [...]           <root level="info">                   <appender-ref ref="FILE" />           </root>      </configuration>
ca	#### Depuració de la passarel·la Java  L'arxiu de registre de la passarel·la Java Zabbix és:      /var/log/zabbix/zabbix_java_gateway.log  Si us cal augmentar el nivell de registre, editeu l'arxiu:      /etc/zabbix/zabbix_java_gateway_logback.xml  i modifiqueu `level="info"` a "debug" o encara "trace" (per un a revisió d'errades en profunditat):      <configuration scan="true" scanPeriod="15 seconds">     [...]           <root level="info">                   <appender-ref ref="FILE" />           </root>      </configuration>

en-us	#### Debugging Java gateway  Zabbix Java gateway log file is:      /var/log/zabbix/zabbix_java_gateway.log  If you like to increase the logging, edit the file:      /etc/zabbix/zabbix_java_gateway_logback.xml  and change `level="info"` to "debug" or even "trace" (for deep troubleshooting):      <configuration scan="true" scanPeriod="15 seconds">     [...]           <root level="info">                   <appender-ref ref="FILE" />           </root>      </configuration>
ca	#### Depuració de la passarel·la Java  L'arxiu de registre de la passarel·la Java Zabbix és:      /var/log/zabbix/zabbix_java_gateway.log  Si us cal augmentar el nivell de registre, editeu l'arxiu:      /etc/zabbix/zabbix_java_gateway_logback.xml  i modifiqueu `level="info"` a "debug" o encara "trace" (per un a revisió d'errades en profunditat):      <configuration scan="true" scanPeriod="15 seconds">     [...]           <root level="info">                   <appender-ref ref="FILE" />           </root>      </configuration>

en-us	#### Debugging Java gateway  Zabbix Java gateway log file is:      /var/log/zabbix/zabbix_java_gateway.log  If you like to increase the logging, edit the file:      /etc/zabbix/zabbix_java_gateway_logback.xml  and change `level="info"` to "debug" or even "trace" (for deep troubleshooting):      <configuration scan="true" scanPeriod="15 seconds">     [...]           <root level="info">                   <appender-ref ref="FILE" />           </root>      </configuration>
ca	#### Depuració de la passarel·la Java  L'arxiu de registre de la passarel·la Java Zabbix és:      /var/log/zabbix/zabbix_java_gateway.log  Si us cal augmentar el nivell de registre, editeu l'arxiu:      /etc/zabbix/zabbix_java_gateway_logback.xml  i modifiqueu `level="info"` a "debug" o encara "trace" (per un a revisió d'errades en profunditat):      <configuration scan="true" scanPeriod="15 seconds">     [...]           <root level="info">                   <appender-ref ref="FILE" />           </root>      </configuration>

en-us	### Default authentication  By default, Zabbix uses internal Zabbix authentication for all users. It is possible to change the default method to [LDAP](#ldap_authentication) system-wide or enable LDAP authentication only for specific user groups.  To set LDAP as default authentication method for all users, navigate to the *LDAP* tab and configure authentication parameters, then return to the *Authentication* tab and switch *Default authentication* selector to LDAP.  Note that the authentication method can be fine-tuned on the [user group](/manual/config/users_and_usergroups/usergroup) level. Even if LDAP authentication is set globally, some user groups can still be authenticated by Zabbix. These groups must have [frontend access](/manual/config/users_and_usergroups/usergroup#configuration) set to Internal. Vice versa, if internal authentication is used globally, LDAP authentication details can be specified and used for specific user groups whose [frontend access](/manual/config/users_and_usergroups/usergroup#configuration) is set to LDAP. If a user is included into at least one user group with LDAP authentication, this user will not be able to use internal authentication method.  [HTTP](#http_authentication) and [SAML 2.0](#saml_authentication) authentication methods can be used in addition to the default authentication method.
ca	### Autenticació per defecte  Per defecte, Zabbix empra l'autenticació interna de Zabbix per a tots els usuaris. És possible canviar el mètode predeterminat a [LDAP](#ldap_authentication) a tot el sistema o habilitar l'autenticació LDAP només per a grups d'usuaris específics.  Per establir LDAP com a mètode d'autenticació predeterminat per a tots els usuaris, aneu a la pestanya *LDAP* i configureu l'autenticació, després torneu a la pestanya *Autenticació* i activeu l'interruptor *Autenticació predeterminada* a LDAP.  Tingueu en compte que el mètode d'autenticació es pot perfeccionar al nivell [grup d'usuaris](/manual/config/users_and_usergroups/usergroup). Fins i tot si l'autenticació LDAP és configurada globalment, alguns grups d'usuaris encara poden ser autenticats per Zabbix. Aquests grups han de tindre [accés frontal](/manual/config/users_and_usergroups/usergroup#configuration) establert com a Intern. Per contra, si l'autenticació interna s'empra globalment, els detalls d'autenticació LDAP es poden especificar i emprar per a grups d'usuaris específics l'[accés frontal](/manual/config/users_and_usergroups/usergroup#configuration) és establert a LDAP. Si un usuari és inclòs en almenys un grup d'usuaris amb autenticació LDAP, aquest usuari no podrà emprar el mètode d'autenticació interna.  Els mètodes d'autenticació [HTTP](#http_authentication) i [SAML 2.0](#saml_authentication) es poden emprar a més del mètode d'autenticació predeterminat.

en-us	#### Default global regular expressions  Zabbix comes with several global regular expression in its default dataset.  |Name|Expression|Matches| |--|------|------| |*File systems for discovery*|`^(btrfs|ext2|ext3|ext4|jfs|reiser|xfs|ffs|ufs|jfs|jfs2|vxfs|hfs|refs|apfs|ntfs|fat32|zfs)$`|"btrfs" or "ext2" or "ext3" or "ext4" or "jfs" or "reiser" or "xfs" or "ffs" or "ufs" or "jfs" or "jfs2" or "vxfs" or "hfs" or "refs" or "apfs" or "ntfs" or "fat32" or "zfs"| |*Network interfaces for discovery*|`^Software Loopback Interface`|Strings starting with "Software Loopback Interface".| | |`^lo$`|"lo"| | |`^(In)?[Ll]oop[Bb]ack[0-9._]*$`|Strings that optionally start with "In", then have "L" or "l", then "oop", then "B" or "b", then "ack", which can be optionally followed by any number of digits, dots or underscores.| | |`^NULL[0-9.]*$`|Strings starting with "NULL" optionally followed by any number of digits or dots.| | |`^[Ll]o[0-9.]*$`|Strings starting with "Lo" or "lo" and optionally followed by any number of digits or dots.| | |`^[Ss]ystem$`|"System" or "system"| | |`^Nu[0-9.]*$`|Strings starting with "Nu" optionally followed by any number of digits or dots.| |*Storage devices for SNMP discovery*|`^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$`|"Physical memory" or "Virtual memory" or "Memory buffers" or "Cached memory" or "Swap space"| |*Windows service names for discovery*|`^(MMCSS|gupdate|SysmonLog|clr_optimization_v2.0.50727_32|clr_optimization_v4.0.30319_32)$`|"MMCSS" or "gupdate" or "SysmonLog" or strings like "clr\_optimization\_v2.0.50727\_32" and "clr\_optimization\_v4.0.30319\_32" where instead of dots you can put any character except newline.| |*Windows service startup states for discovery*|`^(automatic|automatic delayed)$`|"automatic" or "automatic delayed"|
ca	#### Expressions regulars globals per defecte  Zabbix conté per defecte diverses expressions regulars globals.  |Nom|Expressió|Correspondències| |--|-------|------| |*Sistemes de fitxers per a la descoberta*|`^(btrfs\|ext2\|ext3\|ext4\|jfs\|reiser\|xfs\|ffs\|ufs\|jfs\|jfs2\|vxfs\|hfs\| refs\|apfs\|ntfs\|fat32\|zfs)$`|"btrfs" o "ext2" o "ext3" o "ext4" o "jfs" o "reiser" o "xfs" o "ffs" o " ufs" o "jfs" o "jfs2" o "vxfs" o "hfs" o "refs" o "apfs" o "ntfs" o "fat32" o "zfs"| |*Interfícies de xarxa per a la descoberta*|`^Software Loopback Interface`|Cadenes que comencen per "Software Loopback Interface".| | |`^lo$`|"lo"| | |`^(In)?[Ll]oop[Bb]ack[0-9._]*$`|Cadenes que comencen opcionalment amb "In", després tenen "L" o "l", després "oop", després "B" o "b", després "ack", que pot anar seguit opcionalment de qualsevol nombre de dígits, punts o guions baixos.| | |`^NULL[0-9.]*$`|Cadenes que comencen per "NULL" seguides opcionalment per qualsevol nombre de dígits o punts.| | |`^[Ll]o[0-9.]*$`|Cadenes que comencen per "Lo" o "lo" i opcionalment seguides per qualsevol nombre de dígits o punts.| | |`^[Ss]ystem$`|"Sistema" o "sistema"| | |`^Nu[0-9.]*$`|Cadenes que comencen per "Nu" seguides opcionalment per qualsevol nombre de dígits o punts.| |*Dispositius d'emmagatzematge per a la descoberta d'SNMP*|`^(Memòria física\|Memòria virtual\|Buffers de memòria\|Memòria en memòria cau\|Espai d'intercanvi)$`|"Memòria física" o "Memòria virtual" o "Memòria intermèdia" o " Memòria a la memòria cau" o "Espai d'intercanvi"| |*Noms de serveis de Windows per a la descoberta*|`^(MMCSS\|gupdate\|SysmonLog\|clr_optimization_v2.0.50727_32\|clr_optimization_v4.0.30319_32)$`|"MMCSS" o "gupdate" o "SysmonLog like" o "SysmonLog" clr\_optimization\_v2.0.50727\_32" i "clr\_optimization\_v4.0.30319\_32" on en lloc de punts podeu posar qualsevol caràcter excepte la nova línia.| |*Estats d'inici del servei de Windows per a la descoberta*|`^(automàtic\|automàtic endarrerit)$`|"automàtic" o "automàtic endarrerit"|

en-us	 #### Default port numbers  The following list of open ports per component is applicable for default configuration:  |Zabbix component|Port number|Protocol|Type of connection| |-------|-------|-------|-------| |Zabbix agent|10050|TCP|on demand| |Zabbix agent 2|10050|TCP|on demand| |Zabbix server|10051|TCP|on demand| |Zabbix proxy|10051|TCP|on demand| |Zabbix Java gateway|10052|TCP|on demand| |Zabbix web service|10053|TCP|on demand| |Zabbix frontend|80|HTTP|on demand| |^|443|HTTPS|on demand| |Zabbix trapper|10051 |TCP| on demand|  ::: noteclassic The port numbers should be open in firewall to enable Zabbix communications. Outgoing TCP connections usually do not require explicit firewall settings. ::: 
ca	 #### Nombres de port per defecte  La següent llista de ports oberts per component s'aplica a la configuració predeterminada:  |Component Zabbix|Nombre de port|Protocol|Tipus de connexió| |-------|--------|--------|--------| |Agent Zabbix|10050|TCP|a petició| |Agent Zabbix 2|10050|TCP|a petició| |Servidor Zabbix|10051|TCP|a petició| |Proxy Zabbix|10051|TCP|a petició| |Zabbix Java Gateway|10052|TCP|a petició| |Servei web Zabbix|10053|TCP|a petició| |Interfaz Zabbix|80|HTTP|a petició| |^|443|HTTPS|a petició| |Trapper Zabbix|10051 |TCP|a petició |  :::noteclassic Els nombres de port s'han d'obrir al tallafocs per permetre les comunicacions de Zabbix. Les connexions TCP de sortida generalment no requereixen una configuració explícita del tallafocs. :::

en-us	#### Default user roles  By default, Zabbix is configured with four user roles, which have a pre-defined set of permissions:  -   Admin role -   Guest role -   Super admin role -   User role  ![](../../../../../assets/en/manual/web_interface/user_roles0.png){width="600"}  The list of all users assigned the respective role is displayed. The users included in disabled groups are stated in red.  ::: noteclassic  Default *Super admin role* cannot be modified or deleted, because at least one Super admin user with unlimited privileges must exist in Zabbix.  :::  Zabbix users with type Super admins and proper permissions can modify or delete existing roles or create new custom roles.  To create a new role, click on the *Create user role* button at the top right corner. To update an existing role, press on the role name to open the configuration form.  ![](../../../../../assets/en/manual/web_interface/user_role.png)  Available permission options along with default permission sets for pre-configured user roles in Zabbix are described below.  | | | | | | | | |-|----------|--------------------------------------|----|----|----|----| |**Parameter**|<|**Description**|**Default user roles**|<|<|<| | |<|<|*Super admin role*|*Admin role*|*User role*|*Guest role*| |User type|<|Selected user type determines the list of available permissions.<br>Upon selecting a user type, all available permissions for this user type are granted by default.<br>Uncheck the checkbox(es) to revoke certain permissions for the user role.<br>Checkboxes for permissions not available for this user type are grayed out.|Super admin|Admin|User|User| |**Access to UI elements**|<|<|<|<|<|<| |*Monitoring*|<|<|<|<|<|<| | |Dashboard|Enable/disable access to a specific Monitoring menu section and underlying pages.|Yes|Yes|Yes|Yes| |^|Problems|^|^|^|^|^| |^|Hosts|^|^|^|^|^| |^|Latest data|^|^|^|^|^| |^|Maps|^|^|^|^|^| |^|Discovery|^|^|^|No|No| |*Services*|<|<|<|<|<|<| | |Services|Enable/disable access to a specific Services menu section and underlying pages.|Yes|Yes|Yes|Yes| |^|Service actions|^|^|^|No|No| |^|SLA|^|^|^|^|^| |^|SLA report|^|^|^|Yes|Yes| |*Inventory*|<|<|<|<|<|<| | Overview|Enable/disable access to a specific Inventory menu section and underlying pages.|Yes|Yes|Yes|Yes| |^|Hosts|^|^|^|^|^| |*Reports*|<|<|<|<|<|<| | |System information|Enable/disable access to a specific Reports menu section and underlying pages.|Yes|No|No|No| |^|Availability report|^|^|Yes|Yes|Yes| |^|Triggers top 100|^|^|^|^|^| |^|Audit|^|^|No|No|No| |^|Action log|^|^|^|^|^| |^|Notifications|^|^|Yes|^|^| |^|Scheduled reports|^|^|^|^|^| |*Configuration*|<|<|<|<|<|<| | |Host groups|Enable/disable access to a specific *Configuration* menu section and underlying pages.|Yes|Yes|No|No| |^|Templates|^|^|^|^|^| |^|Hosts|^|^|^|^|^| |^|Maintenance|^|^|^|^|^| |^|Actions|^|^|^|^|^| |^|Event correlation|^|^|No|^|^| |^|Discovery|^|^|Yes|^|^| |*Administration*|<|<|<|<|<|<| | |General|Enable/disable access to a specific *Administration* menu section and underlying pages.|Yes|No|No|No| |^|Proxies|^|^|^|^|^| |^|Authentication|^|^|^|^|^| |^|User groups|^|^|^|^|^| |^|User roles|^|^|^|^|^| |^|Users|^|^|^|^|^| |^|Media types|^|^|^|^|^| |^|Scripts|^|^|^|^|^| |^|Queue|^|^|^|^|^| |*Default access to new UI elements*|<|Enable/disable access to the custom UI elements. Modules, if present, will be listed below.|Yes|Yes|Yes|Yes| |**Access to services**|<|<|<|<|<|<| | |Read-write access to services|Select read-write access to services:<br>**None** - no access at all<br>**All** - access to all services is read-write<br>**Service list** - select services for read-write access<br><br>The read-write access, if granted, takes precedence over the read-only access settings and is dynamically inherited by the child services.|All|All|None|None| |^|Read-write access to services with tag|Specify tag name and, optionally, value to additionally grant read-write access to services matching the tag.<br>This option is available if 'Service list' is selected in the *Read-write access to services* parameter.<br>The read-write access, if granted, takes precedence over the read-only access settings and is dynamically inherited by the child services.|^|^|^|^| |^|Read-only access to services|Select read-only access to services:<br>**None** - no access at all<br>**All** - access to all services is read-only<br>**Service list** - select services for read-only access<br><br>The read-only access does not take precedence over the read-write access and is dynamically inherited by the child services.|^|^|All|All| |^|Read-only access to services with tag|Specify tag name and, optionally, value to additionally grant read-only access to services matching the tag.<br>This option is available if 'Service list' is selected in the *Read-only access to services* parameter.<br>The read-only access does not take precedence over the read-write access and is dynamically inherited by the child services.|^|^|^|^| |**Access to modules**|<|<|<|<|<|<| | |<Module name>|Allow/deny access to a specific module. Only enabled modules are shown in this section. It is not possible to grant or restrict access to a module that is currently disabled.|Yes|Yes|Yes|Yes| |^|*Default access to new modules*|Enable/disable access to modules that may be added in the future.|^|^|^|^| |**Access to API**|<|<|<|<|<|<| | |*Enabled*|Enable/disable access to API.|Yes|Yes|Yes|No| |^|*API methods*|Select *Allow list* to allow only specified API methods or *Deny list* to restrict only specified API methods.<br><br>In the search field, start typing the method name, then select the method from the auto-complete list.<br>You can also press the Select button and select methods from the full list available for this user type. Note, that if certain action from the Access to actions block is unchecked, users will not be able to use API methods related to this action.<br><br>Wildcards are supported. Examples: `dashboard.*` (all methods of 'dashboard.' API service) `*` (any method), `*.export` (methods with '.export' name from all API services).<br><br>If no methods have been specified the Allow/Deny list rule will be ignored.|^|^|^|^| |**Access to actions**|<|<|<|<|<|<| | |Create and edit dashboards|Clearing this checkbox will also revoke the rights to use `.create`, `.update` and `.delete` API methods for the corresponding elements.|Yes|Yes|Yes|No| |^|Create and edit maps|^|^|^|^|^| |^|Create and edit maintenance|^|^|^|No|^| |^|Add problem comments|Clearing this checkbox will also revoke the rights to perform corresponding action via `event.acknowledge` API method.|^|^|Yes|^| |^|Change severity|^|^|^|^|^| |^|Acknowledge problems|^|^|^|^|^| |^|Close problems|^|^|^|^|^| |^|Execute scripts|Clearing this checkbox will also revoke the rights to use the `script.execute` API method.|^|^|^|^| |^|Manage API tokens|Clearing this checkbox will also revoke the rights to use all `token.` API methods.|^|^|^|^| |^|Manage scheduled reports|Clearing this checkbox will also revoke the rights to use all `report.` API methods.|^|^|No|^| |^|Manage SLA|Enable/disable the rights to manage [SLA](/manual/web_interface/frontend_sections/services/sla).|^|^|^|^| |^|Default access to new actions|Enable/disable access to new actions.|^|^|Yes|^|  Notes:  -   Each user may have only one role assigned. -   If an element is restricted, users will not be able to access it     even by entering a direct URL to this element into the browser. -   Users of type *User* or *Admin* cannot change their own role     settings. -   Users of type *Super admin* can modify settings of their own role     (not available for the default *Super admin role*), but not the user     type. -   Users of all levels cannot change their own user type.  See also:  -   [Configuring a user](/manual/config/users_and_usergroups/user)
ca	#### Rols d'usuari per defecte  Per defecte, Zabbix es configura amb quatre rols d'usuari, que tenen el següent conjunt predefinit de permisos:  - Rol d'administrador - Rol de convidat - Rol de superadministrador - Rol d'usuari  ![](../../../../../assets/en/manual/web_interface/user_roles0.png){width="600"}  Es mostra la llista de tots els usuaris assignats al rol respectiu. Els usuaris deshabilitats es marquen en vermell.  ::: noteclassic   El *rol de superadministrador* per defecte no es pot modificar ni suprimir, doncs com a mínim ha d'existir un usuari superadministrador amb privilegis il·limitats. :::  Els usuaris de Zabbix amb el tipus Superadministradors i els permisos adequats poden modificar o esborrar els rols existents o crear nous rols personalitzats.  Per crear un rol nou, feu clic al botó *Crear un rol d'usuari* a la cantonada superior dreta. Per actualitzar un rol existent, feu clic al nom del rol per obrir el formulari de configuració.  ![](../../../../../assets/en/manual/web_interface/user_role.png)  Les opcions de permisos disponibles juntament amb els conjunts de permisos predeterminats dels rols d'usuari  es descriuen tot seguit.  | | | | | | | | |-|-----------|-------------------------------------- --|----|----|----|----| |**Paràmetre**|<|**Descripció**|**Rols d'usuari predeterminats**|<|<|<| | |<|<|*Rol de superadministrador*|*Rol d'administrador*|*Rol d'usuari*|*Rol de convidat*| |Tipus d'usuari|<|El tipus d'usuari seleccionat determina la llista de permisos disponibles.<br>En seleccionar un tipus d'usuari, tots els permisos disponibles per a aquest tipus d'usuari s'atorguen de manera predeterminada.<br>Desmarqueu les caselles de selecció per revocar determinats permisos. per al rol d'usuari.<br>Les caselles de selecció dels permisos no disponibles per a aquest tipus d'usuari estan atenuades.|Super administrador|Administrador|Usuari|Usuari| |**Accés als elements de la IU**|<|<|<|<|<|<| |*Vigilància*|<|<|<|<|<|<| | |Tauler|Activar/desactivar l'accés a una secció específica del menú de Monitoratge i pàgines subjacents.|Sí|Sí|Sí|Sí| |^|Problemes|^|^|^|^|^| |^|Equips|^|^|^|^|^| |^|Darreres dades|^|^|^|^|^| |^|Mapes|^|^|^|^|^| |^|Descoberta|^|^|^|No|No| |*Serveis*|<|<|<|<|<|<| | |Serveis|Activar/desactivar l'accés a una secció específica del menú Serveis i pàgines subjacents.|Sí|Sí|Sí|Sí| |^|Accions de servei|^|^|^|No|No| |^|SLA|^|^|^|^|^| |^|Informe SLA|^|^|^|Sí|Sí| |*Inventari*|<|<|<|<|<|<| | Vista general|Activar/desactivar l'accés a una secció específica del menú d'Inventari i pàgines subjacents.|Sí|Sí|Sí|Sí| |^|Equips|^|^|^|^|^| |*Informes*|<|<|<|<|<|<| | |Informació del sistema|Activar/desactivar l'accés a una secció específica del menú Informes i pàgines subjacents.|Sí|No|No|No| |^|Informe de disponibilitat|^|^|Sí|Sí|Sí| |^|Activa els 100 primers|^|^|^|^|^| |^|Auditoria|^|^|No|No|No| |^|Registre d'accions|^|^|^|^|^| |^|Notificacions|^|^|Sí|^|^| |^|Informes programats|^|^|^|^|^| |*Configuració*|<|<|<|<|<|<| | |Grups d'equips|Activar/desactivar l'accés a una secció específica del menú *Configuració* i pàgines subjacents.|Sí|Sí|No|No| |^|Plantilles|^|^|^|^|^| |^|Equips|^|^|^|^|^| |^|Manteniment|^|^|^|^|^| |^|Accions|^|^|^|^|^| |^|Correlació d'esdeveniments|^|^|No|^|^| |^|Descoberta|^|^|Sí|^|^| |*Administració*|<|<|<|<|<|<| | |General|Activar/desactivar l'accés a una secció específica del menú *Administració* i pàgines subjacents.|Sí|No|No|No| |^|Proxies|^|^|^|^|^| |^|Autenticació|^|^|^|^|^| |^|Grups d'usuaris|^|^|^|^|^| |^|Rols d'usuari|^|^|^|^|^| |^|Usuaris|^|^|^|^|^| |^|Tipus de mitjans|^|^|^|^|^| |^|Guions|^|^|^|^|^| |^|Cua|^|^|^|^|^| |*Accés per defecte als nous elements de la IU*|<|Activar/desactivar l'accés als elements de la IU personalitzats. Els mòduls, si n'hi ha, es mostraran a continuació.|Sí|Sí|Sí|Sí| |**Accés als serveis**|<|<|<|<|<|<| | |Accés de lectura i escriptura als serveis|Trieu l'accés de lectura i escriptura als serveis:<br>**Cap** - cap accés<br>**Tots** - l'accés a tots els serveis és de lectura i escriptura<br>**Llista de serveis** - trieu serveis per a l'accés de lectura i escriptura<br><br>L'accés de lectura i escriptura, si es concedeix, té prioritat sobre la configuració d'accés només de lectura i és heretat dinàmicament pels serveis secundaris.|Tots|Tots |Cap|Cap| |^|Accés de lectura i escriptura als serveis amb etiqueta|Especifiqueu el nom de l'etiqueta i, opcionalment, el valor per concedir, addicionalment, accés de lectura i escriptura als serveis que coincideixin amb l'etiqueta.<br>Aquesta opció està disponible si es tria "Llistat de serveis" a *Paràmetre d'accés de lectura i escriptura als serveis*.<br>L'accés de lectura i escriptura, si es concedeix, té prioritat sobre la configuració d'accés només de lectura i és heretat dinàmicament pels serveis secundaris.|^|^|^|^| |^|Accés de només lectura als serveis|Trieu l'accés només de lectura als serveis:<br>**Cap** - no hi ha accés en absolut<br>**Tots** - l'accés a tots els serveis és només de lectura<br >**Llista de serveis** - trieu serveis per a l'accés només de lectura<br><br>L'accés només de lectura no té prioritat sobre l'accés de lectura i escriptura i és heretat dinàmicament pels serveis secundaris.|^|^| Tots|Tots| |^|Accés de només lectura als serveis amb etiqueta|Especifiqueu el nom de l'etiqueta i, opcionalment, el valor per concedir, addicionalment, accés de només lectura als serveis que coincideixin amb l'etiqueta.<br>Aquesta opció està disponible si es tria "Llista de serveis" a *Paràmetre d'accés només de lectura als serveis*.<br>L'accés només de lectura no té prioritat sobre l'accés de lectura i escriptura i és heretat dinàmicament pels serveis secundaris.|^|^|^|^| |**Accés als mòduls**|<|<|<|<|<|<| ||<Nom del mòdul>|Permetre/denegar l'accés a un mòdul específic. En aquesta secció només es mostren els mòduls habilitats. No és possible concedir o restringir l'accés a un mòdul que actualment està desactivat.|Sí|Sí|Sí|Sí| |^|*Accés per defecte als mòduls nous*|Activar/desactivar l'accés als mòduls que es poden afegir en el futur.|^|^|^|^| |**Accés a l'API**|<|<|<|<|<|<| | |*Activat*|Activar/desactivar l'accés a l'API.|Sí|Sí|Sí|No| |^|*Mètodes API*|Seleccioneu *Permetre llista* per permetre només els mètodes API especificats o *Denegar llista* per restringir només els mètodes API especificats.<br><br>Al camp de cerca, comenceu a escriure el nom del mètode i, a continuació, seleccioneu el mètode de la llista d'emplenament automàtic.<br>També podeu prémer el botó Seleccionar i seleccionar mètodes de la llista completa disponible per a aquest tipus d'usuari. Tingueu en compte que si determinades accions del bloc Accés a les accions no estan marcades, els usuaris no podran emprar els mètodes de l'API relacionats amb aquesta acció.<br><br>S'admeten els comodins. Exemples: `tauler de control.*` (tots els mètodes del servei de l'API 'tauler de control') `*` (qualsevol mètode), `*.export' (mètodes amb el nom '.export' de tots els serveis de l'API).<br><br >Si no s'ha especificat cap mètode, s'ignorarà la regla de llista Permetre/Denegar.|^|^|^|^| |**Accés a les accions**|<|<|<|<|<|<| | |Crear i editar taulers de control|Si desactiveu aquesta casella de selecció també es revocaran els drets per emprar els mètodes API `.create`, `.update` i `.delete` per als elements corresponents.|Sí|Sí|Sí|No| |^|Crear i editar mapes|^|^|^|^|^| |^|Crear i editar manteniment|^|^|^|No|^| |^|Afegeix comentaris de problemes|Si s'esborra aquesta casella de selecció també es revocaran els drets per dur a terme l'acció corresponent mitjançant el mètode de l'API `event.acknowledge`.|^|^|Sí|^| |^|Canvia la gravetat|^|^|^|^|^| |^|Reconeix els problemes|^|^|^|^|^| |^|Tancar els problemes|^|^|^|^|^| |^|Executar scripts|Si desactiveu aquesta casella de selecció també es revocaran els drets per emprar el mètode API `script.execute`.|^|^|^|^| |^|Gestiona els testimonis de l'API|Si desactiveu aquesta casella de selecció també es revocaran els drets d'emprar tots els mètodes de l'API `token.|^|^|^|^| |^|Gestiona els informes programats|Si esborra aquesta casella de selecció també es revocaran els drets d'emprar tots els mètodes de l'API "informe".|^|^|No|^| |^|Gestiona SLA|Activa/desactiva els drets per gestionar [SLA](/manual/web_interface/frontend_sections/services/sla).|^|^|^|^| |^|Accés per defecte a accions noves|Activar/desactivar l'accés a accions noves.|^|^|Sí|^|  Notes:  - Cada usuari només pot tindre un rol assignat. - Si un element és restringit, els usuaris no hi podran accedir ni introduint una URL directa a aquest element al navegador. - Els usuaris del tipus *Usuari* o *Administrador* no poden canviar la configuració del seu propi rol. - Els usuaris del tipus *Super administrador* poden modificar la configuració de la seva pròpia funció (no disponible per al *rol de superadministrador* per defecte), però no el tipus d'usuari. - Els usuaris de tots els nivells no poden canviar el seu propi tipus d'usuari.  Veieu també:  - [Configuració d'usuari](/manual/config/users_and_usergroups/user)

en-us	### Default values for Zabbix agent 2  Zabbix agent 2 plugins now allow to define default values for connecting to monitoring targets in the configuration file. If no value is specified in an item key or a named session, the plugin will use the value defined in the corresponding default parameter. New parameters have the structure `Plugins.<PluginName>.Default.<Parameter>` - for example, `Plugins.MongoDB.Default.Uri=tcp://localhost:27017`. See for more info:  - [Configuring plugins](/manual/config/items/plugins#configuring-plugins) - [Plugin configuration file parameters](/manual/appendix/config/zabbix_agent2_plugins)
ca	### Valors per defecte de l'agent 2 de Zabbix  Els plugins de l'agent 2 de Zabbix ara permeten definir valors predeterminats per connectar als destinataris de monitoratge al fitxer de configuració. Si no s'especifica cap valor en una clau d'element o una sessió amb nom, el plugin emprarà el valor definit al paràmetre predeterminat corresponent. Els nous paràmetres tenen l'estructura `Plugins.<PluginName>.Default.<Parameter>` - per exemple, `Plugins.MongoDB.Default.Uri=tcp://localhost:27017`. Per veure més informació:  - [Configurant plugins](/manual/extensions/plugins#configuring-plugins) - [Paràmetres d'arxiu de configuració de plugin](/manual/appendix/config/zabbix_agent2_plugins)

en-us	##### Default values  Since Zabbix 6.0.18, you can set default values for the connection-related parameters (URI, username, password, etc.) in the configuration file in the format:   *Plugins.<PluginName>.Default.<Parameter>=<Value>*  For example, *Plugins.Mysql.Default.Username=zabbix*, *Plugins.MongoDB.Default.Uri=tcp://127.0.0.1:27017*, etc.  If a value for such parameter is not provided in an item key or in the [named session](#named-sessions) parameters, the plugin will use the default value. If a default parameter is also undefined, hardcoded defaults will be used.  :::note-classic If an item key does not have any parameters, Zabbix agent 2 will attempt to collect the metric using values defined in the default parameters section. :::
ca	##### Valors per defecte  Des de Zabbix 6.0.18, podeu establir els valors per defecte per als paràmetres relatius a les connexions (URI, usuari, mot de pas, etc.) a l'arxiu de configuració, en aquest format:  *Plugins.<PluginName>.Default.<Parameter>=<Value>*  Per exemple, *Plugins.Mysql.Default.Username=zabbix*, *Plugins.MongoDB.Default.Uri=tcp://127.0.0.1:27017*, etc.  Si no es proporciona un valor de cada paràmetre a una clau d'element dels paràmetres de la [sessió anomenada](#named-sessions), el plugin emprarà el valor per defecte. Si algun paràmetre no s'ha definit, s'empraran els valors en brut.  :::note-classic Si una clau d'element no té paràmetres, l'agent 2 de Zabbix provarà a collir la mètrica emprant valors definits a la secció de paràmetres per defecte. :::

en-us	##### - Defining items  Each item is defined in a ZBX\_METRIC structure:  ``` {.c} typedef struct {     char        *key;     unsigned    flags;     int     (*function)();     char        *test_param; } ZBX_METRIC; ```  Here, **key** is the item key (e.g., "dummy.random"), **flags** is either CF\_HAVEPARAMS or 0 (depending on whether the item accepts parameters or not), **function** is a C function that implements the item (e.g., "zbx\_module\_dummy\_random"), and **test\_param** is the parameter list to be used when Zabbix agent is started with the "-p" flag (e.g., "1,1000", can be NULL). An example definition may look like this:  ``` {.c} static ZBX_METRIC keys[] = {     { "dummy.random", CF_HAVEPARAMS, zbx_module_dummy_random, "1,1000" },     { NULL } } ```  Each function that implements an item should accept two pointer parameters, the first one of type AGENT\_REQUEST and the second one of type AGENT\_RESULT:  ``` {.c} int zbx_module_dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result) {     ...      SET_UI64_RESULT(result, from + rand() % (to - from + 1));      return SYSINFO_RET_OK; } ```  These functions should return SYSINFO\_RET\_OK, if the item value was successfully obtained. Otherwise, they should return SYSINFO\_RET\_FAIL. See example "dummy" module below for details on how to obtain information from AGENT\_REQUEST and how to set information in AGENT\_RESULT.
ca	##### - Definició d'elements  Cada element es defineix en una estructura ZBX\_METRIC:  ``` {.c} typedef struct {  char *key;  unsigned flags;  int (*function)();  char *test_param; } ZBX_METRIC; ```  Aquí **key** és la clau de l'element (per exemple, "dummy.random"), **flags** és CF\_HAVEPARAMS o 0 (segons si l'element admet paràmetres o no), **function** és una funció en C que implementa l'element (per exemple, "zbx\_module\_dummy\_random"), i **test\_param** és el llistat de paràmetres que s'emprarà quan l'agent Zabbix s'inicia amb l'opció "-p" (p. "1.1000", pot ser NULL). Un exemple de definició podria semblar-se a:  ``` {.c} static ZBX_METRIC keys[] = {  { "dummy.random", CF_HAVEPARAMS, zbx_module_dummy_random, "1,1000" },  { NULL } } ```  Cada funció que implementa un element ha d'acceptar dos paràmetres de punter, el primer de tipus AGENT\_REQUEST i el segon de tipus AGENT\_RESULT:  ``` {.c} int zbx_module_dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result) {  ...   SET_UI64_RESULT(result, from + rand() % (to - from + 1));   return SYSINFO_RET_OK; } ```  Aquestes funcions haurien de retornar SYSINFO\_RET\_OK, si el valor de l'element s'ha obtingut correctament. En cas contrari, haurien de retornar SYSINFO\_RET\_FAIL. Veieu el mòdul "dummy" d'exemple a continuació amb detalls sobre com obtindre informació d'AGENT\_REQUEST i com configurar la informació a AGENT\_RESULT.