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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

en-us	#### Creating MFA methods  Create a "Zabbix TOTP" MFA method utilizing time-based one-time passwords (TOTP), with the hash function for generating TOTP codes set to SHA-1 and the verification code length set to 6 digits.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "mfa.create",     "params": {         "type": 1,         "name": "Zabbix TOTP",         "hash_function": 1,         "code_length": 6     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "mfaids": [             "1"         ]     },     "id": 1 } ```
ca	#### Crear mètodes MFA  Crear un mètode MFA "Zabbix TOTP" emprant passwords únics basats en temps (TOTP), amb la funció hash per generar codis TOTP estabñerta a SHA-1 i la longitud de verificació de codi establerta a 6 dígits.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "mfa.create",     "params": {         "type": 1,         "name": "Zabbix TOTP",         "hash_function": 1,         "code_length": 6     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "mfaids": [             "1"         ]     },     "id": 1 } ```

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

en-us	#### Creating user roles  Create the following roles with the corresponding privileges:  -   **zbx_srv** - role for running Zabbix server and proxy:  ```sql CREATE ROLE zbx_srv; GRANT CONNECT ON DATABASE zabbix TO zbx_srv; GRANT USAGE ON SCHEMA zabbix TO zbx_srv; ALTER DEFAULT PRIVILEGES FOR ROLE usr_owner IN SCHEMA zabbix GRANT DELETE, INSERT, SELECT, UPDATE ON TABLES TO zbx_srv; ALTER DEFAULT PRIVILEGES FOR ROLE usr_owner IN SCHEMA zabbix GRANT SELECT, UPDATE, USAGE ON sequences TO zbx_srv; ```  -   **zbx_web** - role for running Zabbix frontend and API:  ```sql CREATE ROLE zbx_web; GRANT CONNECT ON DATABASE zabbix TO zbx_web; GRANT USAGE ON SCHEMA zabbix TO zbx_web; ALTER DEFAULT PRIVILEGES FOR ROLE usr_owner IN SCHEMA zabbix GRANT DELETE, INSERT, SELECT, UPDATE ON TABLES TO zbx_web; ALTER DEFAULT PRIVILEGES FOR ROLE usr_owner IN SCHEMA zabbix GRANT SELECT, UPDATE, USAGE ON sequences TO zbx_web; ```  -   **zbx_bckp** - role for table backup:  ```sql CREATE ROLE zbx_bckp; GRANT CONNECT ON DATABASE zabbix TO zbx_bckp; GRANT USAGE ON SCHEMA zabbix TO zbx_bckp; ALTER DEFAULT PRIVILEGES FOR ROLE usr_owner IN SCHEMA zabbix GRANT SELECT ON TABLES TO zbx_bckp; ALTER DEFAULT PRIVILEGES FOR ROLE usr_owner IN SCHEMA zabbix GRANT SELECT, UPDATE, USAGE ON sequences TO zbx_bckp; ```  ::: noteimportant Table restoration is possible only by the database owner. :::  After creating roles, they can be assigned to users.
ca	#### Creació de rols d'usuari  Creeu els rols següents amb els privilegis corresponents:  - **zbx_srv** - rol per executar el servidor i el proxy Zabbix:  ```sql CREATE ROLE zbx_srv; GRANT CONNECT ON DATABASE zabbix TO zbx_srv; GRANT USAGE ON SCHEMA zabbix TO zbx_srv; ALTER DEFAULT PRIVILEGES FOR ROLE usr_owner IN SCHEMA zabbix GRANT DELETE, INSERT, SELECT, UPDATE ON TABLES TO zbx_srv; ALTER DEFAULT PRIVILEGES FOR ROLE usr_owner IN SCHEMA zabbix GRANT SELECT, UPDATE, USAGE ON sequences TO zbx_srv; ```  - **zbx_web** - rol per executar la interfície i l'API de Zabbix:  ```sql CREATE ROLE zbx_web; GRANT CONNECT ON DATABASE zabbix TO zbx_web; GRANT USAGE ON SCHEMA zabbix TO zbx_web; ALTER DEFAULT PRIVILEGES FOR ROLE usr_owner IN SCHEMA zabbix GRANT DELETE, INSERT, SELECT, UPDATE ON TABLES TO zbx_web; ALTER DEFAULT PRIVILEGES FOR ROLE usr_owner IN SCHEMA zabbix GRANT SELECT, UPDATE, USAGE ON sequences TO zbx_web; ```  - **zbx_bckp** - rol per a la còpia de seguretat de la taula:  ```sql CREATE ROLE zbx_bckp; GRANT CONNECT ON DATABASE zabbix TO zbx_bckp; GRANT USAGE ON SCHEMA zabbix TO zbx_bckp; ALTER DEFAULT PRIVILEGES FOR ROLE usr_owner IN SCHEMA zabbix GRANT SELECT ON TABLES TO zbx_bckp; ALTER DEFAULT PRIVILEGES FOR ROLE usr_owner IN SCHEMA zabbix GRANT SELECT, UPDATE, USAGE ON sequences TO zbx_bckp; ```  ::: noteimportant La restauració de la taula només és possible pel propietari de la base de dades. :::  Després de crear els rols, es poden assignar als usuaris.

en-us	#### Creating user roles  Create the following roles with the corresponding privileges:  -   **zbx_srv** - role for running Zabbix server and proxy:  ```sql CREATE ROLE 'zbx_srv'; GRANT DELETE, INSERT, SELECT, UPDATE ON zabbix.* TO 'zbx_srv'; FLUSH PRIVILEGES; ```  -   **zbx_web** - role for running Zabbix frontend and API:  ```sql CREATE ROLE 'zbx_web'; GRANT DELETE, INSERT, SELECT, UPDATE ON zabbix.* TO 'zbx_web'; FLUSH PRIVILEGES; ```  -   **zbx_bckp** - role for table backup:  ```sql CREATE ROLE 'zbx_bckp'; GRANT LOCK TABLES, TRIGGER, SELECT ON zabbix.* TO 'zbx_bckp'; GRANT process ON *.* TO 'zbx_bckp'; FLUSH PRIVILEGES; ```  ::: noteimportant Table restoration and upgrade should be performed by the database owner. :::  -   **zbx_part** - role with a reduced set of privileges for database partitioning;     note that this role can be created only after the database has been created, as it grants privileges on specific database tables:  ```sql CREATE ROLE 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.history TO 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.history_uint TO 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.history_str TO 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.history_text TO 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.history_log TO 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.trends TO 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.trends_uint TO 'zbx_part'; -- For MariaDB: skip the next line (GRANT session_variables_admin ON *.* TO 'zbx_part';) GRANT session_variables_admin ON *.* TO 'zbx_part'; GRANT SELECT ON zabbix.dbversion TO 'zbx_part'; GRANT SELECT, DELETE ON zabbix.housekeeper TO 'zbx_part'; FLUSH PRIVILEGES; ```  After creating roles, they can be assigned to users.
ca	#### Creació de rols d'usuari  Creeu els rols següents amb els privilegis corresponents:  - **zbx_srv** - rol per executar el servidor i el proxy Zabbix:  ```sql CREATE ROLE 'zbx_srv'; GRANT DELETE, INSERT, SELECT, UPDATE ON zabbix.* TO 'zbx_srv'; FLUSH PRIVILEGES; ```  - **zbx_web** - rol per executar la interfície i l'API de Zabbix:  ```sql CREATE ROLE 'zbx_web'; GRANT DELETE, INSERT, SELECT, UPDATE ON zabbix.* TO 'zbx_web'; FLUSH PRIVILEGES; ```  - **zbx_bckp** - rol per a la còpia de seguretat de la taula:  ```sql CREATE ROLE 'zbx_bckp'; GRANT LOCK TABLES, TRIGGER, SELECT ON zabbix.* TO 'zbx_bckp'; GRANT process ON *.* TO 'zbx_bckp'; FLUSH PRIVILEGES; ```  ::: noteimportant La restauració i l'actualització de la taula l'ha de fer el propietari de la base de dades. :::  - **zbx_part** - rol amb un conjunt reduït de privilegis per a la partició de bases de dades;     tingueu en compte que aquesta funció només es pot crear després de crear la base de dades, ja que atorga privilegis a taules de bases de dades específiques:  ```sql CREATE ROLE 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.history TO 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.history_uint TO 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.history_str TO 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.history_text TO 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.history_log TO 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.trends TO 'zbx_part'; GRANT SELECT, ALTER, DROP ON zabbix.trends_uint TO 'zbx_part'; -- For MariaDB: skip the next line (GRANT session_variables_admin ON *.* TO 'zbx_part';) GRANT session_variables_admin ON *.* TO 'zbx_part'; GRANT SELECT ON zabbix.dbversion TO 'zbx_part'; GRANT SELECT, DELETE ON zabbix.housekeeper TO 'zbx_part'; FLUSH PRIVILEGES; ```  Després de crear els rols, es poden assignar als usuaris.

