en-us	### Add advanced configuration settings to a configuration view  In this section, you will learn how to add an expandable/collapsible *Advanced configuration* section with optional parameters, such as color, minimum and maximum values, units and the *Description* field created earlier.  1. Create a *Widget.php* file in the main widget directory *lesson_gauge_chart* to create a new class *Widget*.  The *Widget* class will extend the *CWidget* base class to add/override the default widget settings (in this case - translations). JavaScript, provided below, displays the string "No data" in case of missing data. The "No data" string is present in the Zabbix UI translation files.  If there are any widget constants, it is recommended to also specify them in the *Widget* class.  **ui/modules/lesson_gauge_chart/Widget.php**  ```php <?php  namespace Modules\LessonGaugeChart;  use Zabbix\Core\CWidget;  class Widget extends CWidget {      public const UNIT_AUTO = 0;     public const UNIT_STATIC = 1;      public function getTranslationStrings(): array {         return [             'class.widget.js' => [                 'No data' => _('No data')             ]         ];     } } ```  2. Open *includes/WidgetForm.php* and add the new fields *Color* (color picker), *Min* (numeric field), *Max* (numeric field), and *Units* (select), and define the default color palette for the color picker, so that it can be used in the next steps.  **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**  ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Modules\LessonGaugeChart\Widget;  use Zabbix\Widgets\{     CWidgetField,     CWidgetForm };  use Zabbix\Widgets\Fields\{     CWidgetFieldColor,     CWidgetFieldMultiSelectItem,     CWidgetFieldNumericBox,     CWidgetFieldSelect,     CWidgetFieldTextBox };  /**  * Gauge chart widget form.  */ class WidgetForm extends CWidgetForm {      public const DEFAULT_COLOR_PALETTE = [         'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D',         '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D'     ];      public function addFields(): self {         return $this             ->addField(                 (new CWidgetFieldMultiSelectItem('itemid', _('Item')))                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)                     ->setMultiple(false)             )             ->addField(                 (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000')             )             ->addField(                 (new CWidgetFieldNumericBox('value_min', _('Min')))                     ->setDefault(0)                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)             )             ->addField(                 (new CWidgetFieldNumericBox('value_max', _('Max')))                     ->setDefault(100)                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)             )             ->addField(                 (new CWidgetFieldSelect('value_units', _('Units'), [                     Widget::UNIT_AUTO => _x('Auto', 'history source selection method'),                     Widget::UNIT_STATIC => _x('Static', 'history source selection method')                 ]))->setDefault(Widget::UNIT_AUTO)             )             ->addField(                 (new CWidgetFieldTextBox('value_static_units'))             )             ->addField(                 new CWidgetFieldTextBox('description', _('Description'))             );     } } ```  3. Open *views/widget.edit.php* and add the field visual components to the configuration view.  **ui/modules/lesson_gauge_chart/views/widget.edit.php**  ```php <?php  /**  * Gauge chart widget form view.  *  * @var CView $this  * @var array $data  */  $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units']))     ->setPlaceholder(_('value'))     ->setWidth(ZBX_TEXTAREA_TINY_WIDTH);  (new CWidgetFormView($data))     ->addField(         (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))             ->setPopupParameter('numeric', true)     )     ->addFieldset(         (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration')))             ->addField(                 new CWidgetFieldColorView($data['fields']['chart_color'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_min'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_max'])             )             ->addItem([                 $lefty_units->getLabel(),                 (new CFormField([                     $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN),                     $lefty_static_units->getView()                 ]))             ])             ->addField(                 new CWidgetFieldTextBoxView($data['fields']['description'])             )     )     ->show(); ```  ::: noteclassic The *addField()* method of the *CWidgetFormView* class takes a CSS class string as the second parameter. :::  4. Return to the dashboard, switch to the edit mode and click on the gear icon in the widget to open the widget configuration form. The widget configuration form now contains a new expandable/collapsible section *Advanced configuration*.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_advanced.png){width="600"}  5. Expand the *Advanced configuration* section to see additional widget configuration fields. Note that the field *Color* has no color picker yet. This is because the color picker must be initialized with JavaScript, which will be added in the next section - [*Add JavaScript to the widget*](#add-javascript-to-the-widget).  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_advanced_a.png){width="600"}
es	### Agregar ajustes de configuración avanzados a una vista de configuración  En esta sección, aprenderá cómo agregar una sección *Configuración avanzada* expandible/contraíble con parámetros opcionales, como color, valores mínimos y máximos, unidades y el campo *Descripción* creado anteriormente.  1. Cree un archivo *Widget.php* en el directorio principal de widgets *lesson_gauge_chart* para crear una nueva clase *Widget*.  La clase *Widget* ampliará la clase base *CWidget* para agregar/anular la configuración predeterminada del widget (en este caso, traducciones). JavaScript, que se proporciona a continuación, muestra la cadena "Sin datos" en caso de que falten datos. La cadena "Sin datos" está presente en los archivos de traducción de la interfaz de usuario de Zabbix.  Si hay constantes de widget, se recomienda especificarlas también en la clase *Widget*.  **ui/modules/lesson_gauge_chart/Widget.php**  ```php <?php  namespace Modules\LessonGaugeChart;  use Zabbix\Core\CWidget;  class Widget extends CWidget {      public const UNIT_AUTO = 0;     public const UNIT_STATIC = 1;      public function getTranslationStrings(): array {         return [             'class.widget.js' => [                 'No data' => _('No data')             ]         ];     } } ```  2. Abra *includes/WidgetForm.php* y agregue los nuevos campos *Color* (selector de color), *Min* (campo numérico), *Max* (campo numérico) y *Unidades* (seleccione), y defina el paleta de colores predeterminada para el selector de color, de modo que pueda usarse en los siguientes pasos.  **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**  ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Modules\LessonGaugeChart\Widget;  use Zabbix\Widgets\{     CWidgetField,     CWidgetForm };  use Zabbix\Widgets\Fields\{     CWidgetFieldColor,     CWidgetFieldMultiSelectItem,     CWidgetFieldNumericBox,     CWidgetFieldSelect,     CWidgetFieldTextBox };  /**  * Gauge chart widget form.  */ class WidgetForm extends CWidgetForm {      public const DEFAULT_COLOR_PALETTE = [         'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D',         '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D'     ];      public function addFields(): self {         return $this             ->addField(                 (new CWidgetFieldMultiSelectItem('itemid', _('Item')))                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)                     ->setMultiple(false)             )             ->addField(                 (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000')             )             ->addField(                 (new CWidgetFieldNumericBox('value_min', _('Min')))                     ->setDefault(0)                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)             )             ->addField(                 (new CWidgetFieldNumericBox('value_max', _('Max')))                     ->setDefault(100)                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)             )             ->addField(                 (new CWidgetFieldSelect('value_units', _('Units'), [                     Widget::UNIT_AUTO => _x('Auto', 'history source selection method'),                     Widget::UNIT_STATIC => _x('Static', 'history source selection method')                 ]))->setDefault(Widget::UNIT_AUTO)             )             ->addField(                 (new CWidgetFieldTextBox('value_static_units'))             )             ->addField(                 new CWidgetFieldTextBox('description', _('Description'))             );     } } ```  3. Abra *views/widget.edit.php* y agregue los componentes visuales del campo a la vista de configuración.  **ui/modules/lesson_gauge_chart/views/widget.edit.php**  ```php <?php  /**  * Gauge chart widget form view.  *  * @var CView $this  * @var array $data  */  $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units']))     ->setPlaceholder(_('value'))     ->setWidth(ZBX_TEXTAREA_TINY_WIDTH);  (new CWidgetFormView($data))     ->addField(         (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))             ->setPopupParameter('numeric', true)     )     ->addFieldset(         (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration')))             ->addField(                 new CWidgetFieldColorView($data['fields']['chart_color'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_min'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_max'])             )             ->addItem([                 $lefty_units->getLabel(),                 (new CFormField([                     $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN),                     $lefty_static_units->getView()                 ]))             ])             ->addField(                 new CWidgetFieldTextBoxView($data['fields']['description'])             )     )     ->show(); ```  ::: noteclassic El método *addField()* de la clase *CWidgetFormView* toma una cadena de clase CSS como segundo parámetro. :::  4. Regrese al panel, cambie al modo de edición y haga clic en el ícono de ajustes en el widget para abrir el formulario de configuración del widget. El formulario de configuración del widget ahora contiene una nueva sección expandible/contraíble *Configuración avanzada*.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_advanced.png){width="600"}  5. Expanda la sección *Configuración avanzada* para ver campos de configuración de widgets adicionales. Tenga en cuenta que el campo *Color* aún no tiene selector de color. Esto se debe a que el selector de color debe inicializarse con JavaScript, que se agregará en la siguiente sección: [*Agregar JavaScript al widget*](#add-javascript-to-the-widget).  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_advanced_a.png){width="600"}

en-us	#### Add a proxy to a proxy group  Update proxy with ID "5" and add it to proxy group with ID "1".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxy.create",     "params": {         "proxyid": "5",         "proxy_groupid": "1",         "local_address": "127.0.0.1"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "5"         ]     },     "id": 1 } ```
es	#### Agregar un proxy a un grupo de proxy  Actualice el proxy con ID "5" y agréguelo al grupo de proxy con ID "1".  [Solicitud](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxy.create",     "params": {         "proxyid": "5",         "proxy_groupid": "1",         "local_address": "127.0.0.1"     },     "id": 1 } ```  Respuesta:  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "5"         ]     },     "id": 1 } ```

en-us	### Add a widget view  :::noteclassic The widget's **view** file should be located in the *views* directory (for this tutorial, *ui/modules/lesson_gauge_chart/views/*). If the file has the default name *widget.view.php*, you do not need to register it in the *manifest.json* file. If the file has a different name, specify it in the *actions/widget.lesson_gauge_chart.view* section of the [manifest.json](devel/modules/file_structure/manifest) file. :::  1. Create a directory *views* in the *lesson_gauge_chart* directory.  2. Create a *widget.view.php* file in the *views* directory.  **ui/modules/lesson_gauge_chart/views/widget.view.php**  ```php <?php  /**  * Gauge chart widget view.  *  * @var CView $this  * @var array $data  */  (new CWidgetView($data))     ->addItem(         new CTag('h1', true, 'Hello, world!')     )     ->show(); ```  3. Refresh the dashboard. The *Gauge chart* widget now displays "Hello, world!".  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_hello_world.png){width="600"}
es	### Agregar una vista de widget  :::noteclassic  El archivo **view** del widget debe estar ubicado en el directorio *views* (para este tutorial, *ui/modules/lesson_gauge_chart/views/*). Si el archivo tiene el nombre predeterminado *widget.view.php*, no es necesario registrarlo en el archivo *manifest.json*. Si el archivo tiene un nombre diferente, especifíquelo en la sección *actions/widget.lesson_gauge_chart.view* del archivo [manifest.json](devel/modules/file_structure/manifest). :::  1. Cree un directorio *views* en el directorio *lesson_gauge_chart*.  2. Cree un archivo *widget.view.php* en el directorio *views*.  **ui/modules/lesson_gauge_chart/views/widget.view.php**  ```php <?php  /**  * Gauge chart widget view.  *  * @var CView $this  * @var array $data  */  (new CWidgetView($data)) ->addItem( new CTag('h1', true, '¡Hola, mundo!') ) ->show(); ```  3. Actualice el tablero. El widget *Gauge chart* ahora muestra "¡Hola, mundo!".  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_hello_world.png){width="600"}

en-us	### Add CSS styles to the widget  In this section you will learn how to add custom CSS styles to make the widget look more appealing.  1. For widget styles, create a new directory *css* in the *assets* directory.  2. Create a *widget.css* file in the *assets/css* directory. To style widget elements, use the selector *div.dashboard-widget-{widget id}*. To configure CSS for the whole widget, use the selector *form.dashboard-widget-{widget id}*  **ui/modules/lesson_gauge_chart/assets/css/widget.css**  ```css div.dashboard-widget-lesson_gauge_chart {     display: grid;     grid-template-rows: 1fr;     padding: 0; }  div.dashboard-widget-lesson_gauge_chart .chart {     display: grid;     align-items: center;     justify-items: center; }  div.dashboard-widget-lesson_gauge_chart .chart canvas {     background: white; }  div.dashboard-widget-lesson_gauge_chart .description {     padding-bottom: 8px;     font-size: 1.750em;     line-height: 1.2;     text-align: center; }  .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart {     margin-top: 8px; } ```  3. Open *manifest.json* and add the CSS file name (*widget.css*) to the array in the *assets/css* section. This will allow the CSS styles defined in *widget.css* to load with the dashboard page.  **ui/modules/lesson_gauge_chart/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "lesson_gauge_chart",     "type": "widget",     "name": "Gauge chart",     "namespace": "LessonGaugeChart",     "version": "1.0",     "author": "Zabbix",     "actions": {         "widget.lesson_gauge_chart.view": {             "class": "WidgetView"         }     },     "widget": {         "js_class": "WidgetLessonGaugeChart"     },     "assets": {         "css": ["widget.css"],         "js": ["class.widget.js"]     } } ```  4. Refresh the dashboard page to see the finished version of the widget.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_view_finished.png){width="600"}
es	### Agregar estilos CSS al widget  En esta sección aprenderá cómo agregar estilos CSS personalizados para que el widget sea más atractivo.  1. Para estilos de widgets, cree un nuevo directorio *css* en el directorio *assets*.  2. Cree un archivo *widget.css* en el directorio *assets/css*. Para aplicar estilo a los elementos del widget, utilice el selector *div.dashboard-widget-{widget id}*. Para configurar CSS para todo el widget, use el selector *form.dashboard-widget-{widget id}*  **ui/modules/lesson_gauge_chart/assets/css/widget.css**  ```css div.dashboard-widget-lesson_gauge_chart {     display: grid;     grid-template-rows: 1fr;     padding: 0; }  div.dashboard-widget-lesson_gauge_chart .chart {     display: grid;     align-items: center;     justify-items: center; }  div.dashboard-widget-lesson_gauge_chart .chart canvas {     background: white; }  div.dashboard-widget-lesson_gauge_chart .description {     padding-bottom: 8px;     font-size: 1.750em;     line-height: 1.2;     text-align: center; }  .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart {     margin-top: 8px; } ```  3. Abra *manifest.json* y agregue el nombre del archivo CSS (*widget.css*) a la matriz en la sección *assets/css*. Esto permitirá que los estilos CSS definidos en *widget.css* se carguen con la página del tablero.  **ui/modules/lesson_gauge_chart/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "lesson_gauge_chart",     "type": "widget",     "name": "Gauge chart",     "namespace": "LessonGaugeChart",     "version": "1.0",     "author": "Zabbix",     "actions": {         "widget.lesson_gauge_chart.view": {             "class": "WidgetView"         }     },     "widget": {         "js_class": "WidgetLessonGaugeChart"     },     "assets": {         "css": ["widget.css"],         "js": ["class.widget.js"]     } } ```  4. Actualice la página del tablero para ver la versión finalizada del widget.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_view_finished.png){width="600"}

en-us	#### Adding a filter to an LLD rule  Add a filter so that the contents of the *{\#FSTYPE}* macro would match the *\@File systems for discovery* regexp.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "22450",         "filter": {             "evaltype": 1,             "conditions": [                 {                     "macro": "{#FSTYPE}",                     "value": "@File systems for discovery"                 }             ]         }     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "22450"         ]     },     "id": 1 } ```
es	#### Agregar un filtro a una regla LLD  Agregue un filtro para que el contenido de la macro *{\#FSTYPE}* coincida la expresión regular *\@Sistemas de archivos para descubrimiento*.  [Solicitud](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "22450",         "filter": {             "evaltype": 1,             "conditions": [                 {                     "macro": "{#FSTYPE}",                     "value": "@Sistemas de archivos para descubrimiento"                 }             ]         }     },     "id": 1 } ```  Respuesta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "22450"         ]     },     "id": 1 } ```

en-us	## Adding a module  Open *Administration→General→Modules* page and press *Scan directory*.  ![](../../../../assets/en/devel/modules/tutorials/widget/scan_dir.png)  Locate your module in the list and activate it.  To activate a module, press on the *Disabled* hyperlink - the module's state will change to *Enabled*.  Press on the module name to view additional information about the module, such as author, version, or short description (if defined in the manifest).
es	## Agregar un módulo  Abra la página *Administración→General→Módulos* y presione *Escanear directorio*.  ![](../../../../assets/en/devel/modules/tutorials/widget/scan_dir.png)  Localice su módulo en la lista y actívelo.  Para activar un módulo, presione el hipervínculo *Desactivado*; el estado del módulo cambiará a *Activado*.  Presione en el nombre del módulo para ver información adicional sobre el módulo, como autor, versión o descripción breve (si está definida en el manifiesto).

en-us	#### Adding a scheduled downtime  Add a downtime for service with ID "4" scheduled weekly from Monday 22:00 till Tuesday 10:00.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "service.update",     "params": {         "serviceid": "4",         "times": [             {                 "type": "1",                 "ts_from": "165600",                 "ts_to": "201600"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "serviceids": [             "4"         ]     },     "id": 1 } ```
es	#### Agregar un tiempo de inactividad programado  Agregue un tiempo de inactividad para el servicio con ID "4" programado semanalmente a partir del lunes 22:00 hasta el martes 10:00.  [Solicitud](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "service.update",     "params": {         "serviceid": "4",         "times": [             {                 "type": "1",                 "ts_from": "165600",                 "ts_to": "201600"             }         ]     },     "id": 1 } ```  Respuesta:  ```json {     "jsonrpc": "2.0",     "result": {         "serviceids": [             "4"         ]     },     "id": 1 } ```

en-us	#### Adding dashboards  To add dashboards to a template in *Data collection* → *Templates*, do the following:  1. Click on *Dashboards* in the row of the template. 2. Configure a dashboard following the guidelines of [configuring dashboards](/manual/web_interface/frontend_sections/dashboards).  ::: noteimportant When configuring widgets on a template dashboard (instead of a global dashboard), the host-related parameters are not available, and some parameters have a different label. This is because template dashboards display data only from the host that the template is linked to. For example, the parameters *Host groups*, *Exclude host groups* and *Hosts* in the [*Problems*](/manual/web_interface/frontend_sections/dashboards/widgets/problems) widget are not available, the parameter *Host groups* in the [*Host availability*](/manual/web_interface/frontend_sections/dashboards/widgets/host_availability) widget is not available, and the parameter *Show hosts in maintenance* is renamed to *Show data in maintenance*, etc. For more information on the availability of parameters in template dashboard widgets, see specific parameters for each [dashboard widget](/manual/web_interface/frontend_sections/dashboards/widgets). :::  ::: notetip For details on accessing host dashboards that are created from template dashboards, see the [host dashboards](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards#access) section. :::
es	#### Agregar paneles  Para agregar paneles a una plantilla en *Recopilación de datos* → *Plantillas*, haga lo siguiente siguiente:  1. Haga clic en *Paneles* en la fila de la plantilla. 2. Configure un panel siguiendo las pautas de [configurar paneles](/manual/web_interface/frontend_sections/dashboards).  ::: nota importante Al configurar widgets en un panel de plantilla (en lugar de un panel global), los parámetros relacionados con el host no están disponibles y algunos parámetros tienen una etiqueta diferente. Esto se debe a que los paneles de plantilla muestran datos solo del host al que está vinculada la plantilla. Por ejemplo, los parámetros *Grupos de hosts*, *Excluir grupos de hosts* y *Hosts* en el widget [*Problems*](/manual/web_interface/frontend_sections/dashboards/widgets/problems) no están disponibles. el parámetro *Grupos de hosts* en el widget [*Disponibilidad de hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/host_availability) no está disponible y el parámetro *Mostrar hosts en mantenimiento* pasa a llamarse *Mostrar datos en mantenimiento *, etc. Para obtener más información sobre la disponibilidad de parámetros en los widgets del panel de plantilla, consulte los parámetros específicos para cada [widget del panel](/manual/web_interface/frontend_sections/dashboards/widgets). :::  ::: nota Para obtener detalles sobre cómo acceder a los paneles de host que se crean a partir de paneles de plantilla, consulte la sección [paneles de host](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards#access). :::

