Документация

Характеристики УСПОКОИТЕЛЬНОГО API

MATLAB Production Server УСПОКОИТЕЛЬНЫЙ API для открытия и диагностики использует модель ответа запроса HTTP для связи с MATLAB Production Server. Эта модель включает методы запроса, коды ответа, заголовки сообщения и тексты сообщений. УСПОКОИТЕЛЬНЫЙ API для открытия и диагностики имеет следующие характеристики:

Сервис открытия

Используйте сервис открытия узнать о функциях MATLAB, что вы развертываетесь к серверу. Сервис открытия возвращает информацию о развернутых функциях MATLAB как объект JSON. Объект является многоуровневой вложенной структурой, и на высоком уровне отображает версию схемы открытия и список развернутых архивов. Каждый архив содержит информацию о развернутых функциях MATLAB и их функциональных подписях.

Чтобы использовать сервис открытия, необходимо включить сервис открытия на сервер путем установки --enable-discovery свойство в main_config конфигурационный файл сервера.

Чтобы получить полезную информацию при использовании сервиса открытия, необходимо включать файл JSON, содержащий функциональные подписи функций MATLAB, которые вы хотите развернуть при создании развертываемого архива. Для получения информации о том, как создать развертываемый архив, смотрите, Создают Развертываемый Архив для MATLAB Production Server. Для получения информации о создании файла JSON, содержащего функциональные подписи, смотрите Подписи функции MATLAB в JSON.

Вызовите сервис открытия с помощью Информации для поиска GET.

Ответ с сервера является объектом JSON.

Медицинский осмотр

Используйте API медицинский осмотра, чтобы определить, имеет ли сервер допустимую лицензию и может обработать запросы HTTP. Медицинский осмотр классифицирует сервер как здоровый или вредный для здоровья в зависимости от того, имеет ли сервер допустимую лицензию и может связаться с Сетевым менеджером лицензий. Чтобы проверять здоровье сервера, используйте здоровье Сервера GET (MATLAB Production Server).

Сервер здоров, когда это находится в одном из следующих состояний:

Если медицинский осмотр успешен, сервер отвечает 200 OK Код состояния HTTP и объект JSON, указывающий, что сервер здоров.

{
  "status": "ok"
}

Когда сервер недоступен, чтобы обработать запросы HTTP, API медицинский осмотра возвращает 503 Health Check Failed Код ответа HTTP с пустым органом по ответу. Медицинский осмотр перестал работать, когда сервер потерял связь с Сетевым менеджером лицензий сроком на время, превысив льготный период. Когда сервер находится в этом состоянии, он активно пытается восстановить связь с менеджером лицензий. Обработка запросов возобновляется, может ли разъединение восстановить связь с менеджером лицензий.

Не пройдено медицинский осмотр не предоставляет дополнительную информацию о причине отказа в органе по ответу. Администраторы сервера могут использовать mps-status (MATLAB Production Server), чтобы получить подробную информацию о состоянии сервера. Необходимо быть в той же системе как сервер, чтобы запуститься mps-status.

Для получения дополнительной информации о лицензировании смотрите, Управляют Лицензиями на MATLAB Production Server (MATLAB Production Server).

Метрический сервис

Используйте метрический сервис получить метрики сервера в Прометее^® метрический формат. Метрический сервис возвращает информацию о запросах, чтобы клиентские приложения отправили к серверу, и время и память, которую сервер берет, чтобы выполнить запросы. Можно использовать метрики, чтобы контролировать сервер при работе с Kubernetes^® и микросервисы. Чтобы вызвать метрические сервисы, используйте Метрики GET (MATLAB Production Server).

Чтобы использовать метрический сервис, необходимо включить метрический сервис на сервер путем установки --enable-metrics свойство в main_config конфигурационный файл сервера.

Успешный ответ с сервера состоит из нескольких метрик сервера в счетчике Прометея и метрических типах прибора. Для получения дополнительной информации о метрическом формате Прометея, смотрите Прометея Метрика Тайпеса.

# TYPE matlabprodserver_up_time_seconds counter
matlabprodserver_up_time_seconds 68140.5
# TYPE matlabprodserver_queue_time_seconds gauge
matlabprodserver_queue_time_seconds 0
# TYPE matlabprodserver_cpu_time_seconds counter
matlabprodserver_cpu_time_seconds 18.2188
# TYPE matlabprodserver_memory_working_set_bytes gauge
matlabprodserver_memory_working_set_bytes 1.57426e+08
# TYPE matlabprodserver_requests_accepted_total counter
matlabprodserver_requests_accepted_total 0
# TYPE matlabprodserver_requests_in_queue gauge
matlabprodserver_requests_in_queue 0
# TYPE matlabprodserver_requests_processing gauge
matlabprodserver_requests_processing 0
# TYPE matlabprodserver_requests_succeeded_total counter
matlabprodserver_requests_succeeded_total 0
# TYPE matlabprodserver_requests_failed_total counter
matlabprodserver_requests_failed_total 0
# TYPE matlabprodserver_requests_canceled_total counter
matlabprodserver_requests_canceled_total 0

Ошибочный ответ 403 Metrics Disabled указывает, что метрическому сервису не включают на сервере.