en-us	#### Creating users  Assuming that the pluggable database (PDB) owner is `usr_owner`, creating two additional users with the corresponding privileges (for daily operations) are recommended:  -   **usr_srv** - user for running Zabbix server; -   **usr_web** - user for running Zabbix frontend and API.  These users must be created by the PDB owner (`usr_owner`) using the following commands:  ```sql CREATE USER usr_srv IDENTIFIED BY "usr_srv" DEFAULT TABLESPACE "usr_owner" TEMPORARY TABLESPACE temp; CREATE USER usr_web IDENTIFIED BY "usr_web" DEFAULT TABLESPACE "usr_owner" TEMPORARY TABLESPACE temp;  GRANT CREATE SESSION, DELETE ANY TABLE, INSERT ANY TABLE, SELECT ANY TABLE, UPDATE ANY TABLE, SELECT ANY SEQUENCE TO usr_srv; GRANT CREATE SESSION, DELETE ANY TABLE, INSERT ANY TABLE, SELECT ANY TABLE, UPDATE ANY TABLE, SELECT ANY SEQUENCE TO usr_web; ```  ::: noteimportant Table restoration and upgrade should be performed by the database owner. :::  After creating the users, proceed to creating synonyms.
ca	#### Creació d'usuaris  Suposant que el propietari de la base de dades connectable (PDB) és `usr_owner`, es recomana crear dos usuaris addicionals amb els privilegis corresponents (per a les operacions diàries):  - **usr_srv** - usuari per executar el servidor Zabbix; - **usr_web** - usuari per executar la interfície i l'API de Zabbix.  Aquests usuaris han de ser creats pel propietari de la PDB (`usr_owner`) mitjançant les ordres següents:  ```sql CREATE USER usr_srv IDENTIFIED BY "usr_srv" DEFAULT TABLESPACE "usr_owner" TEMPORARY TABLESPACE temp; CREATE USER usr_web IDENTIFIED BY "usr_web" DEFAULT TABLESPACE "usr_owner" TEMPORARY TABLESPACE temp;  GRANT CREATE SESSION, DELETE ANY TABLE, INSERT ANY TABLE, SELECT ANY TABLE, UPDATE ANY TABLE, SELECT ANY SEQUENCE TO usr_srv; GRANT CREATE SESSION, DELETE ANY TABLE, INSERT ANY TABLE, SELECT ANY TABLE, UPDATE ANY TABLE, SELECT ANY SEQUENCE TO usr_web; ```  ::: nota important La restauració i l'actualització de la taula l'ha de fer el propietari de la base de dades. :::  Després de crear els usuaris, procediu a crear sinònims.

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

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

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

en-us	##### CSV to JSON {#csvtojson}  Convert CSV file data into JSON format.  For more information, see: [CSV to JSON preprocessing](/manual/config/items/preprocessing/csv_to_json#csv_header_processing).
ca	##### CSV a JSON {#csvtojson}  Converteix les dades del fitxer CSV a format JSON.  Per obtindre més informació, consulteu: [Preprocessament de CSV a JSON](/manual/config/items/preprocessing/csv_to_json#csv_header_processing).

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

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

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

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

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

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

en-us	##### Custom multiplier {#multiplier}  Multiply the value by the specified integer or floating-point value.  Comments:  -   Use this option to convert values received in KB, MBps, etc., into B, Bps. Otherwise, Zabbix cannot correctly set [prefixes](/manual/appendix/suffixes) (K, M, G, etc.).<br> -   Note that if the item type of information is *Numeric (unsigned)*, incoming values with a fractional part will be trimmed (i.e., '0.9' will become '0') before the custom multiplier is applied;<br> -   If you use a custom multiplier or store value as *Change per second* for items  with the type of information set to *Numeric (unsigned)* and the resulting calculated  value is actually a float number, the calculated value is still accepted as a  correct one by trimming the decimal part and storing the value as an integer;<br> -   Supported: scientific notation, for example, `1e+70`; user macros and LLD macros; strings that include macros, for example, `{#MACRO}e+10`, `{$MACRO1}e+{$MACRO2}`. The macros must resolve to an integer or a floating-point number. -   If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected.
ca	##### Multiplicador personalitzat {#multiplier}  Multiplica el valor per l'enter o el valor de coma flotant especificat.  Comentaris:  - Empreu aquesta opció per convertir els valors rebuts en Ko, Mops, etc., en B, Bps. En cas contrari, Zabbix no pot establir correctament [prefixos](/manual/appendix/sufixos) (o, M, G, etc.).<br> - Tingueu en compte que si el tipus d'informació d'element és *Numèric (sense signe)*, els valors entrants amb una part fraccional es retallaran (és a dir, "0,9" es convertirà en "0") abans que s'apliqui el multiplicador personalitzat;<br> - Si empreu un multiplicador personalitzat o un valor emmagatzemat com a *Canvi per segon* per als articles  amb el tipus d'informació establert a *Numèric (sense signe)* i el resultat calculat  el valor és en realitat un nombre flotant, el valor calculat encara s'accepta com a  corregiu-ne un retallant la part decimal i emmagatzemant el valor com a nombre enter;<br> - Admet: notació científica, com ara `1e+70`; macros d'usuari i macros LLD; cadenes que inclouen macros, com ara `{#MACRO}e+10`, `{$MACRO1}e+{$MACRO2}`. Les macros s'han de resoldre en un nombre enter o en coma flotant. - Si marqueu la casella de selecció *Personalitzar en cas d'error*, és possible especificar opcions personalitzades de gestió d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat. En el cas d'una passa de preprocessament fallida, l'element no serà compatible si es tria l'opció de descartar el valor o establir un valor especificat.

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

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

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

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

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

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

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

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

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

en-us	 ##### Dashboard size  The minimum width of a dashboard is 1200 pixels. The dashboard will not shrink below this width; instead a  horizontal scrollbar is displayed if the browser window is smaller than that.  The maximum width of a dashboard is the browser window width. Dashboard widgets stretch horizontally to fit the window.  At the same time, a dashboard widget cannot be stretched horizontally beyond the window limits.  Horizontally, the dashboard is made up of 72 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 therefore be up to 72 columns wide and 64 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.  Horitzontalment, el tauler consta de fins a 72 columnes 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 fileres; cada filera té una alçada fixa de 70 píxels.  Un giny pot tindre fins a 72 columnes d'amplada i 64 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|ID|ID of the dashboard.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the dashboard.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |userid|ID|ID of the user that is the owner of the dashboard.| |private|integer|Type of dashboard sharing.<br><br>Possible values:<br>0 - public dashboard;<br>1 - *(default)* private dashboard.| |display\_period|integer|Default page display period (in seconds).<br><br>Possible values: 10, 30, 60, 120, 600, 1800, 3600.<br><br>Default: 30.| |auto\_start|integer|Auto start slideshow.<br><br>Possible values:<br>0 - do not auto start slideshow;<br>1 - *(default)* auto start slideshow.|
ca	### Tauler  L'objecte tauler té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dashboardid|ID|*(només lectura)* ID del tauler.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització| |name|string|Nom del tauler.| |userid|ID|ID de l'usuari propietari del tauler.| |private|integer|Tipus de compartició del tauler.<br><br>Valors possibles:<br>0 - tauler públic;<br>1 - *(per defecte)* tauler privat.| |display\_period|integer|Període (en segons) de mstra de la pàgina per defecte.<br><br>Valors possibles: 10, 30, 60, 120, 600, 1800, 3600.<br><br>Per defecte: 30.| |auto\_start|integer|Iniciar presentació automàticament.<br><br>Valors possibles:<br>0 - no iniciar-la automàticament;<br>1 - *(per defecte)* iniciar-la automàticament.|

en-us	# Dashboard  This class is designed to work with dashboards.  Object references:  -   [Dashboard](/manual/api/reference/dashboard/object#dashboard) -   [Dashboard page](/manual/api/reference/dashboard/object#dashboard_page) -   [Dashboard widget](/manual/api/reference/dashboard/object#dashboard_widget) -   [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard_widget_field) -   [Dashboard user group](/manual/api/reference/dashboard/object#dashboard_user_group) -   [Dashboard user](/manual/api/reference/dashboard/object#dashboard_user)  Available methods:  -   [dashboard.create](/manual/api/reference/dashboard/create) - create new dashboards -   [dashboard.delete](/manual/api/reference/dashboard/delete) - delete dashboards -   [dashboard.get](/manual/api/reference/dashboard/get) - retrieve dashboards -   [dashboard.update](/manual/api/reference/dashboard/update) - update 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     group](/manual/api/reference/dashboard/object#dashboard_user_group) -   [Dashboard     user](/manual/api/reference/dashboard/object#dashboard_user)  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|ID|ID of the user group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |permission|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Grup d'usuaris del tauler  Llistat dels permisos del tauler en funció dels grups d'usuaris. L'objecte té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |usrgrpid|ID|ID del grup d'usuaris.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |permission|integer|Tipus del nivell de permisos.<br><br>Valors possibles:<br>2 - només lectura;<br>3 - lectura i escriptura.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

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

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

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