en-us	#### Adding elements  To add an element, click on *Add* next to `Map element`. The new element will appear at the top left corner of the map. Drag and drop it wherever you like.  Note that with the Grid option "On", elements will always align to the grid (you can pick various grid sizes from the dropdown, also hide/show the grid). If you want to put elements anywhere without alignment, turn the option to "Off". (You can align random elements to the grid later,  by clicking on *Align map elements*.)  Now that you have some elements in place, you may want to start differentiating them by giving names, etc. By clicking on the element, a form is displayed and you can set the element type, give a name, choose a different icon, etc.  ![](../../../../../assets/en/manual/config/visualization/map_element.png){width="600"}  Map element attributes:  |Parameter|Description| |--|--------| |*Type*|Type of the element:<br>**Host** - icon representing status of all triggers of the selected host<br>**Map** - icon representing status of all elements of a map<br>**Trigger** - icon representing status of one or more triggers<br>**[Host group](/manual/config/visualization/maps/host_groups)** - icon representing status of all triggers of all hosts belonging to the selected group<br>**Image** - an icon, not linked to any resource| |*Label*|Icon label, any string.<br>Macros and multiline strings can be used.<br>Expression [macros](/manual/appendix/macros/supported_by_location) are supported in this field, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`).<br>For a full list of supported macros, see [supported macros](/manual/appendix/macros/supported_by_location) and search for 'map element labels'.| |*Label location*|Label location in relation to the icon:<br>**Default** - map's default label location<br>**Bottom** - beneath the icon<br>**Left** - to the left<br>**Right** - to the right<br>**Top** - above the icon| |*Host*|Enter the host if the element type is 'Host'. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts. Scroll down to select. Click on 'x' to remove the selected.| |*Map*|Select the map if the element type is 'Map'. This field is auto-complete so starting to type the name of a map will offer a dropdown of matching maps. Scroll down to select. Click on 'x' to remove the selected.| |*Triggers*|If the element type is 'Trigger', select one or more triggers in the *New triggers* field below and click on *Add*.<br>The order of selected triggers can be changed, but only within the same severity of triggers. Multiple trigger selection also affects {HOST.\*} macro resolution both in the editing and view modes.<br>// 1 In editing mode// the first displayed {HOST.\*} macros will be resolved depending on the first trigger in the list (based on trigger severity).<br>// 2 View mode// depends on the [Display problems](/manual/config/visualization/maps/map#creating_a_map) parameter in General map attributes.<br>\* If *Expand single problem* mode is chosen, the first displayed {HOST.\*} macros will be resolved depending on the latest detected problem trigger (not mattering the severity) or the first trigger in the list (in case no problem detected);<br>\* If *Number of problems and expand most critical one* mode is chosen, the first displayed {HOST.\*} macros will be resolved depending on the trigger severity.<br>| |*Host group*|Enter the host group if the element type is 'Host group'. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups. Scroll down to select. Click on 'x' to remove the selected.| |*Tags*|Specify tags to limit the number of problems displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met<br>This field is available for host and host group element types.| |*Automatic icon selection*|In this case an icon mapping will be used to determine which icon to display.| |*Icons*|You can choose to display different icons for the element in these cases: default, problem, maintenance, disabled.| |*Coordinate X*|X coordinate of the map element.| |*Coordinate Y*|Y coordinate of the map element.| |*URLs*|Element-specific URLs (up to 2048 characters) can be set for the element. A label for the URL can also be defined. These will be displayed as links when a user clicks on the element in the map viewing mode. If the element has its own URLs and there are map level URLs for its type defined, they will be combined in the same menu.<br>Macros can be used in map element names and values. For a full list, see [supported macros](/manual/appendix/macros/supported_by_location) and search for 'map URL names and values'.|  ::: noteimportant Added elements are not automatically saved. If you navigate away from the page, all changes may be lost.  Therefore it is a good idea to click on the **Update** button in the top right corner. Once clicked, the changes are saved regardless of what you choose in the following popup.  Selected grid options are also saved with each map. :::
es	#### Agregar elementos  Para agregar un elemento, haga clic en *Agregar* junto a "Elemento de mapa". Ell nuevo elemento aparecerá en la esquina superior izquierda del mapa. Arrástrelo y suéltelo donde quiera.  Tenga en cuenta que con la opción Cuadrícula "Activada", los elementos siempre se alinearán con la cuadrícula (puede elegir varios tamaños de cuadrícula en el menú desplegable, también ocultar/mostrar la cuadrícula). Si desea colocar elementos en cualquier lugar sin alineación, cambie la opción a "Desactivado". (Los elementos aleatorios se pueden volver a alinear más tarde con la cuadrícula haciendo clic en *Alinear elementos del mapa*.)  Ahora que tiene algunos elementos en su lugar, es posible que desee comenzar diferenciándolos dándole nombres, etc. Al pulsar sobre el elemento, aparecerá un formulario y puede establecer el tipo de elemento, darle un nombre, elegir un icono diferente, etc.  ![](../../../../../assets/en/manual/config/visualization/map_element.png){width="600"}  Atributos del elemento del mapa:  |Parámetro|Descripción| |--|--------| |*Tipo*|Tipo de elemento:<br>**Equipo** - icono que representa el estado de todos los iniciadores del equipo seleccionado<br>**Mapa** - icono que representa el estado de todos los elementos de un mapa<br> **Iniciador**: icono que representa el estado de uno o más iniciadores<br>**[Grupo de equipos](/manual/config/visualization/maps/host_groups)** - icono que representa el estado de todos los iniciadores de todos los equipos que pertenecen al grupo seleccionado<br>**Imagen**: un icono, no vinculado a ningún recurso| |*Etiqueta*|Etiqueta de icono, cualquier cadena.<br>Se pueden usar macros y cadenas multilínea.<br>La expresión [macros](/manual/appendix/macros/supported_by_location) se admite en este campo, pero solo con las funciones `avg `, `last`, `min` y `max`, con el tiempo como parámetro (por ejemplo, `{?avg(/host/key,1h)}`).<br>Para obtener una lista completa de las macros compatibles, consulte [macros compatibles](/manual/appendix/macros/supported_by_location) y busque 'etiquetas de elementos de mapa'.| |*Ubicación de la etiqueta*|Ubicación de la etiqueta en relación con el ícono:<br>**Predeterminado**: ubicación predeterminada de la etiqueta del mapa<br>**Abajo**: debajo del ícono<br>**Izquierda**: hacia el izquierda<br>**Derecha** - a la derecha<br>**Arriba** - encima del icono| |*Equipo*|Ingrese el equipo si el tipo de elemento es 'Equipo'. Este campo se completa automáticamente, por lo que al comenzar a escribir el nombre de un equipo se mostrará un menú desplegable de equipos coincidentes. Desplácese hacia abajo para seleccionar. Haga clic en 'x' para eliminar lo seleccionado.| |*Mapa*|Seleccione el mapa si el tipo de elemento es 'Mapa'. Este campo se completa automáticamente, por lo que al comenzar a escribir el nombre de un mapa aparecerá un menú desplegable de mapas coincidentes. Desplácese hacia abajo para seleccionar. Haga clic en 'x' para eliminar lo seleccionado.| |*Iniciadores*|Si el tipo de elemento es 'Iniciador', seleccione uno o más Iniciadores en el campo *Nuevos Iniciadores* a continuación y haga clic en *Agregar*.<br>El orden de los Iniciadores seleccionados se puede cambiar, pero solo dentro de la misma gravedad de los Iniciadores. La selección de múltiples Iniciadores también afecta a la resolución de la macro {HOST.\*} tanto en los modos de construcción como de vista.<br>// 1 En el modo de construcción// las primeras macros {HOST.\*} mostradas se resolverán dependiendo del primer Iniciador. en la lista (según la gravedad del Iniciador).<br>// 2 Modo de visualización// depende del parámetro [Problemas de visualización](/manual/config/visualization/maps/map#creating_a_map) en Atributos generales del mapa.<br> \* Si se elige el modo *Expandir un solo problema*, las primeras macros {HOST.\*} mostradas se resolverán según el último Iniciador del problema detectado (sin importar la gravedad) o el primer Iniciador de la lista (en caso de que no se detecte ningún problema). );<br>\* Si se elige el modo *Número de problemas y expandir el más crítico*, las primeras macros {HOST.\*} mostradas se resolverán dependiendo de la gravedad del Iniciador.<br>| |*Grupo de equipos*|Ingrese el grupo de equipos si el tipo de elemento es 'Grupo de equipos'. Este campo se completa automáticamente, por lo que al comenzar a escribir el nombre de un grupo aparecerá un menú desplegable de grupos coincidentes. Desplácese hacia abajo para seleccionar. Haga clic en 'x' para eliminar lo seleccionado.| |*Etiquetas*|Especifique etiquetas para limitar la cantidad de problemas que se muestran en el widget. Es posible incluir y excluir etiquetas y valores de etiquetas específicos. Se pueden establecer varias condiciones. La coincidencia de nombres de etiquetas siempre distingue entre mayúsculas y minúsculas.<br>Hay varios operadores disponibles para cada condición:<br>**Existe**: incluye los nombres de etiquetas especificados<br>**Igual**: incluye los nombres de etiquetas especificados y valores (distingue entre mayúsculas y minúsculas)<br>**Contiene**: incluye los nombres de etiqueta especificados donde los valores de etiqueta contienen la cadena ingresada (coincidencia de subcadena, no distingue entre mayúsculas y minúsculas)<br>**No existe**: excluye lo especificado nombres de etiquetas<br>**No es igual**: excluye los nombres y valores de etiquetas especificados (distingue entre mayúsculas y minúsculas)<br>**No contiene**: excluye los nombres de etiquetas especificados donde los valores de etiqueta contienen la cadena ingresada ( coincidencia de subcadena, no distingue entre mayúsculas y minúsculas)<br>Hay dos tipos de cálculo para las condiciones:<br>**Y/O**: se deben cumplir todas las condiciones, las condiciones que tengan el mismo nombre de etiqueta se agruparán por la condición O<br >**O** - suficiente si se cumple una condición<br>Este campo está disponible para tipos de elementos de equipo y grupo de equipos.| |*Selección automática de iconos*|En este caso, se utilizará una asignación de iconos para determinar qué icono mostrar.| |*Iconos*|Puede elegir mostrar diferentes iconos para el elemento en estos casos: predeterminado, problema, mantenimiento, deshabilitado.| |*Coordenada X*|Coordenada X del elemento del mapa.| |*Coordenada Y*|Coordenada Y del elemento del mapa.| |*URL*|Se pueden establecer URL específicas del elemento para el elemento. Estos se mostrarán como enlaces cuando un usuario haga clic en el elemento en el modo de visualización del mapa. Si el elemento tiene sus propias URL y hay URL a nivel de mapa para su tipo definido, se combinarán en el mismo menú.<br>Se pueden usar macros en los nombres y valores de los elementos del mapa. Para obtener una lista completa, consulte las [macros admitidas](/manual/appendix/macros/supported_by_location) y busque 'nombres y valores de URL del mapa'.|  ::: noteimportant Los elementos agregados no se guardan automáticamente. Si usted navega fuera de la página, es posible que se pierdan todos los cambios.  Por lo tanto, es una buena idea hacer clic en el botón **Actualizar** en la  esquina superior derecha. Una vez que se hace clic, los cambios se guardan independientemente de lo que usted elija en la siguiente ventana emergente.  Las opciones de cuadrícula seleccionadas también se guardan con cada mapa. :::

en-us	##### Adding host  Hosts are added during the discovery process, as soon as a host is discovered, rather than at the end of the discovery process.  ::: notetip As network discovery can take some time due to many unavailable hosts/services having patience and using reasonable IP ranges is advisable. :::  When adding a host, its name is decided by the standard **gethostbyname** function. If the host can be resolved, resolved name is used. If not, the IP address is used. Besides, if IPv6 address must be used for a host name, then all ":" (colons) are replaced by "\_" (underscores), since colons are not allowed in host names.  ::: noteimportant If performing discovery by a proxy, currently hostname lookup still takes place on Zabbix server. :::  ::: noteimportant If a host already exists in Zabbix configuration with the same name as  a newly discovered one, Zabbix will add **\_N** to the hostname,  where **N** is increasing number, starting with 2. :::
es	##### Agregar host  Los hosts se agregan durante el proceso de descubrimiento, tan pronto como un host es descubierto, en lugar de al final del proceso de descubrimiento.  ::: nota Como el descubrimiento de la red puede llevar algún tiempo debido a muchos hosts/servicios no disponibles tener paciencia y usar IP razonable Se recomiendan rangos. :::  Al agregar un host, su nombre lo decide el estándar. Función **gethostbyname**. Si el host se puede resolver, nombre resuelto se utiliza. En caso contrario, se utiliza la dirección IP. Además, si la dirección IPv6 debe usarse para un nombre de host, entonces todos los ":" (dos puntos) se reemplazan por "\_" (guiones bajos), ya que no se permiten dos puntos en los nombres de host.  ::: nota importante Si realiza el descubrimiento mediante un proxy, actualmente La búsqueda del nombre de host todavía se realiza en el servidor Zabbix. :::  ::: nota importante Si ya existe un host en la configuración de Zabbix con el mismo nombre que  uno recién descubierto, Zabbix agregará **\_N** al nombre de host,  donde **N** es un número creciente, comenzando con 2. :::

en-us	#### Adding host  Information about configured hosts in Zabbix is available in *Data collection → Hosts* and *Monitoring* → *Hosts*. There is already one pre-defined host, called "Zabbix server", but we want to learn adding another.  To add a new host, click on *Create host*. This will present us with a host configuration form.\ ![](../../../assets/en/manual/quickstart/new_host.png)  All mandatory input fields are marked with a red asterisk.  The bare minimum to enter here is:  ***Host name***  -   Enter a host name. Alphanumerics, spaces, dots, dashes and     underscores are allowed.  ***Host groups***  -   Select one or several existing groups by clicking *Select* button or     enter a non-existing group name to create a new group.  ::: noteclassic All access permissions are assigned to host groups, not individual hosts. That is why a host must belong to at least one group. :::  ***Interfaces: IP address***  -   Although not a required field technically, a host interface is necessary for collecting certain metrics. To use Zabbix agent passive checks, specify the agent's IP or DNS in this field. Note that you should also specify Zabbix server's IP or DNS in the Zabbix agent configuration file 'Server' directive. If Zabbix agent and Zabbix server are installed on the same machine, you need to specify the same IP/DNS in both places.  [Other options](/manual/config/hosts/host#configuration) will suit us with their defaults for now.  When done, click *Add*. Your new host should be visible in the host list.  ![](../../../assets/en/manual/quickstart/host_list.png){width="600"}  The Availability column contains indicators of host availability per each interface. We have defined a Zabbix agent interface, so we can use the agent availability icon (with 'ZBX' on it) to understand host availability:  -   ![icon\_zbx\_gray.png](../../../assets/en/manual/quickstart/icon_zbx_gray.png) -     host status has not been established; no metric check has happened     yet -   ![icon\_zbx\_green.png](../../../assets/en/manual/quickstart/icon_zbx_green.png) -     host is available, a metric check has been successful -   ![icon\_zbx\_red.png](../../../assets/en/manual/quickstart/icon_zbx_red.png) -     host is unavailable, a metric check has failed (move your mouse     cursor over the icon to see the error message). There might be some     error with communication, possibly caused by incorrect interface     credentials. Check that Zabbix server is running, and try refreshing     the page later as well.
es	#### Agregar equipo  La información sobre los equipos configurados en Zabbix está disponible en *Recopilación de datos → Equipos* y *Monitoreo* → *Equipos*. Ya hay un equipo predefinido, llamado "servidor Zabbix", pero queremos aprender a agregar otro.  Para agregar un nuevo equipo, haga clic en *Crear equipo*. Esto nos presentará un formulario de configuración del equipo.\ ![](../../../assets/en/manual/quickstart/new_host.png)  Todos los campos de entrada obligatorios están marcados con un asterisco rojo.  El mínimo indispensable para entrar aquí es:  ***Nombre del equipo***  - Introduzca un nombre de equipo. Alfanuméricos, espacios, puntos, rayas y     Se permiten guiones bajos.  ***Grupos de equipo***  - Seleccione uno o varios grupos existentes haciendo clic en el botón *Seleccionar* o     ingrese un nombre de grupo no existente para crear un nuevo grupo.  ::: noteclassic Todos los permisos de acceso se asignan a grupos de equipos, no a equipos individuales. Es por eso que un equipo debe pertenecer al menos a un grupo. :::  ***Interfaces: dirección IP***  - Aunque técnicamente no es un campo obligatorio, se necesita una interfaz de equipo para recopilar ciertas métricas. Para utilizar comprobaciones pasivas del agente de Zabbix, especifique la IP o el DNS del agente en este campo. Tenga en cuenta que también debe especificar la IP o DNS del servidor Zabbix en la directiva 'Servidor' del archivo de configuración del agente Zabbix. Si el agente Zabbix y el servidor Zabbix están instalados en la misma máquina, debe especificar la misma IP/DNS en ambos lugares.  Las [otras opciones](/manual/config/hosts/host#configuration) nos estarán bien con sus valores predeterminados por ahora.  Cuando termine, haga clic en *Agregar*. Su nuevo equipo debería estar visible en la lista de equipos.  ![](../../../assets/en/manual/quickstart/host_list.png){width="600"}  La columna Disponibilidad contiene indicadores de disponibilidad del equipo por cada interfaz. Hemos definido una interfaz de agente Zabbix, por lo que podemos usar el ícono de disponibilidad del agente (con 'ZBX') para comprender la disponibilidad del equipo:  - ![icon\_zbx\_gray.png](../../../assets/en/manual/quickstart/icon_zbx_gray.png) -     no se ha establecido el estatus de anfitrión; no se ha realizado ninguna verificación métrica     todavía - ![icon\_zbx\_green.png](../../../assets/en/manual/quickstart/icon_zbx_green.png) -     el equipo está disponible, una verificación de métrica ha sido exitosa - ![icon\_zbx\_red.png](../../../assets/en/manual/quickstart/icon_zbx_red.png) -     el equipo no está disponible, una verificación de métrica ha fallado (mueva el mouse     cursor sobre el icono para ver el mensaje de error). Puede que haya algunos     errores con la comunicación, posiblemente causados por unas credenciales incorrectas de     la interfaz. Compruebe que el servidor Zabbix se esté ejecutando e intente actualizar     la página más tarde.

en-us	#### Adding hosts to host groups  Add two hosts to host groups with IDs 5 and 6.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.massadd",     "params": {         "groups": [             {                 "groupid": "5"             },             {                 "groupid": "6"             }         ],         "hosts": [             {                 "hostid": "30050"             },             {                 "hostid": "30001"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "5",             "6"         ]     },     "id": 1 } ```
es	#### Agregar equipos a grupos de equipos  Agregue dos equipos a los grupos de equipos con ID 5 y 6.  [Solicitud](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.massadd",     "params": {         "groups": [             {                 "groupid": "5"             },             {                 "groupid": "6"             }         ],         "hosts": [             {                 "hostid": "30050"             },             {                 "hostid": "30001"             }         ]     },     "id": 1 } ```  Respuesta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "5",             "6"         ]     },     "id": 1 } ```

en-us	#### Adding host tags during discovery/autoregistration  Additional operations are now available for discovery and autoregistration events:  -   Add host tags -   Remove host tags
es	#### Agregar etiquetas de equipo durante el descubrimiento/registro automático  Ahora hay operaciones adicionales disponibles para eventos de descubrimiento y registro automático:  -   Agregar etiquetas de equipo -   Eliminar etiquetas de equipo

en-us	#### Adding item  All items are grouped around hosts. That is why to configure a sample item we go to *Data collection → Hosts* and find the "New host" we have created.  Click on the *Items* link in the row of "New host", and then click on *Create item*. This will present us with an item definition form.  ![](../../../assets/en/manual/quickstart/new_item.png){width="600"}  All mandatory input fields are marked with a red asterisk.  For our sample item, the essential information to enter is:  ***Name***  -   Enter *CPU load* as the value. This will be the item name displayed     in lists and elsewhere.  ***Key***  -   Manually enter *system.cpu.load* as the value. This is the technical     name of an item that identifies the type of information that will be     gathered. The particular key is just one of [pre-defined     keys](/manual/config/items/itemtypes/zabbix_agent) that come with     Zabbix agent.  ***Type of information***  -   This attribute defines the format of the expected data. For the     *system.cpu.load* key, this field will be automatically set to     *Numeric (float)*.  ::: noteclassic You may also want to reduce the number of days [item history](/manual/config/items/history_and_trends) will be kept, to 7 or 14. This is good practice to relieve the database from keeping lots of historical values. :::  [Other options](/manual/config/items/item#configuration) will suit us with their defaults for now.  When done, click *Add*. The new item should appear in the item list. Click on *Details* above the list to view what exactly was done.  ![](../../../assets/en/manual/quickstart/item_created.png)
es	#### Añadiendo una métrica  Todas las métricas están agrupadas en torno a equipos. Es por eso que para configurar una métrica de muestra vamos a *Recopilación de datos → Equipos* y buscamos el "Nuevo equipo" que tenemos creado.  Haga clic en el enlace *Métricas* en la fila de "Nuevo equipo" y luego haga clic en *Crear métrica*. Esto nos presentará un formulario de definición de métricas.  ![](../../../assets/en/manual/quickstart/new_item.png){width="600"}  Todos los campos de entrada obligatorios están marcados con un asterisco rojo.  Para nuestra métrica de muestra, la información esencial a introducir es:  ***Nombre***  -   Introduzca *Carga de CPU* como valor. Este será el nombre de la métrica que se mostrará.     en listas y en otros lugares.  ***Clave***  -   Introduzca manualmente *system.cpu.load* como valor. Este es el nombre técnico     de una métrica que identifica el tipo de información que será     reunido. La clave particular es solo una de las [claves predefinidas     ](/manual/config/items/itemtypes/zabbix_agent) que vienen con el     Agente Zabbix.  ***Tipo de información***  -   Este atributo define el formato de los datos esperados. Para la clave     *system.cpu.load*, este campo se configurará automáticamente en     *Numérico (flotante)*.  ::: noteclassic También es posible que desee reducir el número de días que se mantendrá el [historial de la métrica](/manual/config/items/history_and_trends) , en 7 o 14. Esta es una buena práctica para evitar que la base de datos mantenga muchos valores históricos. :::  Por ahora, el [resto opciones](/manual/config/items/item#configuration) nos irán bien con sus valores predeterminados.  Cuando termine, haga clic en *Agregar*. La nueva métrica debería aparecer en la lista de métricas. Haga clic en *Detalles* encima de la lista para ver qué se hizo exactamente.  ![](../../../assets/en/manual/quickstart/item_created.png)

en-us	#### Adding items, triggers, graphs  ::: noteimportant Items have to be added to a template first. Triggers and graphs cannot be added without the corresponding item. :::  There are two ways to add items to the template:\  1. To create new items, follow the guidelines for [Creating an item](/manual/config/items/item).\  2. To add existing items to the template: - Go to *Data collection → Hosts* (or *Templates*). - Click on *Items* in the row of the required host/template. - Mark the checkboxes of items you want to add to the template. - Click on *Copy* below the item list. - Select the template (or group of templates) the items should be copied to and click on *Copy*.\ All the selected items should be copied to the template.  Adding triggers and graphs is done in a similar fashion (from the list of triggers and graphs respectively), again, keeping in mind that they can only be added if the required items are added first.
es	#### Agregar métricas, iniciadores y gráficos  ::: noteimportant Primero se deben agregar métricas a una plantilla. No se pueden agregar iniciadores ni gráficos sin las correspondientes métricas. :::  Hay dos formas de agregar métricas a la plantilla:\  1. Para crear nuevas métricas, siga las pautas para [Crear una métrica](/manual/config/items/item).\  2. Para agregar métricas existentes a la plantilla: - Vaya a *Recopilación de datos → Equipos* (o *Plantillas*). - Haga clic en *Métricas* en la fila del equipo/plantilla requerido. - Marque las casillas de verificación de las métricas que desea agregar a la plantilla. - Haga clic en *Copiar* debajo de la lista de elementos. - Seleccione la plantilla (o grupo de plantillas) a la que se deben copiar las métricas y haga clic en *Copiar*.\ Todas las métricas seleccionadas deben copiarse a la plantilla.  Agregar iniciadores y gráficos se realiza de manera similar (de la lista de iniciadores y gráficos respectivamente), nuevamente, teniendo en cuenta que solo se puede agregar si las métricas requeridas se agregan primero.

en-us	#### Adding item to template  To add an item to the template, go to the item list for 'New host'. In *Data collection → Hosts* click on *Items* next to 'New host'.  Then:  -   Mark the checkbox of the 'CPU Load' item in the list. -   Click on *Copy* below the list. -   Select the template to copy the item to.  ![](../../../assets/en/manual/quickstart/copy_to_template.png){width="600"}  All mandatory input fields are marked with a red asterisk.  -   Click on *Copy*.  If you now go to *Data collection* → *Templates*, 'New template' should have one new item in it.  We will stop at one item only for now, but similarly you can add any other items, triggers or other entities to the template until it's a fairly complete set of entities for given purpose (monitoring OS, monitoring single application).
es	#### Agregar métrica a la plantilla  Para agregar una métrica a la plantilla, vaya a la lista de métrica de "Nuevo equipo". En *Recopilación de datos → Equipos* haga clic en *Métricas* junto a 'Nuevo equipo'.  Entonces:  - Marque la casilla de verificación del elemento 'Carga de CPU' en la lista. - Haga clic en *Copiar* debajo de la lista. - Seleccione la plantilla para copiar el elemento.  ![](../../../assets/en/manual/quickstart/copy_to_template.png){width="600"}  Todos los campos de entrada obligatorios están marcados con un asterisco rojo.  - Haga clic en *Copiar*.  Si ahora va a *Recopilación de datos* → *Plantillas*, la 'Nueva plantilla' debería tener una nueva métrica.  Nos detendremos solo en una métrica por ahora, pero de manera similar puede agregar cualquier otra métrica, iniciador u otras entidades a la plantilla hasta que sea un conjunto bastante completo de entidades para un propósito determinado (monitoreo del sistema operativo, seguimiento de una aplicación).

en-us	##### Adding JMX agent item  For each JMX counter you are interested in you add **JMX agent** item attached to that interface.\  The key in the screenshot below says `jmx["java.lang:type=Memory","HeapMemoryUsage.used"]`.  ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_item.png){width="600"}  All mandatory input fields are marked with a red asterisk.  The fields that require specific information for JMX items are:  |   |   | |--|--------| |*Type*|Set **JMX agent** here.| |*Key*|The `jmx[]` item key contains three parameters:<br>**object name** - the object name of an MBean<br>**attribute name** - an MBean attribute name with optional composite data field names separated by dots<br>**unique short description** - a unique description that allows multiple JMX items with the same object name and attribute name on the host (optional)<br>See below for more detail on JMX item keys.<br>You may discover MBeans and MBean attributes using a `jmx.discovery[]` [low-level discovery](/manual/discovery/low_level_discovery/examples/jmx) item.| |*JMX endpoint*|You may specify a custom JMX endpoint. Make sure that JMX endpoint connection parameters match the JMX interface. This can be achieved by using {HOST.\*} macros as done in the default JMX endpoint.<br>{HOST.\*} [macros](/manual/appendix/macros/supported_by_location) and user macros are supported.| |*User name*|Specify the user name (up to 255 characters), if you have configured authentication on your Java application.<br>User macros are supported.| |*Password*|Specify the password (up to 255 characters), if you have configured authentication on your Java application.<br>User macros are supported.|  If you wish to monitor a Boolean counter that is either "true" or "false", then you specify type of information as "Numeric (unsigned)" and select "Boolean to decimal" preprocessing step in the Preprocessing tab. Server will store Boolean values as 1 or 0, respectively.
es	##### Agregar elemento de agente JMX  Para cada contador JMX que le interese, agregue el elemento **Agente JMX** adjunto a esa interfaz.\  La clave en la captura de pantalla a continuación dice `jmx["java.lang:type=Memoria","HeapMemoryUsage.used"]`.  ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_item.png){width="600"}  Todos los campos de entrada obligatorios están marcados con un asterisco rojo.  Los campos que requieren información específica para los elementos JMX son:  |   |   | |--|--------| |*Tipo*|Establezca **agente JMX** aquí.| |*Clave*|La clave del elemento `jmx[]` contiene tres parámetros:<br>**nombre de objeto**: el nombre de objeto de un MBean<br>**nombre de atributo**: un nombre de atributo de MBean con compuesto opcional nombres de campos de datos separados por puntos<br>**descripción breve única**: una descripción única que permite múltiples elementos JMX con el mismo nombre de objeto y nombre de atributo en el host (opcional)<br>Consulte a continuación para obtener más detalles sobre el elemento JMX claves.<br>Puede descubrir MBeans y atributos de MBean utilizando un elemento `jmx.discovery[]` [descubrimiento de bajo nivel](/manual/discovery/low_level_discovery/examples/jmx).| |*Punto final JMX*|Puede especificar un punto final JMX personalizado. Asegúrese de que los parámetros de conexión del punto final JMX coincidan con la interfaz JMX. Esto se puede lograr utilizando macros {HOST.\*} como se hace en el punto final JMX predeterminado.<br>{HOST.\*} [macros](/manual/appendix/macros/supported_by_location) y se admiten macros de usuario.| |*Nombre de usuario*|Especifique el nombre de usuario (hasta 255 caracteres), si ha configurado la autenticación en su aplicación Java.<br>Se admiten macros de usuario.| |*Contraseña*|Especifique la contraseña (hasta 255 caracteres), si ha configurado la autenticación en su aplicación Java.<br>Se admiten macros de usuario.|  Si desea monitorear un contador booleano que sea "verdadero" o "falso", luego especifica el tipo de información como "Numérica (sin firmar)" y seleccione el paso de preprocesamiento "Booleano a decimal" en Preprocesamiento pestaña. El servidor almacenará valores booleanos como 1 o 0, respectivamente.

