Работа с журналами сервера

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

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

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

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

Откройте Manager и войдите в систему как администратор. Справка по этому шагу приведена в разделе Вход в Manager.
Щелкните Журналы > Просмотр журналов для просмотра текущих журналов. Некоторые сообщения возвращаются с дополнительной информацией.

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

Журналирование установки и пост-установки

Когда вы устанавливаете или обновляете ArcGIS Server, для журнала сервера задается Подробный уровень. Это означает, что сообщения в процессе установки или обновления записываются очень детально.

Если при выполнении процесса возникает ошибка, и вы хотите для ее исправления посмотреть журналы, сначала определите, есть ли у вас доступ к ArcGIS Server Manager. При его наличии выполните запросы к журналам и просмотрите сообщения. В противном случае просмотрите сообщения журнала на диске. Для доступа к журналам на диске перейдите в директорию журналов и откройте самый последний файл журнала (например, <ArcGIS Server installation directory>/arcgisserver/logs/<machine name>/server/server-20150101.095803-8596-0.0.log). Если необходимо, вы можете передать эту информацию в Службу технической поддержки Esri.

Если при выполнении процесса возникает ошибка, и вы хотите для ее исправления посмотреть журналы, сначала определите, есть ли у вас доступ к ArcGIS Server Manager. При его наличии выполните запросы к журналам и просмотрите сообщения. В противном случае просмотрите сообщения журнала на диске. Для доступа к журналам на диске перейдите в директорию журналов и откройте самый последний файл журнала (например, C:\arcgisserver\logs\<machine name>\server\server-20150101.095803-8596-0.0.log). Если необходимо, вы можете передать эту информацию в Службу технической поддержки Esri.

По завершении процесса установки или обновления по умолчанию будет установлен уровень журнала сервера Предупреждения. Это значит, что записываются только сообщения о серьезных проблемах. Если пользователь сервера сообщает о проблеме, вам необходимо изменить уровень ведения журнала, чтобы захватить больше сообщений, посвященных возникшей проблеме. Чтобы узнать, как изменить уровень журналирования, см. раздел Задание настроек журналов сервера в Manager.

Устранение проблем

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

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

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

Подсказка:

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

Что такое журналы?

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

По умолчанию в окне журнала отображаются только свойства Уровень, Время, Сообщение и Источник. Если хотите добавить или удалить свойства из изображения, выберите Столбцы.

Подсказка:

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

Уровень

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

Примечание:

ArcGIS Server может одновременно хранить только 1000 журналов. Сохраняются только самые последние 1000 журналов, независимо от других настроек, выбранных вами для хранения журналов.

Частота сообщений журнала увеличивается по мере увеличения уровня детализации; например, на уровне FINE регистрируется больше сообщений, чем на уровне SEVERE.

Рекомендуется поддерживать уровень журнала на SEVERE, WARNING или INFO, за исключением случаев, когда вам нужно увеличить уровень журнала для устранения неполадок.

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


Уровень журнала	Описание	Пример сообщения
Серьезный	Серьезные проблемы, требующие немедленного внимания. Этот уровень содержит только критичные сообщения.	Не удалось обработать запрос. Сервис Planning/counties/FeatureServer не найден.
Предупреждение	Проблемы средней степени серьезности, требующие внимания. Этот уровень также содержит критичные сообщения.	Не удалось войти. Задано неверное имя пользователя или пароль.
Информация	Административные сообщения сервера, в том числе сообщения о создании и запуске сервиса. Этот уровень также содержит критичные сообщения и предупреждения.	Папка Planning была успешно создана.
Уточнение	Общие сообщения об использовании сервера, например, имена полученных запросов операций. Этот уровень также содержит критичные, информационные сообщения и предупреждения.	Проверка на просроченные элементы в /admin/arcgisserver/directories/arcgisjobs. Проверка на просроченные элементы в C:\arcgisserver\directories\arcgisjobs.
Подробно	Сообщения содержат подробную информацию о том, как развертывание выполняет операцию, например, сообщение о том, что каждый слой картографического сервиса успешно отображен, как быстро слой был отображен, сколько времени потребовалось для осуществления доступа к исходным данным слоя. Этот уровень также содержит критичные, информационные сообщения и предупреждения.	Начало отрисовки слоя: counties.
Отладка	Очень подробные сообщения, предназначенные для разработчиков и службы поддержки и нацеленные на обеспечение лучшего понимания состояния сервера в процессе поиска и устранения неисправностей. Рекомендуется не применять этот уровень в производственной среде, так как он может сильно уменьшить скорость работы системы. Если вы не решили эту проблему, используйте лучше уровень Предупреждение.	Очистка директорий сервера.
Выкл.	Ведение журнала отключено. События не заносятся в журнал портала.	Н/Д

