ArcGIS Notebook Server записывает все события, происходящие на сайте, и все связанные с ними ошибки в журналы. Эти журналы доступны администраторам сайта.
Журналы представляют собой важный инструмент отслеживания и диагностики/устранения неисправностей на сайте ArcGIS Notebook Server. Информация в журналах помогает находить ошибки и дает сведения, позволяющие понять, как их исправить. Журналы также служат системой записи всех событий, происходящих на сайте.
Например, в журналах записываются следующие типы событий:
- Установка и обновление, авторизация ПО и создание сайта
- Открытие и закрытие ArcGIS Notebooks
- Задачи очистки, выполняемые сайтом
- События, связанные с управлением сайтом,выполняемые администратором, такие как добавление или удаление рабочих сред блокнота, создание серверных директорий или настройка параметров безопасности
- События, связанные с безопасностью, такие как вход пользователей на сайт или импорт/экспорт сертификатов SSL
Некоторые события не записываются в журналы ArcGIS Notebook Server. Они включают интеграцию сайта с порталом. События, которые происходят в ArcGIS Notebooks – добавление ресурсов, запуск ячеек и т.д. – не записываются. Также не записываются события, происходящие в контейнерах Docker; для просмотра этих событий см. раздел Просмотр журналов контейнеров Docker.
Доступные уровни журналирования
Каждый журнал имеет свой уровень журналирования, которые перечислены ниже в порядке от менее до более подробного:
- Серьёзное – серьезные проблемы, требующие немедленного внимания.
- Предупреждение – проблемы средней степени серьезности, требующие внимания.
- Информация – административные сообщения сайта Notebook Server, в том числе сообщения о создании и запуске сервиса.
- Точно – общие сообщения об использовании сервера, например, имена полученных запросов операций.
- Подробно – сообщения, содержащие более подробную информацию о том, как сервер обрабатывает операции.
- Отладка – очень подробные сообщения, предназначенные для разработчиков и службы поддержки и нацеленные на обеспечение лучшего понимания состояния сервера в процессе поиска и устранения неисправностей. Не рекомендуется для использования в производственных системах ввиду большого количества создаваемых журналов.
В ArcGIS Notebook Server Administrator Directory, можно задать создание наиболее детализированного журнала. Например, если вы выбрали уровень Точно, сайт сервера будет записывать сообщения на уровнях Строгий, Предупреждение, Информация и Точно.
Коды журнала
Диапазоны кодов журнала соответствуют определенным типам сообщений. В следующей таблице описаны диапазоны кодов журнала и тип их содержимого.
| Диапазон кодов журнала | Содержание сообщения |
|---|---|
1000-4999 | Основная среда ArcGIS Notebook Server |
5000-6999 | Относящиеся к Docker SDK и контейнеру |
7000-7200 | Блокноты |
7200-7299 | Веб-инструменты Notebook |
7300-7399 | Снимок Notebook |
7400-7499 | Фрагменты кода Notebook |
Запрос журналов в Manager
Начиная с ArcGIS Notebook Server версии 10.8, Manager включает страницу Журналы. На этой странице вы можете запросить все журналы для вашего сайта ArcGIS Notebook Server.
- Войдите на ваш портал ArcGIS Enterprise с правами администратора и откройте ArcGIS Notebook Server Manager.
- Открыть страницу Журналы.
- Параметры фильтра запросов находятся вверху страницы. Используйте любой из параметров, чтобы ограничить или расширить свой поиск.
- Уровень журнала — минимальный уровень журнала для запроса (см. раздел выше). Он возвращает только записи с уровнем журнала на том же уровне или более серьезном, чем этот уровень. Уровень по умолчанию WARNING.
- Время журнала – продолжительность времени поиска журналов. Вы можете ограничить запрос до последних 15 минут, последнего часа, последних шести или 24 часов, прошлой недели или последних 30 дней или показать все журналы с момента создания сайта.
Подсказка:
Используйте Administrator Directory для выполнения запросов журналов, если вы хотите указать время окончания, отличное от настоящего, например, журналы от трех до двух дней назад.
- Машина – ограничьте запрос журналами с одной из ваших ArcGIS Notebook Server машин или покажите журналы со всех машин.
- ID запросов - разделенные запятыми ID запроса одного или нескольких запросов сервера, журналы которых вы хотите запросить. Некоторые сообщения журнала связаны с конкретным запросом.
- Пользователи – имя одного или нескольких пользователей (разделенных запятыми), чьи журналы связаны для запроса. Некоторые сообщения журнала связаны с действиями конкретного пользователя.
- Коды журнала – один или несколько кодов журнала, назначенных сообщению журнала. Если оставить это поле пустым, отображаются все коды регистрации .
- Щелкните Поиск, чтобы запустить запрос. Все журналы, соответствующие параметрам вашего запроса , отображаются в итоговой таблице.
Измените параметры журнала сервера в Manager
Вы также можете использовать ArcGIS Notebook Server Manager, чтобы изменить настройки журнала для вашего сайта.
- Войдите на ваш портал ArcGIS Enterprise с правами администратора и откройте ArcGIS Notebook Server Manager.
- Откройте страницу Настройки и щелкните Журналы.
- Можно изменить следующие настройки:
- Директория журнала – расположение на диске директории ваших журналов. Если на вашем сайте несколько компьютеров, убедитесь , что этот путь является общим ресурсом UNC.
- Уровень журнала – самый подробный уровень журнала, который будет писать ваш сайт. Если установлено FINE, например, ваш сайт не ведет журналы на уровне VERBOSE или DEBUG.
- Количество дней, в течение которых журналы будут храниться – количество дней, по истечении которых сообщения журнала удаляются. Учитывайте объем памяти, доступной на диске вашего каталога журналов, а также выбранный параметр Уровень журнала и уровень активности на вашем сайте. Например, если вы измените уровень журнала, чтобы начать запись на более детальном уровне, вам может потребоваться уменьшить количество дней, в течение которых журналы хранятся.
- Щелкните Сохранить, чтобы подтвердить изменения.
Журнал сервера запросов в Administrator Directory.
Используйте ArcGIS Notebook Server Administrator Directory для выполнения запросов, просмотра, настройки и удаления журналов сервера.
Для доступа к журналам выполните следующие шаги:
- Войдите в Administrator Directory. URL-адрес имеет вид https://notebookserver.domain.com:11443/arcgis/admin или https://notebookserver.domain.com/<webadaptorname>/admin.
- Щелкните Журналы > Запрос, чтобы создать запрос и просмотреть текущие журналы. Используйте фильтры, которые помогут сократить число событий по категориям,например, по времени или уровню журналирования.
- Щелкните Журналы > Настройки, чтобы перейти к управлению настройками журналов, например, выбрать уровень журналирования по умолчанию (как описывалось выше), время хранения журналов на диске и местоположение для записи журналов.
- Щелкните Очистить журналы, чтобы удалить все файлы журналов с сайта ArcGIS Notebook Server.
Просмотрите журналы контейнера Docker с ArcGIS Notebook Server Manager
Вы можете просмотреть журналы, относящиеся к контейнерам Docker сайта, используя ArcGIS Notebook Server Manager.
- Войдите на ваш портал ArcGIS Notebook Server Manager с правами администратора. Адрес URL имеет формат https://webadaptorhost.domain.com/webadaptorname/home/notebook/manager.html.
- Перейдите на вкладку Контейнеры.
- Щелкните кнопку Просмотр журналов, чтобы просмотреть журналы контейнера для выбранного компьютера.
Просмотрите журналы контейнера Docker с командной строкой Docker
Вы можете просмотреть журналы, относящиеся к контейнерам Docker сайта, используя интерфейс командной строки Docker.
- Войдите в Administrator Directory. URL-адрес имеет вид https://notebookserver.domain.com:11443/arcgis/admin или https://notebookserver.domain.com/<webadaptorname>/admin.
- Перейдите к система > контейнеры. Найдите контейнер, журналы которого вы хотите просмотреть, и щелкните его ID.
- Откройте вид JSON страницы информации о контейнере, добавив ?f=pjson к его URL-адресу, так, чтобы URL имел вид https://notebookserver.arcgis.com/<webadaptorname>/admin/system/containers/<container>?f=pjson.
- Найдите containerId контейнера и запишите значение.
- Откройте окно командной строки от имени пользователя с правами использования Docker.
- Запустите команду docker logs <containerId>, используя записанное значение. Команда вернет журналы Docker, относящиеся к этому контейнеру.