en-us	#### Adding lines  In addition to shapes, it is also possible to add some lines. Lines can be used to link elements or shapes in a map.  To add a line, click on *Add* next to Shape. A new shape will appear at the top left corner of the map. Select it and click on *Line* in the editing form to change the shape into a line. Then adjust line properties, such as line type, width, color, etc.  ![map\_line.png](../../../../../assets/en/manual/config/visualization/map_line.png){width="600"}
es	#### Adición de líneas  Además de las formas, también es posible añadir algunas líneas. Las líneas pueden utilizarse para vincular elementos o formas en un mapa.  Para agregar una línea, haga clic en *Agregar* junto a Forma. Una nueva forma aparecerá en la esquina superior izquierda del mapa. Selecciónelo y haga clic en *Línea* en el forma de edición para cambiar la forma en una línea. Luego ajuste la línea propiedades, como tipo de línea, ancho, color, etc.  ![mapa\_linea.png](../../../../../assets/en/manual/config/visualization/map_line.png){width="600"}

en-us	#### Adding LLD macro paths  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "22450",         "lld_macro_paths": [             {                 "lld_macro": "{#MACRO1}",                 "path": "$.json.path"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "22450"         ]     },     "id": 1 } ```
es	#### Agregar rutas de macro LLD  [Solicitud](/manual/api#performing-requests):  ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "22450", "lld_macro_paths": [ { "lld_macro": "{#MACRO1}", "path": "$.json.path" } ] }, "id": 1 } ```  Response:  ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ```

en-us	#### Adding macros  Add two new macros to two hosts.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.massadd",     "params": {         "hosts": [             {                 "hostid": "10160"             },             {                 "hostid": "10167"             }         ],         "macros": [             {                 "macro": "{$TEST1}",                 "value": "MACROTEST1"             },             {                 "macro": "{$TEST2}",                 "value": "MACROTEST2",                 "description": "Test description"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10160",             "10167"         ]     },     "id": 1 } ```
es	#### Agregar macros  Agregue dos nuevas macros a dos equipos.  [Solicitud](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.massadd",     "params": {         "hosts": [             {                 "hostid": "10160"             },             {                 "hostid": "10167"             }         ],         "macros": [             {                 "macro": "{$TEST1}",                 "value": "MACROTEST1"             },             {                 "macro": "{$TEST2}",                 "value": "MACROTEST2",                 "description": "Test description"             }         ]     },     "id": 1 } ```  Respuesta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10160",             "10167"         ]     },     "id": 1 } ```

en-us	#### Adding pages  To add a new page to a dashboard:  -   Make sure the dashboard is in the [editing     mode](#editing_a_dashboard) -   Click on the arrow next to the *Add* button and select the *Add     page* option  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_add.png)  -   Fill the general page parameters and click on *Apply*. If you leave     the name empty, the page will be added with a `Page N` name where     'N' is the incremental number of the page. The page display period     allows to customize how long a page is displayed in a slideshow.  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_properties.png)  A new page will be added, indicated by a new tab (*Page 2*).  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_new.png)  The pages can be reordered by dragging-and-dropping the page tabs. Reordering maintains the original page naming. It is always possible to go to each page by clicking on its tab.  When a new page is added, it is empty. You can add widgets to it as described above.
es	#### Agregar páginas  Para agregar una nueva página a un tablero:  -   Asegúrese de que el tablero esté en el [modo edición](#editing_a_dashboard) -   Haga clic en la flecha al lado del botón *Agregar* y seleccione la opción de *Agregar     página*  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_add.png)  -   Complete los parámetros generales de la página y haga clic en *Aplicar*. Si deja     el nombre vacío, la página se agregará con un nombre de `Página N` donde     'N' es el número incremental de la página. El período de visualización de la página     permite personalizar cuánto tiempo se muestra una página en una presentación de diapositivas.  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_properties.png)  Se agregará una nueva página, indicada por una nueva pestaña (*Página 2*).  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_new.png)  Las páginas se pueden reordenar arrastrando y soltando las pestañas de las páginas. La reordenación mantiene el nombre de la página original. Siempre es posible acceder a cada página haciendo clic en su pestaña.  Cuando se agrega una nueva página, está vacía. Puede agregarle widgets como se describe arriba.

en-us	##### Adding permissions  By default, a new user has no permissions to access hosts and templates. To grant the user rights, click on the group of the user in the *Groups* column (in this case - 'Zabbix administrators'). In the group properties form, go to the *Host permissions* tab to assign permissions to host groups. Click on ![](../../../assets/en/manual/config/add_link.png){class="nozoom"} for the host group selection field to be displayed:  ![](../../../assets/en/manual/quickstart/group_permissions.png){width="600"}  Then click on *Select* next to the field to see the list of the host groups. This user is to have read-only access to *Linux servers* group, so mark the appropriate checkbox in the list and click on *Select* to confirm your choice.  ![](../../../assets/en/manual/quickstart/add_permissions.png){width="600"}  Click the *Read* button to set the permission level and then *Update* to save the changes made to the user group configuration.  To grant permissions to templates, you will need to switch to the *Template permissions* tab and specify template groups.   ::: noteimportant In Zabbix, access rights to hosts and templates are assigned to [user groups](/manual/config/users_and_usergroups/usergroup), not individual users. :::  Done! You may try to log in using the credentials of the new user.
es	##### Agregar permisos  De forma predeterminada, un nuevo usuario no tiene permisos para acceder a equipos ni plantillas. Para conceder los derechos de usuario, haga clic en el grupo del usuario en la columna *Grupos* (en este caso - 'administradores de Zabbix'). En el formulario de propiedades del grupo, vaya a la pestaña *Permisos de equipo* para asignar permisos a los grupos de equipos. Haga clic en ![](../../../assets/en/manual/config/add_link.png){class="nozoom"} para que se muestre el campo de selección del grupo de equipos:  ![](../../../assets/en/manual/quickstart/group_permissions.png){width="600"}  Luego haga clic en *Seleccionar* junto al campo para ver la lista de los grupos de equipos. Este usuario debe tener acceso de solo lectura al grupo *servidores Linux*,así que marque la casilla correspondiente en la lista y haga clic en *Seleccionar* para confirmar su elección.  ![](../../../assets/en/manual/quickstart/add_permissions.png){width="600"}  Haga clic en el botón *Leer* para establecer el nivel de permiso y luego en *Actualizar* para guardar los cambios realizados en la configuración del grupo de usuarios.  Para otorgar permisos a las plantillas, deberá cambiar a la pestaña *Permisos de plantilla* y especificar grupos de plantillas.   ::: noteimportant En Zabbix, los derechos de acceso a equipos y plantillas se asignan a los [grupos de usuarios](/manual/config/users_and_usergroups/usergroup), no a los usuarios individuales. :::  ¡Hecho! Puede intentar iniciar sesión con las credenciales del nuevo usuario.

en-us	##### Adding proxies  To configure a proxy in Zabbix frontend:  -   Go to: *Administration → Proxies* -   Click on *Create proxy*  ![](../../../assets/en/manual/distributed_monitoring/proxy.png){width="600"}  |Parameter|<|Description| |-|----------|----------------------------------------| |*Proxy name*|<|Enter the proxy name. It must be the same name as in the *Hostname* parameter in the proxy configuration file.| |*Proxy group*|<|Select the proxy group for proxy [load balancing/high availability](/manual/distributed_monitoring/proxies/ha).<br>Only one group can be selected.| |*Address for active agents*|<|Enter address the monitored active agents or senders must connect to. Supported **only** for Zabbix 7.0 agents or later.<br>This address is used to connect to both active and passive proxies. This field is only available if a proxy group is selected in the *Proxy group* field.| | |*Address*|IP address/DNS name to connect to.| |^|*Port*|TCP port number (10051 by default) to connect to. User macros are supported.| |*Proxy mode*|<|Select the proxy mode.<br>**Active** - the proxy will connect to the Zabbix server and request configuration data<br>**Passive** - Zabbix server connects to the proxy<br>*Note* that without encrypted communications (sensitive) proxy configuration data may become available to parties having access to the Zabbix server trapper port when using an active proxy. This is possible because anyone may pretend to be an active proxy and request configuration data if authentication does not take place or proxy addresses are not limited in the *Proxy address* field.| |*Proxy address*|<|If specified then active proxy requests are only accepted from this list of comma-delimited IP addresses, optionally in CIDR notation, or DNS names of active Zabbix proxy.<br>This field is only available if an active proxy is selected in the *Proxy mode* field. Macros are not supported.| |*Interface*|<|Enter interface details for a passive proxy.<br>This field is only available if a passive proxy is selected in the Proxy mode field.| | |*Address*|IP address/DNS name of the passive proxy.| |^|*Port*|TCP port number of the passive proxy (10051 by default). User macros are supported.| |*Description*|<|Enter the proxy description.|  The **Encryption** tab allows you to require encrypted connections with the proxy.  |Parameter|Description| |--|--------| |*Connections to proxy*|How the server connects to the passive proxy: no encryption (default), using PSK (pre-shared key) or certificate.| |*Connections from proxy*|Select what type of connections are allowed from the active proxy. Several connection types can be selected at the same time (useful for testing and switching to other connection type). Default is "No encryption".| |*Issuer*|Allowed issuer of certificate. Certificate is first validated with CA (certificate authority). If it is valid, signed by the CA, then the *Issuer* field can be used to further restrict allowed CA. This field is optional, intended to use if your Zabbix installation uses certificates from multiple CAs.| |*Subject*|Allowed subject of certificate. Certificate is first validated with CA. If it is valid, signed by the CA, then the *Subject* field can be used to allow only one value of *Subject* string. If this field is empty then any valid certificate signed by the configured CA is accepted.| |*PSK identity*|Pre-shared key identity string.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |*PSK*|Pre-shared key (hex-string). Maximum length: 512 hex-digits (256-byte PSK) if Zabbix uses GnuTLS or OpenSSL library, 64 hex-digits (32-byte PSK) if Zabbix uses mbed TLS (PolarSSL) library. Example: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952|  The **Timeouts** tab allows you to override [global](/manual/web_interface/frontend_sections/administration/general#timeouts) timeouts for item types that support it.  ![](../../../assets/en/manual/distributed_monitoring/proxy_timeout.png){width="600"}  |Parameter|Description| |--|--------| |*Timeouts for item types*|Select the timeout option:<br>**Global** - global timeout is used (displayed in the grayed out *Timeout* field for each item type);<br>**Override** - custom timeout is used (set in the *Timeout* field for each item type). Allowed range: 1 - 600s (default: inherited from [global](/manual/web_interface/frontend_sections/administration/general#timeouts) timeouts). [Time suffixes](/manual/appendix/suffixes#time-suffixes), e.g. 30s, 1m, and [user macros](/manual/config/macros/user_macros) are supported.<br><br>Clicking the *Global timeouts* link allows you to configure [global](/manual/web_interface/frontend_sections/administration/general#timeouts) timeouts. Note that the *Global timeouts* link is visible only to users of *Super admin* type with permissions to the *Administration* → [*General*](/manual/web_interface/frontend_sections/administration/general) frontend section.<br><br>Supported item types:<br>- [Zabbix agent](/manual/config/items/itemtypes/zabbix_agent) (both passive and active checks)<br>- [Simple check](/manual/config/items/itemtypes/simple_checks) (except `icmpping*`, `vmware.*` items)<br>- [SNMP agent](/manual/config/items/itemtypes/snmp) (only for SNMP `walk[OID]` and `get[OID]` items)<br>- [External check](/manual/config/items/itemtypes/external)<br>- [Database monitor](/manual/config/items/itemtypes/odbc_checks)<br>- [HTTP agent](/manual/config/items/itemtypes/http)<br>- [SSH agent](/manual/config/items/itemtypes/ssh_checks)<br>- [TELNET agent](/manual/config/items/itemtypes/telnet_checks)<br>- [Script](/manual/config/items/itemtypes/script)<br>- [Browser](/manual/config/items/itemtypes/browser)<br><br>Note that the timeouts set under **Override** will prevail over the global ones but will be overridden by individual item timeouts if those are set under [item configuration](/manual/config/items/item#configuration).|  ::: noteclassic If proxy major version does not match server major version, ![](../../../assets/en/manual/distributed_monitoring/info_yellow.png){class="nozoom"} icon will be displayed next to *Timeouts for item types*, with the hover message "Timeouts disabled because the proxy and server versions do not match". In such cases, the proxy will use the [`Timeout`](/manual/appendix/config/zabbix_proxy#timeout) parameter from the proxy configuration file. :::  The editing form of an existing proxy has the following additional buttons:  -    *Refresh configuration* - refresh configuration of the proxy -    *Clone* - create a new proxy based on the properties of the existing proxy -    *Delete* - delete the proxy
es	##### Agregar servidores proxy  Para configurar un proxy en la interfaz de Zabbix:  -   Ir a: *Administración → Proxies* -   Haga clic en *Crear proxy*  ![](../../../assets/en/manual/distributed_monitoring/proxy.png){width="600"}  |Parámetro|<|Descripción| |-|----------|------------------------------------ ----| |*Nombre del proxy*|<|Ingrese el nombre del proxy. Debe ser el mismo nombre que en el parámetro *Hostname* en el archivo de configuración del proxy.| |*Grupo de proxy*|<|Seleccione el grupo de proxy para el proxy [equilibrio de carga/alta disponibilidad](/manual/distributed_monitoring/proxies/ha).<br>Solo se puede seleccionar un grupo.| |*Dirección para agentes activos*|<|Ingrese la dirección a la que deben conectarse los agentes activos o remitentes monitoreados. Compatible **solo** con agentes Zabbix 7.0 o posterior.<br>Esta dirección se utiliza para conectarse a servidores proxy tanto activos como pasivos. Este campo solo está disponible si se selecciona un grupo de proxy en el campo *Grupo de proxy*.| | |*Dirección*|Dirección IP/nombre DNS al que conectarse.| |^|*Puerto*|Número de puerto TCP (10051 de forma predeterminada) al que conectarse. Se admiten macros de usuario.| |*Modo proxy*|<|Seleccione el modo proxy.<br>**Activo**: el proxy se conectará al servidor Zabbix y solicitará datos de configuración<br>**Pasivo**: el servidor Zabbix se conecta al proxy< br>*Tenga en cuenta* que sin comunicaciones cifradas (sensibles) los datos de configuración del proxy pueden estar disponibles para las partes que tienen acceso al puerto trampa del servidor Zabbix cuando usan un proxy activo. Esto es posible porque cualquiera puede pretender ser un proxy activo y solicitar datos de configuración si no se realiza la autenticación o las direcciones de proxy no están limitadas en el campo *Dirección de proxy*.| |*Dirección de proxy*|<|Si se especifica, las solicitudes de proxy activo solo se aceptan de esta lista de direcciones IP delimitadas por comas, opcionalmente en notación CIDR, o nombres DNS del proxy Zabbix activo.<br>Este campo solo está disponible si El proxy activo está seleccionado en el campo *Modo proxy*. No se admiten macros.| |*Interfaz*|<|Ingrese los detalles de la interfaz para un proxy pasivo.<br>Este campo solo está disponible si se selecciona un proxy pasivo en el campo Modo proxy.| | |*Dirección*|Dirección IP/nombre DNS del proxy pasivo.| |^|*Puerto*|Número de puerto TCP del proxy pasivo (10051 por defecto). Se admiten macros de usuario.| |*Descripción*|<|Ingrese la descripción del proxy.|  La pestaña **Cifrado** le permite solicitar conexiones cifradas con el proxy.  |Parámetro|Descripción| |--|--------| |*Conexiones al proxy*|Cómo se conecta el servidor al proxy pasivo: sin cifrado (predeterminado), usando PSK (clave precompartida) o certificado.| |*Conexiones desde proxy*|Seleccione qué tipo de conexiones se permiten desde el proxy activo. Se pueden seleccionar varios tipos de conexión al mismo tiempo (útil para probar y cambiar a otro tipo de conexión). El valor predeterminado es "Sin cifrado".| |*Emisor*|Emisor de certificado permitido. El certificado se valida primero con CA (autoridad certificadora). Si es válido y está firmado por la CA, entonces el campo *Issuer* se puede utilizar para restringir aún más la CA permitida. Este campo es opcional y está pensado para utilizarse si su instalación de Zabbix utiliza certificados de varias CA.| |*Asunto*|Asunto permitido del certificado. El certificado se valida primero con CA. Si es válido y está firmado por la CA, entonces el campo *Asunto* se puede utilizar para permitir solo un valor de la cadena *Asunto*. Si este campo está vacío, se acepta cualquier certificado válido firmado por la CA configurada.| |*Identidad PSK*|Cadena de identidad de clave previamente compartida.<br>No incluya información confidencial en la identidad PSK, se transmite sin cifrar a través de la red para informar al receptor qué PSK usar.| |*PSK*|Clave previamente compartida (cadena hexadecimal). Longitud máxima: 512 dígitos hexadecimales (PSK de 256 bytes) si Zabbix usa la biblioteca GnuTLS u OpenSSL, 64 dígitos hexadecimales (PSK de 32 bytes) si Zabbix usa la biblioteca mbed TLS (PolarSSL). Ejemplo: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952|  La pestaña **Tiempos de espera** le permite anular los tiempos de espera [global](/manual/web_interface/frontend_sections/administration/general#timeouts) para los tipos de métricas que lo admiten.  ![](../../../assets/en/manual/distributed_monitoring/proxy_timeout.png){width="600"}  |Parámetro|Descripción| |--|--------| |*Tiempos de espera para tipos de métricas*|Seleccione la opción de tiempo de espera:<br>**Global**: se utiliza el tiempo de espera global (se muestra en el campo atenuado *Tiempo de espera* para cada tipo de elemento);<br>**Anular** - se utiliza un tiempo de espera personalizado (establecido en el campo *Tiempo de espera* para cada tipo de elemento). Rango permitido: 1 - 600 s (predeterminado: heredado de los tiempos de espera [global](/manual/web_interface/frontend_sections/administration/general#timeouts)). [Sufijos de tiempo](/manual/appendix/suffixes#time-suffixes), p.e. Se admiten 30 segundos, 1 m y [macros de usuario](/manual/config/macros/user_macros).<br><br>Hacer clic en el enlace *Tiempos de espera globales* le permite configurar [global](/manual/web_interface/frontend_sections/ administración/general#timeouts) tiempos de espera. Tenga en cuenta que el enlace *Tiempos de espera globales* es visible solo para usuarios de tipo *Super administrador* con permisos para la sección de interfaz *Administración* → [*General*](/manual/web_interface/frontend_sections/administration/general).<br> <br>Tipos de elementos admitidos:<br>- [Agente Zabbix](/manual/config/items/itemtypes/zabbix_agent) (verificaciones tanto pasivas como activas)<br>- [Verificación simple](/manual/config/items/ itemtypes/simple_checks) (excepto elementos `icmpping*`, `vmware.*`)<br>- [Agente SNMP](/manual/config/items/itemtypes/snmp) (solo para SNMP `walk[OID]` y ` get[OID]` items)<br>- [Comprobación externa](/manual/config/items/itemtypes/external)<br>- [Monitor de base de datos](/manual/config/items/itemtypes/odbc_checks)<br> - [Agente HTTP](/manual/config/items/itemtypes/http)<br>- [Agente SSH](/manual/config/items/itemtypes/ssh_checks)<br>- [Agente TELNET](/manual/config /items/itemtypes/telnet_checks)<br>- [Script](/manual/config/items/itemtypes/script)<br>- [Navegador](/manual/config/items/itemtypes/browser)<br><br >Tenga en cuenta que los tiempos de espera establecidos en **Anular** prevalecerán sobre los globales, pero serán anulados por los tiempos de espera de elementos individuales si se configuran en [configuración de elementos](/manual/config/items/item#configuration).|  ::: noteclassic Si la versión principal del proxy no coincide con la versión principal del servidor, ![](../../../assets/en/manual/distributed_monitoring/info_amarillo.png)Se mostrará el icono {class="nozoom"} junto a *Tiempos de espera para tipos de métricas*, con el mensaje flotante "Tiempos de espera deshabilitados porque las versiones del proxy y del servidor no coinciden". En tales casos, el proxy utilizará el parámetro [`Timeout`](/manual/appendix/config/zabbix_proxy#timeout) del archivo de configuración del proxy. :::  El formulario de edición de un proxy existente tiene los siguientes botones adicionales:  -   *Actualizar configuración* - actualizar la configuración del proxy -   *Clonar*: crea un nuevo proxy basado en las propiedades del proxy existente -   *Eliminar* - eliminar el proxy

en-us	#### Adding shapes  In addition to map elements, it is also possible to add some shapes. Shapes are not map elements; they are just a visual representation. For example, a rectangle shape can be used as a background to group some hosts. Rectangle and ellipse shapes can be added.  To add a shape, click on *Add* next to Shape. The new shape will appear at the top left corner of the map. Drag and drop it wherever you like.  A new shape is added with default colors. By clicking on the shape, a form is displayed and you can customize the way a shape looks, add text, etc.  ![](../../../../../assets/en/manual/config/visualization/map_shape.png){width="600"}  To select shapes, select one and then hold down *Ctrl* to select the others. With several shapes selected, common properties can be mass updated, similarly as with elements.  Text can be added in the shapes. Expression [macros](/manual/appendix/macros/supported_by_location) are supported in the text, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`).  To display text only, the shape can be made invisible by removing the shape border (select 'None' in the *Border* field). For example, take note of how the {MAP.NAME} macro, visible in the screenshot above, is actually a rectangle shape with text, which can be seen when clicking on the macro:  ![](../../../../../assets/en/manual/config/visualization/map_name_macro.png)  {MAP.NAME} resolves to the configured map name when viewing the map.  If hyperlinks are used in the text, they become clickable when viewing the map.  Line wrapping for text is always "on" within shapes. However, within an ellipse, the lines are wrapped as though the ellipse were a rectangle. Word wrapping is not implemented, so long words (words that do not fit the shape) are not wrapped, but are masked (on map editing page) or clipped (other pages with maps).
es	#### Agregar formas  Además de los elementos del mapa, también es posible agregar algunas formas. Las formas no son elementos del mapa; son sólo una representación visual. Por ejemplo, se puede utilizar una forma de rectángulo como fondo para agrupar algunos equipos. Se pueden agregar formas de rectángulo y elipse.  Para agregar una forma, haga clic en *Agregar* junto a Forma. La nueva forma aparecerá en la esquina superior izquierda del mapa. Arrástrala y suéltala donde quiera.  Se agrega una nueva forma con colores predeterminados. Al hacer clic en la forma, se muestra el formulario y puede personalizar la apariencia de una forma, agregar texto, etc.  ![](../../../../../assets/en/manual/config/visualization/map_shape.png){width="600"}  Para seleccionar formas, seleccione una y luego mantenga presionado *Ctrl* para seleccionar las otras. Con varias formas seleccionadas, las propiedades comunes pueden ser actualizadas a la vez, al igual que con los elementos.  Se puede agregar texto en las formas. Las expresiones de [macros](/manual/appendix/macros/supported_by_location) son compatibles con el texto, pero sólo con las funciones `avg`, `last`, `min` y `max`, con tiempo como parámetro (por ejemplo, `{?avg(/host/key,1h)}`).  Para mostrar solo texto, la forma se puede hacer invisible quitando el borde de forma (seleccione 'Ninguno' en el campo *Borde*). Por ejemplo, tome nota de cómo se muestra la macro {MAP.NAME}, visible en la captura de pantalla anterior. en realidad una forma de rectángulo con texto, que se puede ver al hacer clic en la macro:  ![](../../../../../assets/en/manual/config/visualization/map_name_macro.png)  {MAP.NAME} resuelve el nombre del mapa configurado al visualizar el mapa.  Si se utilizan hipervínculos en el texto, se puede hacer clic en ellos al verlos el mapa.  El ajuste de línea para el texto siempre está "activado" dentro de las formas. Sin embargo, dentro de una elipse, las líneas se ajustan como si la elipse fuera un rectángulo. No se implementa el ajuste de palabras, por lo que las palabras largas (palabras que no encajan en la forma) no están ajustadas, sino enmascaradas (en la página de edición del mapa) o recortadas (otras páginas con mapas).

en-us	#### Adding templates to template groups  Add two templates to template groups with IDs 12 and 13.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.massadd",     "params": {         "groups": [             {                 "groupid": "12"             },             {                 "groupid": "13"             }         ],         "templates": [             {                 "templateid": "10486"             },             {                 "templateid": "10487"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "12",             "13"         ]     },     "id": 1 } ```
es	#### Agregar plantillas a grupos de plantillas  Agregue dos plantillas a los grupos de plantillas con los ID 12 y 13.  [Solicitud](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.massadd",     "params": {         "groups": [             {                 "groupid": "12"             },             {                 "groupid": "13"             }         ],         "templates": [             {                 "templateid": "10486"             },             {                 "templateid": "10487"             }         ]     },     "id": 1 } ```  Respuesta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "12",             "13"         ]     },     "id": 1 } ```

