[comment]: # translation:outdated

[comment]: # ({1a1e2756-1a1e2756})
# 18 Скриптовые элементы данных

[comment]: # ({/1a1e2756-1a1e2756})

[comment]: # ({e70a8338-cb89bc38})
#### Обзор

Скриптовые элементы данных можно использовать для сбора данных путем выполнения пользовательского JavaScript кода с возможностью получения данных через HTTP/HTTPS. В дополнение к скрипту можно указать опциональный список параметров (пары из имени и значения) и время ожидания.

Этот тип элементов данных может быть полезен в сценариях сбора данных, требующих нескольких шагов или сложной логики. Например, скриптовый элемент данных можно настроить на выполнение HTTP вызова, последующей обработки неким образом данных, полученных на первом шаге, и передачи преобразованного значения второму HTTP вызову.

Скриптовые элементы данные обрабатываются Zabbix сервером или прокси на уровне поллеров.

[comment]: # ({/e70a8338-cb89bc38})

[comment]: # ({1c67563e-7ed55e87})
#### Настройка

В поле *Тип* [диалога настройки элемента данных](/manual/config/items/item) выберите Скрипт, затем заполните необходимые поля.

![script\_item.png](../../../../../assets/en/manual/config/items/itemtypes/script_item.png)

Все обязательные поля ввода отмечены красной звёздочкой.

Поля, которые требуют информацию, специфичную для элементов данных Скрипт:

|Поле|Описание|
|--|--------|
|Ключ|Введите уникальный ключ, который будет использоваться для идентификации этого элемента данных.|
|Параметры|Укажите переменные, которые будут переданы скрипту как пары атрибутов и значений.<br>Поддерживаются [встроенные макросы](/manual/config/macros) {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.IP}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG} и [пользовательские макросы](/manual/config/macros/user_macros).|
|Скрипт|Введите JavaScript код в блоке, который появится при нажатии на поле параметров (или на кнопку просмотра / изменения сразу за полем параметров). Этот код должен обеспечивать логику получаемого значения метрики.<br>Код имеет доступ ко всем параметрам, может выполнять запросы HTTP GET, POST, PUT и DELETE, а также имеет управление над HTTP заголовками и телом запроса.<br>Смотрите также: [Дополнительные JavaScript объкты](/manual/config/items/preprocessing/javascript/javascript_objects), [Руководство пользователя JavaScript](https://developer.mozilla.org/ru/docs/Web/JavaScript/Guide).|
|Время ожидания|Время ожидания выполнения JavaScript (1-60s, по умолчанию 3s); превышение этого значения вернёт ошибку.<br>Поддерживаются суффиксы времени, например, 30s, 1m.<br>В зависимости от скрипта срабатывание времени ожидания может занять больше времени. |

[comment]: # ({/1c67563e-7ed55e87})

[comment]: # ({ebeb959a-4c860844})
#### Примеры

[comment]: # ({/ebeb959a-4c860844})

[comment]: # ({2f86a97a-9c6c78ee})
##### Простой сбор данных

Получение содержимого *https://www.example.com/release\_notes*:

-   Создайте элемент данных с типом "Скрипт".\
-   В поле *Скрипт* введите следующий код:

```javascript
var request = new HttpRequest();
return request.get("https://www.example.com/release_notes");
```

[comment]: # ({/2f86a97a-9c6c78ee})

[comment]: # ({9e4b5ebc-7115c5ef})
##### Сбор данных с параметрами

Использование макроса {HOST.CONN} в качестве значения параметра и получение ответа с раскрытым макросом:

-   Создайте элемент данных с типом "Скрипт".\
-   Создайте параметр:\
    *Имя:* host\
    *Значение:* {HOST.CONN}\
-   В поле *Скрипт* введите следующий код:

``` {.java}
var request = new HttpRequest();
return request.post("https://postman-echo.com/post", JSON.parse(value));
```

[comment]: # ({/9e4b5ebc-7115c5ef})

[comment]: # ({d5553e63-18a089f4})
##### Несколько HTTP запросов

Сбор содержимого как *https://www.example.com*, так и *https://www.example.com/release\_notes*:

-   Создайте элемент данных с типом "Скрипт".\
-   В поле *Скрипт* введите следующий код:

```javascript
var request = new HttpRequest();
return request.get("https://www.example.com") + request.get("https://www.example.com/release_notes");
```

[comment]: # ({/d5553e63-18a089f4})

[comment]: # ({0a711007-d837bcdd})
##### Журналирование

Добавление записи "Log test" в журнал Zabbix сервера и получение значением элемента данных "1":

-   Создайте элемент данных с типом "Скрипт".\
-   В поле *Скрипт* введите следующий код:

```javascript
Zabbix.log(3, 'Log test');
return 1;
```

[comment]: # ({/0a711007-d837bcdd})