en-us	### Dashboard widget  The dashboard widget object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |widgetid|ID|ID of the dashboard widget.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |type|string|Type of the dashboard widget.<br><br>Possible values:<br>actionlog - Action log;<br>clock - Clock;<br>*(deprecated)* dataover - Data overview;<br>discovery - Discovery status;<br>favgraphs - Favorite graphs;<br>favmaps - Favorite maps;<br>gauge - Gauge;<br>geomap - Geomap;<br>graph - Graph (classic);<br>graphprototype - Graph prototype;<br>honeycomb - Honeycomb;<br>hostavail - Host availability;<br>hostnavigator - Host navigator;<br>itemhistory - Item history;<br>itemnavigator - Item navigator;<br>item - Item value;<br>map - Map;<br>navtree - Map Navigation Tree;<br>piechart - Pie chart;<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>toptriggers - Top triggers;<br>trigover - Trigger overview;<br>url - URL;<br>web - Web monitoring.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |name|string|Custom widget name.| |x|integer|A horizontal position from the left side of the dashboard.<br><br>Possible values range from 0 to 71.| |y|integer|A vertical position from the top of the dashboard.<br><br>Possible values range from 0 to 63.| |width|integer|The widget width.<br><br>Possible values range from 1 to 72.| |height|integer|The widget height.<br><br>Possible values range from 1 to 64.| |view\_mode|integer|The widget view mode.<br><br>Possible values:<br>0 - *(default)* default widget view;<br>1 - with hidden header;| |fields|array|Array of the [dashboard widget field](object#dashboard-widget-field) objects.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- see individual widgets in [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields)|
ca	### Giny de tauler  L'objecte  giny de tauler té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |widgetid|ID|ID del giny de tauler.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |tipus|string|Tipus de giny de tauler.<br><br>Valors possibles:<br>actionlog - Registre d'acció;<br>clock - Rellotge;<br>*(obsolet)* dataover - Vista general d'informació;<br>discovery - Estat de descoberta;<br>favgraphs - Gràfics preferits;<br>favmaps - Mapes preferits;<br>gauge - Calibre;<br>geomap - Geomapa;<br>graph - Gràfic (clàssic);<br>graphprototype - Prototipus de gràfic;<br>honeycomb - Rusc;<br>hostavail - Disponibilitat de l'equip;<br>hostnavigator - Navegador d'equips;<br>itemhistory - Historial de l'element;<br>itemnavigator - Navegador d'elements;<br>item - Valor d'element;<br>map - Mapa;<br>navtree - Arbre de navegació del mapa;<br>piechart - Gràfic de pastís;<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 - Equips principals;<br>toptriggers - Triggers principals;<br>trigover - Vista general dels triggers;<br>url - URL;<br>web - Monitoratge Web.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |name|string|Nom del giny personalitzat.| |x|integer|Posició horitzontal des de l'esquerra del tauler.<br><br>Interval vàlid des de 0 a 23.| |y|integer|Posició vertical des de dalt del tauler.<br><br>Valors vàlids entre 0 i 62.| |width|integer|Amplada del giny.<br><br>Valors vàlids entre 1 i 24.| |height|integer|Alçada del giny.<br><br>Valors vàlids entre 2 i 32.| |view\_mode|integer|Mode de vista del giny.<br><br>Valors possibles:<br>0 - *(per defecte)* vista del giny per defecte;<br>1 - amb capçalera oculta;| |fields|array|Taula dels objectes [camp del giny del tauler](object#dashboard-widget-field).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- veieu els ginys individuals al [Tauler de camps de giny](/manual/api/reference/dashboard/widget_fields)|

en-us	#### dashboard  [ZBXNEXT-8316](https://support.zabbix.com/browse/ZBXNEXT-8316), [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193), [ZBX-24488](https://support.zabbix.com/browse/ZBX-24488), [ZBX-24490](https://support.zabbix.com/browse/ZBX-24490) Renamed [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type `plaintext` to [`itemhistory`](/manual/api/reference/dashboard/widget_fields/item_history), replaced its dashboard widget fields `itemids.0`, `style`, `show_as_html` with `columns.0.itemid`, `layout`, `columns.0.display`, and added new dashboard widget fields.\ [ZBXNEXT-8496](https://support.zabbix.com/browse/ZBXNEXT-8496) Replaced dashboard widget fields `columns.0.timeshift`, `columns.0.aggregate_interval` with `columns.0.time_period._reference`, `columns.0.time_period.from`, `columns.0.time_period.from` in [`tophosts`](/manual/api/reference/dashboard/widget_fields/top_hosts#item-value) widget.\ [ZBXNEXT-2299](https://support.zabbix.com/browse/ZBXNEXT-2299) Replaced dashboard widget field `unacknowledged` with two new fields `acknowledgement_status` and `acknowledged_by_me` in [`problems`](/manual/api/reference/dashboard/widget_fields/problems#parameters) widget.\ [ZBXNEXT-8245](https://support.zabbix.com/browse/ZBXNEXT-8245) Removed dashboard widget field `adv_conf` in [`clock`](/manual/api/reference/dashboard/widget_fields/clock#parameters) and [`item`](/manual/api/reference/dashboard/widget_fields/item_value#parameters) widgets.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Changed dashboard widget field naming: complex data fields renamed from `str.str.index1.index2` to `str.index1.str.index2` (e.g. `thresholds.0.threshold.1`, `ds.0.hosts.1`); fields referencing database objects renamed from `str` to `str.index1` (e.g. `itemid.0`, `severities.0`).\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Replaced dashboard widget field `filter_widget_reference` with `sysmapid._reference`, and removed field `source_type` in [`map`](/manual/api/reference/dashboard/widget_fields/map#parameters) widget.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Replaced dashboard widget field `dynamic` with `override_hostid._reference` in [`gauge`](/manual/api/reference/dashboard/widget_fields/gauge#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters), [`item`](/manual/api/reference/dashboard/widget_fields/item_value#parameters), [`plaintext`](/manual/api/reference/dashboard/widget_fields/plain_text#parameters), and [`url`](/manual/api/reference/dashboard/widget_fields/url#parameters) widgets.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Replaced dashboard widget fields `graph_time` with `time_period._reference`, `time_from` with `time_period.from`, `time_to` with `time_period.to` in [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#time-period) widget.\ [ZBXNEXT-9044](https://support.zabbix.com/browse/ZBXNEXT-9044) Changed the value range of the dashboard widget parameters `x` (from 0-23 to 0-71 ) and `y` (from 0-62 to 0-63) as well as `width` (from 1–24 to 1–72) and `height` (from 2–32 to 1–64).\
ca	#### tauler  [ZBXNEXT-8316](https://support.zabbix.com/browse/ZBXNEXT-8316), [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193), [ZBX-24488](https://support.zabbix.com/browse/ZBX-24488), [ZBX-24490](https://support.zabbix.com/browse/ZBX-24490) S'ha canviat el nom del tipus `plaintext` del [giny del tauler](/manual/ api/reference/dashboard/object#dashboard-widget) [`itemhistory`](/manual/api/reference/dashboard/widget_fields/item_history), canviant els camps del giny de tauler `itemids.0`, `style`, `show_as_html` amb `columns.0.itemid`, `layout`, `columns.0.display` i s'han afegit camps de giny nous al tauler.\ [ZBXNEXT-8496](https://support.zabbix.com/browse/ZBXNEXT-8496) S'han substituït els camps del giny del tauler de control `columns.0.timeshift`, `columns.0.aggregate_interval` per `columns.0.time_period._reference `, `columns.0.time_period.from`, `columns.0.time_period.from` al giny [`tophosts`](/manual/api/reference/dashboard/widget_fields/top_hosts#item-value).\ [ZBXNEXT-2299](https://support.zabbix.com/browse/ZBXNEXT-2299) S'ha substituït el camp del giny del tauler de control `unacknowledged` per dos camps nous `acknowledgement_status` i `acknowledged_by_me` al giny [`problems`](/manual/api/reference/dashboard/widget_fields/problems#parameters.\ [ZBXNEXT-8245](https://support.zabbix.com/browse/ZBXNEXT-8245) S'ha esborrat el camp del giny del tauler de control `adv_conf` als ginys [`clock`](/manual/api/reference/dashboard/widget_fields/clock#parameters) i [`item`](/manual/api/reference/dashboard/widget_fields/item_value#parameters).\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) S'ha canviat el nom dels camps del giny del tauler: camps de dades complexos canviats de nom de `str.str.index1.index2` a `str.index1.str. index2` (per exemple, `thresholds.0.threshold.1`, `ds.0.hosts.1`); camps que fan referència a objectes de base de dades canviats de nom de `str` a `str.index1` (per exemple, `itemid.0`, `severities.0`).\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) S'ha substituït el camp del giny del tauler de control `filter_widget_reference` per `sysmapid._reference` i s'ha esborrat el camp `source_type` al giny [`map`](/manual/api/reference/dashboard/widget_fields/map#parameters.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) S'ha substituït el camp del giny del tauler de control `dynamic` per `override_hostid._reference` als ginys [`gauge`](/manual/api/reference/dashboard /widget_fields/gauge#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters ), [`item`](/manual/api/reference/dashboard/widget_fields/item_value#parameters), [`plaintext`](/manual/api/reference/dashboard/widget_fields/plain_text#parameters) i [`url`](/manual/api/reference/dashboard/widget_fields/url#parameters).\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) S'han substituït els camps del giny del tauler `graph_time` per `time_period._reference`, `time_from` per `time_period.from`, `time_to` amb `time_period.to` al giny [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#time-period).\ [ZBXNEXT-9044](https://support.zabbix.com/browse/ZBXNEXT-9044) S'ha canviat l'interval de valors dels paràmetres del giny del tauler `x` (de 0-23 a 0-71 ) i `y` (de 0-62 a 0-63), així com "amplada" (de 1-24 a 1-72) i "alçada" (de 2-32 a 1-64).\