en-us	#### Adding template  To start working with templates, we must first create one. To do that, in *Data collection* → *Templates* click on *Create template*. This will present us with a template configuration form.  ![](../../../assets/en/manual/quickstart/new_template.png){width="600"}  All mandatory input fields are marked with a red asterisk.  The required parameters to enter here are:  ***Template name***  -   Enter a template name. Alpha-numericals, spaces and underscores are     allowed.  ***Template groups***  -   Select one or several groups by clicking *Select* button. The     template must belong to a group.  ::: noteclassic Access permissions to template groups are assigned in the [user group](/manual/quickstart/login#adding-permissions) configuration on the **Template permissions** tab in the same way as host permissions. All access permissions are assigned to groups, not individual templates, that's why including the template into at least one group is mandatory.  :::   When done, click *Add*. Your new template should be visible in the list of templates. You can also use the [filter](/manual/web_interface/frontend_sections/data_collection/templates#using-filter) to find your template.  ![](../../../assets/en/manual/quickstart/template_list.png){width="600"}  As you may see, the template is there, but it holds nothing in it - no items, triggers or other entities.
es	#### Agregar plantilla  Para empezar a trabajar con plantillas, primero debemos crear una. Para hacer eso, en *Recopilación de datos* → *Plantillas* haga clic en *Crear plantilla*. Esto nos presentará un formulario de configuración de plantilla.  ![](../../../assets/en/manual/quickstart/new_template.png){width="600"}  Todos los campos de entrada obligatorios están marcados con un asterisco rojo.  Los parámetros requeridos para ingresar aquí son:  ***Nombre de la plantilla***  - Introduzca un nombre de plantilla. Los caracteres alfanuméricos, los espacios y los guiones bajos están     permitidos.  ***Grupos de plantillas***  - Seleccione uno o varios grupos haciendo clic en el botón *Seleccionar*.     La plantilla debe pertenecer a un grupo.  ::: noteclassic Los permisos de acceso a los grupos de plantillas se asignan en la configuración del [grupo de usuarios](/manual/quickstart/login#adding-permissions) en la pestaña **Permisos de plantilla** de la misma manera que los permisos de equipo. Todos los permisos de acceso se asignan a grupos, no a plantillas individuales, por eso es obligatorio incluir la plantilla en al menos un grupo. :::   Cuando termine, haga clic en *Agregar*. Su nueva plantilla debería estar visible en la lista de plantillas. También puede utilizar el [filtro](/manual/web_interface/frontend_sections/data_collection/templates#using-filter) para encontrar su plantilla.  ![](../../../assets/en/manual/quickstart/template_list.png){width="600"}  Como puede ver, la plantilla está ahí, pero no contiene nada, no tiene métricas, iniciadores ni otras entidades.

en-us	#### Adding trigger  To configure a trigger for our item, go to *Data collection → Hosts*, find 'New host' and click on *Triggers* next to it and then on *Create trigger*. This presents us with a trigger definition form.\ ![](../../../assets/en/manual/quickstart/new_trigger.png){width="600"}  For our trigger, the essential information to enter here is:  *Name*  -   Enter *CPU load too high on 'New host' for 3 minutes* as the value.     This will be the trigger name displayed in lists and elsewhere.  *Expression*  -   Enter: avg(/New host/system.cpu.load,3m)>2  This is the trigger expression. Make sure that the expression is entered right, down to the last symbol. The item key here (system.cpu.load) is used to refer to the item. This particular expression basically says that the problem threshold is exceeded when the CPU load average value for 3 minutes is over 2. You can learn more about the [syntax of trigger expressions](/manual/config/triggers/expression).  When done, click *Add*. The new trigger should appear in the trigger list.
es	#### Añadiendo un iniciador  Para configurar un iniciador para nuestra métrica, vaya a *Recopilación de datos → Equipos*, y busque 'Nuevo equipo' y haga clic en *Iniciadores* que está al lado y luego en *Crear iniciador*. Esto nos presenta un formulario de definición de iniciador.\ ![](../../../assets/en/manual/quickstart/new_trigger.png){width="600"}  Para nuestro iniciador, la información esencial para introducir aquí es:  *Nombre*  -   Ingrese *Carga de CPU demasiado alta en 'Nuevo equipo' durante 3 minutos* como valor.     Este será el nombre del iniciador que se mostrará en las listas y en otros lugares.  *Expresión*  -   Introduza: avg(/Nuevo host/system.cpu.load,3m)>2  Esta es la expresión del iniciador. Asegúrese de que se haya ingresado la expresión. correcta, hasta el último símbolo. La clave de la métrica (system.cpu.load) es utilizada para referirse a la métrica. Esta expresión en particular básicamente dice que el umbral del problema se excede cuando el valor promedio de carga de la CPU durante 3 minutos son más de 2. Puede obtener más información sobre la [sintaxis de las expresiones del iniciador](/manual/config/triggers/expression).  Cuando termine, haga clic en *Agregar*. El nuevo iniciador debería aparecer en la lista de iniciadores.

en-us	#### Adding user  To view information about users, go to *Users → Users*.  ![](../../../assets/en/manual/quickstart/userlist.png){width="600"}  To add a new user, click on *Create user*.  In the new user form, make sure to add your user to one of the existing [user groups](/manual/config/users_and_usergroups/usergroup), for example 'Zabbix administrators'.  ![](../../../assets/en/manual/quickstart/new_user.png)  All mandatory input fields are marked with a red asterisk.  By default, new users have no media (notification delivery methods) defined for them. To create one, go to the 'Media' tab and click on *Add*.  ![](../../../assets/en/manual/quickstart/new_media.png)  In this pop-up, enter an email address for the user.  You can specify a time period when the medium will be active (see [Time period specification](/manual/appendix/time_period) page for a description of the format), by default a medium is always active. You can also customize [trigger severity](/manual/config/triggers/severity) levels for which the medium will be active, but leave all of them enabled for now.  Click on *Add* to save the medium, then go to the Permissions tab.  Permissions tab has a mandatory field *Role*. The role determines which frontend elements the user can view and which actions he is allowed to perform. Press Select and select one of the roles from the list. For example, select *Admin role* to allow access to all Zabbix frontend sections, except Administration. Later on, you can modify permissions or create more user roles. Upon selecting a role, permissions will appear in the same tab:  ![user\_permissions.png](../../../assets/en/manual/config/user_permissions.png){width="600"}   Click *Add* in the user properties form to save the user. The new user appears in the userlist.  ![](../../../assets/en/manual/quickstart/userlist2.png){width="600"}
es	#### Agregar usuario  Para ver información sobre los usuarios, vaya a *Usuarios → Usuarios*.  ![](../../../assets/en/manual/quickstart/userlist.png){width="600"}  Para agregar un nuevo usuario, haga clic en *Crear usuario*.  En el formulario de nuevo usuario, asegúrese de agregar su usuario a uno de los  [grupos de usuarios](/manual/config/users_and_usergroups/usergroup) existentes, por ejemplo 'Administradores de Zabbix'.  ![](../../../assets/en/manual/quickstart/new_user.png)  Todos los campos de entrada obligatorios están marcados con un asterisco rojo.  De forma predeterminada, los nuevos usuarios no tienen medios (métodos de entrega de notificaciones) definidos para ellos. Para crear uno, vaya a la pestaña 'Medios' y haga clic en *Agregar*.  ![](../../../assets/en/manual/quickstart/new_media.png)  En esta ventana emergente, ingrese una dirección de correo electrónico para el usuario.  Puede especificar un período de tiempo en el que el medio estará activo (consulte la página [especificación del período de tiempo](/manual/appendix/time_period)  para una descripción del formato), por defecto un medio siempre está activo. También puede personalizar los niveles de [gravedad del iniciador](/manual/config/triggers/severity)  para los cuales el medio estará activo, pero déjelos todos habilitados por ahora.  Haga clic en *Agregar* para guardar el medio, luego vaya a la pestaña Permisos.  La pestaña Permisos tiene un campo obligatorio *Rol*. El rol determina los elementos de la interfaz que el usuario puede ver y qué acciones puede  llevar a cabo. Presione Seleccionar y seleccione uno de los roles de la lista. Por ejemplo, seleccione *Rol de administrador* para permitir el acceso a todas las secciones de la interfaz de Zabbix, excepto Administración. Más adelante podrá modificar los permisos o crear más roles de usuario. Al seleccionar un rol, aparecerán los permisos. en la misma pestaña:  ![user\_permissions.png](../../../assets/en/manual/config/user_permissions.png){width="600"}   Haga clic en *Agregar* en el formulario de propiedades del usuario para guardar al usuario. El nuevo usuario aparece en la lista de usuarios.  ![](../../../assets/en/manual/quickstart/userlist2.png){width="600"}

en-us	#### Adding web scenarios  To add web scenarios to a template in *Data collection* → *Templates*, do the following:  1. Click on *Web* in the row of the template. 2. Configure a web scenario following the usual method of [configuring web scenarios](/manual/web_monitoring#configuring_a_web_scenario).
es	#### Agregar escenarios web  Para agregar escenarios web a una plantilla en *Recopilación de datos* → *Plantillas*, haga la siguiente:  1. Haga clic en *Web* en la fila de la plantilla. 2. Configure un escenario web siguiendo el método habitual de [configurar escenarios web](/manual/web_monitoring#configuring_a_web_scenario).

en-us	#### Adding widgets  To add a widget to a dashboard:  -   Click on the     ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_add_button.png)     button or the *Add widget* option in the action menu that can be     opened by clicking on the arrow. Fill the widget configuration form.     The widget will be created in its default size and placed after the     existing widgets (if any);  Or  -   Move your mouse to the desired empty spot for the new widget. Notice     how a placeholder appears, on mouseover, on any empty slot on the     dashboard. Then click to open the widget configuration form. After     filling the form the widget will be created in its default size or,     if its default size is bigger than is available, take up the     available space. Alternatively, you may click and drag the     placeholder to the desired widget size, then release, and then fill     the widget configuration form. (Note that when there is a widget     copied onto the clipboard, you will be first prompted to select     between *Add widget* and *Paste widget* options to create a widget.)  ![](../../../../assets/en/manual/web_interface/dashboard_click.png)  ![](../../../../assets/en/manual/web_interface/dashboard_select.png)  In the widget configuration form:  -   Select the *Type* of widget -   Enter widget parameters -   Click on *Add*  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widget_add.png)  #### Widgets  A wide variety of [widgets](/manual/web_interface/frontend_sections/dashboards/widgets) (e.g. [Clock](/manual/web_interface/frontend_sections/dashboards/widgets/clock), [Host availability](/manual/web_interface/frontend_sections/dashboards/widgets/host_availability) or [Trigger overview](/manual/web_interface/frontend_sections/dashboards/widgets/trigger_overview)) can be added to a dashboard: these can be resized and moved around the dashboard in dashboard editing mode by clicking on the widget title bar and dragging it to a new location. Also, you can click on the following buttons in the top-right corner of the widget to:  -   ![](../../../../assets/en/manual/web_interface/widget_edit.png) -     edit a widget; -   ![](../../../../assets/en/manual/web_interface/button_widget_menu.png) -     access the [widget menu](#widget_menu)  Click on *Save changes* for the dashboard to make any changes to the widgets permanent.
es	#### Agregar widgets  Para agregar un widget a un tablero:  -   Haga clic en      ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_add_button.png)     o la opción *Agregar widget* en el menú de acciones que      se abre haciendo clic en la flecha. Complete el formulario de configuración del widget.     El widget se creará en su tamaño predeterminado y se colocará después de los     widgets existentes (si los hay);  O  -   Mueva el mouse al lugar vacío deseado para el nuevo widget. Observe     cómo aparece un marcador de posición, al pasar el mouse, en cualquier espacio vacío en el     tablero. Luego haga clic para abrir el formulario de configuración del widget. Después     de completar el formulario, el widget se creará en su tamaño predeterminado o,     si su tamaño predeterminado es mayor que el disponible, toma el     espacio disponible. Alternativamente, puede hacer clic y arrastrar el     marcador de posición al tamaño deseado de widget, luego suéltelo y luego complete     el formulario de configuración del widget. (Tenga en cuenta que cuando hay un widget     copiado en el portapapeles, primero se le pedirá que seleccione     entre las opciones *Agregar widget* y *Pegar widget* para crear un widget).  ![](../../../../assets/en/manual/web_interface/dashboard_click.png)  ![](../../../../assets/en/manual/web_interface/dashboard_select.png)  En el formulario de configuración del widget:  -   Seleccione el *Tipo* de widget -   Ingrese los parámetros del widget -   Haga clic en *Agregar*  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widget_add.png)  #### Widgets  Una amplia variedad de [widgets](/manual/web_interface/frontend_sections/dashboards/widgets) (por ejemplo, [Reloj](/manual/web_interface/frontend_sections/dashboards/widgets/clock), [Disponibilidad del equipo](/manual/web_interface/frontend_sections /dashboards/widgets/host_availability) o [Descripción general del iniciador](/manual/web_interface/frontend_sections/dashboards/widgets/trigger_overview)) se pueden agregar a un tablero: se pueden cambiar de tamaño y mover por el tablero en el modo de edición del tablero haciendo clic en la barra de título del widget y arrastrándolo a una nueva ubicación. Además, puede hacer clic en los siguientes botones en la esquina superior derecha del widget para:  - ![](../../../../assets/en/manual/web_interface/widget_edit.png) -     editar un widget; - ![](../../../../assets/en/manual/web_interface/button_widget_menu.png) -     acceder al [menú de widgets](#widget_menu)  Haga clic en *Guardar cambios* para hacer permanentes los cambios en los widgets del tablero.

en-us	### Adding Zabbix repository  Install the repository configuration package. This package contains yum (software package manager) configuration files.  SLES 15:      rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/7.0/sles/15/x86_64/zabbix-release-7.0-1.sles15.noarch.rpm     zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository'   SLES 12 (proxy only):      rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/7.0/sles/12/x86_64/zabbix-release-7.0-1.sles12.noarch.rpm     zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository'   Please note that Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually.
es	### Agregar repositorio Zabbix  Instale el paquete de configuración del repositorio. Este paquete contiene los archivos de configuración de yum (administrador de paquetes de software) .  SLES 15:      rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/7.0/sles/15/x86_64/zabbix-release-7.0-1.sles15.noarch.rpm     zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository'   SLES 12 (solo proxy):      rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/7.0/sles/12/x86_64/zabbix-release-7.0-1.sles12.noarch.rpm     zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository'   Tenga en cuenta que el proceso del servicio web Zabbix, que se utiliza para la [generación de informes programados](/manual/web_interface/frontend_sections/reports/scheduled), requiere el navegador Google Chrome. El navegador no está incluido en los paquetes y debe instalarse manualmente.

en-us	#### Additional parameters  **bucket\_rate\_foreach**  A third optional parameter is supported by the *bucket\_rate\_foreach* function:      bucket_rate_foreach(item filter,time period,<parameter number>)  where <parameter number> is the position of the "bucket" value in the item key. For example, if the "bucket" value in myItem\[aaa,0.2\] is '0.2', then its position is 2.  The default value of <parameter number> is '1'.  **count\_foreach**  Third and fourth optional parameters are supported by the *count\_foreach* function:      count_foreach(item filter,time period,<operator>,<pattern>)  Where:  -   **operator** is the conditional operator for item values (must be double-quoted). Supported `operators`:<br>*eq* - equal<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br> -   **pattern** is the required pattern (string arguments must be double-quoted); supported if *operator* is specified in the third parameter.  Comments:  -   Optional parameters *operator* or *pattern* can't be left empty after a comma, only fully omitted. -   With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number_to_compare_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number_to_compare_with*. If the result of "bitwise AND" is equal to *number_to_compare_with*, the value is counted.<br>If *number_to_compare_with* and *mask* are equal, only the *mask* need be specified (without '/'). -   With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.  See [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate) for more details and examples on using foreach functions.
es	#### Parámetros adicionales  **bucket\_rate\_foreach**  Un tercer parámetro opcional es compatible con la función *bucket\_rate\_foreach*:      bucket_rate_foreach(filtro de métricas,período de tiempo,<número de parámetro>)  donde <número de parámetro> es la posición del valor del "depósito" en la clave de la métrica. Por ejemplo, si el valor del "depósito" en myItem\[aaa,0.2\] es '0.2', entonces su posición es 2.  El valor predeterminado de <número de parámetro> es '1'.  **count\_foreach**  El tercer y cuarto parámetro opcional son compatibles con la función *count\_foreach*:      count_foreach(filtro de métricas,período de tiempo,<operador>,<patrón>)  Dónde:  - **operador** es el operador condicional para los valores de las métricas (debe estar entre comillas dobles). `Operadores` admitidos:<br>*eq* - igual<br>*ne* - no igual<br>*gt* - mayor<br>*ge* - mayor o igual<br>*lt* - menos<br >*le* - menor o igual<br>*like* - coincide si contiene patrón (distingue entre mayúsculas y minúsculas)<br>*bitand* - AND bit a bit<br>*regexp* - coincide entre mayúsculas y minúsculas de la expresión regular dada en `pattern`<br>*iregexp* - coincidencia que no distingue entre mayúsculas y minúsculas de la expresión regular dada en `pattern`<br> - **patrón** es el patrón requerido (los argumentos de cadena deben estar entre comillas dobles); compatible si se especifica *operador* en el tercer parámetro.  Comentarios:  - Los parámetros opcionales *operador* o *patrón* no se pueden dejar vacíos después de una coma, solo se pueden omitir por completo. - Con *bitand* como tercer parámetro, el cuarto parámetro `patrón` se puede especificar como dos números, separados por '/': **número_para_comparar_con/máscara**. count() calcula "Y bit a bit" a partir del valor y la *máscara* y compara el resultado con *número_a_comparar_con*. Si el resultado de "Y bit a bit" es igual a *number_to_compare_with*, el valor se cuenta.<br>Si *number_to_compare_with* y *mask* son iguales, solo es necesario especificar la *mask* (sin '/'). - Con *regexp* o *iregexp* como tercer parámetro, el cuarto parámetro `pattern` puede ser una expresión regular ordinaria o [global](/manual/regular_expressions#global_regular_expressions) (comenzando con '@'). En el caso de expresiones regulares globales, la distinción entre mayúsculas y minúsculas se hereda de la configuración de expresiones regulares globales. A los efectos de la coincidencia de expresiones regulares, los valores flotantes siempre se representarán con 4 dígitos decimales después de '.'. También tenga en cuenta que, para números grandes, la diferencia en la representación decimal (almacenada en la base de datos) y binaria (utilizada por el servidor Zabbix) puede afectar el cuarto dígito decimal.  Consulte [cálculos agregados](/manual/config/items/itemtypes/calculated/aggregate) para obtener más detalles y ejemplos sobre el uso de funciones foreach.