Время

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

При выполнении запросов к журналам можно для отображения задать временные рамки.

Источник

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

Ниже приведены примеры:

Событие, связанное с картографическим сервисом SampleWorldCities, отображается как SampleWorldCities.MapServer.
После успешного создания кластера сервера на вашем сайте, в качестве компонента, зарегистрировавшего событие, отображается Admin.

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

Компьютер

Каждый компьютер сервера, участвующий в вашем сайте, ведёт набор журналов, специфичных для этого устройства. Если вы зарегистрировали ArcGIS Data Store на вашем сайте, каждый компьютер Хранилища данных также журналирует сообщения, относящиеся к данному компьютеру.

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

При выполнении запросов к журналам можно для отображения задать временные рамки.

Код

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

Прошло времени

Это время, которое (в миллисекундах) заняло завершение журналируемого события. Например, событие экспорта изображения веб-карты содержит прошедшее время, то есть время, потребовавшееся для экспорта изображения веб-карты.

Имя пользователя

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

Процесс

Это ID процесса компьютера, зарегистрировавшего событие.

Поток

Это поток процессов сервера, который сгенерировал сообщение.

ID запроса

Это уникальный текстовый ID, прикрепленный к каждому запросу, направленному на ArcGIS Server при отправке, который передается в течение всего жизненного цикла запроса в системе.

Название метода

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

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

Чтобы сузить события и отобрать релевантные сообщения, вы можете делать запросы по уровню журнала, возрасту журнала (времени), исходному компоненту и компьютеру. Можно сочетать несколько таких фильтров в запросе. Вы можете получить доступ к этим фильтрам на странице Просмотр журналов в Manager.

Фильтр журналов

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

Возраст

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


Приращение времени	Описание
Последние 15 минут	Отображает события, зафиксированные за последние 15 минут
Последний час	Отображает события, зафиксированные за последний час
Последние 6 часов	Отображает события, зафиксированные за последние шесть часов
Последние 24 часа	Отображает события, зафиксированные за последние сутки
Прошлая неделя	Показывают все события, зарегистрированные за последнюю неделю, или которые находятся во временных рамках, указанных вами на сайте для сохранения журналов на диске
С момента запуска	Показывают все события, зарегистрированные с момента последнего перезапуска сервера, или которые находятся во временных рамках, указанных вами на сайте для сохранения журналов на диске
Все	Показывают все события, зарегистрированные с момента установки ArcGIS Server, или которые находятся во временных рамках, заданных вами на сайте для сохранения журналов на диске

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

Помните, что запрос возвращает только журналы, которые находятся во временных рамках, заданных вами на сайте ArcGIS Server для сохранения журналов на диске. По умолчанию — 90 дней. Например, если вы настроили сайт на хранение журналов в течение пяти дней, выбор Последняя неделя из фильтра Возраст возвращает только журналы за последние пять дней.

Подсказка:

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

Источник

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

Примечание:

Источники Admin, Server, Rest и Soap, описанные ниже, собраны под уровнем Среда сервера фильтра Источник. Чтобы запросить эти источники, выберите Среда сервера в ниспадающем списке Источник.


