Устранение неполадок, связанных с сервисами геообработки REST
В этом разделе
- Включение сообщений геообработки на уровне информации
- Проверка каталога arcgisjobs
- Превышение ограничения на передачу данных
Наиболее распространенные проблемы, связанные с сервисом геообработки, можно обнаруживать, используя один или несколько из перечисленных ниже методов.
- Включите сообщения геообработки в сервисе, повторно запустите задачу и просмотрите сообщения.
- Выполните задачу и просмотрите каталог arcgisjobs.
- Убедитесь, что значение свойства ограничения передачи не было превышено.
Включение сообщений геообработки на уровне информации
Сообщения инструмента геообработки содержат пошаговые инструкции по выполнению задачи геообработки. В случае сбоя сообщения геообработки помогут правильно определить точку сбоя задачи геообработки. Сообщения геообработки, отправленные клиенту, определяются свойством Уровень сообщения (Message Level) сервиса геообработки. Используются четыре уровня сообщений: Нет (None), Ошибка (Error), Предупреждение (Warning) и Информация (Info). Если уровень сообщений задан как Нет (None), операции выполнения задачи или отправки задания в рамках задачи геообработки не вернут какие-либо сообщения инструментов геообработки, кроме успешного или неуспешного выполнения задачи. Уровень Информация (Info) позволяет регистрировать все сообщения геообработки, созданные задачей. Этот уровень рекомендуется использовать при устранении неполадок. Можно задать свойство Уровень сообщений (Message Level) для сервиса геообработки как Информация (Info) с помощью ArcGIS for Server Manager или ArcGIS for Desktop и продолжить устранение неполадок.
Подсказка:
Если сообщения геообработки не поступают даже после определения уровня сообщений как Информация, это означает наличие недопустимых входных данных. Значения входных параметров задачи могли быть неправильно сформированы, указаны не полностью или являться недопустимыми значениями JSON. Необходимо проверить типы данных входных параметров и их значения JSON.
Проверка каталога arcgisjobs
Другим способом устранения неполадок, связанных с сервисами геообработки является использования асинхронного режима выполнения в целях отладки. Можно изменить свойство режима выполнения для сервиса геообработки с помощью ArcGIS for Server Manager или ArcGIS for Desktop. В асинхронном режиме выполнения сервер создает уникальный каталог для каждого задания, переданного клиентом в каталог arcgisjobs. Каждый каталог содержит папку scratch, которая служит в качестве временной рабочей области для задания геообработки, выполняемого на сервере. Во временную рабочую область записываются выходные данные, промежуточные (временные) данные и сообщения геообработки, созданные асинхронным заданием. Можно просмотреть данные во временной рабочей области, чтобы определить проблемы и неполадки, которые могли привести к сбою задачи.
Каталог arcgisjobs является настраиваемым свойством сервиса геообработки и может быть изменен во время публикации или позже. Путь по умолчанию к каталогу arcgisjobs: <server_directories>\directories\arcgisjobs. Временной рабочей областью по умолчанию для асинхронного задания является <arcgis-jobs-folder>\<server_folder_if_any>\<gpservice_name>\<jobid>\scratch.
Содержимое временной рабочей области сервера
- Папка scratch: эта папка содержит выходные данные в виде файлов, например шейп-файлы, растры и т. д. в зависимости от функций инструмента.
- scratch.gdb: база геоданных scratch.gdb расположенная в папке временной рабочей области scratch. В нее записываются классы объектов и растры базы геоданных.
- messages.xml: файл message.xml располагается в папке scratch и содержит все сообщения геообработки, которые были зарегистрированы для задач геообработки. Сообщения в файле XML зависят от параметра Уровень сообщений (Message Level) сервиса геообработки.
Подсказка:
Каталоги scratch в папке arcgisjobs будут удаляться через предварительно заданные интервалы времени в рамках стандартной процедуры очистки сервера. Продолжительность очистки определяется свойством Максимальный возраст файла (Maximum file age) для каталога arcgisjobs. Значением по умолчанию является 360 мин., однако администратор сервера может изменить это значение в ArcGIS for Desktop или ArcGIS for Server Manager.
Подсказка:
Во время выполнения задачи сервер записывает промежуточные данные, созданные моделью или скриптом, в папку scratch. Однако промежуточные данные будут удалены после выполнения. Если необходимо изучить определенные промежуточные данные в модели или скрипте, преобразуйте их в выходные параметры непосредственно в модели или скрипте, создайте новый результат и опубликуйте результат как сервис. Выполните этот новый сервис для изучения новых выходных данных.
Превышение ограничения на передачу данных
Иногда синхронная или асинхронная задача может завершиться успешно, однако выходной набор параметров или параметры набора записей, возвращенные сервером, могут не содержать каких-либо объектов и записей. В этих случаях необходимо увеличить значение свойства Максимальное число записей, возвращаемое сервером (Maximum number of records returned by the server) сервиса геообработки с помощью ArcGIS for Desktop или ArcGIS for Server Manager. Максимальное число выходных объектов и записей, возвращаемых задачей геообработки, определяется свойством Максимальное число записей, возвращаемое сервером (Maximum number of records returned by the server). Значением по умолчанию для этого свойства является 1000 записей или объектов. Если количество записей или объектов в выходных данных задачи превышает значение свойства Максимальное число записей, возвращаемое сервером, задача геообработки не вернет какие-либо записи или объекты, даже если она завершится успешно.