en-us	### Add JavaScript to the widget  In this section, you will learn how to add a gauge chart - made using JavaScript - that shows if the latest value is normal or too high/too low.  1. Create a *widget.edit.js.php* file in the *views* directory.  JavaScript will be responsible for initializing the color picker in the configuration view.  **ui/modules/lesson_gauge_chart/views/widget.edit.js.php**  ```php <?php  use Modules\LessonGaugeChart\Widget;  ?>  window.widget_lesson_gauge_chart_form = new class {      init({color_palette}) {         this._unit_select = document.getElementById('value_units');         this._unit_value = document.getElementById('value_static_units');          this._unit_select.addEventListener('change', () => this.updateForm());          colorPalette.setThemeColors(color_palette);          for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) {             jQuery(colorpicker).colorpicker();         }          const overlay = overlays_stack.getById('widget_properties');          for (const event of ['overlay.reload', 'overlay.close']) {             overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); });         }          this.updateForm();     }      updateForm() {         this._unit_value.disabled = this._unit_select.value == <?= Widget::UNIT_AUTO ?>;     } }; ```  2. Open *views/widget.edit.php* and add the *widget.edit.js.php* file with the JavaScript to the configuration view. To do this, use the *includeJsFile()* method. To add inline JavaScript, use the *addJavaScript()* method.  **ui/modules/lesson_gauge_chart/views/widget.edit.php**  ```php <?php  /**  * Gauge chart widget form view.  *  * @var CView $this  * @var array $data  */  use Modules\LessonGaugeChart\Includes\WidgetForm;  $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units']))     ->setPlaceholder(_('value'))     ->setWidth(ZBX_TEXTAREA_TINY_WIDTH);  (new CWidgetFormView($data))     ->addField(         (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))             ->setPopupParameter('numeric', true)     )     ->addFieldset(         (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration')))             ->addField(                 new CWidgetFieldColorView($data['fields']['chart_color'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_min'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_max'])             )             ->addItem([                 $lefty_units->getLabel(),                 (new CFormField([                     $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN),                     $lefty_static_units->getView()                 ]))             ])             ->addField(                 new CWidgetFieldTextBoxView($data['fields']['description'])             )     )     ->includeJsFile('widget.edit.js.php')     ->addJavaScript('widget_lesson_gauge_chart_form.init('.json_encode([         'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE     ], JSON_THROW_ON_ERROR).');')     ->show(); ```  3. Return to the dashboard, click on the gear icon in the widget to open the widget configuration form. Now, expand the *Advanced configuration* section to see the initialized color picker. Fill in the fields with values and select a color for the gauge chart.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_advanced_b.png){width="600"}  4. Click on *Apply* in the widget configuration form. Then click on *Save changes* in the top right corner to save the dashboard.  5. Open *actions/WidgetView.php* and update the controller.  The **$this->fields_values** property now contains the values of all the *Advanced configuration* fields. Finalize the controller to enable passing the configuration and selected item value to the widget view.  **ui/modules/lesson_gauge_chart/actions/WidgetView.php**  ```php <?php  namespace Modules\LessonGaugeChart\Actions;  use API,     CControllerDashboardWidgetView,     CControllerResponseData;  class WidgetView extends CControllerDashboardWidgetView {      protected function doAction(): void {         $db_items = API::Item()->get([             'output' => ['itemid', 'value_type', 'name', 'units'],             'itemids' => $this->fields_values['itemid'],             'webitems' => true,             'filter' => [                 'value_type' => [ITEM_VALUE_TYPE_UINT64, ITEM_VALUE_TYPE_FLOAT]             ]         ]);          $history_value = null;          if ($db_items) {             $item = $db_items[0];              $history = API::History()->get([                 'output' => API_OUTPUT_EXTEND,                 'itemids' => $item['itemid'],                 'history' => $item['value_type'],                 'sortfield' => 'clock',                 'sortorder' => ZBX_SORT_DOWN,                 'limit' => 1             ]);              if ($history) {                 $history_value = convertUnitsRaw([                     'value' => $history[0]['value'],                     'units' => $item['units']                 ]);             }         }          $this->setResponse(new CControllerResponseData([             'name' => $this->getInput('name', $this->widget->getName()),             'history' => $history_value,             'fields_values' => $this->fields_values,             'user' => [                 'debug_mode' => $this->getDebugMode()             ]         ]));     } } ```  6. Open and modify *views/widget.view.php*.  You need to create a container for the gauge chart, which you will draw in the next steps, and a container for the description.  To pass values to JavaScript as a JSON object, use the *setVar()* method.  **ui/modules/lesson_gauge_chart/views/widget.view.php**  ```php <?php  /**  * Gauge chart widget view.  *  * @var CView $this  * @var array $data  */  (new CWidgetView($data))     ->addItem([         (new CDiv())->addClass('chart'),         $data['fields_values']['description']             ? (new CDiv($data['fields_values']['description']))->addClass('description')             : null     ])     ->setVar('history', $data['history'])     ->setVar('fields_values', $data['fields_values'])     ->show(); ```  7. Create a new directory *assets* in the *lesson_gauge_chart* directory. This directory will be used for storing JavaScript, CSS, and potentially any other assets, such as fonts or images.  8. For widget view JavaScript, create a directory *js* in the *assets* directory.  9. Create a *class.widget.js* file in the *assets/js* directory.  This JavaScript widget class will extend the base JavaScript class of all dashboard widgets - *CWidget*.  The dashboard relies on a correct implementation of a widget and communicates any relevant information to the widget through calling the respective JavaScript methods. The dashboard also expects the widget to generate events when some interaction occurs. Thus, the *CWidget* class contains a set of methods with the default implementation of widget behavior, which can be customized by extending the class.  In this case, some customization is necessary, therefore custom logic will be implemented for the following widget behavior:  -   widget initialization that is responsible for defining the initial state of the widget (see the *onInitialize()* method); -   displaying widget contents (that is, drawing the gauge chart) if the widget update process has been successful and without errors (see the *processUpdateResponse(response)* method and the related *\_resizeChart()* and *\_updatedChart()* methods) -   resizing the widget (see the *onResize()* method and the related *\_resizeChart()* method)  For other aspects of the gauge chart widget, the default implementation for widget behavior will be used. To learn more about the JavaScript methods of the *CWidget* class, see: [JavaScript](/devel/modules/widgets/presentation/javascript).  Since this JavaScript is required for the widget view, it should be loaded with the dashboard page. To enable JavaScript loading, you will need to update the *assets/js* and *js_class* parameters in the ***manifest.json*** file as shown in step 10.  **ui/modules/lesson_gauge_chart/assets/js/class.widget.js**  ```js class WidgetLessonGaugeChart extends CWidget {      static UNIT_AUTO = 0;     static UNIT_STATIC = 1;      onInitialize() {         super.onInitialize();          this._refresh_frame = null;         this._chart_container = null;         this._canvas = null;         this._chart_color = null;         this._min = null;         this._max = null;         this._value = null;         this._last_value = null;         this._units = '';     }      processUpdateResponse(response) {         if (response.history === null) {             this._value = null;             this._units = '';         }         else {             this._value = Number(response.history.value);             this._units = response.fields_values.value_units == WidgetLessonGaugeChart.UNIT_AUTO                 ? response.history.units                 : response.fields_values.value_static_units;         }          this._chart_color = response.fields_values.chart_color;         this._min = Number(response.fields_values.value_min);         this._max = Number(response.fields_values.value_max);          super.processUpdateResponse(response);     }      setContents(response) {         if (this._canvas === null) {             super.setContents(response);              this._chart_container = this._body.querySelector('.chart');             this._chart_container.style.height =                 `${this._getContentsSize().height - this._body.querySelector('.description').clientHeight}px`;             this._canvas = document.createElement('canvas');              this._chart_container.appendChild(this._canvas);              this._resizeChart();         }          this._updatedChart();     }      onResize() {         super.onResize();          if (this._state === WIDGET_STATE_ACTIVE) {             this._resizeChart();         }     }      _resizeChart() {         const ctx = this._canvas.getContext('2d');         const dpr = window.devicePixelRatio;          this._canvas.style.display = 'none';         const size = Math.min(this._chart_container.offsetWidth, this._chart_container.offsetHeight);         this._canvas.style.display = '';          this._canvas.width = size * dpr;         this._canvas.height = size * dpr;          ctx.scale(dpr, dpr);          this._canvas.style.width = `${size}px`;         this._canvas.style.height = `${size}px`;          this._refresh_frame = null;          this._updatedChart();     }      _updatedChart() {         if (this._last_value === null) {             this._last_value = this._min;         }          const start_time = Date.now();         const end_time = start_time + 400;          const animate = () => {             const time = Date.now();              if (time <= end_time) {                 const progress = (time - start_time) / (end_time - start_time);                 const smooth_progress = 0.5 + Math.sin(Math.PI * (progress - 0.5)) / 2;                 let value = this._value !== null ? this._value : this._min;                 value = (this._last_value + (value - this._last_value) * smooth_progress - this._min) / (this._max - this._min);                  const ctx = this._canvas.getContext('2d');                 const size = this._canvas.width;                 const char_weight = size / 12;                 const char_shadow = 3;                 const char_x = size / 2;                 const char_y = size / 2;                 const char_radius = (size - char_weight) / 2 - char_shadow;                  const font_ratio = 32 / 100;                  ctx.clearRect(0, 0, size, size);                  ctx.beginPath();                 ctx.shadowBlur = char_shadow;                 ctx.shadowColor = '#bbb';                 ctx.strokeStyle = '#eee';                 ctx.lineWidth = char_weight;                 ctx.lineCap = 'round';                 ctx.arc(char_x, char_y, char_radius, Math.PI * 0.749, Math.PI * 2.251, false);                 ctx.stroke();                  ctx.beginPath();                 ctx.strokeStyle = `#${this._chart_color}`;                 ctx.lineWidth = char_weight - 2;                 ctx.lineCap = 'round';                 ctx.arc(char_x, char_y, char_radius, Math.PI * 0.75,                     Math.PI * (0.75 + (1.5 * Math.min(1, Math.max(0, value)))), false                     );                 ctx.stroke();                  ctx.shadowBlur = 2;                 ctx.fillStyle = '#1f2c33';                 ctx.font = `${(char_radius * font_ratio)|0}px Arial`;                 ctx.textAlign = 'center';                 ctx.textBaseline = 'middle';                 ctx.fillText(`${this._value !== null ? this._value : t('No data')}${this._units}`,                     char_x, char_y, size - char_shadow * 4 - char_weight * 2                 );                  ctx.fillStyle = '#768d99';                 ctx.font = `${(char_radius * font_ratio * .5)|0}px Arial`;                 ctx.textBaseline = 'top';                  ctx.textAlign = 'left';                 ctx.fillText(`${this._min}${this._min != '' ? this._units : ''}`,                     char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight                 );                  ctx.textAlign = 'right';                 ctx.fillText(`${this._max}${this._max != '' ? this._units : ''}`,                     size - char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight                 );                  requestAnimationFrame(animate);             }             else {                 this._last_value = this._value;             }         };          requestAnimationFrame(animate);     } } ```  10. Open *manifest.json* and add:  - file name (*class.widget.js*) to the array in the *assets/js* section; - class name (*WidgetLessonGaugeChart*) to the *js_class* parameter in the *widget* section.  The *WidgetLessonGaugeChart* class will now be automatically loaded with the dashboard.  **ui/modules/lesson_gauge_chart/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "lesson_gauge_chart",     "type": "widget",     "name": "Gauge chart",     "namespace": "LessonGaugeChart",     "version": "1.0",     "author": "Zabbix",     "actions": {         "widget.lesson_gauge_chart.view": {             "class": "WidgetView"         }     },     "widget": {         "js_class": "WidgetLessonGaugeChart"     },     "assets": {         "js": ["class.widget.js"]     } } ```
es	### Agregar JavaScript al widget  En esta sección, aprenderá cómo agregar un gráfico de indicadores, elaborado con JavaScript, que muestra si el último valor es normal o demasiado alto/demasiado bajo.  1. Cree un archivo *widget.edit.js.php* en el directorio *views*.  JavaScript será responsable de inicializar el selector de color en la vista de configuración.  **ui/modules/lesson_gauge_chart/views/widget.edit.js.php**  ```php <?php  use Modules\LessonGaugeChart\Widget;  ?>  window.widget_lesson_gauge_chart_form = new class {      init({color_palette}) {         this._unit_select = document.getElementById('value_units');         this._unit_value = document.getElementById('value_static_units');          this._unit_select.addEventListener('change', () => this.updateForm());          colorPalette.setThemeColors(color_palette);          for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) {             jQuery(colorpicker).colorpicker();         }          const overlay = overlays_stack.getById('widget_properties');          for (const event of ['overlay.reload', 'overlay.close']) {             overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); });         }          this.updateForm();     }      updateForm() {         this._unit_value.disabled = this._unit_select.value == <?= Widget::UNIT_AUTO ?>;     } }; ```  2. Abra *views/widget.edit.php* y agregue el archivo *widget.edit.js.php* con JavaScript a la vista de configuración. Para hacer esto, use el método *includeJsFile()*. Para agregar JavaScript en línea, utilice el método *addJavaScript()*.  **ui/modules/lesson_gauge_chart/views/widget.edit.php**  ```php <?php  /**  * Gauge chart widget form view.  *  * @var CView $this  * @var array $data  */  use Modules\LessonGaugeChart\Includes\WidgetForm;  $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units']))     ->setPlaceholder(_('value'))     ->setWidth(ZBX_TEXTAREA_TINY_WIDTH);  (new CWidgetFormView($data))     ->addField(         (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))             ->setPopupParameter('numeric', true)     )     ->addFieldset(         (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration')))             ->addField(                 new CWidgetFieldColorView($data['fields']['chart_color'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_min'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_max'])             )             ->addItem([                 $lefty_units->getLabel(),                 (new CFormField([                     $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN),                     $lefty_static_units->getView()                 ]))             ])             ->addField(                 new CWidgetFieldTextBoxView($data['fields']['description'])             )     )     ->includeJsFile('widget.edit.js.php')     ->addJavaScript('widget_lesson_gauge_chart_form.init('.json_encode([         'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE     ], JSON_THROW_ON_ERROR).');')     ->show(); ```  3. Regrese al tablero, haga clic en el ícono de ajustes en el widget para abrir el formulario de configuración del widget. Ahora, expanda la sección *Configuración avanzada* para ver el selector de color inicializado. Complete los campos con valores y seleccione un color para el gráfico de indicadores.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_advanced_b.png){width="600"}  4. Haga clic en *Aplicar* en el formulario de configuración del widget. Luego haga clic en *Guardar cambios* en la esquina superior derecha para guardar el tablero.  5. Abra *actions/WidgetView.php* y actualice el controlador.  La propiedad **$this->fields_values** ahora contiene los valores de todos los campos de *Configuración avanzada*. Finalice el controlador para permitir pasar la configuración y el valor de la métrica seleccionada a la vista del widget.  **ui/modules/lesson_gauge_chart/actions/WidgetView.php**  ```php <?php  namespace Modules\LessonGaugeChart\Actions;  use API,     CControllerDashboardWidgetView,     CControllerResponseData;  class WidgetView extends CControllerDashboardWidgetView {      protected function doAction(): void {         $db_items = API::Item()->get([             'output' => ['itemid', 'value_type', 'name', 'units'],             'itemids' => $this->fields_values['itemid'],             'webitems' => true,             'filter' => [                 'value_type' => [ITEM_VALUE_TYPE_UINT64, ITEM_VALUE_TYPE_FLOAT]             ]         ]);          $history_value = null;          if ($db_items) {             $item = $db_items[0];              $history = API::History()->get([                 'output' => API_OUTPUT_EXTEND,                 'itemids' => $item['itemid'],                 'history' => $item['value_type'],                 'sortfield' => 'clock',                 'sortorder' => ZBX_SORT_DOWN,                 'limit' => 1             ]);              if ($history) {                 $history_value = convertUnitsRaw([                     'value' => $history[0]['value'],                     'units' => $item['units']                 ]);             }         }          $this->setResponse(new CControllerResponseData([             'name' => $this->getInput('name', $this->widget->getName()),             'history' => $history_value,             'fields_values' => $this->fields_values,             'user' => [                 'debug_mode' => $this->getDebugMode()             ]         ]));     } } ```  6. Abra y modifique *views/widget.view.php*.  Debe crear un contenedor para el gráfico de indicadores, que dibujará en los siguientes pasos, y un contenedor para la descripción.  Para pasar valores a JavaScript como un objeto JSON, utilice el método *setVar()*.  **ui/modules/lesson_gauge_chart/views/widget.view.php**  ```php <?php  /**  * Gauge chart widget view.  *  * @var CView $this  * @var array $data  */  (new CWidgetView($data))     ->addItem([         (new CDiv())->addClass('chart'),         $data['fields_values']['description']             ? (new CDiv($data['fields_values']['description']))->addClass('description')             : null     ])     ->setVar('history', $data['history'])     ->setVar('fields_values', $data['fields_values'])     ->show(); ```  7. Cree un nuevo directorio *assets* en el directorio *lesson_gauge_chart*. Este directorio se utilizará para almacenar JavaScript, CSS y potencialmente cualquier otro activo, como fuentes o imágenes.  8. Para la vista de widget JavaScript, cree un directorio *js* en el directorio *assets*.  9. Cree un archivo *class.widget.js* en el directorio *assets/js*.  Esta clase de widget de JavaScript ampliará la clase de JavaScript base de todos los widgets del tablero: *CWidget*.  El tablero se basa en una implementación correcta de un widget y comunica cualquier información relevante al widget mediante la llamada a los respectivos métodos de JavaScript. El tablero también espera que el widget genere eventos cuando se produzca alguna interacción. Por lo tanto, la clase *CWidget* contiene un conjunto de métodos con la implementación predeterminada del comportamiento del widget, que se puede personalizar extendiendo la clase.  En este caso, es necesaria cierta personalización; por lo tanto, se implementará una lógica personalizada para el siguiente comportamiento del widget:  -   inicialización del widget que es responsable de definir el estado inicial del widget (ver el método *onInitialize()*); -   mostrar el contenido del widget (es decir, dibujar el gráfico de indicadores) si el proceso de actualización del widget ha sido exitoso y sin errores (consulte el método *processUpdateResponse(response)* y los métodos relacionados  *\_resizeChart()* y *\_updatedChart()*) -   cambiar el tamaño del widget (consulte el método *onResize()* y el método relacionado *\_resizeChart()*)  Para otros aspectos del widget del gráfico de indicadores, se utilizará la implementación predeterminada para el comportamiento del widget. Para obtener más información sobre los métodos JavaScript de la clase *CWidget*, consulte: [JavaScript](/devel/modules/widgets/presentation/javascript).  Dado que este JavaScript es necesario para la vista del widget, debe cargarse con la página del tablero. Para habilitar la carga de JavaScript, deberá actualizar los parámetros *assets/js* y *js_class* en el archivo ***manifest.json*** como se muestra en el paso 10.  **ui/modules/lesson_gauge_chart/assets/js/class.widget.js**  ```js class WidgetLessonGaugeChart extends CWidget {      static UNIT_AUTO = 0;     static UNIT_STATIC = 1;      onInitialize() {         super.onInitialize();          this._refresh_frame = null;         this._chart_container = null;         this._canvas = null;         this._chart_color = null;         this._min = null;         this._max = null;         this._value = null;         this._last_value = null;         this._units = '';     }      processUpdateResponse(response) {         if (response.history === null) {             this._value = null;             this._units = '';         }         else {             this._value = Number(response.history.value);             this._units = response.fields_values.value_units == WidgetLessonGaugeChart.UNIT_AUTO                 ? response.history.units                 : response.fields_values.value_static_units;         }          this._chart_color = response.fields_values.chart_color;         this._min = Number(response.fields_values.value_min);         this._max = Number(response.fields_values.value_max);          super.processUpdateResponse(response);     }      setContents(response) {         if (this._canvas === null) {             super.setContents(response);              this._chart_container = this._body.querySelector('.chart');             this._chart_container.style.height =                 `${this._getContentsSize().height - this._body.querySelector('.description').clientHeight}px`;             this._canvas = document.createElement('canvas');              this._chart_container.appendChild(this._canvas);              this._resizeChart();         }          this._updatedChart();     }      onResize() {         super.onResize();          if (this._state === WIDGET_STATE_ACTIVE) {             this._resizeChart();         }     }      _resizeChart() {         const ctx = this._canvas.getContext('2d');         const dpr = window.devicePixelRatio;          this._canvas.style.display = 'none';         const size = Math.min(this._chart_container.offsetWidth, this._chart_container.offsetHeight);         this._canvas.style.display = '';          this._canvas.width = size * dpr;         this._canvas.height = size * dpr;          ctx.scale(dpr, dpr);          this._canvas.style.width = `${size}px`;         this._canvas.style.height = `${size}px`;          this._refresh_frame = null;          this._updatedChart();     }      _updatedChart() {         if (this._last_value === null) {             this._last_value = this._min;         }          const start_time = Date.now();         const end_time = start_time + 400;          const animate = () => {             const time = Date.now();              if (time <= end_time) {                 const progress = (time - start_time) / (end_time - start_time);                 const smooth_progress = 0.5 + Math.sin(Math.PI * (progress - 0.5)) / 2;                 let value = this._value !== null ? this._value : this._min;                 value = (this._last_value + (value - this._last_value) * smooth_progress - this._min) / (this._max - this._min);                  const ctx = this._canvas.getContext('2d');                 const size = this._canvas.width;                 const char_weight = size / 12;                 const char_shadow = 3;                 const char_x = size / 2;                 const char_y = size / 2;                 const char_radius = (size - char_weight) / 2 - char_shadow;                  const font_ratio = 32 / 100;                  ctx.clearRect(0, 0, size, size);                  ctx.beginPath();                 ctx.shadowBlur = char_shadow;                 ctx.shadowColor = '#bbb';                 ctx.strokeStyle = '#eee';                 ctx.lineWidth = char_weight;                 ctx.lineCap = 'round';                 ctx.arc(char_x, char_y, char_radius, Math.PI * 0.749, Math.PI * 2.251, false);                 ctx.stroke();                  ctx.beginPath();                 ctx.strokeStyle = `#${this._chart_color}`;                 ctx.lineWidth = char_weight - 2;                 ctx.lineCap = 'round';                 ctx.arc(char_x, char_y, char_radius, Math.PI * 0.75,                     Math.PI * (0.75 + (1.5 * Math.min(1, Math.max(0, value)))), false                     );                 ctx.stroke();                  ctx.shadowBlur = 2;                 ctx.fillStyle = '#1f2c33';                 ctx.font = `${(char_radius * font_ratio)|0}px Arial`;                 ctx.textAlign = 'center';                 ctx.textBaseline = 'middle';                 ctx.fillText(`${this._value !== null ? this._value : t('No data')}${this._units}`,                     char_x, char_y, size - char_shadow * 4 - char_weight * 2                 );                  ctx.fillStyle = '#768d99';                 ctx.font = `${(char_radius * font_ratio * .5)|0}px Arial`;                 ctx.textBaseline = 'top';                  ctx.textAlign = 'left';                 ctx.fillText(`${this._min}${this._min != '' ? this._units : ''}`,                     char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight                 );                  ctx.textAlign = 'right';                 ctx.fillText(`${this._max}${this._max != '' ? this._units : ''}`,                     size - char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight                 );                  requestAnimationFrame(animate);             }             else {                 this._last_value = this._value;             }         };          requestAnimationFrame(animate);     } } ```  10. Abra *manifest.json* y agregue:  -   nombre del archivo (*class.widget.js*) de la matriz en la sección *assets/js*; -   nombre de la clase (*WidgetLessonGaugeChart*) al parámetro *js_class* en la sección *widget*.  La clase *WidgetLessonGaugeChart* ahora se cargará automáticamente con el tablero.  **ui/modules/lesson_gauge_chart/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "lesson_gauge_chart",     "type": "widget",     "name": "Gauge chart",     "namespace": "LessonGaugeChart",     "version": "1.0",     "author": "Zabbix",     "actions": {         "widget.lesson_gauge_chart.view": {             "class": "WidgetView"         }     },     "widget": {         "js_class": "WidgetLessonGaugeChart"     },     "assets": {         "js": ["class.widget.js"]     } } ```

en-us	### Add settings to a configuration view and use them in a widget view  In this section, you will learn how to add a widget configuration field and show the entered value in the widget view as text.  The widget configuration consists of a form (*Zabbix\\Widgets\\CWidgetForm*) and a widget form view (*widget.edit.php*). To add fields (*Zabbix\\Widgets\\CWidgetField*), you need to create a *WidgetForm* class, which will extend *Zabbix\\Widgets\\CWidgetForm*.  The form contains the set of fields (*Zabbix\\Widgets\\CWidgetField*) of various types, which are used to validate user-entered values. The form field (*Zabbix\\Widgets\\CWidgetField*) for each input element type converts the value into a single format to store it in the database.  :::noteclassic The widget's **form** file should be located in the *includes* directory (for this tutorial, *ui/modules/lesson_gauge_chart/includes/*). If the file has the default name *WidgetForm.php*, you do not need to register it in the *manifest.json* file. If the file has a different name, specify it in the *widget/form_class* section of the [manifest.json](devel/modules/file_structure/manifest) file. :::  1. Create a new directory *includes* in the *lesson_gauge_chart* directory.  2. Create a *WidgetForm.php* file in the *includes* directory.  **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**  ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Zabbix\Widgets\CWidgetForm;  class WidgetForm extends CWidgetForm { } ```  3. Add a *Description* field to widget configuration form. This is a regular text field, where a user can enter any character set. You can use the *CWidgetFieldTextBox* class for it.  **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**  ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Zabbix\Widgets\CWidgetForm;  use Zabbix\Widgets\Fields\CWidgetFieldTextBox;  class WidgetForm extends CWidgetForm {      public function addFields(): self {         return $this             ->addField(                new CWidgetFieldTextBox('description', _('Description'))             );    } } ```  4. In the *views* directory, create a widget configuration view file *widget.edit.php* and add a view for the new *Description* field. For the *CWidgetFieldTextBox* field class, the view is *CWidgetFieldTextBoxView.*  **ui/modules/lesson_gauge_chart/views/widget.edit.php**  ```php <?php  /**  * Gauge chart widget form view.  *  * @var CView $this  * @var array $data  */  (new CWidgetFormView($data))     ->addField(         new CWidgetFieldTextBoxView($data['fields']['description'])     )     ->show(); ```  5. Go to the dashboard and click on the gear icon in the widget to open the widget configuration form.  6. The widget configuration form now contains a new *Description* text field. Enter any value, for example, *Gauge chart description*.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_descr.png){width="600"}  7. Click on *Apply* in the widget configuration form. Then click on *Save changes* in the top right corner to save the dashboard. Note that the new description is not visible anywhere, and the widget still displays "Hello, world!".  For the new description to appear in the widget, the *Description* field value needs to be retrieved from the database and passed to the widget view. For that, you need to create an action class.  8. Create a new directory *actions* in the *lesson_gauge_chart* directory.  9. Create a *WidgetView.php* file in the *actions* directory. The *WidgetView* action class will extend the *CControllerDashboardWidgetView* class.  Values of the widget configuration fields are stored in the **$fields_values** property of the action class.  **ui/modules/lesson_gauge_chart/actions/WidgetView.php**  ```php <?php  namespace Modules\LessonGaugeChart\Actions;  use CControllerDashboardWidgetView,     CControllerResponseData;  class WidgetView extends CControllerDashboardWidgetView {      protected function doAction(): void {         $this->setResponse(new CControllerResponseData([             'name' => $this->getInput('name', $this->widget->getName()),             'description' => $this->fields_values['description'],             'user' => [                 'debug_mode' => $this->getDebugMode()             ]         ]));     } } ```  10. Open *manifest.json* and register *WidgetView* as an action class in the *actions/widget.lesson_gauge_chart.view* section.  **ui/modules/lesson_gauge_chart/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "lesson_gauge_chart",     "type": "widget",     "name": "Gauge chart",     "namespace": "LessonGaugeChart",     "version": "1.0",     "author": "Zabbix",     "actions": {         "widget.lesson_gauge_chart.view": {             "class": "WidgetView"         }     } } ```  11. Now you can use the value of the description field, contained in *$data['description']*, in the widget view. Open *views/widget.view.php* and replace the static text "Hello, world!" with *$data['description']*.  **ui/modules/lesson_gauge_chart/views/widget.view.php**  ```php <?php  /**  * Gauge chart widget view.  *  * @var CView $this  * @var array $data  */  (new CWidgetView($data))     ->addItem(         new CTag('h1', true, $data['description'])     )     ->show(); ```  12. Refresh the dashboard page. You should now see the widget description text instead of "Hello, world!".  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_view_descr.png){width="600"}
es	### Agregar configuraciones a una vista de configuración y usarlas en una vista de widget  En esta sección, aprenderá cómo agregar un campo de configuración del widget y mostrar el valor ingresado en la vista del widget como texto.  La configuración del widget consta de un formulario (*Zabbix\\Widgets\\CWidgetForm*) y una vista de formulario de widget (*widget.edit.php*). Para agregar campos (*Zabbix\\Widgets\\CWidgetField*), necesita crear una clase *WidgetForm*, que extenderá *Zabbix\\Widgets\\CWidgetForm*.  El formulario contiene el conjunto de campos (*Zabbix\\Widgets\\CWidgetField*) de varios tipos, que se utilizan para validar los valores ingresados por el usuario. El campo de formulario (*Zabbix\\Widgets\\CWidgetField*) para cada tipo de elemento de entrada convierte el valor a un formato único para almacenarlo en la base de datos.  :::noteclassic El archivo **form** del widget debe estar ubicado en el directorio *includes* (para este tutorial, *ui/modules/lesson_gauge_chart/includes/*). Si el archivo tiene el nombre predeterminado *WidgetForm.php*, no es necesario registrarlo en el archivo *manifest.json*. Si el archivo tiene un nombre diferente, especifíquelo en la sección *widget/form_class* del archivo [manifest.json](devel/modules/file_structure/manifest). :::  1. Cree un nuevo directorio *includes* en el directorio *lesson_gauge_chart*.  2. Cree un archivo *WidgetForm.php* en el directorio *includes*.  **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**  ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Zabbix\Widgets\CWidgetForm;  class WidgetForm extends CWidgetForm { } ```  3. Agregue un campo *Descripción* al formulario de configuración del widget. Este es un campo de texto normal, donde un usuario puede ingresar cualquier conjunto de caracteres. Puede utilizar la clase *CWidgetFieldTextBox* para ello.  **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**  ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Zabbix\Widgets\CWidgetForm;  use Zabbix\Widgets\Fields\CWidgetFieldTextBox;  class WidgetForm extends CWidgetForm {      public function addFields(): self {     return $this     ->addField(     new CWidgetFieldTextBox('description', _('Descripción'))     );     } } ```  4. En el directorio *views*, cree un archivo de vista de configuración del widget *widget.edit.php* y agregue una vista para el nuevo campo *Descripción*. Para la clase de campo *CWidgetFieldTextBox*, la vista es *CWidgetFieldTextBoxView.*  **ui/modules/lesson_gauge_chart/views/widget.edit.php**  ```php <?php  /**  * Gauge chart widget form view.  *  * @var CView $this  * @var array $data  */  (new CWidgetFormView($data))     ->addField(     new CWidgetFieldTextBoxView($data['fields']['descripción'])     )     ->show(); ```  5. Vaya al tablero y haga clic en el ícono de ajustes en el widget para abrir el formulario de configuración del widget.  6. El formulario de configuración del widget ahora contiene un nuevo campo de texto *Description*. Ingrese cualquier valor, por ejemplo, *Descripción del gráfico de indicadores*.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_descr.png){width="600"}  7. Haga clic en *Aplicar* en el formulario de configuración del widget. Luego haga clic en *Guardar cambios* en la esquina superior derecha para guardar el panel. Tenga en cuenta que la nueva descripción no es visible en ninguna parte y el widget aún muestra "¡Hola, mundo!".  Para que la nueva descripción aparezca en el widget, el valor del campo *Descripción* debe recuperarse de la base de datos y pasarse a la vista del widget. Para eso, necesitas crear una clase de acción.  8. Cree un nuevo directorio *actions* en el directorio *lesson_gauge_chart*.  9. Cree un archivo *WidgetView.php* en el directorio *actions*. La clase de acción *WidgetView* ampliará la clase *CControllerDashboardWidgetView*.  Los valores de los campos de configuración del widget se almacenan en la propiedad **$fields_values** de la clase de acción.  **ui/modules/lesson_gauge_chart/actions/WidgetView.php**  ```php <?php  namespace Modules\LessonGaugeChart\Actions;  use CControllerDashboardWidgetView,     CControllerResponseData;  class WidgetView extends CControllerDashboardWidgetView {      protected function doAction(): void {     $this->setResponse(new CControllerResponseData([     'name' => $this->getInput('name', $this->widget->getName()),     'description' => $this->fields_values['descripción'],     'user' => [     'debug_mode' => $this->getDebugMode()     ]     ]));     } } ```  10. Abra *manifest.json* y registre *WidgetView* como una clase de acción en la sección *actions/widget.lesson_gauge_chart.view*.  **ui/modules/lesson_gauge_chart/manifest.json**  ```json { "manifest_version": 2.0, "id": "lesson_gauge_chart", "type": "widget", "name": "Gauge chart", "namespace": "LessonGaugeChart", "version": "1.0", "author": "Zabbix", "actions": { "widget.lesson_gauge_chart.view": { "class": "WidgetView" } } } ```  11. Ahora puede utilizar el valor del campo de descripción, contenido en *$data['description']*, en la vista del widget. Abra *views/widget.view.php* y reemplace el texto estático "¡Hola, mundo!" con *$data['description']*.  **ui/modules/lesson_gauge_chart/views/widget.view.php**  ```php <?php  /**  * Gauge chart widget view.  *  * @var CView $this  * @var array $data  */  (new CWidgetView($data)) ->addItem( new CTag('h1', true, $data['descripción']) ) ->show(); ```  12. Actualice la página del tablero. Ahora debería ver el texto de descripción del widget en lugar de "¡Hola, mundo!".  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_view_descr.png){width="600"}

