Работа с журналами организации

Отслеживание журналов поможет вам определить ошибки и решить возникшие с организацией проблемы. Используйте ArcGIS Portal Administrator Directory для выполнения запросов, просмотра, настройки и удаления журналов организации. Portal Administrator Directory сводит сообщения журнала в таблицу, которую вы можете просмотреть и с которой вы сможете работать.

Доступ к событиям, зарегистрированным для каждого компонента вашей организации, можно получить в Portal Administrator Directory. Возможно, вам все еще придется использовать ArcGIS Server Manager, чтобы задать настройки журнала сервера, удалить журналы сервера и использовать все опции фильтрации.

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

• Захват, запрос и просмотр событий
• Использование фильтров в запросе для сужения результатов поиска
• Удаление журналов

Захват, запрос и просмотр событий

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

1. Откройте Portal Administrator Directory и войдите в качестве администратора. Этот ресурс доступен, как правило, по ссылке https://webadaptorhost.example.com/webadaptorname/portaladmin.
2. Щелкните Журналы > Запрос.
3. Оставьте все значения параметров, предложенные по умолчанию, и щелкните Запрос.

Некоторые сообщения возвращаются с дополнительной информацией. К примеру, вы увидите следующие сообщения, если пользователь введет неправильный пароль слишком много раз и заблокирует тем самым свою учетную запись:

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

Все события записывают вышеуказанную информацию, такую как тип уровня журнала, время события, исходный компонент, записавший ее, компьютер, на котором событие произошло, пользователь, связанный с событием, код журнала и ID процесса и ID запроса. Вся эта информация поможет вам более эффективно решать проблемы с организацией. Для получения подробного описания этой информации см. раздел О журналах.

Если у вас есть подозрения, что что-то идет не так

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

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

• Постарайтесь заново воспроизвести проблему:
  • Если проблему можно воспроизвести, создайте запрос к журналам и просмотрите сообщения, чтобы получить информацию о ней:
    1. Если информация отсутствует, измените уровень журналирования на более подробный. Снова воспроизведите проблему, запросите журналы и просмотрите сообщения.
    2. Если в сообщениях журнала есть информация, просмотрите ее и решите проблему.
  • Если воспроизвести проблему нельзя, запомните сценарий, который привел к проблеме, если она вновь возникнет.

Подсказка:

Если вы подозреваете, что проблема связана с несколькими компонентами, рекомендуется при запросе журналов выбирать интегрированные серверы. Журналы сервера и журналы ArcGIS Data Store могут содержать дополнительную информацию, которая поможет вам устранить неполадки.

Ниже приводятся примеры отслеживания событий, запросов и их идентификации с записями журналов.

• Пользователь не может добавить вложение к сервису объектов
• Пользователь задал неверное имя пользователя или пароль.
• Элемент перемещен из одной папки в другую
• Организация настроена на доступ только для чтения

Пользователь не может добавить вложение к сервису объектов

В этом примере пользователь сообщает, что у него не получается добавление вложения к сервису объектов. Пользователь пытался много раз, но файл так и не загрузился. Чтобы зафиксировать события такого типа, сначала необходимо установить уровень журнала портала на INFO.

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

1. Попросите пользователя воспроизвести проблему и записать шаги и время, которые потребовались для воспроизведения проблемы.
2. Откройте Portal Administrator Directory и войдите в качестве администратора. Этот ресурс доступен, как правило, по ссылке https://webadaptorhost.example.com/webadaptorname/portaladmin.
3. Щелкните Журналы > Запрос.
   1. Задайте значения времени, полученные от пользователя. Формат – yyyy-mm-ddThh:mm:ss. К примеру, время начала – 2015-05-10T14:05:00, а время окончания – 2015-05-10T14:03:00.
   2. Задайте запрос для показа сообщений на уровне журнала Информация.
   3. В поле Пользователи задайте имя пользователя участника. Например, jcho для пользователя John Cho.
   4. Щелкните Запрос.
4. Просмотрите поле Сообщение для изучения сообщений, связанных с возникшей проблемой.

Вы увидите сообщение, в котором говорится следующее:

