Работа с логами ArcGIS Notebook Server

ArcGIS Notebook Server записывает все события, происходящие на сайте, и все связанные с ними ошибки в журналы. Эти журналы доступны администраторам сайта.

Журналы представляют собой важный инструмент отслеживания и диагностики/устранения неисправностей на сайте ArcGIS Notebook Server. Информация в журналах помогает находить ошибки и дает сведения, позволяющие понять, как их исправить. Журналы также служат системой записи всех событий, происходящих на сайте.

Например, в журналах записываются следующие типы событий:

• Установка и обновление, авторизация ПО и создание сайта

• Открытие и закрытие блокнотов ArcGIS Notebooks

• Задачи очистки, выполняемые сайтом

• События, связанные с управлением сайтом,выполняемые администратором, такие как добавление или удаление рабочих сред блокнота, создание серверных директорий или настройка параметров безопасности

• События, связанные с безопасностью, такие как вход пользователей на сайт или импорт/экспорт сертификатов SSL

Некоторые события не фиксируются в журналах ArcGIS Notebook Server. Они включают интеграцию сайта с порталом. События, которые происходят в ArcGIS Notebooks – добавление ресурсов, запуск ячеек и т.д. – не записываются. Также не записываются события, происходящие в контейнерах Docker вашего компьютера; для просмотра журналов, относящихся к конкретным контейнерам, см. ниже в разделе Просмотр журналов контейнеров Docker с помощью командной строки Docker.

Доступные уровни журналирования

Каждый журнал имеет свой уровень журналирования, которые перечислены ниже в порядке от менее до более подробного:

• Серьёзное – серьезные проблемы, требующие немедленного внимания.

• Предупреждение – проблемы средней степени серьезности, требующие внимания.

• Информация – административные сообщения сайта Notebook Server, в том числе сообщения о создании и запуске сервиса.

• Точно – общие сообщения об использовании сервера, например, имена полученных запросов операций.

• Подробно – сообщения, содержащие более подробную информацию о том, как сервер обрабатывает операции.

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

Коды журнала

Диапазоны кодов журнала соответствуют определенным типам сообщений. В следующей таблице описаны диапазоны кодов журнала и тип их содержимого.

Диапазон кодов журнала	Содержание сообщения
1000-4999	Основная среда ArcGIS Notebook Server
5000-6999	Относящиеся к Docker SDK и контейнеру
7000-7200	Блокноты
7200-7299	Веб-инструменты Notebook
7300-7399	Снимок Notebook
7400-7499	Фрагменты кода Notebook

Логи запросов в ArcGIS Notebook Server Manager

ArcGIS Notebook Server Manager содержит страницу Журналы. На этой странице вы можете запросить все журналы для своего сайта ArcGIS Notebook Server.

1. Войдите на свой портал ArcGIS Enterprise как администратор и откройте ArcGIS Notebook Server Manager.

2. Открыть страницу Журналы.

3. Нажмите Фильтры, чтобы настроить фильтры для уточнения поиска.

   • Коды журнала – один или несколько кодов журнала, назначенных сообщению журнала. Если оставить это поле пустым, отображаются все коды регистрации.

   • Пользователи – имя одного или нескольких пользователей (разделенных запятыми), чьи журналы связаны для запроса. Некоторые сообщения журнала связаны с действиями конкретного пользователя.

   • ID запросов - разделенные запятыми ID запроса одного или нескольких запросов сервера, журналы которых вы хотите запросить. Некоторые сообщения журнала связаны с конкретным запросом.

   • Уровень журнала - минимальный уровень журнала для запроса (см. раздел выше). Он возвращает только записи с уровнем журнала на том же уровне или более серьезном, чем этот уровень. Уровень по умолчанию — WARNING.

   • Время журнала – продолжительность времени поиска журналов. Вы можете ограничить запрос до последних 15 минут, последнего часа, последних шести или 24 часов, последней недели или последних 30 дней или показать все журналы с момента создания сайта.

     Подсказка:

     Используйте Administrator Directory для выполнения запросов журналов, если вы хотите указать время окончания, отличное от настоящего, например, журналы от трех до двух дней назад.

   • Компьютер – ограничьте запрос журналами с одного из вашего компьютера ArcGIS Notebook Server или покажите журналы со всех компьютеров.

4. Щелкните Поиск, чтобы запустить запрос. Все журналы, соответствующие параметрам вашего запроса , отображаются в итоговой таблице.

Измените параметры журнала в Manager

Вы также можете использовать ArcGIS Notebook Server Manager для изменения настроек лога на вашем сайте.

1. Войдите на свой портал ArcGIS Enterprise как администратор и откройте ArcGIS Notebook Server Manager.

2. Откройте страницу Настройки и щелкните Журналы.

3. Можно изменить следующие настройки:

   • Директория журнала – расположение на диске директории ваших журналов. Если на вашем сайте несколько компьютеров, убедитесь , что этот путь является общим ресурсом UNC.

   • Уровень журнала – самый подробный уровень журнала, который будет писать ваш сайт. Например, если вы выбрали уровень FINE, сайт сервера будет записывать сообщения на уровнях SEVERE, WARNING, INFO и FINE и не будет хранить журналы на уровнях VERBOSE и DEBUG.

   • Количество дней, в течение которых журналы будут храниться – количество дней, по истечении которых сообщения журнала удаляются. Учитывайте объем памяти, доступной на диске в директории журнала, а также выбранную настройку Уровень журнала и уровень активности на сайте. Например, если вы измените уровень журнала, чтобы начать запись на более детальном уровне, вам может потребоваться уменьшить количество дней, в течение которых журналы хранятся.

4. Щелкните Сохранить, чтобы подтвердить изменения.

Журнал сервера запросов в Administrator Directory

Используйте ArcGIS Notebook Server Administrator Directory для выполнения запросов, просмотра, настройки и удаления журналов сервера.

Для доступа к журналам выполните следующие шаги:

1. Войдите в Administrator Directory. URL-адрес имеет вид https://notebookserver.domain.com:11443/arcgis/admin или https://notebookserver.domain.com/<webadaptorname>/admin.

2. Щелкните Журналы > Запрос, чтобы создать запрос и просмотреть текущие журналы. Используйте фильтры, которые помогут сократить число событий по категориям,например, по времени или уровню журналирования.

3. Щелкните Журналы > Настройки, чтобы перейти к управлению настройками журналов, например, выбрать уровень журналирования по умолчанию (как описывалось выше), время хранения журналов на диске и местоположение для записи журналов.

4. Щелкните Очистить журналы, чтобы удалить все файлы журналов с сайта ArcGIS Notebook Server.

Просмотр журналов контейнеров Docker с использованием командной строки Docker

Вы можете просмотреть журналы, относящиеся к контейнерам Docker сайта, используя интерфейс командной строки Docker.

1. Войдите в Administrator Directory. URL-адрес имеет вид https://notebookserver.domain.com:11443/arcgis/admin или https://notebookserver.domain.com/<webadaptorname>/admin.

2. Выберите Система > Контейнеры. Найдите контейнер, журналы которого вы хотите просмотреть, и щелкните его ID.

3. Откройте вид JSON страницы информации о контейнере, добавив ?f=pjson к его URL-адресу, так, чтобы URL имел вид https://notebookserver.arcgis.com/<webadaptorname>/admin/system/containers/<container>?f=pjson.

4. Найдите containerId контейнера и запишите значение.

5. Откройте командную строку как пользователь с правами Docker.

6. Откройте терминал как пользователь с правами Docker.

7. Запустите команду docker logs <containerId>, используя записанное значение. Команда вернет журналы Docker, относящиеся к этому контейнеру.