en-us	## Administration  With the Zabbix API you can change administration settings of your monitoring system.
es	## Administración  Con la API de Zabbix puede cambiar la configuración de administración de su Sistema de monitoreo.

en-us	#### Advanced configuration  Advanced configuration options are available in a collapsible *Advanced configuration* section:  ![](../../../../../assets/en/manual/web_interface/script_advanced.png){width="600"}  |Parameter|Description| |----------|----------------------------------------| |*Enable user input*|Mark the checkbox to enable manual user input before executing the script.<br>Manual user input will replace the {MANUALINPUT} macro value in the script.<br>See also: [Manual user input](#manual-user-input).| |*Input prompt*|Enter custom text prompting for custom user input. This text will be displayed above the input field in the *Manual input* popup.<br>To see a preview of the *Manual input* popup, click on *Test user input*. The preview also allows to test if the input string complies with the input validation rule (see parameters below).<br>Macro and user macro support depends on the scope of the script (see *Scope* in general script configuration parameters).| |*Input type*|Select the manual input type:<br>**String** - single string;<br>**Dropdown** - value is selected from multiple dropdown options.| |*Dropdown options*|Enter unique values for the user input dropdown in a comma-delimited list.<br>To include an empty option in the dropdown, add an extra comma at the beginning, middle, or end of the list.<br>This field is displayed only if 'Dropdown' is selected as *Input type*.| |*Default input string*|Enter the default string for user input (or none).<br>This field will be validated against the regular expression provided in the *Input validation rule* field.<br>The value entered here will be displayed by default in the *Manual input* popup.<br>This field is displayed only if 'String' is selected as *Input type*.| |*Input validation rule*|Enter a regular expression to validate the user input string.<br>Global regular expressions are supported.<br>This field is displayed only if 'String' is selected as *Input type*.| |*Enable confirmation*|Mark the checkbox to display a confirmation message before executing the script. This feature might be especially useful with potentially dangerous operations (like a reboot script) or ones that might take a long time.| |*Confirmation text*|Enter custom confirmation text for the confirmation popup enabled with the checkbox above (for example, *Remote system will be rebooted. Are you sure?*). To see how the text will look like, click on *Test confirmation* next to the field.<br>[Macros](/manual/appendix/macros/supported_by_location) and custom [user macros](/manual/config/macros/user_macros) are supported.<br>*Note:* the macros will not be expanded when testing the confirmation message.|  If both manual user input and a confirmation message are configured, they will be displayed in consecutive popup windows.
es	#### Configuración avanzada  Las opciones de configuración avanzada están disponibles en una sección plegable *Configuración avanzada*:  ![](../../../../../assets/en/manual/web_interface/script_advanced.png){width="600"}  |Parámetro|Descripción| |----------|-------------------------------------- --| |*Habilitar entrada de usuario*|Marque la casilla de verificación para habilitar la entrada manual del usuario antes de ejecutar el script.<br>La entrada manual del usuario reemplazará el valor de la macro {MANUALINPUT} en el script.<br>Consulte también: [Entrada manual del usuario](#entrada-manual-de-usuario).| |*Mensaje de entrada*|Ingrese un texto personalizado que solicite la entrada personalizada del usuario. Este texto se mostrará encima del campo de entrada en la ventana emergente *Entrada manual*.<br>Para ver una vista previa de la ventana emergente *Entrada manual*, haga clic en *Probar entrada del usuario*. La vista previa también permite probar si la cadena de entrada cumple con la regla de validación de entrada (consulte los parámetros a continuación).<br>La compatibilidad con macros y macros de usuario depende del alcance del script (consulte *Alcance* en los parámetros generales de configuración del script).| |*Tipo de entrada*|Seleccione el tipo de entrada manual:<br>**Cadena** - cadena única;<br>**Desplegable** - el valor se selecciona entre múltiples opciones desplegables.| |*Opciones desplegables*|Ingrese valores únicos para el menú desplegable de entrada del usuario en una lista delimitada por comas.<br>Para incluir una opción vacía en el menú desplegable, agregue una coma adicional al principio, en el medio o al final de la lista.< br>Este campo se muestra sólo si se selecciona 'Desplegable' como *Tipo de entrada*.| |*Cadena de entrada predeterminada*|Ingrese la cadena predeterminada para la entrada del usuario (o ninguna).<br>Este campo se validará con la expresión regular proporcionada en el campo *Regla de validación de entrada*.<br>El valor ingresado aquí será se muestra de forma predeterminada en la ventana emergente *Entrada manual*.<br>Este campo se muestra solo si se selecciona 'Cadena' como *Tipo de entrada*.| |*Regla de validación de entrada*|Ingrese una expresión regular para validar la cadena de entrada del usuario.<br>Se admiten expresiones regulares globales.<br>Este campo se muestra solo si se selecciona 'Cadena' como *Tipo de entrada*.| |*Habilitar confirmación*|Marque la casilla de verificación para mostrar un mensaje de confirmación antes de ejecutar el script. Esta característica puede ser especialmente útil con operaciones potencialmente peligrosas (como un script de reinicio) o aquellas que pueden llevar mucho tiempo.| |*Texto de confirmación*|Ingrese un texto de confirmación personalizado para la ventana emergente de confirmación habilitada con la casilla de verificación anterior (por ejemplo, *El sistema remoto se reiniciará. ¿Está seguro?*). Para ver cómo se verá el texto, haga clic en *Confirmación de prueba* junto al campo.<br>[Macros](/manual/appendix/macros/supported_by_location) y [macros de usuario] personalizadas(/manual/config/macros/ user_macros) son compatibles.<br>*Nota:* las macros no se expandirán al probar el mensaje de confirmación.|  Si se configuran tanto la entrada manual del usuario como un mensaje de confirmación, se mostrarán en ventanas emergentes consecutivas.

en-us	##### Advanced configuration  Advanced configuration options are available in the collapsible *Advanced configuration* section and only for elements selected in the *Show* field (see above) and the background color or thresholds for honeycomb cells.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/honeycomb_advanced_configuration.png){width="600"}  |   |   | |--|--------| |***Primary/Secondary label***|<| |*Type*|Select the label type:<br>**Text** - the label will display the text specified in the *Text* parameter;<br>**Value** - the label will display the item value with decimal places as specified in the *Decimal places* parameter.| |*Text*|Enter the label text. This text may override the default item name.<br>Multiline text is supported. A combination of text and [supported macros](/manual/appendix/macros/supported_by_location) is possible.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, and [user macros](/manual/appendix/macros/supported_by_location_user#other-locations) are supported.<br>Honeycomb cells are ordered alphabetically by host name, and, within each host, by item name.<br>This parameter is available if *Type* is set to "Text".| |*Decimal places*|Enter the number of decimal places to display with the value.<br>This parameter is available if *Type* is set to "Value", and affects only items that return [numeric (float)](/manual/config/items/item#configuration) data.| |*Size*|Select the label size:<br>**Auto** - use automatically adjusted label size;<br>**Custom** - enter a custom label size (in percent, relative to the honeycomb cell size).<br>Note that labels that do not fit the honeycomb cell size are truncated.| |*Bold*|Mark the checkbox to display item units in bold.| |*Color*|Select the item units color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Units***|<| |*Units*|Mark the checkbox to display units with the item value.<br>If you enter a unit name, it will override the units set in the [item configuration](/manual/config/items/item#configuration).<br>This parameter is available if *Type* is set to "Text".| |*Position*|Select the position of the item units (before or after the item value).<br>This parameter is ignored for the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.<br>This parameter is available if *Type* is set to "Text".| |***Background color***|<| |*Background color*|Select the honeycomb cells background color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Thresholds***|<| |*Color interpolation*|Mark the checkbox to enable smooth transitioning between threshold colors for honeycomb cells.<br>This parameter is available if two or more thresholds are set.| |*Threshold*|Click *Add* to add a threshold, select a threshold color from the color picker, and specify a numeric value.<br>The thresholds list will be sorted in ascending order when saved.<br>Note that the colors configured as thresholds will be displayed correctly only for numeric items.<br>[Suffixes](/manual/appendix/suffixes) (for example, "1d", "2w", "4K", "8G") are supported. [Value mappings](/manual/config/items/mapping) are supported.|
es	##### Configuración avanzada  Las opciones de configuración avanzada están disponibles en la sección plegable *Configuración avanzada* y solo para los elementos seleccionados en el campo *Mostrar* (ver arriba) y el color de fondo o los umbrales para las celdas de panal.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/honeycomb_advanced_configuration.png){width="600"}  |   |   | |--|--------| |***Etiqueta primaria/secundaria***|<| |*Tipo*|Seleccione el tipo de etiqueta:<br>**Texto**: la etiqueta mostrará el texto especificado en el parámetro *Texto*;<br>**Valor**: la etiqueta mostrará el valor del elemento con Lugares decimales como se especifica en el parámetro *Lugares decimales*.| |*Texto*|Ingrese el texto de la etiqueta. Este texto puede anular el nombre del elemento predeterminado.<br>Se admite texto multilínea. Es posible una combinación de texto y [macros compatibles](/manual/appendix/macros/supported_by_location).<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} y [macros de usuario ](/manual/appendix/macros/supported_by_location_user#other-locations).<br>Las celdas del panal se ordenan alfabéticamente por nombre de equipo y, dentro de cada equipo, por nombre de métrica.<br>Este parámetro está disponible si *Tipo * está configurado en "Texto".| |*Lugares decimales*|Ingrese el número de lugares decimales que se mostrarán con el valor.<br>Este parámetro está disponible si *Tipo* está establecido en "Valor" y afecta solo a las métricas que devuelven datos [numéricos (flotante)](/manual/config/items/item#configuration).| |*Tamaño*|Seleccione el tamaño de la etiqueta:<br>**Auto**: use el tamaño de etiqueta ajustado automáticamente;<br>**Personalizado**: ingrese un tamaño de etiqueta personalizado (en porcentaje, en relación con el tamaño de la celda del panal) .<br>Tenga en cuenta que las etiquetas que no se ajustan al tamaño de celda del panal se truncan.| |*Negrita*|Marque la casilla de verificación para mostrar las unidades de artículos en negrita.| |*Color*|Seleccione el color de las unidades del elemento en el selector de color.<br>"D" representa el color predeterminado, que depende del tema de la interfaz. Para volver al color predeterminado, haga clic en el botón *Usar predeterminado* en el selector de color.| |***Unidades***|<| |*Unidades*|Marque la casilla de verificación para mostrar las unidades con el valor de la métrica.<br>Si ingresa un nombre de unidad, anulará las unidades establecidas en la [configuración de la métrica](/manual/config/items/item#configuration) .<br>Este parámetro está disponible si *Tipo* está establecido en "Texto".| |*Posición*|Seleccione la posición de las unidades de la métrica (antes o después del valor de la métrica).<br>Este parámetro se ignora para las siguientes [unidades relacionadas con el tiempo](/manual/config/items/item#configuration): unixtime, uptime, s.<br>Este parámetro está disponible si *Tipo* está establecido en "Texto".| |***Color de fondo***|<| |*Color de fondo*|Seleccione el color de fondo de las celdas en forma de panal en el selector de color.<br>"D" representa el color predeterminado, que depende del tema de la interfaz. Para volver al color predeterminado, haga clic en el botón *Usar predeterminado* en el selector de color.| |***Umbrales***|<| |*Interpolación de color*|Marque la casilla de verificación para permitir una transición suave entre los colores de umbral para las celdas de panal.<br>Este parámetro está disponible si se establecen dos o más umbrales.| |*Umbral*|Haga clic en *Agregar* para agregar un umbral, seleccione un color de umbral en el selector de color y especifique un valor numérico.<br>La lista de umbrales se ordenará en orden ascendente cuando se guarde.<br>Tenga en cuenta que el los colores configurados como umbrales se mostrarán correctamente solo para métricas numéricas.<br>Se admiten [Sufijos](/manual/appendix/suffixes) (por ejemplo, "1d", "2w", "4K", "8G"). Se admiten [asignaciones de valores](/manual/config/items/mapping).|

en-us	#### Advanced configuration  Advanced configuration options are available in the collapsible *Advanced configuration* section, and only for those elements that are selected in the *Show* field (see above).  Additionally, advanced configuration allows to change the background  color for the whole widget.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/clock_advanced.png){width=600}  |   |   | |--|--------| |*Background color* |Select the background color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |_**Date**_ || |*Size* |Enter font size height for the date (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display date in bold type. | |*Color* |Select the date color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |_**Time**_ || |*Size* |Enter font size height for the time (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display time in bold type. | |*Color* |Select the time color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |*Seconds* |Mark the checkbox to display seconds. Otherwise only hours and minutes will be displayed.| |*Format* |Select to display a 24-hour or 12-hour time. | |_**Time zone**_ || |*Size* |Enter font size height for the time zone (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display time zone in bold type. | |*Color* |Select the time zone color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |*Time zone*|Select the time zone.| |*Format* |Select to display time zone in short format (e.g. `New York`) or full format (e.g.`(UTC-04:00) America/New York`). |
es	#### Configuración avanzada  Las opciones de configuración avanzada están disponibles en la sección plegable *Configuración avanzada*, y sólo para aquellos elementos que están seleccionados en el campo *Mostrar* (ver arriba).  Además, la configuración avanzada permite cambiar el fondo.  color para todo el widget.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/clock_advanced.png){width=600}  |   |   | |--|--------| |*Color de fondo* |Seleccione el color de fondo en el selector de color.<br>`D` significa color predeterminado (depende del tema de la interfaz). Para volver al valor predeterminado, haga clic en el botón *Usar valor predeterminado* en el selector de color. | |_**Fecha**_ || |*Tamaño* |Ingrese la altura del tamaño de fuente para la fecha (en porcentaje relativo a la altura total del widget). | |*Negrita* |Marque la casilla de verificación para mostrar la fecha en negrita. | |*Color* |Seleccione el color de la fecha en el selector de color.<br>`D` significa color predeterminado (depende del tema de la interfaz). Para volver al valor predeterminado, haga clic en el botón *Usar valor predeterminado* en el selector de color. | |_**Hora**_ || |*Tamaño* |Ingrese la altura del tamaño de fuente para el momento (en porcentaje relativo a la altura total del widget). | |*Negrita* |Marque la casilla de verificación para mostrar la hora en negrita. | |*Color* |Seleccione el color de tiempo en el selector de color.<br>`D` significa color predeterminado (depende del tema de la interfaz). Para volver al valor predeterminado, haga clic en el botón *Usar valor predeterminado* en el selector de color. | |*Segundos* |Marque la casilla de verificación para mostrar los segundos. De lo contrario, sólo se mostrarán las horas y los minutos.| |*Formato* |Seleccione para mostrar una hora de 24 o 12 horas. | |_**Zona horaria**_ || |*Tamaño* |Ingrese la altura del tamaño de fuente para la zona horaria (en porcentaje relativo a la altura total del widget). | |*Negrita* |Marque la casilla de verificación para mostrar la zona horaria en negrita. | |*Color* |Seleccione el color de la zona horaria en el selector de color.<br>`D` significa color predeterminado (depende del tema de la interfaz). Para volver al valor predeterminado, haga clic en el botón *Usar valor predeterminado* en el selector de color. | |*Zona horaria*|Seleccione la zona horaria.| |*Formato* |Seleccione mostrar la zona horaria en formato corto (por ejemplo, `Nueva York`) o en formato completo (por ejemplo, `(UTC-04:00) América/Nueva York`). |

en-us	#### Advanced configuration  Advanced configuration options are available in the collapsible *Advanced configuration* section, and only for those elements that are selected in the *Show* field (see above).  Additionally, advanced configuration allows to change the background  color (static or dynamic) for the whole widget.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/item_value_advanced.png){width="600"}  |   |   | |--|--------| |***Description***|<| |*Description* |Enter the item description. This description may override the default item name. Multiline descriptions are supported. A combination of text and supported macros is possible.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} and user macros are supported. | |*Horizontal position* |Select horizontal position of the item description - left, right or center. | |*Vertical position* |Select vertical position of the item description - top, bottom or middle. | |*Size* |Enter font size height for the item description (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display item description in bold type. | |*Color* |Select the item description color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Value***|<| |*Decimal places* |Select how many decimal places will be displayed with the value. This value will affect only float items. | |*Size* |Enter font size height for the decimal places (in percent relative to total widget height). | |*Horizontal position* |Select horizontal position of the item value - left, right or center. | |*Vertical position* |Select vertical position of the item value - top, bottom or middle. | |*Size* |Enter font size height for the item value (in percent relative to total widget height).<br>Note that the size of item value is prioritized; other elements have to concede space for the value. With the change indicator though, if the value is too large, it will be truncated to show the change indicator. | |*Bold* |Mark the checkbox to display item value in bold type. | |*Color* |Select the item value color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Units***|<| |*Units* |Mark the checkbox to display units with the item value. If you enter a unit name, it will override the unit from item configuration. | |*Position* |Select the item unit position - above, below, before or after the value. | |*Size* |Enter font size height for the item unit (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display item unit in bold type. | |*Color* |Select the item unit color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Time*** *(clock value from item history)*|<| |*Horizontal position* |Select horizontal position of the time - left, right or center. | |*Vertical position* |Select vertical position of the time - top, bottom or middle. | |*Size* |Enter font size height for the time (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display time in bold type. | |*Color* |Select the time color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Change indicator***|Select the color of change indicators from the color picker. The change indicators are as follows:<br>**↑** - item value is up (for numeric items)<br>**↓** - item value is down (for numeric items)<br>**↕** - item value has changed (for string items and items with value mapping)<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker.<br>Vertical size of the change indicator is equal to the size of the value (integer part of the value for numeric items).<br>Note that up and down indicators are not shown with just one value. | |***Background color***|Select the background color for the whole widget from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Thresholds***|Configure the dynamic background color for the whole widget. Click *Add* to add a threshold, select the background color from the color picker, and specify a numeric value. Once the item value equals or is greater than the threshold value, the background color will change.<br>The list will be sorted in ascending order when saved.<br>Note that the dynamic background color will be displayed correctly only for numeric items.| |***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>**count** - display the count of values;<br>**sum** - display the sum of values;<br>**first** - display the first value;<br>**last** - display the last value;<br>**not used** - display the most recent value (no aggregation).<br><br>Aggregation allows to display an aggregated value for the chosen interval (5 minutes, an hour, a day), instead of the most recent value.<br>Only numeric data can be displayed for *min*, *max*, *avg* and *sum*. For *count*, non-numeric data will be changed to numeric.| |***Time period***|Specify the time period to use for aggregating values:<br>**Dashboard** - use time period of the dashboard;<br>**Widget** - use time period of the specified widget;<br>**Custom** - use a custom time period.<br><This parameter will not be displayed if *Aggregation function* is set to "not used". | |*Widget*|Select the widget.<br>This parameter will only be displayed if *Time period* is set to "Widget".| |*From*|Select the time period from (default value `now-1h`). See [relative time syntax](/manual/web_interface/time_period_selector).<br>This parameter will only be displayed if *Time period* is set to "Custom".| |*To*|Select the time period to (default value `now`). See [relative time syntax](/manual/web_interface/time_period_selector).<br>This parameter will only be displayed if *Time period* is set to "Custom".| |***History data***|Take data from history or trends:<br>**Auto** - automatic selection;<br>**History** - take history data;<br>**Trends** - take trend data.<br><br>This setting applies only to numeric data. Non-numeric data will always be taken from history.|  Note that multiple elements cannot occupy the same space; if they are placed in the same space, an error message will be displayed.
es	#### Configuración avanzada  Las opciones de configuración avanzada están disponibles si la casilla de verificación  *configuración avanzada* está marcada  y solo para aquellos elementos que están seleccionadas en el campo *Mostrar* (ver arriba).  Además, la configuración avanzada permite cambiar el color de fondo (estático o dinámico) para todo el widget.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/item_value_advanced.png){width="600"}  |    |    | |--|--------| |***Descripción***|<| |*Descripción* |Ingrese la descripción de la métrica. Esta descripción puede reemplazar el nombre de la métrica predeterminada. Se admiten descripciones de varias líneas. Es posible una combinación de texto y macros compatibles.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} y las macros de usuario son compatibles. | |*Posición horizontal* |Seleccione la posición horizontal de la descripción de la métrica: izquierda, derecha o centro. | |*Posición vertical* |Seleccione la posición vertical de la descripción de la métrica: superior, inferior o media. | |*Tamaño* |Ingrese la altura del tamaño de fuente para la descripción de la métrica (en porcentaje relativo a la altura total del widget). | |*Negrita* |Marque la casilla de verificación para mostrar la descripción de la métrica en negrita. | |*Color* |Seleccione el color de descripción de la métrica en el selector de color.<br>`D` significa color predeterminado (depende del tema de la interfaz). Para volver al valor predeterminado, haga clic en el botón *Usar valor predeterminado* en el selector de color. | |***Valor***|<| |*Lugares decimales* |Seleccione cuántos decimales se mostrarán con el valor. Este valor afectará sólo a las métricas flotantes. | |*Tamaño* |Ingrese la altura del tamaño de fuente para los decimales (en porcentaje relativo a la altura total del widget). | |*Posición horizontal* |Seleccione la posición horizontal del valor de la métrica: izquierda, derecha o centro. | |*Posición vertical* |Seleccione la posición vertical del valor de la métrica: superior, inferior o central. | |*Tamaño* |Ingrese la altura del tamaño de fuente para el valor de la métrica (en porcentaje relativo a la altura total del widget).<br>Tenga en cuenta que se prioriza el tamaño del valor de la métrica; otros elementos tienen que ceder espacio al valor. Sin embargo, con el indicador de cambio, si el valor es demasiado grande, se truncará para mostrar el indicador de cambio. | |*Negrita* |Marque la casilla de verificación para mostrar el valor de la métrica en negrita. | |*Color* |Seleccione el color del valor de la métrica en el selector de color.<br>`D` significa color predeterminado (depende del tema de la interfaz). Para volver al valor predeterminado, haga clic en el botón *Usar valor predeterminado* en el selector de color. | |***Unidades***|<| |*Unidades* |Marque la casilla de verificación para mostrar las unidades con el valor de la métrica. Si ingresa un nombre de unidad, anulará la unidad de la configuración de la métrica. | |*Posición* |Seleccione la posición de la unidad de la métrica: arriba, abajo, antes o después del valor. | |*Tamaño* |Ingrese la altura del tamaño de fuente para la unidad de la métrica (en porcentaje relativo a la altura total del widget). | |*Negrita* |Marque la casilla de verificación para mostrar la unidad de la métrica en negrita. | |*Color* |Seleccione el color de la unidad de la métrica en el selector de color.<br>`D` significa color predeterminado (depende del tema de la interfaz). Para volver al valor predeterminado, haga clic en el botón *Usar valor predeterminado* en el selector de color. | |***Hora*** *(valor del reloj del historial de la métrica)*|<| |*Posición horizontal* |Seleccione la posición horizontal de la hora: izquierda, derecha o centro. | |*Posición vertical* |Seleccione la posición vertical de la hora: superior, inferior o media. | |*Tamaño* |Ingrese la altura del tamaño de fuente para el momento (en porcentaje relativo a la altura total del widget). | |*Negrita* |Marque la casilla de verificación para mostrar la hora en negrita. | |*Color* |Seleccione el color de tiempo en el selector de color.<br>`D` significa color predeterminado (depende del tema de la interfaz). Para volver al valor predeterminado, haga clic en el botón *Usar valor predeterminado* en el selector de color. | |***Indicador de cambio***|Seleccione el color de los indicadores de cambio en el selector de color. Los indicadores de cambio son los siguientes:<br>** ↑** - el valor de la métrica ha aumentado (para métricas numéricas)<br>**↓** - el valor de la métrica ha disminuido (para métricas numéricas)<br>**↕* * - el valor de la métrica ha cambiado (para métricas de cadena y métricas con asignación de valor)<br>`D` significa color predeterminado (depende del tema de la interfaz). Para volver al valor predeterminado, haga clic en el botón *Usar valor predeterminado* en el selector de color.<br>El tamaño vertical del indicador de cambio es igual al tamaño del valor (parte entera del valor para elementos numéricos).<br> Tenga en cuenta que los indicadores hacia arriba y hacia abajo no se muestran con un solo valor. | |***Color de fondo***|Seleccione el color de fondo para todo el widget desde el selector de color.<br>`D` significa color predeterminado (depende del tema de la interfaz). Para volver al valor predeterminado, haga clic en el botón *Usar valor predeterminado* en el selector de color. | |***Umbrales***|Configure el color de fondo dinámico para todo el widget. Haga clic en *Agregar* para agregar un umbral, seleccione el color de fondo en el selector de color y especifique un valor numérico. Una vez que el valor de la métrica sea igual o mayor que el valor umbral, el color de fondo cambiará.<br>La lista se ordenará en orden ascendente cuando se guarde. <br> Tenga en cuenta que el color de fondo dinámico se mostrará correctamente sólo para métricas numéricas.| |***Función de agregación***|Especifique qué función de agregación usar:<br>**min** - muestra el valor más pequeño;<br>**max** - muestra el valor más grande;<br>** avg** - muestra el valor promedio;<br>**count** - muestra el recuento de valores;<br>**sum** - muestra la suma de valores;<br>**first** - muestra el primer valor;<br>**last**: muestra el último valor;<br>**not used**: muestra el valor más reciente (sin agregación).<br><br>La agregación permite mostrar un valor agregado para el intervalo elegido (5 minutos, una hora, un día), en lugar del valor más reciente.<br>Solo se pueden mostrar datos numéricos para *min*, *max*, *avg* y *sum*. Para *count*, los datos no numéricos se cambiarán a numéricos.| |***Período de tiempo***|Especifique el período de tiempo que se usará para agregar valores:<br>**tablero**: use el período de tiempo del tablero;<br>**Widget**: usa el período de tiempo del widget especificado;<br>**Personalizado**: usa un período de tiempo personalizado.<br><Este parámetro no se mostrará si la *Función de agregación* está establecido en "no utilizado". | |*Widget*|Seleccione el widget.<br>Este parámetro solo se mostrará si *Período de tiempo* está configurado en "Widget".| |*Desde*|Seleccione el período de tiempo desde (valor predeterminado `now-1h` ). Consulte [sintaxis de tiempo relativa](/manual/web_interface/time_period_selector).<br>Este parámetro solo se mostrará si *Período de tiempo* está configurado en "Personalizado".| |*Hasta*|Seleccione el período de tiempo en (valor predeterminado "ahora"). Consulte [sintaxis de tiempo relativa](/manual/web_interface/time_period_selector).<br>Este parámetro solo se mostrará si *Período de tiempo* está configurado en "Personalizado".| |***Datos del historial***|Tomar datos de historial o tendencias:<br>**Auto** - selección automática;<br>**History** - tomar datos del historial;<br>**Trends** - tomar datos de tendencias.<br><br>Esta configuración se aplica sólo a datos numéricos. Los datos no numéricos siempre se tomarán del histórico.|  Tenga en cuenta que varios elementos no pueden ocupar el mismo espacio; si se colocan en el mismo espacio, se mostrará un mensaje de error.