Failed to add attachment. File size limit of 20 MB exceeded for feature service '/gis/rest/services/Hosted/parks3k_19/FeatureServer/0/1/addAttachment'.

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

Пользователь задал неверное имя пользователя или пароль.

Чтобы зафиксировать события такого типа, сначала необходимо установить уровень журнала портала на WARNING.

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

1. Откройте Portal Administrator Directory и войдите в качестве администратора. Этот ресурс доступен, как правило, по ссылке https://webadaptorhost.example.com/webadaptorname/portaladmin.
2. Щелкните Журналы > Запрос.
3. Убедитесь, что уровень журнала установлен на уровень WARNING. Игнорируйте все другие поля, поскольку возвращаются сообщения уровня "предупреждения" для всех пользователей.
4. Просмотрите поле Сообщение для изучения сообщений, связанных с возникшей проблемой.

Вы увидите сообщение, в котором говорится следующее:

Sign in error: Invalid username or password specified for 'asmith'.

Сообщение говорит о том, что пользователь asmith (Ashley Smith) задал неверное имя пользователя или пароль при попытке войти в организацию. Отслеживайте эти события для предотвращения попыток неавторизованного доступа.

Элемент перемещен из одной папки в другую

Чтобы зафиксировать события такого типа, сначала необходимо установить уровень журнала портала на INFO.

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

1. Откройте Portal Administrator Directory и войдите в качестве администратора. Этот ресурс доступен, как правило, по ссылке https://webadaptorhost.example.com/webadaptorname/portaladmin.
2. Щелкните Журналы > Запрос.
3. Убедитесь, что уровень журнала установлен на INFO. Игнорируйте все остальные поля, поскольку возвращаются сообщения информационного уровня для всех пользователей с момента задания данного уровня.
4. Щелкните Запрос.
5. Просмотрите поле Сообщение для изучения сообщений, связанных с возникшей проблемой.

Вы увидите сообщение, в котором говорится следующее:

Item moved from folder 'jcho/(Home)' to folder 'jcho/(Home)/Utilities'. Item ID is 'b7557bd2691b4e74bc4ce3e373402cc6'.

Это сообщение содержит информацию о том, что пользователь jcho (John Cho) переместил элемент (с ID b7557bd2691b4e74bc4ce3e373402cc6) из своей домашней папки (Home) в ее подкаталог с названием Utilities.

Организация настроена на доступ только для чтения

Чтобы отслеживать, что происходит со всеми компонентами, когда вы переводите свою организацию в режим только для чтения, сначала необходимо установить уровень журналирования для компонентов на INFO или ниже. Дополнительные сведения см. в разделах Настройка параметров журнала портала и Настройка параметров журнала сервера.

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

1. Откройте Portal Administrator Directory и войдите в качестве администратора. Этот ресурс доступен, как правило, по ссылке https://webadaptorhost.example.com/webadaptorname/portaladmin.
2. Щелкните Журналы > Запрос.
3. Убедитесь, что уровень журнала установлен на INFO и щелкните Запрос.
4. Найдите сообщение журнала, указывающее, что организация переведена в режим только для чтения, и обратите внимание на идентификатор запроса для этого сообщения.

   Successfully set the organization to read-only mode

5. Щелкните Запрос, чтобы вернуться к сообщениям журнала запросов.
6. Введите идентификатор запроса, указанный на шаге 4, в поле RequestId.
7. Выберите Все в поле Интегрированные серверы.
8. Щелкните Запрос и просмотреть журналы по всем компонентам, связанным с переводом организации в режим только для чтения.

Использование фильтров в запросе для сужения результатов поиска

Для сужения круга событий и показа только нужных вам сообщений можно создать запрос на основе уровня журнала, источника компонента, времени, конкретного кода или диапазона кодов, конкретного пользователя или списка пользователей и ID запроса. Можно сочетать несколько таких фильтров в запросе.

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

Для работы с этими фильтрами войдите в Portal Administrator Directory и щелкните Домашняя страница > Журналы > Запрос.

Уровень журнала