en-us	#### dashboard  [ZBXNEXT-8956](https://support.zabbix.com/browse/ZBXNEXT-8956) Added new dashboard widget fields `groupids._reference`, `hostids._reference`, `itemid._reference`, `graphid._reference`, `reference` in multiple widgets.\ [ZBXNEXT-9057](https://support.zabbix.com/browse/ZBXNEXT-9057) Added new dashboard widget field `show_software_update_check_details` in [`systeminfo`](/manual/api/reference/dashboard/widget_fields/system) widget.\ [ZBXNEXT-8686](https://support.zabbix.com/browse/ZBXNEXT-8686) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`itemnavigator`](/manual/api/reference/dashboard/widget_fields/item_navigator).\ [ZBXNEXT-8685](https://support.zabbix.com/browse/ZBXNEXT-8685) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`hostnavigator`](/manual/api/reference/dashboard/widget_fields/host_navigator).\ [ZBXNEXT-8683](https://support.zabbix.com/browse/ZBXNEXT-8683) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`honeycomb`](/manual/api/reference/dashboard/widget_fields/honeycomb).\ [ZBXNEXT-8907](https://support.zabbix.com/browse/ZBXNEXT-8907) Added new dashboard widget field `legend_lines_mode` in [`graph`](/manual/api/reference/dashboard/widget_fields/graph#legend) widget.\ [ZBXNEXT-8496](https://support.zabbix.com/browse/ZBXNEXT-8496) Added new dashboard widget fields `aggregate_function`, `history`, `time_period._reference`, `time_period.from`, `time_period.from` in [`item`](/manual/api/reference/dashboard/widget_fields/item_value#advanced-configuration) widget.\ [ZBXNEXT-7736](https://support.zabbix.com/browse/ZBXNEXT-7736) Added new dashboard widget field `interface_type` value (5 - Zabbix Agent(active checks)) in [`hostavail`](/manual/api/reference/dashboard/widget_fields/host_availability#parameters) widget.\ [ZBXNEXT-7736](https://support.zabbix.com/browse/ZBXNEXT-7736) Added new dashboard widget field `only_totals` in [`hostavail`](/manual/api/reference/dashboard/widget_fields/host_availability#parameters) widget.\ [ZBXNEXT-7687](https://support.zabbix.com/browse/ZBXNEXT-7687) Added new dashboard widget field `maintenance` in [`tophosts`](/manual/api/reference/dashboard/widget_fields/top_hosts#parameters) widget.\ [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`toptriggers`](/manual/api/reference/dashboard/widget_fields/top_triggers).\ [ZBXNEXT-743](https://support.zabbix.com/browse/ZBXNEXT-743) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`gauge`](/manual/api/reference/dashboard/widget_fields/gauge).\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331), [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145), [ZBXNEXT-8908](https://support.zabbix.com/browse/ZBXNEXT-8908), [ZBXNEXT-8907](https://support.zabbix.com/browse/ZBXNEXT-8907) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart).\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Added new dashboard widget field `legend_aggregation` in [`graph`](/manual/api/reference/dashboard/widget_fields/graph#legend) widget.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Added new dashboard widget field `reference` in [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), and [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters) widgets.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Added new dashboard widget fields `time_period._reference`, `time_period.from`, `time_period.to` in [`actionlog`](/manual/api/reference/dashboard/widget_fields/action_log#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters), and [`toptriggers`](/manual/api/reference/dashboard/widget_fields/top_triggers#parameters) widgets.\
ca	#### tauler  [ZBXNEXT-8956](https://support.zabbix.com/browse/ZBXNEXT-8956) S'han afegit eels nous camps de giny de tauler `groupids._reference`, `hostids._reference`, `itemid._reference`, `graphid._reference`, `reference` a múltiples ginys.\ [ZBXNEXT-8956](https://support.zabbix.com/browse/ZBXNEXT-8956) Added new dashboard widget fields `groupids._reference`, `hostids._reference`, `itemid._reference`, `graphid._reference`, `reference` in multiple widgets.\ [ZBXNEXT-9057](https://support.zabbix.com/browse/ZBXNEXT-9057) Added new dashboard widget field `show_software_update_check_details` in [`systeminfo`](/manual/api/reference/dashboard/widget_fields/system) widget.\ [ZBXNEXT-8686](https://support.zabbix.com/browse/ZBXNEXT-8686) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`itemnavigator`](/manual/api/reference/dashboard/widget_fields/item_navigator).\ [ZBXNEXT-8685](https://support.zabbix.com/browse/ZBXNEXT-8685) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`hostnavigator`](/manual/api/reference/dashboard/widget_fields/host_navigator).\ [ZBXNEXT-8683](https://support.zabbix.com/browse/ZBXNEXT-8683) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`honeycomb`](/manual/api/reference/dashboard/widget_fields/honeycomb).\ [ZBXNEXT-8907](https://support.zabbix.com/browse/ZBXNEXT-8907) Added new dashboard widget field `legend_lines_mode` in [`graph`](/manual/api/reference/dashboard/widget_fields/graph#legend) widget.\ [ZBXNEXT-8496](https://support.zabbix.com/browse/ZBXNEXT-8496) Added new dashboard widget fields `aggregate_function`, `history`, `time_period._reference`, `time_period.from`, `time_period.from` in [`item`](/manual/api/reference/dashboard/widget_fields/item_value#advanced-configuration) widget.\ [ZBXNEXT-7736](https://support.zabbix.com/browse/ZBXNEXT-7736) Added new dashboard widget field `interface_type` value (5 - Zabbix Agent(active checks)) in [`hostavail`](/manual/api/reference/dashboard/widget_fields/host_availability#parameters) widget.\ [ZBXNEXT-7736](https://support.zabbix.com/browse/ZBXNEXT-7736) Added new dashboard widget field `only_totals` in [`hostavail`](/manual/api/reference/dashboard/widget_fields/host_availability#parameters) widget.\ [ZBXNEXT-7687](https://support.zabbix.com/browse/ZBXNEXT-7687) Added new dashboard widget field `maintenance` in [`tophosts`](/manual/api/reference/dashboard/widget_fields/top_hosts#parameters) widget.\ [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`toptriggers`](/manual/api/reference/dashboard/widget_fields/top_triggers).\ [ZBXNEXT-743](https://support.zabbix.com/browse/ZBXNEXT-743) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`gauge`](/manual/api/reference/dashboard/widget_fields/gauge).\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331), [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145), [ZBXNEXT-8908](https://support.zabbix.com/browse/ZBXNEXT-8908), [ZBXNEXT-8907](https://support.zabbix.com/browse/ZBXNEXT-8907) Added new [dashboard widget](/manual/api/reference/dashboard/object#dashboard-widget) type [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart).\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Added new dashboard widget field `legend_aggregation` in [`graph`](/manual/api/reference/dashboard/widget_fields/graph#legend) widget.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Added new dashboard widget field `reference` in [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), and [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters) widgets.\ [ZBXNEXT-8145](https://support.zabbix.com/browse/ZBXNEXT-8145) Added new dashboard widget fields `time_period._reference`, `time_period.from`, `time_period.to` in [`actionlog`](/manual/api/reference/dashboard/widget_fields/action_log#parameters), [`graph`](/manual/api/reference/dashboard/widget_fields/graph_classic#parameters), [`graphprototype`](/manual/api/reference/dashboard/widget_fields/graph_prototype#parameters), and [`toptriggers`](/manual/api/reference/dashboard/widget_fields/top_triggers#parameters) widgets.\

en-us	#### dashboard  [ZBXNEXT-9215](https://support.zabbix.com/browse/ZBXNEXT-9215) Added new dashboard widget field `ds.0.itemids.0._reference` in [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#data-set) and [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart#data-set) widgets.\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) Added new dashboard widget field `stroke` in [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart) widget.\
ca	#### tauler  [ZBXNEXT-9215](https://support.zabbix.com/browse/ZBXNEXT-9215) S'ha afegit el nou camp de giny de tauler `ds.0.itemids.0._reference` a [`svggraph`](/manual/api/reference/dashboard/widget_fields/graph#data-set) i els ginys [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart#data-set).\ [ZBXNEXT-8331](https://support.zabbix.com/browse/ZBXNEXT-8331) S'ha afegit un nou camp de giny del tauler de control `stroke` al giny [`piechart`](/manual/api/reference/dashboard/widget_fields/pie_chart).\

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     # atureu-vos aquí si creeu una base de dades per al proxy Zabbix     sqlplus> @images.sql     sqlplus> @data.sql  ::: notetip Definiu el paràmetre d'inicialització CURSOR\_SHARING=FORCE per tindre més bon rendiment. :::

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

en-us	#### Database partitioning with TimescaleDB  Database partitioning is facilitated by TimescaleDB. To utilize TimescaleDB, Zabbix server requires database owner privileges.  If the PostgreSQL `zabbix` schema has already been created in the `zabbix` database, you can enable TimescaleDB with the following command:  ```bash echo "CREATE EXTENSION IF NOT EXISTS timescaledb WITH SCHEMA zabbix CASCADE;" | sudo -u postgres psql zabbix ```
ca	#### Particionament de bases de dades amb TimescaleDB  El particionament de la base de dades és proveït per TimescaleDB. Per emprar TimescaleDB, el servidor Zabbix requereix privilegis de propietari de la base de dades.  Si l'esquema `zabbix` de PostgreSQL ja s'ha creat a la base de dades `zabbix`, podeu habilitar TimescaleDB amb l'ordre següent:  ```bash echo "CREATE EXTENSION IF NOT EXISTS timescaledb WITH SCHEMA zabbix CASCADE;" | sudo -u postgres psql zabbix ```

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

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

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