en-us	##### Advanced configuration  Advanced configuration options are available in the collapsible *Advanced configuration* section:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/gauge_advanced_configuration.png){width="600"}  |   |   | |--|--------| |*Angle*|Select the gauge angle (180° or 270°).| |***Description***|<| |*Description*|Enter the item description. This description may override the default item name.<br>Multiline descriptions are supported. A combination of text and supported macros is possible.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} and user macros are supported.| |*Size*|Enter the font size height for the item description (in percent, relative to the total widget height).| |*Vertical position*|Select the vertical position of the item description (top or bottom, relative to the gauge arc).| |*Bold*|Mark the checkbox to display the item description in bold.| |*Color*|Select the item description color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Value***|<| |*Decimal places*|Enter the number of decimal places to display with the value.<br>This option affects only items that return [numeric (float)](/manual/config/items/item#configuration) data.| |*Size*|Enter the font size height for the value (in percent, relative to the gauge arc height).| |*Bold*|Mark the checkbox to display the value in bold.| |*Color*|Select the value color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Units***|<| |*Units*|Mark the checkbox to display units with the item value.<br>If you enter a unit name, it will override the units set in the [item configuration](/manual/config/items/item#configuration).| |*Size*|Enter the font size height for the item units (in percent, relative to the gauge arc height).| |*Bold*|Mark the checkbox to display item units in bold.| |*Position*|Select the position of the item units (above, below, before or after, relative to the item value).<br>This option is ignored for the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.| |*Color*|Select the item units color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Value arc***|<| |*Arc size*|Enter the size height of the gauge value arc (in percent, relative to the gauge arc radius).| |***Needle***|<| |*Color*|Select the gauge needle color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. If *Thresholds* are set, the default color for the needle depends on the threshold color. To return to the default color, click the *Use default* button in the color picker.| |***Scale***|<| |*Show units*|Mark the checkbox to display units with the minimum and maximum value of the gauge.| |*Size*|Enter the font size height for the minimum and maximum value of the gauge (in percent, relative to the gauge arc height).| |*Decimal places*|Enter the number of decimal places to display with the minimum and maximum value of the gauge.<br>This option affects only items that return [numeric (float)](/manual/config/items/item#configuration) data.| |***Thresholds***|<| |*Thresholds*|Click *Add* to add a threshold, select a threshold color from the color picker, and specify a numeric value.<br>The thresholds list will be sorted in ascending order when saved.<br>Note that the colors configured as thresholds will be displayed correctly only for numeric items.<br>[Suffixes](/manual/appendix/suffixes) (for example, "1d", "2w", "4K", "8G") are supported. [Value mappings](/manual/config/items/mapping) are supported.| |*Show labels*|Mark the checkbox to display threshold values as labels on the gauge scale.| |*Show arc*|Mark the checkbox to display the gauge thresholds arc.| |*Arc size*|Enter the size height of the gauge thresholds arc (in percent, relative to the gauge arc radius).|
es	##### Configuración avanzada  Las opciones de configuración avanzada están disponibles en la sección plegable *Configuración avanzada*:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/gauge_advanced_configuration.png){width="600"}  |   |   | |--|--------| |*Ángulo*|Seleccione el ángulo de calibre (180° o 270°).| |***Descripción***|<| |*Descripción*|Ingrese la descripción de la métrica. Esta descripción puede reemplazar el nombre predeterminado de la métrica.<br>Se admiten descripciones de varias líneas. Es posible una combinación de texto y macros compatibles.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} y macros de usuario son compatibles.| |*Tamaño*|Ingrese la altura del tamaño de fuente para la descripción de la métrica (en porcentaje, en relación con la altura total del widget).| |*Posición vertical*|Seleccione la posición vertical de la descripción de la métrica (arriba o abajo, en relación con el arco del indicador).| |*Negrita*|Marque la casilla de verificación para mostrar la descripción de la métrica en negrita.| |*Color*|Seleccione el color de descripción de la métrica en el selector de color.<br>"D" representa el color predeterminado, que depende del tema de la interfaz. Para volver al color predeterminado, haga clic en el botón *Usar predeterminado* en el selector de color.| |***Valor***|<| |*Lugares decimales*|Ingrese el número de decimales que se mostrarán con el valor.<br>Esta opción afecta solo a las métricas que devuelven datos [numéricos (flotantes)](/manual/config/items/item#configuración).| |*Tamaño*|Ingrese la altura del tamaño de fuente para el valor (en porcentaje, en relación con la altura del arco indicador).| |*Negrita*|Marque la casilla de verificación para mostrar el valor en negrita.| |*Color*|Seleccione el color del valor en el selector de color.<br>"D" representa el color predeterminado, que depende del tema de la interfaz. Para volver al color predeterminado, haga clic en el botón *Usar predeterminado* en el selector de color.| |***Unidades***|<| |*Unidades*|Marque la casilla de verificación para mostrar las unidades con el valor del artículo.<br>Si ingresa un nombre de unidad, anulará las unidades establecidas en la [configuración del artículo](/manual/config/items/item#configuración) .| |*Tamaño*|Ingrese la altura del tamaño de fuente para las unidades de la métrica (en porcentaje, en relación con la altura del arco del indicador).| |*Negrita*|Marque la casilla de verificación para mostrar las unidades de las métricas en negrita.| |*Posición*|Seleccione la posición de las unidades de la métrica (arriba, abajo, antes o después, en relación con el valor de la métrica).<br>Esta opción se ignora para las siguientes [unidades relacionadas con el tiempo](/manual/config/ items/item#configuración): unixtime, uptime, s.| |*Color*|Seleccione el color de las unidades de la métrica en el selector de color.<br>"D" representa el color predeterminado, que depende del tema de la interfaz. Para volver al color predeterminado, haga clic en el botón *Usar predeterminado* en el selector de color.| |***Arco de valores***|<| |*Tamaño del arco*|Ingrese el tamaño de la altura del arco del valor del calibre (en porcentaje, en relación con el radio del arco del calibre).| |***Aguja***|<| |*Color*|Seleccione el color de la aguja del calibre en el selector de color.<br>"D" representa el color predeterminado, que depende del tema de la interfaz. Si se configuran *Umbrales*, el color predeterminado de la aguja depende del color del umbral. Para volver al color predeterminado, haga clic en el botón *Usar predeterminado* en el selector de color.| |***Escala***|<| |*Mostrar unidades*|Marque la casilla de verificación para mostrar las unidades con el valor mínimo y máximo del indicador.| |*Tamaño*|Ingrese la altura del tamaño de fuente para el valor mínimo y máximo del calibre (en porcentaje, en relación con la altura del arco del calibre).| |*Lugares decimales*|Ingrese el número de decimales que se mostrarán con el valor mínimo y máximo del indicador.<br>Esta opción afecta solo a las métricas que devuelven valores [numéricos (flotante)](/manual/config/items/item#configuración) datos.| |***Umbrales***|<| |*Umbrales*|Haga clic en *Agregar* para agregar un umbral, seleccione un color de umbral en el selector de color y especifique un valor numérico.<br>La lista de umbrales se ordenará en orden ascendente cuando se guarde.<br>Tenga en cuenta que el los colores configurados como umbrales se mostrarán correctamente solo para elementos numéricos.<br>Se admiten [Sufijos](/manual/appendix/suffixes) (por ejemplo, "1d", "2w", "4K", "8G"). Se admiten [asignaciones de valores](/manual/config/items/mapping).| |*Mostrar etiquetas*|Marque la casilla de verificación para mostrar los valores de umbral como etiquetas en la escala del medidor.| |*Mostrar arco*|Marque la casilla de verificación para mostrar el arco de umbrales de calibre.| |*Tamaño del arco*|Ingrese el tamaño de la altura del arco de los umbrales del indicador (en porcentaje, en relación con el radio del arco del indicador).|

en-us	#### Advanced configuration  Advanced configuration options are available in the collapsible *Advanced configuration* section:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/item_history_advanced_configuration.png)  |   |   | |--|--------| |*New values*|Select where new item values should be added:<br>**Top** - at the top of columns;<br>**Bottom** - at the bottom of columns.| |*Show timestamp*|Mark this checkbox to display the timestamp column (unmarked by default).| |*Show column header*|Select the column header orientation:<br>**Off** - hide the header;<br>**Horizontal** - display the header horizontally;<br>**Vertical** - display the header vertically.| |[*Time period*](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters)|Select the data source for the time period:<br>**Dashboard** - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>**Widget** - set a compatible widget specified in the *Widget* parameter as the data source;<br>**Custom** - set the time period specified in the *From* and *To* parameters as the data source; if set, a clock icon will be displayed in the top right corner of the widget, indicating the set time on mouseover.| |*Widget*|Enter or select a compatible widget (*Graph*, *Graph (classic)*, *Graph prototype*) as the data source for the time period.<br>This parameter is available if *Time period* is set to "Widget".| |*From*|Enter or select the start of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*To*|Enter or select the end of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".|
es	#### Configuración avanzada  Las opciones de configuración avanzada están disponibles en la sección plegable *Configuración avanzada*:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/item_history_advanced_configuration.png)  |   |   | |--|--------| |*Nuevos valores*|Seleccione dónde se deben agregar nuevos valores de métricas:<br>**Arriba** - en la parte superior de las columnas;<br>**Abajo** - en la parte inferior de las columnas.| |*Mostrar marca de tiempo*|Marque esta casilla de verificación para mostrar la columna de marca de tiempo (sin marcar de forma predeterminada).| |*Mostrar encabezado de columna*|Seleccione la orientación del encabezado de columna:<br>**Desactivado**: ocultar el encabezado;<br>**Horizontal**: mostrar el encabezado horizontalmente;<br>**Vertical**: mostrar el encabezado verticalmente.| |[*Período de tiempo*](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters)|Seleccione la fuente de datos para el período de tiempo:<br>**Tablero**: configure el selector [*Período de tiempo* ](/manual/web_interface/time_period_selector) como origen de datos;<br>**Widget**: establece un widget compatible especificado en el parámetro *Widget* como origen de datos;<br>**Personalizado**: establece el período de tiempo especificado en los parámetros *Desde* y *Hasta* como fuente de datos; si está configurado, se mostrará un ícono de reloj en la esquina superior derecha del widget, indicando la hora configurada al pasar el mouse.| |*Widget*|Ingrese o seleccione un widget compatible (*Gráfico*, *Gráfico (clásico)*, *Prototipo de gráfico*) como origen de datos para el período de tiempo.<br>Este parámetro está disponible si *Período de tiempo* es establecido en "Widget".| |*Desde*|Ingrese o seleccione el inicio del período de tiempo.<br>[Sintaxis de tiempo relativo](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) es compatible.<br>Este parámetro está disponible si *Período de tiempo* está configurado en "Personalizado".| |*Hasta*|Ingrese o seleccione el final del período de tiempo.<br>[Sintaxis de tiempo relativo](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) es compatible.<br>Este parámetro está disponible si *Período de tiempo* está configurado en "Personalizado".|

en-us	 #### Advanced configuration  ![](../../../assets/en/manual/web_interface/service_a.png){width=600}  |Parameter|Description| |--|--------| |_**Additional rules**_|Click on *Add* to configure additional status calculation rules.| |*Set status to*|Set service status to either *OK* (default), *Not classified*, *Information*, *Warning*, *Average*, *High* or *Disaster* in case of a condition match.| |*Condition*|Select the condition for direct child services:<br>**if at least (N) child services have (Status) status or above**<br>**if at least (N%) of child services have (Status) status or above**<br>**if less than (N) child services have (Status) status or below**<br>**if less than (N%) of child services have (Status) status or below**<br>**if weight of child services with (Status) status or above is at least (W)**<br>**if weight of child services with (Status) status or above is at least (N%)**<br>**if weight of child services with (Status) status or below is less than (W)**<br>**if weight of child services with (Status) status or below is less than (N%)** <br><br> If several conditions are specified and the situation matches more than one condition, the highest severity will be set.| |*N (W)*|Set the value of N or W (1-100000), or N% (1-100) in the condition.| |*Status*|Select the value of *Status* in the condition: *OK* (default), *Not classified*, *Information*, *Warning*, *Average*, *High* or *Disaster*.| |_**Status propagation rule**_|Rule for propagating the service status to the parent service:<br>**As is** - the status is propagated without change<br>**Increase by** - you may increase the propagated status by 1 to 5 severities<br>**Decrease by** - you may decrease the propagated status by 1 to 5 severities<br>**Ignore this service** - the status is not propagated to the parent service at all<br>**Fixed status** - the status is propagated statically, i.e. as always the same| |_**Weight**_|Weight of the service (integer in the range from 0 (default) to 1000000).|  :::noteclassic Additional status calculation rules can only be used to increase severity level over the level calculated according to the main *Status calculation rule* parameter. If according to additional rules the status should be Warning, but according to the *Status calculation rule* the status is Disaster - the service will have status Disaster.  :::
es	 #### Configuración avanzada  ![](../../../assets/en/manual/web_interface/service_a.png){width=600}  |Parámetro|Descripción| |--|--------| |_**Reglas adicionales**_|Haga clic en *Agregar* para configurar reglas de cálculo de estado adicionales.| |*Establecer estado en*|Establezca el estado del servicio en *OK* (predeterminado), *No clasificado*, *Información*, *Advertencia*, *Promedio*, *Alto* o *Desastre* en caso de que coincida una condición. | |*Condición*|Seleccione la condición para servicios infantiles directos:<br>**si al menos (N) servicios infantiles tienen estado (Estado) o superior**<br>**si al menos (N%) de servicios infantiles tienen estado (Estado) o superior**<br>**si menos de (N) servicios infantiles tienen estado (Estado) o inferior**<br>**si menos de (N%) de servicios infantiles tienen (Estado) o inferior**<br>**si el peso de los servicios para niños con estado (Estado) o superior es al menos (W)**<br>**si el peso de los servicios para niños con estado (Estado) o superior es al menos (N%)**<br>**si el peso de los servicios para niños con estado (Estado) o inferior es menor que (W)**<br>**si el peso de los servicios para niños con estado (Estado) o inferior es menor que (N%)** <br><br> Si se especifican varias condiciones y la situación coincide con más de una condición, se establecerá la gravedad más alta.| |*N (W)*|Establezca el valor de N o W (1-100000), o N% (1-100) en la condición.| |*Estado*|Seleccione el valor de *Estado* en la condición: *OK* (predeterminado), *No clasificado*, *Información*, *Advertencia*, *Promedio*, *Alto* o *Desastre*.| |_**Regla de propagación de estado**_|Regla para propagar el estado del servicio al servicio principal:<br>**Tal como está**: el estado se propaga sin cambios<br>**Aumentar en**: puede aumentar el estado propagado de 1 a 5 niveles de gravedad<br>**Disminuir en**: puede disminuir el estado propagado de 1 a 5 niveles de gravedad<br>**Ignorar este servicio**: el estado no se propaga al servicio principal en absoluto<br>**Estado fijo** - el estado se propaga estáticamente, es decir, como siempre el mismo| |_**Peso**_|Peso del servicio (entero en el rango de 0 (predeterminado) a 1000000).|  :::noteclassic Las reglas de cálculo de estado adicionales solo se pueden utilizar para aumentar el nivel de gravedad por encima del nivel calculado según el parámetro principal *Regla de cálculo de estado*. Si según reglas adicionales el estado debería ser Advertencia, pero según la *regla de cálculo de estado* el estado es Desastre - el servicio tendrá estado Desastre.  :::

en-us	#### Advanced configuration  The following advanced configuration parameters are supported for the *Gauge* widget.  ::: noteclassic The number in the *Thresholds* property name (e.g. thresholds.0.color) references the threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). :::  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Angle*|0|angle|Possible values: 180 *(default)* or 270.| |***Description***|<|<|<| |*Description*|1|description|Any string value, including macros.<br>Supported macros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, user macros.<br><br>Default: {ITEM.NAME}.| |*Size*|0|desc_size|Possible values range from 1-100.<br><br>Default: 15.| |*Vertical position*|0|desc_v_pos|0 - Top;<br>1 - *(default)* Bottom.| |*Bold*|0|desc_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|desc_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |***Value***|<|<|<| |*Decimal places*|0|decimal_places|Possible values range from 1-10.<br><br>Default: 2.| |*Size*|0|value_size|Possible values range from 1-100.<br><br>Default: 25.| |*Bold*|0|value_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|value_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |***Units***|<|<|<| |*Units* (checkbox)|0|units_show|0 - Disabled;<br>1 - *(default)* Enabled.| |*Units* (value)|1|units|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"| |*Size*|0|units_size|Possible values range from 1-100.<br><br>Default: 25.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"| |*Bold*|0|units_bold|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"| |*Position*|0|units_pos|0 - Before value;<br>1 - Above value;<br>2 - *(default)* After value;<br>3 - Below value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"<br><br>This parameter is ignored if set to one of the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.| |*Color*|1|units_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |***Value arc***|<|<|<| |*Arc size*|0|value_arc_size|Possible values range from 1-100.<br><br>Default: 20.| |***Needle***|<|<|<| |*Color*|1|needle_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if a dashboard widget field object for *Show* with the value "Value arc" is set, or *Show arc* is set to "Enabled"| |***Scale***|<|<|<| |*Show units*|0|scale_show_units|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled" and either a dashboard widget field object for *Show* with the value "Value arc" is set, or *Show arc* is set to "Enabled"| |*Size*|0|scale_size|Possible values range from 1-100.<br><br>Default: 15.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if a dashboard widget field object for *Show* with the value "Value arc" is set, or *Show arc* is set to "Enabled"| |*Decimal places*|0|scale_decimal_places|Possible values range from 1-10.<br><br>Default: 0.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if a dashboard widget field object for *Show* with the value "Value arc" is set, or *Show arc* is set to "Enabled"| |***Thresholds***|<|<|<| |*Color*|1|thresholds.0.color|Hexadecimal color code (e.g. `FF0000`).| |*Threshold*|1|thresholds.0.threshold|Any numeric value. [Suffixes](/manual/appendix/suffixes) (e.g. "1d", "2w", "4K", "8G") are supported.| |*Show labels*|0|th_show_labels|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Thresholds* are set and either a dashboard widget field object for *Show* with the value "Value arc" is set or *Show arc* is set to "Enabled"| |*Show arc*|0|th_show_arc|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Thresholds* are set| |*Arc size*|0|th_arc_size|Possible values range from 1-100.<br><br>Default: 5.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show arc* is set to "Enabled"|
es	#### Configuración avanzada  Los siguientes parámetros de configuración avanzada son compatibles con el widget *Gauge*.  ::: noteclassic El número en el nombre de la propiedad *Thresholds* (por ejemplo, thresholds.0.color) hace referencia al lugar del threshold en una lista, ordenada en orden ascendente. Sin embargo, si los thresholds se configuran en un orden diferente, los valores se ordenarán en orden ascendente después de actualizar la configuración del widget en la interfaz de Zabbix. (por ejemplo, `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1. threshold": "5"`). :::  |Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor| |-----|-|-----|-------------------| |*Ángulo*|0|angle|Valores posibles: 180 *(predeterminado)* o 270.| |***Descripción***|<|<|<| |*Descripción*|1|description|Cualquier valor de cadena, incluidas las macros.<br>Macros admitidas: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macros de usuario.<br>< br>Predeterminado: {ITEM.NAME}.| |*Tamaño*|0|desc_size|Los valores posibles oscilan entre 1 y 100.<br><br>Predeterminado: 15.| |*Posición vertical*|0|desc_v_pos|0 - Arriba;<br>1 - *(predeterminado)* Abajo.| |*Negrita*|0|desc_bold|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.| |*Color*|1|desc_color|Código de color hexadecimal (por ejemplo, `FF0000`).<br><br>Predeterminado: `""` (vacío).| |***Valor***|<|<|<| |*Lugares decimales*|0|decimal_places|Los valores posibles van del 1 al 10.<br><br>Predeterminado: 2.| |*Tamaño*|0|value_size|Los valores posibles oscilan entre 1 y 100.<br><br>Predeterminado: 25.| |*Negrita*|0|value_bold|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.| |*Color*|1|value_color|Código de color hexadecimal (por ejemplo, `FF0000`).<br><br>Predeterminado: `""` (vacío).| |***Unidades***|<|<|<| |*Unidades* (casilla de verificación)|0|units_show|0 - Deshabilitado;<br>1 - *(predeterminado)* Habilitado.| |*Unidades* (valor)|1|units|Cualquier valor de cadena.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *compatible* si *Unidades* (casilla de verificación) está configurada en "Activado"| |*Tamaño*|0|units_size|Los valores posibles oscilan entre 1 y 100.<br><br>Predeterminado: 25.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior): <br>- *compatible* si *Unidades* (casilla de verificación) está configurada en "Habilitado"| |*Negrita*|0|units_bold|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):<br >- *compatible* si *Unidades* (casilla de verificación) está configurada en "Activado"| |*Posición*|0|units_pos|0 - Antes del valor;<br>1 - Por encima del valor;<br>2 - *(predeterminado)* Después del valor;<br>3 - Por debajo del valor.<br><br>[ Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *compatible* si *Unidades* (casilla de verificación) está configurada en "Habilitado"<br><br>Este parámetro se ignora si se establece en uno de las siguientes [unidades relacionadas con el tiempo](/manual/config/items/item#configuration): unixtime, uptime, s.| |*Color*|1|units_color|Código de color hexadecimal (por ejemplo, `FF0000`).<br><br>Predeterminado: `""` (vacío).| |***Arco de valores***|<|<|<| |*Tamaño del arco*|0|value_arc_size|Los valores posibles oscilan entre 1 y 100.<br><br>Predeterminado: 20.| |***Aguja***|<|<|<| |*Color*|1|needle_color|Código de color hexadecimal (por ejemplo, `FF0000`).<br><br>Predeterminado: `""` (vacío).<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):<br>- *compatible* si se establece un objeto de campo de widget de tablero para *Mostrar* con el valor "Arco de valor", o *Mostrar arco* está configurado en "Habilitado"| |***Escala***|<|<|<| |*Mostrar unidades*|0|scale_show_units|0 - Deshabilitado;<br>1 - *(predeterminado)* Habilitado.<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):< br>- *compatible* si *Unidades* (casilla de verificación) está configurado en "Habilitado" y un objeto de campo de widget de tablero para *Mostrar* con el valor "Arco de valor" está configurado, o *Mostrar arco* está configurado en "Habilitado" "| |*Tamaño*|0|scale_size|Los valores posibles oscilan entre 1 y 100.<br><br>Predeterminado: 15.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior): <br>- *compatible* si se establece un objeto de campo de widget de tablero para *Mostrar* con el valor "Arco de valor", o *Mostrar arco* está configurado en "Habilitado"| |*Lugares decimales*|0|scale_decimal_places|Los valores posibles oscilan entre 1 y 10.<br><br>Valor predeterminado: 0.<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior) :<br>- *compatible* si se establece un objeto de campo de widget de tablero para *Mostrar* con el valor "Arco de valor", o *Mostrar arco* está configurado en "Habilitado"| |***Umbrales***|<|<|<| |*Color*|1|thresholds.0.color|Código de color hexadecimal (por ejemplo, `FF0000`).| |*Umbral*|1|thresholds.0.threshold|Cualquier valor numérico. Se admiten [Sufijos](/manual/appendix/suffixes) (por ejemplo, "1d", "2w", "4K", "8G").| |*Mostrar etiquetas*|0|th_show_labels|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):< br>- *compatible* si se establecen *Umbrales* y se establece un objeto de campo de widget de tablero para *Mostrar* con el valor "Arco de valor" o *Mostrar arco* está configurado en "Habilitado"| |*Mostrar arco*|0|th_show_arc|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):< br>- *compatible* si se establecen *Umbrales*| |*Tamaño del arco*|0|th_arc_size|Los valores posibles oscilan entre 1 y 100.<br><br>Valor predeterminado: 5.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior) :<br>- *compatible* si *Mostrar arco* está configurado en "Activado"|

