Skip To Content

Работа с журналами ArcGIS Notebook Server

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.

  1. Войдите на ваш портал ArcGIS Enterprise с правами администратора и откройте ArcGIS Notebook Server Manager.
  2. Открыть страницу Журналы.
  3. Параметры фильтра запросов находятся вверху страницы. Используйте любой из параметров, чтобы ограничить или расширить свой поиск.

    • Уровень журнала — минимальный уровень журнала для запроса (см. раздел выше). Он возвращает только записи с уровнем журнала на том же уровне или более серьезном, чем этот уровень. Уровень по умолчанию WARNING.
    • Время журнала – продолжительность времени поиска журналов. Вы можете ограничить запрос до последних 15 минут, последнего часа, последних шести или 24 часов, прошлой недели или последних 30 дней или показать все журналы с момента создания сайта.
      Подсказка:

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

    • Машина – ограничьте запрос журналами с одной из ваших ArcGIS Notebook Server машин или покажите журналы со всех машин.
    • ID запросов - разделенные запятыми ID запроса одного или нескольких запросов сервера, журналы которых вы хотите запросить. Некоторые сообщения журнала связаны с конкретным запросом.
    • Пользователи – имя одного или нескольких пользователей (разделенных запятыми), чьи журналы связаны для запроса. Некоторые сообщения журнала связаны с действиями конкретного пользователя.
    • Коды журнала – один или несколько кодов журнала, назначенных сообщению журнала. Если оставить это поле пустым, отображаются все коды регистрации .

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

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

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

  1. Войдите на ваш портал ArcGIS Enterprise с правами администратора и откройте ArcGIS Notebook Server Manager.
  2. Откройте страницу Настройки и щелкните Журналы.
  3. Можно изменить следующие настройки:

    • Директория журнала – расположение на диске директории ваших журналов. Если на вашем сайте несколько компьютеров, убедитесь , что этот путь является общим ресурсом UNC.
    • Уровень журнала – самый подробный уровень журнала, который будет писать ваш сайт. Если установлено 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 с ArcGIS Notebook Server Manager

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

  1. Войдите на ваш портал ArcGIS Notebook Server Manager с правами администратора. Адрес URL имеет формат https://webadaptorhost.domain.com/webadaptorname/home/notebook/manager.html.
  2. Перейдите на вкладку Контейнеры.
  3. Щелкните кнопку Просмотр журналов, чтобы просмотреть журналы контейнера для выбранного компьютера.

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