Источник	Описание
Администратор	Означает, что сообщение было зарегистрировано административным API. Административный API – это уровень сервера, позволяющий управлять сервером, например создавать сайт, добавлять компьютеры, сервисы и настраивать кластеры.
Сервер	Означает, что сообщение было зарегистрировано той частью среды сервера, которая отвечает за создание экземпляров сервисов.
Rest	Означает, что сообщение было зарегистрировано обработчиком REST сервера. Компонент Rest журналирует сообщения на всех уровнях.
Soap	Означает, что сообщение было журналировано обработчиком SOAP сервера. Компонент Soap журналирует сообщения на всех уровнях.
ArcGIS Data Store	Означает, что сообщение было журналировано ArcGIS Data Store. Сообщения появляются только в том случае, если вы зарегистрировали ArcGIS Data Store в ArcGIS Server.
<имя сервиса>.FeatureServer	Исходный код — это сервис объектов.
<имя сервиса>.GeocodeServer	Исходный код — сервис геокодирования.
<имя сервиса>.GeoDataServer	Источник — это сервис геоданных.
<имя сервиса>.GeometryServer	Источник — это сервис геометрии.
Geometry.GeometryServer	Источником является предварительно настроенный сервис геометрии, установленный с ArcGIS Server.
<имя сервиса>.GPServer	Источник — это сервис геообработки.
CachingTools.GPServer	Источник состоит из предварительно настроенных инструментов кэширования, установленных с ArcGIS Server.
PrintingTools.GPServer	Источник – предварительно настроенный сервис PrintingTools, установленный с ArcGIS Server.
PublishingTools.GPServer	Источник состоит из предварительно опубликованных инструментов кэширования, установленных с ArcGIS Server.
<имя сервиса>.ImageServer	Источник — это сервис изображений.
<имя сервиса>.KmlServer	Источник — это сервис KML.
<имя сервиса>.MapServer	Источник — это картографический сервис.
<имя сервиса>.NAServer	Источник — это сервис сетевого анализа.
<имя сервиса>.WCSServer	Источник — это веб-сервис покрытий.
<имя сервиса>.WFSServer	Источник — это Web Feature Service.
<имя сервиса>.WMServer	Источник — это сервис Workflow Manager.
<имя сервиса>.WMSServer	Источник — Web Map Service.
<имя сервиса>.WMTSServer	Источник — Web Map Tile Service.
<имя сервиса>.WPSServer	Исходный код — это Web Processing Service.
<имя сервиса>.SceneServer	Источник — это сервис сцены.
<имя сервиса>.SchematicsServer	Источник — сервис Schematics.
<имя сервиса>.SearchServer	Источник — это сервис поиска.
SampleWorldCities.MapServer	Источник – предварительно настроенный картографический сервис SampleWorldCities, установленный с ArcGIS Server.
Search.SearchServer	Источником является предварительно настроенный сервис поиска, установленный с ArcGIS Server.
Search_indexer.GPServer	Источник — это сопутствующий сервис геообработки _indexer заранее настроенного поиска.
<название сервиса поиска>_indexer.GPServer	Источник — это сервис геообработки _indexer сервиса поиска.

Компьютер

Каждый компьютер сервера, участвующий в вашем сайте, ведёт ряд журналов, специфичных для этого устройства. Также, если вы зарегистрировали ArcGIS Data Store на своем сайте, каждый компьютер Хранилища данных также журналирует сообщения, относящиеся к данному компьютеру.

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

Пролистывание журналов сервера

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

Если ваш запрос возвращает более 1000 сообщений, перейдите к следующему набору записей, нажав на кнопку Старше внизу окна журнала. Точно также переключите страницу вперёд во времени, нажав Новее.

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

Просмотр журналов в формате, подходящем для печати

После выполнения запроса нажмите на ссылку Вид, подходящий для печати, чтобы просмотреть журналы в формате, удобном для печати. Откроется новое окно браузера (или вкладка), отображающее журналы в HTML. Вы можете использовать этот вид для печати журналов, сохранения HTML на диск или копирования и вставки журналов в документ или таблицу. Таким путем, вы можете обмениваться сообщениями журнала с другими пользователями организации и, если необходимо, со службой технической поддержки Esri.

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

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

Нажмите Удалить журналы, чтобы удалить все сообщения журнала с каждого сервера, участвующего в вашем сайте. После нажатия Удалить журналы вам будет предложено подтвердить решение удалить все журналы.

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