en-us	#### Database setup  Create the user that will be the database owner, and create the Zabbix database; the database owner is the user that is specified on database creation:  ```bash createuser -U postgres -h localhost --pwprompt usr_owner createdb -U postgres -h localhost -O usr_owner -E Unicode -T template0 zabbix ```  ::: noteimportant A clean install or upgrade of the database has to be performed by the database owner. This is because the right to drop a database object or alter its definition is a privilege that is inherent to the database owner and cannot be granted or revoked. :::  ::: noteimportant The following commands on this page must be executed while the connection to PostgreSQL is made specifically to the `zabbix` database. :::  Create the `zabbix` schema and set the database owner (`usr_owner`) to be the owner of this schema:  ```sql CREATE SCHEMA zabbix AUTHORIZATION usr_owner; ```  Configure a secure schema [usage pattern](https://www.postgresql.org/docs/current/ddl-schemas.html#DDL-SCHEMAS-PATTERNS):  ```sql REVOKE CREATE ON SCHEMA public FROM PUBLIC; REVOKE ALL ON DATABASE zabbix FROM PUBLIC; -- Note: search_path should point to the "zabbix" schema: ALTER ROLE ALL IN DATABASE zabbix SET search_path = "zabbix"; ```  After setting up the database, proceed to creating user roles.
ca	#### Configuració de la base de dades  Creeu l'usuari que serà el propietari de la base de dades i creeu la base de dades Zabbix; el propietari de la base de dades és l'usuari que s'especifica en la creació de la base de dades:  ```bash createuser -U postgres -h localhost --pwprompt usr_owner creatb -U postgres -h host local -O propietari_usr -E Unicode -T template0 zabbix ```  ::: nota important El propietari de la base de dades ha de fer una instal·lació o actualització neta de la base de dades. Això es deu al fet que el dret d'eliminar un objecte de base de dades o modificar-ne la definició és un privilegi inherent al propietari de la base de dades i no es pot concedir ni revocar. :::  ::: nota important Les ordres següents d'aquesta pàgina s'han d'executar mentre la connexió a PostgreSQL es fa específicament a la base de dades `zabbix`. :::  Creeu l'esquema `zabbix` i configureu el propietari de la base de dades (`usr_owner`) perquè sigui el propietari d'aquest esquema:  ```sql CREATE SCHEMA zabbix AUTHORIZATION usr_owner; ```  Configureu un esquema segur [patró d'ús](https://www.postgresql.org/docs/current/ddl-schemas.html#DDL-SCHEMAS-PATTERNS):  ```sql REVOQUE CREATE ON SCHEMA public FROM PUBLIC; REVOKE ALL ON DATABASE zabbix FROM PUBLIC; -- Nota: search_path hauria d'apuntar a l'esquema "zabbix": ALTER ROLE ALL IN DATABASE zabbix SET search_path = "zabbix"; ```  Després de configurar la base de dades, procediu a la creació de rols d'usuari.

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

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

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

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

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

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

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

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

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

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

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

en-us	##### Data set configuration details  Existing data sets are displayed in a list. You can rearrange, expand/collapse, change colors, and clone these data sets.  For more information, see data set configuration details in the [*Graph*](/manual/web_interface/frontend_sections/dashboards/widgets/graph#data-set-configuration-details) widget. These details also apply to the *Pie chart* widget.
ca	##### Detalls de configuració del conjunt de dades  Els conjunts de dades existents es mostren en una llista. Podeu reorganitzar, ampliar/replegar, canviar els colors i clonar aquests conjunts de dades.  Per obtindre més informació, consulteu el [giny de gràfics](/manual/web_interface/frontend_sections/dashboards/widgets/graph#data-set-configuration-details). Aquests detalls també apliquen al giny de *Gràfic de pastís*.

en-us	##### Data set configuration details  Existing data sets are displayed in a list. You may:  -   Click on the ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/move_icon.png) move icon and drag a data set to a new place in the list. -   Click on the ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/expand_icon.png) expand icon to expand data set details. When expanded, this icon turns into a ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/collapse_icon.png) collapse icon. -   Click on the ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/color_icon.png) color icon to change the color, either from the color picker or manually. For *Item patterns* data set, the color is used to calculate different color shades for each item. For *Item list* data set, the color is used for the specified item. -   Click on the *Add new data set* button to add an empty data set allowing to select host and item patterns.     If you click on the downward pointing icon next to the *Add new data set* button, a drop-down menu appears, allowing you to add a new *Item patterns* or *Item list* data set or allowing you to *Clone* the currently open data set. If all data sets are collapsed, the *Clone* option is not available.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/graph_dataset_add.png)
ca	 Els conjunts de dades existents es mostren en una llista. Podeu:  - ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/move_icon.png) - feu clic a la icona de moviment i arrossegueu un conjunt de dades a un nou lloc de la llista. - ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/expand_icon.png) - feu clic a la icona d'ampliació per ampliar els detalls del conjunt de dades. Quan s'amplia, aquesta icona es converteix en una icona de replegament. - ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/color_icon.png) - feu clic a la icona de color per canviar el color base, ja sigui des del selector de colors o manualment. El color base s'utilitza per calcular diferents colors per a cada element del conjunt de dades. - ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/add_data_set.png) - feu clic a aquest botó per afegir un conjunt de dades buit que permet seleccionar el patró d'equip/element.      - Si feu clic a la icona que apunta cap avall al costat del botó *Afegir un conjunt de dades nou*, apareix un menú desplegable que permet afegir un nou conjunt de dades amb un patró d'elements/una llista d'elements o clonant el conjunt de dades obert actualment. Si tots els conjunts de dades són replegats, l'opció *Clonar* no és disponible.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/graph_dataset_add.png)