События отличаются уровнем детализации от Строгого, означающего наличие проблемы, требующей немедленного внимания, до Подробного, представляющего собой подробное, информативное сообщение, которое создается при обычном использовании портала. Выберите нужный уровень в списке Уровень журнала. Для получения подробного описания каждого уровня см. раздел Тип журнала.

Источник

Источник журналированных событий создается из компонентов портала, публикации данных и административных компонентов программного обеспечения. Например:

• События, связанные с публикацией и пользователями, находятся в категории Публикация.
• События, связанные с безопасностью и индексацией, находятся в категории Администратор портала.
• События, связанные с установкой программного обеспечения, находятся в категории Портал.

По умолчанию все источники запрашиваются (опция Все ниспадающего списка). Для фильтрации событий портала по определенному источнику выберите источник из ниспадающего списка Источник.

Время

Для фильтрации событий за определенный временной промежуток задайте интересующие вас значения времени, используя поля Время начала и Время окончания (в формате yyyy-mm-ddThh:mm:ss). Время начала – это время начала интервала, а время окончания – соответственно, время его окончания. Например:

• Для задания 15-минутного временного интервала начальное время – 2015-05-01T13:15:00, а время окончания – 2015-05-01T13:00:00.
• Для задания часового временного интервала начальное время – 2015-05-01T14:00:00, а время окончания – 2015-05-01T13:00:00.
• Для задания одного дня время начала – 2015-05-02T12:00:00, а окончания – 2015-05-01T12:00:00.
• Для запроса всех журналов оставьте пустыми поля времени.

Если задано время начала, а время окончания – нет, возвращаются все более ранние (относительно начального времени) журналы. И наоборот: если не задано время начала, а время окончания – указано, возвращаются все более поздние журналы (относительно времени окончания).

Если выбран этот параметр, события, зарегистрированные на интегрированных серверах, также будут отфильтрованы.

Коды журнала

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

• Для фильтрации одного кода задайте значение кода (к примеру, 204028).
• Для фильтрации нескольких кодов разделяйте их запятыми (,) (например, 204028, 212015, 219114).
• Для фильтрации с помощью диапазона кодов, например, всех кодов категории безопасности, задайте начальный и заключительный коды, разделив их дефисом (-) (например, 204000–205999).
• Для фильтрации с помощью диапазона кодов и отдельных кодов задайте начальный и заключительный коды (разделенные дефисом), а отдельные коды разделяйте запятыми (например, 204000–205999, 212015, 219114).

Пользователи

Для фильтрации событий портала для конкретного пользователя задайте нужное имя пользователя в поле Пользователи, к примеру:

• Для фильтрации для одного конкретного пользователя задайте имя пользователя (например, jcho для пользователя John Cho).
• Для фильтрации нескольких пользователей разделяйте их имена запятыми (,) (например, jcho, asmith для пользователей John Cho и Ashley Smith).

Примечание:

Символ маски (*) не поддерживается.

ID запросов

Это уникальный текстовый ID, прикрепленный к каждому направленному запросу, который передается в течение всего жизненного цикла запроса в системе. Выберите один или все интегрированные серверы, если вы выполняете фильтрацию по идентификатору запроса для операции, охватывающей несколько компонентов.

Число сообщений

Количество сообщений, которые отображаются при выполнении запроса. Сообщения показываются на одной веб-странице. В случае необходимости прокрутите вниз страницу для просмотра всех сообщений.

Интегрированные серверы

Чтобы устранить неполадки или получить представление об операциях, связанных с несколькими компонентами ArcGIS Enterprise, включите журналы сервера в свой запрос, выбрав один или все интегрированные серверы. При запросе журналов хост-сервера также будут учитываться журналы ArcGIS Data Store.

Удаление журналов

При необходимости удалить журналы щелкнитеДомашняя страница > Журналы > Очистить > Очистить журналы. Это приведет к удалению сообщений журнала с компьютера портала. При отладке определенных сценариев, которые вызывают проблемы на вашем портале, удаление журналов может помочь выявить возникающую проблему. Таким образом, журнал очищается от любых других событий, что позволяет вам сфокусироваться на решении проблемы.

Чтобы удалить серверные журналы, воспользуйтесь ArcGIS Server Manager.