en-us	#### Advanced configuration  The following advanced configuration parameters are supported for the *Honeycomb* widget.  ::: noteclassic The number in the *Thresholds* property name (e.g. thresholds.0.color) references the threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). :::  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |***Primary label***|<|<|<| |*Type*|0|primary_label_type|0 - *(default)* Text;<br>1 - Value.| |*Text*|1|primary_label|Any string value, including macros.<br>Supported macros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, user macros.<br><br>Default: {HOST.NAME}<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Text"| |*Decimal places*|0|primary_label_decimal_places|Possible values range from 0-6.<br><br>Default: 2.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value"| |*Size* (type)|0|primary_label_size_type|0 - *(default)* Auto;<br>1 - Custom.| |*Size*|0|primary_label_size|Possible values range from 1-100.<br><br>Default: 20.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Size* (type) is set to "Custom"| |*Bold*|0|primary_label_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|primary_label_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: based on `theme` of [Settings object](/manual/api/reference/settings/object#settings) and [User object](/manual/api/reference/user/object#user):<br>`1F2C33` for "blue-theme" or "hc-light";<br>`EEEEEE` for "dark-theme" or "hc-dark".| |*Units* (checkbox)|0|primary_label_units_show|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value"| |*Units* (value)|1|primary_label_units|Any string value.<br><br>`""` (empty)<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value" and *Units* (checkbox) is set to "Enabled"| |*Position*|0|primary_label_units_pos|0 - Before value;<br>1 - *(default)* After value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value" and *Units* (checkbox) is set to "Enabled"<br><br>This parameter is ignored if set to one of the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.| |***Secondary label***|<|<|<| |*Type*|0|secondary_label_type|0 - Text;<br>1 - *(default)* Value.| |*Text*|1|secondary_label|Any string value, including macros.<br>Supported macros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, user macros.<br><br>Default: {{ITEM.LASTVALUE}.fmtnum(2)}<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Text"| |*Decimal places*|0|secondary_label_decimal_places|Possible values range from 0-6.<br><br>Default: 2.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value"| |*Size* (type)|0|secondary_label_size_type|0 - *(default)* Auto;<br>1 - Custom.| |*Size*|0|secondary_label_size|Possible values range from 1-100.<br><br>Default: 30.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Size* (type) is set to "Custom"| |*Bold*|0|secondary_label_bold|0 - Disabled;<br>1 - *(default)* Enabled.| |*Color*|1|secondary_label_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: based on `theme` of [Settings object](/manual/api/reference/settings/object#settings) and [User object](/manual/api/reference/user/object#user):<br>`1F2C33` for "blue-theme" or "hc-light";<br>`EEEEEE` for "dark-theme" or "hc-dark".| |*Units* (checkbox)|0|secondary_label_units_show|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value"| |*Units* (value)|1|secondary_label_units|Any string value.<br><br>`""` (empty)<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value" and *Units* (checkbox) is set to "Enabled"| |*Position*|0|secondary_label_position|0 - Before value;<br>1 - *(default)* After value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value" and *Units* (checkbox) is set to "Enabled"<br><br>This parameter is ignored if set to one of the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.| |***Background color***|<|<|<| |*Background color*|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: based on `theme` of [Settings object](/manual/api/reference/settings/object#settings) and [User object](/manual/api/reference/user/object#user):<br>`D9E7ED` for "blue-theme";<br>`3D5059` for "dark-theme";<br>`AAD7E9` for "hc-light";<br>`335463` for "hc-dark".| |***Thresholds***|<|<|<| |*Color interpolation*|0|interpolation|0 - Disabled;<br>1 - *(default)* Enabled.| |*Color*|1|thresholds.0.color|Hexadecimal color code (e.g. `FF0000`).| |*Threshold*|1|thresholds.0.threshold|Any numeric value. [Suffixes](/manual/appendix/suffixes) (e.g. "1d", "2w", "4K", "8G") are supported.|
es	#### Configuración avanzada  Los siguientes parámetros de configuración avanzada son compatibles con el widget *Panel*.  ::: noteclassic El número en el nombre de la propiedad *Thresholds* (por ejemplo, thresholds.0.color) hace referencia al lugar del threshold en una lista, ordenada en orden ascendente. Sin embargo, si los umbrales se configuran en un orden diferente, los valores se ordenarán en orden ascendente después de actualizar la configuración del widget en la interfaz de Zabbix. (por ejemplo, `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). :::  |Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor| |-----|-|-----|-------------------| |***Etiqueta principal***|<|<|<| |*Tipo*|0|primary_label_type|0 - *(predeterminado)* Texto;<br>1 - Valor.| |*Texto*|1|primary_label|Cualquier valor de cadena, incluidas las macros.<br>Macros admitidas: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macros de usuario.<br>< br>Predeterminado: {HOST.NAME}<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *compatible* si *Tipo* está configurado en "Texto"| |*Lugares decimales*|0|primary_label_decimal_places|Los valores posibles oscilan entre 0 y 6.<br><br>Predeterminado: 2.<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior) :<br>- *compatible* si *Tipo* está establecido en "Valor"| |*Tamaño* (tipo)|0|primary_label_size_type|0 - *(predeterminado)* Automático;<br>1 - Personalizado.| |*Tamaño*|0|primary_label_size|Los valores posibles oscilan entre 1 y 100.<br><br>Valor predeterminado: 20.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior): <br>- *compatible* si *Tamaño* (tipo) está configurado en "Personalizado"| |*Negrita*|0|primary_label_bold|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.| |*Color*|1|primary_label_color|Código de color hexadecimal (por ejemplo, `FF0000`).<br><br>Predeterminado: basado en el `tema` de [Objeto de configuración](/manual/api/reference/settings/object#settings ) y [Objeto de usuario](/manual/api/reference/user/object#user):<br>`1F2C33` para "tema azul" o "hc-light";<br>`EEEEEE` para "tema oscuro" tema" o "hc-dark".| |*Unidades* (casilla de verificación)|0|primary_label_units_show|0 - Deshabilitado;<br>1 - *(predeterminado)* Habilitado.<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior) :<br>- *compatible* si *Tipo* está establecido en "Valor"| |*Unidades* (valor)|1|primary_label_units|Cualquier valor de cadena.<br><br>`""` (vacío)<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior ):<br>- *compatible* si *Tipo* está configurado en "Valor" y *Unidades* (casilla de verificación) está configurado en "Habilitado"| |*Posición*|0|primary_label_units_pos|0 - Antes del valor;<br>1 - *(predeterminado)* Después del valor.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior): <br>- *compatible* si *Tipo* está establecido en "Valor" y *Unidades* (casilla de verificación) está establecido en "Habilitado"<br><br>Este parámetro se ignora si se establece en uno de los siguientes [tiempo- unidades relacionadas](/manual/config/items/item#configuration): unixtime, uptime, s.| |***Etiqueta secundaria***|<|<|<| |*Tipo*|0|secondary_label_type|0 - Texto;<br>1 - *(predeterminado)* Valor.| |*Texto*|1|secondary_label|Cualquier valor de cadena, incluidas las macros.<br>Macros admitidas: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macros de usuario.<br>< br>Predeterminado: {{ITEM.LASTVALUE}.fmtnum(2)}<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *compatible* si *Tipo* está configurado en "Texto"| |*Lugares decimales*|0|secondary_label_decimal_places|Los valores posibles oscilan entre 0 y 6.<br><br>Predeterminado: 2.<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior) :<br>- *compatible* si *Tipo* está establecido en "Valor"| |*Tamaño* (tipo)|0|secondary_label_size_type|0 - *(predeterminado)* Automático;<br>1 - Personalizado.| |*Tamaño*|0|secondary_label_size|Los valores posibles oscilan entre 1 y 100.<br><br>Predeterminado: 30.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior): <br>- *compatible* si *Tamaño* (tipo) está configurado en "Personalizado"| |*Negrita*|0|secondary_label_bold|0 - Deshabilitado;<br>1 - *(predeterminado)* Habilitado.| |*Color*|1|secondary_label_color|Código de color hexadecimal (por ejemplo, `FF0000`).<br><br>Predeterminado: basado en el `tema` de [Objeto de configuración](/manual/api/reference/settings/object#settings ) y [Objeto de usuario](/manual/api/reference/user/object#user):<br>`1F2C33` para "tema azul" o "hc-light";<br>`EEEEEE` para "tema oscuro" tema" o "hc-dark".| |*Unidades* (casilla de verificación)|0|secondary_label_units_show|0 - Deshabilitado;<br>1 - *(predeterminado)* Habilitado.<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior) :<br>- *compatible* si *Tipo* está establecido en "Valor"| |*Unidades* (valor)|1|secondary_label_units|Cualquier valor de cadena.<br><br>`""` (vacío)<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior ):<br>- *compatible* si *Tipo* está configurado en "Valor" y *Unidades* (casilla de verificación) está configurado en "Habilitado"| |*Posición*|0|secondary_label_position|0 - Antes del valor;<br>1 - *(predeterminado)* Después del valor.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior): <br>- *compatible* si *Tipo* está establecido en "Valor" y *Unidades* (casilla de verificación) está establecido en "Habilitado"<br><br>Este parámetro se ignora si se establece en una de las siguientes [unidades de tiempo relacionadas](/manual/config/items/item#configuration): unixtime, uptime, s.| |***Color de fondo***|<|<|<| |*Color de fondo*|1|bg_color|Código de color hexadecimal (por ejemplo, `FF0000`).<br><br>Predeterminado: basado en el `tema` de [Objeto de configuración](/manual/api/reference/settings/object# configuración) y [Objeto de usuario](/manual/api/reference/user/object#user):<br>`D9E7ED` para "tema azul";<br>`3D5059` para "tema oscuro";<br >`AAD7E9` para "hc-light";<br>`335463` para "hc-dark".| |***Umbrales***|<|<|<| |*Interpolación de color*|0|interpolation|0 - Deshabilitado;<br>1 - *(predeterminado)* Habilitado.| |*Color*|1|thresholds.0.color|Código de color hexadecimal (por ejemplo, `FF0000`).| |*Umbral*|1|thresholds.0.threshold|Cualquier valor numérico. Se admiten [Sufijos](/manual/appendix/suffixes) (por ejemplo, "1d", "2w", "4K", "8G").|

en-us	#### Advanced configuration  The following advanced configuration parameters are supported for the *Item history* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*New values*|<|0|sortorder|0 - *(default)* Top;<br>1 - Bottom.| |*Show timestamp*|<|0|show_timestamp|0 - *(default)* Disabled;<br>1 - Enabled.| |*Show column header*|<|0|show_column_header|0 - Off;<br>1 - Horizontal;<br>2 - *(default)* Vertical.| |*Time period*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.| |<|*From*|1|time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set| |^|*To*|1|time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set|
es	#### Configuración avanzada  Los siguientes parámetros de configuración avanzada son compatibles con el widget *Historial de métrica*.  |Parámetro|<|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor| |-|--------|--|--------|-------------------------------| |*Nuevos valores*|<|0|sortorder|0 - *(predeterminado)* Arriba;<br>1 - Abajo.| |*Mostrar marca de tiempo*|<|0|show_timestamp|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.| |*Mostrar encabezado de columna*|<|0|show_column_header|0 - Desactivado;<br>1 - Horizontal;<br>2 - *(predeterminado)* Vertical.| |*Período de tiempo*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - establece el [*selector de período de tiempo*](/manual/web_interface/time_period_selector) como fuente de datos;<br>`ABCDE._timeperiod ` - establece un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con su parámetro *Reference* establecido en "`ABCDE`") como fuente de datos.<br><br> Valor predeterminado: `DASHBOARD._timeperiod`<br><br>Alternativamente, puede establecer el período de tiempo solo en los parámetros *Desde* y *Hasta*.| |<|*Desde*|1|time_period.from|Cadena de tiempo válida en sintaxis de tiempo absoluta (`AAAA-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now` , `now/d`, `now/w-1w`, etc.).<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):<br>- *compatible* si *Período de tiempo* no está establecido| |^|*Hasta*|1|time_period.to|Cadena de tiempo válida en sintaxis de tiempo absoluta (`AAAA-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now` , `now/d`, `now/w-1w`, etc.).<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):<br>- *compatible* si *Período de tiempo* no está establecido|

en-us	#### Advanced configuration  The following advanced configuration parameters are supported for the *Item value* widget.  ::: noteclassic The number in the *Thresholds* property name (e.g. thresholds.0.color) references the threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). :::  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Background color*|<|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Thresholds*|<|<|<|<| |<|*Color*|1|thresholds.0.color|Hexadecimal color code (e.g. `FF0000`).| |^|*Threshold*|1|thresholds.0.threshold|Any string value.| |*Aggregation function*|<|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.| |*Time period*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its `reference` parameter equal to `ABCDE`) as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"| |<|*From*|1|time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set and *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"| |^|*To*|1|time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set and *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"| |*History data*|<|0|history|0 - *(default)* Auto;<br>1 - History;<br>2 - Trends.|
es	#### Configuración avanzada  Los siguientes parámetros de configuración avanzada son compatibles con el widget *Valor de la métrica*.  ::: noteclassic El número en el nombre de la propiedad *Thresholds* (por ejemplo, thresholds.0.color) hace referencia al lugar del umbral en una lista, ordenada en orden ascendente. Sin embargo, si los umbrales se configuran en un orden diferente, los valores se ordenarán en orden ascendente después de actualizar la configuración del widget en la interfaz de Zabbix. (por ejemplo,`"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). :::  |Parámetro|<|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor| |-|--------|--|--------|-------------------------------| |*Color de fondo*|<|1|bg_color|Código de color hexadecimal (por ejemplo, `FF0000`).<br><br>Predeterminado: `""` (vacío).| |*Umbrales*|<|<|<|<| |<|*Color*|1|thresholds.0.color|Código de color hexadecimal (por ejemplo, `FF0000`).| |^|*Umbral*|1|thresholds.0.threshold|Cualquier valor de cadena.| |*Función de agregación*|<|0|aggregate_function|0 - *(predeterminado)* no utilizado;<br>1 - min;<br>2 - max;<br>3 - promedio;<br>4 - recuento; <br>5 - suma;<br>6 - primero;<br>7 - último.| |*Período de tiempo*|<|1|time_period._reference|`DASHBOARD._timeperiod` - establece el [*selector de período de tiempo*](/manual/web_interface/time_period_selector) como fuente de datos.<br>`ABCDE._timeperiod` - establecer un widget compatible (*Graph*, *Graph (classic)* o *Graph prototipo* con su parámetro `reference` igual a `ABCDE`) como fuente de datos.<br><br>Predeterminado: `DASHBOARD._timeperiod `<br><br>Como alternativa, puede establecer el período de tiempo solo en los parámetros *Desde* y *Hasta*.<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior): <br>- *compatible* si la *Función de agregación* está configurada en "min", "max", "avg", "count", "sum", "first", "last"| |<|*Desde*|1|time_period.from|Cadena de tiempo válida en sintaxis de tiempo absoluta (`AAAA-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now` , `now/d`, `now/w-1w`, etc.).<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):<br>- *compatible* si *El período de tiempo* no está establecido y la *Función de agregación* está configurada en "min", "max", "avg", "count", "sum", "first", "last"| |^|*Hasta*|1|time_period.to|Cadena de tiempo válida en sintaxis de tiempo absoluta (`AAAA-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now` , `now/d`, `now/w-1w`, etc.).<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):<br>- *compatible* si *El período de tiempo* no está establecido y la *Función de agregación* está configurada en "min", "max", "avg", "count", "sum", "first", "last"| |*Datos del historial*|<|0|history|0 - *(predeterminado)* Auto;<br>1 - Historial;<br>2 - Tendencias.|

en-us	#### Advanced configuration  The following advanced configuration parameters are supported if *Clock type* is set to "Digital".  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Background color*|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).|
es	#### Configuración avanzada  Los siguientes parámetros de configuración avanzada son compatibles si *Tipo de reloj* está configurado en "Digital".  |Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor| |-----|-|-----|-------------------| |*Color de fondo*|1|bg_color|Código de color hexadecimal (por ejemplo, `FF0000`).<br><br>Predeterminado: `""` (vacío).|

en-us	#### Advanced extensions
es	#### Extensiones avanzadas

en-us	#### Advanced host interface configuration  The `vmware.vm.discovery[{$VMWARE.URL}]` item key, configured in the [*Create a low-level discovery rule*](#create-a-low-level-discovery-rule) section, returns network interfaces data in the ["net_if" field](/manual/vm_monitoring/discovery_fields):  ```json "net_if": [       {         "ifname": "5000",         "ifdesc": "Network adapter 1",         "ifmac": "00:11:22:33:44:55",         "ifconnected": true,         "iftype": "VirtualVmxnet3",         "ifbackingdevice": "VLAN(myLab)",         "ifdvswitch_uuid": "",         "ifdvswitch_portgroup": "",         "ifdvswitch_port": "",         "ifip": [           "127.0.0.1",           "::1"         ]       },       {         "ifname": "5001",         "ifdesc": "Network adapter 2",         "ifmac": "00:11:22:33:44:55",         "ifconnected": false,         "iftype": "VirtualVmxnet3",         "ifbackingdevice": "VLAN(myLab2)",         "ifdvswitch_uuid": "",         "ifdvswitch_portgroup": "",         "ifdvswitch_port": "",         "ifip": []       }     ] ```  This data can be used to configure a custom host interface.  1\. When [creating a low-level discovery rule](#create-a-low-level-discovery-rule), additionally configure a [low-level discovery macro](/manual/config/macros/lld_macros). In the *LLD macros* tab, create a custom LLD macro with a [JSONPath](/manual/config/items/preprocessing/jsonpath_functionality) value. For example:  - {#MYLAB.NET.IF} - `$.net_if[?(@.ifbackingdevice=="VLAN(myLab)")].ifip[0].first()`  ![](../../../assets/en/manual/vm_monitoring/vmware_lld_macro.png){width="600"}  2\. When [creating a host prototype](#create-a-host-prototype), add a custom host interface and enter the LLD macro in the *DNS name* or *IP address* field.  ![](../../../assets/en/manual/vm_monitoring/vmware_lld_macro_host_prototype.png){width="600"}
es	#### Configuración avanzada de la interfaz del equipo  La clave de métrica `vmware.vm.discovery[{$VMWARE.URL}]`, configurada en la sección [*Crear una regla de descubrimiento de bajo nivel*](#create-a-low-level-discovery-rule), devuelve datos de interfaces de red en el campo ["net_if"](/manual/vm_monitoring/discovery_fields):  ```json "net_if": [       {         "ifnombre": "5000",         "ifdesc": "Adaptador de red 1",         "ifmac": "00:11:22:33:44:55",         "si está conectado": verdadero,         "iftype": "VirtualVmxnet3",         "ifbackingdevice": "VLAN(miLab)",         "ifdvswitch_uuid": "",         "ifdvswitch_portgroup": "",         "ifdvswitch_port": "",         "ifip": [           "127.0.0.1",           "::1"         ]       },       {         "ifnombre": "5001",         "ifdesc": "Adaptador de red 2",         "ifmac": "00:11:22:33:44:55",         "si está conectado": falso,         "iftype": "VirtualVmxnet3",         "ifbackingdevice": "VLAN(myLab2)",         "ifdvswitch_uuid": "",         "ifdvswitch_portgroup": "",         "ifdvswitch_port": "",         "ifip": []       }     ] ```  Estos datos se pueden utilizar para configurar una interfaz de equipo personalizada.  1\. Al [crear una regla de descubrimiento de bajo nivel] (#crear-una-regla-de-descubrimiento-de-bajo-nivel), configure adicionalmente una [macro de descubrimiento de bajo nivel](/manual/config/macros/lld_macros). En la pestaña *Macros LLD*, cree una macro LLD personalizada con un valor [JSONPath](/manual/config/items/preprocessing/jsonpath_functionality). Por ejemplo:  - {#MYLAB.NET.IF} - `$.net_if[?(@.ifbackingdevice=="VLAN(myLab)")].ifip[0].first()`  ![](../../../assets/en/manual/vm_monitoring/vmware_lld_macro.png){width="600"}  2\. Al [crear un prototipo de equipo](#create-a-host-prototype), agrega una interfaz de equipo personalizada e ingresa la macro LLD en el campo *nombre DNS* o *dirección IP*.  ![](../../../assets/en/manual/vm_monitoring/vmware_lld_macro_host_prototype.png){width="600"}

en-us	 #### Advanced root-cause handling for unsupported item state  Error handling in case of a failure to retrieve an item value (and thus it becoming unsupported) previously lacked the ability to distinguish the reason or runtime stage where the process failed. All errors had to be handled using one and the same option for error handling - either to discard the value, set a specified value or set a specified error message.  It is now possible to match the error message to a regular expression. If the error matches (or does not match) it is possible to specify how the error case should be processed. For example, a specific error message can be "mapped" to a more general case to be matched for and handled by a further preprocessing step, or some intermittent (e.g., network connectivity) issue can be handled differently to a definite failure to acquire the item value.  Multiple *Check for not supported value* preprocessing steps can now be added. Note that there can be only one "any error" matching step at the end of the pipeline probing for unsupported state of the item. If present, it is activated if none of the specific checks (mis)matched the according pattern, or a (modified) error message was carried over - i.e., no "Discard value" or "Set value to" override came into effect.  ![](../../../assets/en/manual/config/items/check_unsupported_format_error.png){width="600"}  See also: [Check for not supported value](/manual/config/items/preprocessing#checkunsupported)
es	 #### Manejo avanzado de la causa raíz del estado de la métrica no soportada  El manejo de errores en caso de que no se pudiera recuperar el valor de una métrica (y, por lo tanto, dejara de ser compatible) anteriormente carecía de la capacidad de distinguir el motivo o la etapa de tiempo de ejecución donde falló el proceso. Todos los errores debían manejarse utilizando la misma opción para el manejo de errores: ya sea descartar el valor, establecer un valor específico o establecer un mensaje de error específico.  Ahora es posible hacer coincidir el mensaje de error con una expresión regular. Si el error coincide (o no coincide), es posible especificar cómo se debe procesar el caso de error. Por ejemplo, un mensaje de error específico se puede "asignar" a un caso más general para que coincida y se maneje mediante un paso de preprocesamiento adicional, o algún problema intermitente (por ejemplo, conectividad de red) se puede manejar de manera diferente a una falla definitiva en la adquisición del mensaje. valor del ítem.  Ahora se pueden agregar varios pasos de preprocesamiento *Verificar valor no admitido*. Tenga en cuenta que solo puede haber un paso de coincidencia de "cualquier error" al final de la canalización que busca el estado no compatible del elemento. Si está presente, se activa si ninguna de las comprobaciones específicas coincide (mal) con el patrón correspondiente, o si se transfirió un mensaje de error (modificado), es decir, no entró en vigor ninguna anulación de "Descartar valor" o "Establecer valor en".  ![](../../../assets/en/manual/config/items/check_unsupported_format_error.png){width="600"}  Consulte también: [Compruebe si hay valores no admitidos](/manual/config/items/preprocessing#checkunsupported)