en-us	#### Data set  The **Data set** tab allows selecting data for the graph by adding data sets. Two types of data sets can be added:  -   *Item patterns* - data from matching items is displayed. The graph is drawn using different shades of single color for each item. -   *Item list* - data from selected items is displayed. The graph is drawn using different colors for each item.  By default, an *Item patterns* data set is added.  |   |   |   | |-|----------|----------------------------------------| |*Data set*|<|For **Item patterns** data set:<br>Select or enter host and item patterns; data of items that match these patterns will be displayed on the graph; up to 50 items may be displayed.<br>Wildcard patterns may be used for selection (for example, `*` will return results that match zero or more characters).<br>To specify a wildcard pattern, enter the string manually and press *Enter*.<br>The wildcard symbol is always interpreted, so it is not possible to add, for example, an item named *item\** individually if there are other matching items (for example, *item2*, *item3*).<br>Specifying host and item patterns is mandatory for "Item patterns" data sets.<br>See also: [Data set configuration details](#data-set-configuration-details).<br><br>For **Item list** data set:<br>Select items for the graph by clicking on the *Add item* button.<br>Since Zabbix 7.0.1, you may also select compatible widgets as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) for items by clicking on the *Add widget* button.<br>Specifying items or widgets is mandatory for "Item list" data sets.<br>See also: [Data set configuration details](#data-set-configuration-details).<br><br>Note that only numeric item types are allowed.<br><br>When configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards), the parameter for specifying host patterns is not available, and the parameter for specifying an item list allows to select only the [items configured on the template](/manual/config/templates/template#adding-items-triggers-graphs).| | |*Draw*|Choose the draw type of the metric.<br>Possible draw types: *Line* (set by default), *Points*, *Staircase*, and *Bar*.<br>Note that if there is only one data point in the line/staircase graph, it is drawn as a point regardless of the draw type. The point size is calculated from the line width, but it cannot be smaller than 3 pixels, even if the line width is less.| |^|*Stacked*|Mark the checkbox to display data as stacked (filled areas displayed).<br>This option is disabled when *Points* draw type is selected.| |^|*Width*|Set the line width.<br>This option is available when *Line* or *Staircase* draw type is selected.| |^|*Point size*|Set the point size.<br>This option is available when *Points* draw type is selected.| |^|*Transparency*|Set the transparency level.| |^|*Fill*|Set the fill level.<br>This option is available when *Line* or *Staircase* draw type is selected.| |^|*Missing data*|Select the option for displaying missing data:<br>**None** - the gap is left empty;<br>**Connected** - two border values are connected;<br>**Treat as 0** - the missing data is displayed as 0 values;<br>**Last known** - the missing data is displayed with the same value as the last known value; not applicable for the *Points* and *Bar* draw type.| |^|*Y-axis*|Select the side of the graph where the Y-axis will be displayed.| |^|*Time shift*|Specify time shift if required.<br>You may use [time suffixes](/manual/appendix/suffixes#time_suffixes) in this field. Negative values are allowed.| |^|*Aggregation function*|Specify which aggregation function to use:<br>**min** - display the smallest value;<br>**max** - display the largest value;<br>**avg** - display the average value;<br>**sum** - display the sum of values;<br>**count** - display the count of values;<br>**first** - display the first value;<br>**last** - display the last value;<br>**none** - display all values (no aggregation).<br><br>Aggregation allows to display an aggregated value for the chosen interval (5 minutes, an hour, a day), instead of all values. See also: [Aggregation in graphs](/manual/config/visualization/graphs/aggregate).| |^|*Aggregation interval*|Specify the interval for aggregating values.<br>You may use [time suffixes](/manual/appendix/suffixes#time_suffixes) in this field. A numeric value without a suffix will be regarded as seconds.| |^|*Aggregate*|Specify whether to aggregate:<br>**Each item** - each item in the dataset will be aggregated and displayed separately;<br>**Data set** - all dataset items will be aggregated and displayed as one value.| |^|*Approximation*|Specify what value to display when more than one value exists per vertical graph pixel:<br>**all** - display the smallest, the largest and the average values;<br>**min** - display the smallest value;<br>**max** - display the largest value;<br>**avg** - display the average value.<br><br>This setting is useful when displaying a graph for a large time period with frequent update interval (such as one year of values collected every 10 minutes).| |^|*Data set label*|Specify the data set label that is displayed in graph *Data set* configuration and in graph *Legend* (for aggregated data sets).<br>All data sets are numbered including those with a specified *Data set label*. If no label is specified, the data set will be labeled automatically according to its number (e.g. "Data set #2", "Data set #3", etc.). Data set numbering ir recalculated after reordering/dragging data sets.<br>Data set labels that are too long will be shortened to fit where displayed (e.g. "Number of proc...").|
ca	#### Conjunt de dades  La pestanya **Conjunt de dades** permet afegir conjunts de dades i definir la seva representació visual:  | | | | |-|-----------|-------------------------------------- ----| |*Conjunt de dades*|<|Per al conjunt de dades **Patrons d'elements**:<br>Trieu o introduïu patrons d'amfitrió i d'elements; les dades dels elements que coincideixen amb aquests patrons es mostraran al gràfic; es poden mostrar fins a 50 elements.<br>Per a la tria es poden emprar patrons comodí (com ara `*`, que retornarà resultats que coincideixin amb zero o més caràcters).<br>Per especificar un patró de comodí, introduïu la cadena manualment i premeu *Enter*.<br>El símbol de comodí sempre s'interpreta, de manera que no és possible afegir, per exemple, un element anomenat *item\** individualment si hi ha altres elements coincidents (per exemple, *item2*, *item3*).<br>Especificar patrons d'equip i d'element és obligatori per als conjunts de dades "Patrons d'elements".<br>Veieu també: [Detalls de configuració del conjunt de dades](#data-set-configuration-details).<br><br >Per al conjunt de dades **Llistat d'elements**:<br>Trieu els elements per al gràfic fent clic al botó *Afegir un element*.<br>Des de Zabbix 7.0.1, també podeu triar estris compatibles com a [font de dades] (/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) per als elements fent clic al botó *Afegir giny*.<br>Especificar elements o ginys és obligatori per als conjunts de dades "Llistat d'elements".<br>Veieu també: [Detalls de configuració del conjunt de dades](#data-set-configuration-details).<br><br>Tingueu en compte que només es permeten els tipus d'elements numèrics.<br><br>Quan configureu el giny en un [tauler de plantilla]( /manual/config/templates/template#adding-dashboards), el paràmetre per especificar patrons d'equips no és pas disponible i el paràmetre per especificar una llista d'elements permet triar només els [elements configurats a la plantilla](/manual/config/ templates/template#adding-items-triggers-graphs).| | |*Dibuix*|Trieu el tipus de dibuix de la mètrica. Els tipus de dibuix possibles són *Línia* (establert per defecte), *Punts*, *Escala* i *Bar*.<br>Tingueu en compte que si només hi ha un punt de dades al gràfic de línia/escala, es dibuixa com a punt independentment de el tipus de dibuix. La mida del punt es calcula a partir de l'amplada de la línia, però no pot ser inferior a 3 píxels, encara que l'amplada de la línia sigui menor.| |^|*Apilat*|Marqueu la casella de selecció per veure les dades com a apilades (es mostren les àrees plenes).<br>Aquesta opció és desactivada quan es tria el tipus de dibuix *Punts*.| |^|*Amplada*|Defineix l'amplada de la línia.<br>Aquesta opció és disponible quan es tria el tipus de dibuix *Línia* o *Escala*.| |^|*Mida del punt*|Defineix la mida del punt.<br>Aquesta opció és disponible quan es tria el tipus de dibuix *Punts*.| |^|*Transparència*|Estableix el nivell de transparència.| |^|*Omplilr*|Defineix el nivell d'ompliment.<br>Aquesta opció és disponible quan es tria el tipus de dibuix *Línia* o *Escala*.| |^|*Dades que manquen*|Trieu l'opció per veure les dades que manquen:<br>**Cap** - el buit es deixa buit;<br>**Connectat** - hi ha dos valors de vora connectats<br>**Treat com 0** - les dades que manquen es mostren com a valors 0;<br>**Darrer conegut** - les dades que manquen es mostren amb el mateix valor que el darrer valor conegut;no s'aplica als tipus de dibuix *Punts* i *Barra*.| |^|*Eix Y*|Trieu el costat del gràfic on es veurà l'eix Y.| |^|*Desplaçament de temps*|Especifiqueu time shift si cal. Podeu emprar [sufixos de temps](/manual/appendix/suffixes#time_suffixes) en aquest camp. Es permeten valors negatius.| |^|*Funció d'agregació*|Especifica quina funció d'agregació s'empra:<br>**min** - mostra el valor més petit;<br>**max** - mostra el valor més gran;<br>**mig** - veure el valor mitjà;<br>**suma** - veure la suma de valors;<br>**recompte** - veure el recompte de valors;<br>**primer** - veure el primer valor;<br>** last** - mostra el darrer valor;<br>**cap** - mostra tots els valors(sense agregació).<br>L'agregació permet veure un valor agregat per a l'interval escollit (5 minuts, una hora, un dia), en lloc d'això de tots els valors. Veieu també: [Agregació en gràfics](/manual/config/visualization/graphs/aggregate).| |^|*Interval d'agregació*|Especifiqueu l'interval per a l'agregació de valors.<br>Podeu emprar [sufixos de temps](/manual/appendix/suffixes#time_suffixes) en aquest camp. Un valor numèric sense sufix es considerarà segons.| |^|*Agregar*|Especifiqueu si voleu afegir:<br>**Cada element** - cada element del conjunt de dades s'afegirà i es veurà per separat;<br>**Conjunt de dades** - tots els elements del conjunt de dades s'afegiran i es mostra com un valor.| |^|*Aproximació*|Especifiqueu quin valor es mostra quan hi ha més d'un valor per píxel del gràfic vertical:<br>**tots** - mostra els valors més petits, més grans i mitjans;<br>**min** - mostra el valor més petit;<br>**màx** - mostra el valor més gran;<br>**mitjana** - mostra el valor mitjà.<br>Aquesta configuració és útil quan es mostra un gràfic durant un període de temps gran amb actualització freqüent interval (com ara un any de valors recollits cada 10 minuts).| |^|*Etiqueta del conjunt de dades*|Especifiqueu l'etiqueta del conjunt de dades que es mostra al gràfic *Configuració del conjunt de dades* i al gràfic *Llegenda* (per a conjunts de dades agregades).<br>Tots els conjunts de dades estan numerats, inclosos els que tenen una especificació. *Etiqueta del conjunt de dades*. Si no s'especifica cap etiqueta, el conjunt de dades s'etiquetarà automàticament segons el seu número (p. ex., "Conjunt de dades #2", "Conjunt de dades #3", etc.). La numeració del conjunt de dades s'ha recalculat després de reordenar/arrossegar els conjunts de dades.<br>Les etiquetes del conjunt de dades massa llargues s'escurçaran per adaptar-se a on es mostren (p. ex., "Nombre de processos...").|

en-us	#### Data set  The **Data set** tab allows selecting data for the pie chart by adding data sets. Two types of data sets can be added:  -   *Item patterns* - data from matching items is displayed. The chart is drawn using different shades of single color for each item. -   *Item list* - data from selected items is displayed. The chart is drawn using different colors for each item.  By default, an *Item patterns* data set is added.  |   |   |   | |-|----------|----------------------------------------| |*Data set*|<|For **Item patterns** data set:<br>Select or enter host and item patterns; data of items that match the entered patterns will be displayed on the pie chart; up to 50 items may be displayed.<br>Wildcard patterns may be used for selection (for example, `*` will return results that match zero or more characters).<br>To specify a wildcard pattern, enter the string manually and press *Enter*.<br>The wildcard symbol is always interpreted, so it is not possible to add, for example, an item named *item\** individually if there are other matching items (for example, *item2*, *item3*).<br>Specifying host and item patterns is mandatory for "Item patterns" data sets.<br>See also: [Data set configuration details](#data-set-configuration-details).<br><br>For **Item list** data set:<br>Select items for the pie chart by clicking on the *Add item* button.<br>The *Type* dropdown after the item name allows to select the display type for each item:<br>**Normal** - item value is represented proportionally on the pie chart (default);<br>**Total** - item value takes up the whole pie chart. Note that only one "Total" item can exist per pie chart, and it will be placed first on the pie chart legend. If an item is set to "Total", the *Data set aggregation* parameter (see below) will be disabled and set to "not used".<br>Since Zabbix 7.0.1, you may also select compatible widgets as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters) for items by clicking on the *Add widget* button. The same options apply to widgets as to individual items.<br>Specifying items or widgets is mandatory for "Item list" data sets.<br>See also: [Data set configuration details](#data-set-configuration-details).<br><br>Note that only numeric item types are allowed.<br><br>When configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards), the parameter for specifying host patterns is not available, and the parameter for specifying an item list allows to select only the [items configured on the template](/manual/config/templates/template#adding-items-triggers-graphs).| | |*Aggregation function*|Specify which aggregation function to use for each item in the data set:<br>**min** - display the smallest value;<br>**max** - display the largest value;<br>**avg** - display the average value;<br>**sum** - display the sum of values;<br>**count** - display the count of values;<br>**first** - display the first value;<br>**last** - display the last value (default).<br><br>Aggregation allows to display an aggregated value for the interval (5 minutes, an hour, a day) selected in the *Time period* tab or used for the whole dashboard.| |^|*Data set aggregation*|Specify which aggregation function to use for the whole data set:<br>**not used** - no aggregation, items are displayed separately (default);<br>**min** - display the smallest value;<br>**max** - display the largest value;<br>**avg** - display the average value;<br>**sum** - display the sum of values;<br>**count** - display the count of values.<br><br>Aggregation allows to display an aggregated value for the interval (5 minutes, an hour, a day) selected in the *Time period* tab or used for the whole dashboard.| |^|*Data set label*|Specify a custom label for the data set.<br>The label is displayed in the data set configuration and the pie chart legend (for aggregated data sets).<br>All data sets are numbered including those with a specified *Data set label*. If no label is specified, the data set will be labeled automatically according to its number (e.g. "Data set #2", "Data set #3", etc.). Data set numbering ir recalculated after reordering/dragging data sets.<br>Data set labels that are too long will be shortened to fit where displayed (e.g. "Number of proc...").|
ca	#### Conjunt de dades  La pestanya **Conjunt de dades** permet triar dades per al gràfic circular afegint conjunts de dades.   Es poden afegir dos tipus de conjunts de dades:   - *Patrons d'elements* - es mostren les dades dels elements coincidents.  Els colors distintius escollits automàticament s'empren per dibuixar el gràfic. - *Llistat d'elements* - es mostren les dades dels elements seleccionats.  Els colors es poden ajustar per a cada element visible.  Per defecte s'afegeix un conjunt de dades *Patrons d'elements*. Quan s'afegeix un conjunt de dades nou,  és possible triar entre conjunts de dades *Patrons d'elements*/*Llistat d'elements*,  fent clic a la icona que apunta cap avall al costat del botó *Afegir un conjunt de dades nou* i  triant l'opció requerida. Tingueu en compte que només es permeten els tipus d'elements numèrics.  |   |   |   | |-|-----------|-------------------------------------- ----| |*Conjunt de dades*|<|Per al conjunt de dades **Patrons d'elements**:<br>Introduïu l'amfitrió i els patrons d'elements: les dades dels elements que coincideixen amb els patrons introduïts es mostraran al gràfic circular.<br>És possible que els patrons de comodins s'utilitzarà per a la selecció (per exemple, `*` retornarà resultats que coincideixen amb zero o més caràcters).<br>Per especificar un patró de comodí, només cal que introduïu la cadena manualment i premeu *Retorn*.<br>Una característica important és que si comenceu a escriure caràcters, una llista desplegable mostrarà els amfitrions/elements coincidents. Vegeu també: [Detalls de configuració del conjunt de dades](#data-set-configuration-details).<br>Els paràmetres del patró d'amfitrió i del patró d'element són obligatoris.<br>El símbol de comodí sempre s'interpreta, per tant, no és possible afegir-hi , per exemple, un element anomenat *item\** individualment, si hi ha altres elements coincidents (p. ex., item2, item3).<br><br>Per al conjunt de dades **Llista d'elements**:<br>Seleccioneu els elements per el gràfic circular fent clic al botó *Afegeix*.<br>Es mostra un selector de colors davant del nom de l'element seleccionat.<br>El menú desplegable *Tipus* després del nom de l'element permet triar el tipus de visualització per a cada element:< br>**Normal** - el valor de l'element es representa proporcionalment al gràfic circular (per defecte);<br>**Total** - el valor de l'element ocupa tot el gràfic circular.<br>Només pot existir un element *Total* per gràfic de sectors i es col·locarà primer a la llegenda del gràfic de sectors. A més, *Agregació de conjunts de dades* (vegeu més avall) es desactivarà i s'establirà en "Cap" si s'afegeix un element *Total*.<br><br>Quan es configura el widget en un [tauler de plantilla](/manual/config). /templates/template#adding-dashboards), el paràmetre per especificar patrons d'amfitrió no està disponible i el paràmetre per especificar una llista d'elements permet triar només els [elements configurats a la plantilla](/manual/config/templates/template# afegint-elements-disparadors-gràfics).| | |*Funció d'agregació*|Especifica quina funció d'agregació s'utilitza per a cada element del conjunt de dades:<br>**min** - mostra el valor més petit;<br>**max** - mostra el valor més gran;<br >**mitjana** - mostra el valor mitjà;<br>**sum** - mostra la suma de valors;<br>**count** - mostra el recompte de valors;<br>**primer** - mostrar el primer valor;<br>**últim** - mostrar l'últim valor (per defecte).<br><br>L'agregació permet mostrar un valor agregat per a l'interval (5 minuts, una hora, un dia) seleccionat a la pestanya *Període de temps* o utilitzat per a tot el tauler.| |^|*Agregació del conjunt de dades*|Especifiqueu quina funció d'agregació s'utilitzarà per a tot el conjunt de dades:<br>**no s'utilitza** - no hi ha agregació, els elements es mostren per separat (per defecte);<br>**min** - mostrar el valor més petit;<br>**max** - mostrar el valor més gran;<br>**mitjana** - mostrar el valor mitjà;<br>**suma** - mostrar la suma de valors;< br>**compte** - mostra el recompte de valors.<br><br>L'agregació permet mostrar un valor agregat per a l'interval (5 minuts, una hora, un dia) seleccionat a la pestanya *Període de temps* o utilitzat per a tot el quadre de comandament.| |^|*Etiqueta del conjunt de dades*|Especifiqueu una etiqueta personalitzada per al conjunt de dades.<br>L'etiqueta es mostra a la configuració del conjunt de dades i a la llegenda del gràfic circular (per a conjunts de dades agregades).<br>Tots els conjunts de dades estan numerats. inclosos aquells amb una *etiqueta de conjunt de dades especificada*. Si no s'especifica cap etiqueta, el conjunt de dades s'etiquetarà automàticament segons el seu número (p. ex., "Conjunt de dades #2", "Conjunt de dades #3", etc.). La numeració dels conjunts de dades s'ha recalculat després de reordenar/arrossegar els conjunts de dades.<br>Les etiquetes de conjunts de dades massa llargues s'escurçaran per adaptar-se a on es mostren (p. ex., "Nombre de processos...").|

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.0.hosts.0, ds.0.items.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| |-|--------|--|--------|-------------------------------| |*Data set type*|<|0|ds.0.dataset_type|0 - Item list;<br>1 - *(default)* Item patterns.| |<|*Items*|4|ds.0.itemids.0|[Item](/manual/api/reference/item/get) ID.<br><br>When configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object), only items configured on the template should be set.<br><br>Note: To configure multiple items, create a dashboard widget field object for each item with an incremented number in the property name.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item list" and *Items (Widget)* is not set| |^|*Items (Widget)*|1|ds.0.itemids.0.\_reference|Instead of [Item](/manual/api/reference/item/get) ID:<br>`ABCDE._itemid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for items.<br><br>Note: To configure multiple widgets, create a dashboard widget field object for each widget with an incremented number in the property name.<br><br>This parameter is supported since Zabbix 7.0.1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item list" and *Items* is not set| |^|*Color*|1|ds.0.color.0|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item list"| |^|*Host patterns*|1|ds.0.hosts.0|[Host](/manual/api/reference/host/get) name or pattern (e.g., "Zabbix\*").<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item patterns"<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Item patterns*|1|ds.0.items.0|[Item](/manual/api/reference/item/get) name or pattern (e.g., "\*: Number of processed \*values per second").<br><br>When configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object), only the patterns for items configured on the template should be set.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item patterns"| |^|*Color*|1|ds.0.color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `FF465C`.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Data set type* is set to "Item patterns"| |*Draw*|<|0|ds.0.type|0 - *(default)* Line;<br>1 - Points;<br>2 - Staircase;<br>3 - Bar.| |*Stacked*|<|0|ds.0.stacked|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Line", "Staircase", or "Bar"| |*Width*|<|0|ds.0.width|Possible values range from 1-10.<br><br>Default: 1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Line" or "Staircase"| |*Point size*|<|0|ds.0.pointsize|Possible values range from 1-10.<br><br>Default: 3.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Points"| |*Transparency*|<|0|ds.0.transparency|Possible values range from 1-10.<br><br>Default: 5.| |*Fill*|<|0|ds.0.fill|Possible values range from 1-10.<br><br>Default: 3.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Line" or "Staircase"| |*Missing data*|<|0|ds.0.missingdatafunc|0 - *(default)* None;<br>1 - Connected;<br>2 - Treat as 0;<br>3 - Last known.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Draw* is set to "Line" or "Staircase"| |*Y-axis*|<|0|ds.0.axisy|0 - *(default)* Left;<br>1 - Right.| |*Time shift*|<|1|ds.0.timeshift|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.0.aggregate_function|0 - *(default)* not used;<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.0.aggregate_interval|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.0.aggregate_grouping|0 - *(default)* Each item;<br>1 - Data set.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", or "last"| |*Approximation*|<|0|ds.0.approximation|1 - min;<br>2 - *(default)* avg;<br>4 - max;<br>7 - all.| |*Data set label*|<|1|ds.0.data_set_label|Any string value.<br><br>Default: `""` (empty).|
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 està present, representa l'equip o l'element configurat. :::  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Tipus de conjunt de dades*|<|0|ds.dataset_type.0|0 - Llista d'elements;<br>1 - *(per defecte)* Patró d'element.| |Paràmetres si *Tipus de conjunt de dades* s'estableix a "Llista d'elements"|<|<|<|<| |<|*Elements*|4|ds.itemids.0.0|Identificador de [Item](/manual/api/reference/item/get).<br><br>Nota: per configurar diversos elements, creeu un camp de giny de tauler objecte per a cada element.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*| |^|*Elements (Giny)*|1|ds.0.itemids.0.\_reference|En lloc d'[Elements](/manual/api/reference/item/get) ID:<br>`ABCDE._itemid` - estableix un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Reference* definit en "`ABCDE`") com a font de dades per als elements.<br><br >Nota: per configurar diversos ginys, creeu un objecte de camp de giny del tauler de control per a cada giny amb un nombre incrementat al nom de la propietat.<br><br>Aquest paràmetre s'admet des de Zabbix 7.0.1.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si *Tipus de conjunt de dades* és establert a "Llistat d'elements" i *Elements* no és pas definit | |^|*Color*|1|ds.color.0.0|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br >- *obligatori*| |Paràmetres si *Tipus de conjunt de dades* s'estableix en "Patró d'element"|<|<|<|<| |<|*Patró d'equip*|1|ds.hosts.0.0|[Equip](/manual/api/reference/host/get) nom o patró (p. ex., "Zabbix\*").<br><br> [Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*| |^|*Patró d'element*|1|ds.items.0.0|[Item](/manual/api/reference/item/get) nom o patró (p. ex., "\*: Nombre de \*valors per segon" processats) ).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*| |^|*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.| |*Stacked*|<|0|ds.stacked.0|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>El paràmetre *Stacked* no és disponible si *Dibuix* s'ha establert a "Punts".| |*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 és disponible si *Dibuix* s'ha establert 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>Paràmetre *Mida del punt* no disponible si *Dibuix* s'estableix a "Línia", "Escala" o "Barra".| |*Transparència*|<|0|ds.transparency.0|Els valors vàlids oscil·len entre 1 i 10.<br><br>Per defecte: 5.| |*Emplenat*|<|0|ds.fill.0|Els valors vàlids van d'1 a 10.<br><br>Per defecte: 3.<br><br>El paràmetre *Emplenat* no és disponible si *Dibuix* s'ha establert a "Punts" o "Barra".| |*Manquen dades*|<|0|ds.missingdatafunc.0|0 - *(per defecte)* Cap;<br>1 - Connectat;<br>2 - Tracta com a 0;<br>3 - Darrer conegut.< br><br>El paràmetre *Manquen dades* no és disponible si *Dibuix* s'estableix a "Punts" o "Barra".| |*Eix Y*|<|0|ds.axisy.0|0 - *(per defecte)* Esquerra;<br>1 - Dreta.| |*Desplaçament de temps*|<|1|ds.timeshift.0|Cadena de temps vàlida (p. ex., `3600`, `1h`, etc.).<br>Podeu emprar [sufixos de temps](/manual/appendix/sufixos #sufixos-temps). També es permeten valors negatius.<br><br>Per defecte: `""` (buida).| |*Funció d'afegit*|<|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'afegit*|<|1|ds.aggregate_interval.0|Cadena de temps vàlida (per exemple, `3600`, `1h`, etc.).<br>Podeu emprar [sufixos de temps](/manual/appendix/suffixes #sufixos de temps).<br><br>Per defecte: `1h`.| |*Afegit*|<|0|ds.aggregate_grouping.0|0 - *(per defecte)* Cada element;<br>1 - Conjunt de dades.<br><br>Paràmetre *Afegit* no disponible si *Funció d'afegit* s'estableix a "cap".| |*Aproximació*|<|0|ds.approximation.0|1 - mín;<br>2 - *(per defecte)* mitjana;<br>4 - màxim;<br>7 - tot.| |*Etiqueta del conjunt de dades*|<|1|ds.data_set_label.0|Qualsevol valor de cadena.<br><br>Per defecte: `""` (buida).|

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.0.hosts.0, ds.0.items.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| |-|--------|--|--------|-------------------------------| |*Data set type*|<|0|ds.0.dataset_type|0 - Item list;<br>1 - *(default)* Item patterns.| |<|*Items*|4|ds.0.itemids.0|[Item](/manual/api/reference/item/get) ID.<br>When configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object), only items configured on the template should be set.<br><br>Note: To configure multiple items, create a dashboard widget field object for each item with an incremented number in the property name.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item list" and *Items (Widget)* is not set| |^|*Items (Widget)*|1|ds.0.itemids.0.\_reference|Instead of [Item](/manual/api/reference/item/get) ID:<br>`ABCDE._itemid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for items.<br><br>Note: To configure multiple widgets, create a dashboard widget field object for each widget with an incremented number in the property name.<br><br>This parameter is supported since Zabbix 7.0.1.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item list" and *Items* is not set| |^|*Color*|1|ds.0.color.0|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Data set type* is set to "Item list"| |^|*Item type*|0|ds.0.type.0|0 - *(default)* Normal;<br>1 - Total.<br><br>The value "Total" can be set only for one item in the whole chart.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Data set type* is set to "Item list"| |^|*Host patterns*|1|ds.0.hosts.0|[Host](/manual/api/reference/host/get) name or pattern (e.g., "Zabbix\*").<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item patterns"<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Item patterns*|1|ds.0.items.0|[Item](/manual/api/reference/item/get) name or pattern (e.g., "\*: Number of processed \*values per second").<br><br>When configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object), only the patterns for items configured on the template should be set.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Data set type* is set to "Item patterns"| |^|*Color*|1|ds.0.color|Hexadecimal color code (e.g. `FF0000`).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Data set type* is set to "Item patterns"| |*Aggregation function*|<|0|ds.0.aggregate_function|1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - *(default)* last.| |*Data set aggregation*|<|0|ds.0.dataset_aggregation|0 - *(default)* none;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Item type* is set to "Total"| |*Data set label*|<|1|ds.0.data_set_label|Any string value.<br><br>Default: `""` (empty).|
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.0.hosts.0, ds.0.items.0) representa el conjunt de dades concret, mentre que el segon nombre, si és present, representa l'equip o l'element configurat. :::  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Tipus de conjunt de dades*|<|0|ds.0.dataset_type|0 - Llista d'elements;<br>1 - *(per defecte)* Patrons d'elements.| |<|*Elements*|4|ds.0.itemids.0|ID de l'[element](/manual/api/reference/item/get).<br>Quan es configura el giny a un [tauler de control de plantilla](/manual/api/reference/templatedashboard/object), només s'han d'establir els elements configurats a la plantilla.<br><br>Nota: per configurar diversos elements, creeu un objecte de camp de giny del tauler per a cada element amb un nombre incrementat al nom de la propietat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si *Tipus de conjunt de dades* s'estableix a "Llista d'elements"| |^|*Elements (Giny)*|1|ds.0.itemids.0.\_reference|En lloc d'[Elements](/manual/api/reference/item/get) ID:<br>`ABCDE._itemid` - estableix un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre *Reference* definit en "`ABCDE`") com a font de dades per als elements.<br><br >Nota: per configurar diversos ginys, creeu un objecte de camp de giny del tauler de control per a cada giny amb un nombre incrementat al nom de la propietat.<br><br>Aquest paràmetre s'admet des de Zabbix 7.0.1.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si *Tipus de conjunt de dades* és establert a "Llistat d'elements" i *Elements* no és pas definit | |^|*Color*|1|ds.0.color.0|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior): <br>- *admès* si el *Tipus de conjunt de dades* és definit a "Llista d'elements"| |^|*Tipus d'element*|0|ds.0.type.0|0 - *(per defecte)* Normal;<br>1 - Total.<br><br>El valor "Total" només es pot establir per a un element de tot el gràfic.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Tipus de conjunt de dades* s'estableix a "Llista d'elements" | |^|*Patrons d'equips*|1|ds.0.hosts.0|[Equip](/manual/api/reference/host/get) nom o patró (p. ex., "Zabbix\*").<br>< br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si *Tipus de conjunt de dades* s'estableix a "Patrons d'elements"<br><br>Aquest paràmetre no s'admet si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |^|*Patrons d'element*|1|ds.0.items.0|[Element](/manual/api/reference/item/get) nom o patró (p. ex., "\*: Nombre de \*valors processats per segon").<br><br>Quan es configura el giny en un [tauler de control de plantilla](/manual/api/reference/templatedashboard/object), només s'han d'establir els patrons dels elements configurats a la plantilla.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si *Tipus de conjunt de dades* s'estableix a "Patrons d'elements"| |^|*Color*|1|ds.0.color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br >- *admès* si el *Tipus de conjunt de dades* s'estableix en "Patrons d'elements"| |*Funció d'agregació*|<|0|ds.0.aggregate_function|1 - mín;<br>2 - màxim;<br>3 - mitjana;<br>4 - recompte;<br>5 - suma;<br >6 - primer;<br>7 - *(per defecte)* darrer.| |*Agregació del conjunt de dades*|<|0|ds.0.dataset_aggregation|0 - *(per defecte)* cap;<br>1 - mín;<br>2 - màx;<br>3 - mitjana;<br> 4 - recompte;<br>5 - suma.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Tipus d'element* s'estableix a " Total"| |*Etiqueta del conjunt de dades*|<|1|ds.0.data_set_label|Qualsevol valor de cadena.<br><br>Per defecte: `""` (buida).|

en-us	#### Data types  The Zabbix API supports the following data types as input:  |Type|Description| |--|--------| |ID|A unique identifier used to reference an entity.| |boolean|A boolean value (either `true` or `false`).| |flag|A value that is considered to be `true` if passed and not equal to `null`; otherwise, the value 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 (a plain array).| |object|An associative array.| |query|A value that defines the data to be returned. The value 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ó| |--|--------| |ID|Un identificador únic emprat per referenciar una entitat.| |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. :::