Работа с журналами сервера—Документация (10.4)

Отслеживание журналов сервера поможет вам определить ошибки и решить возникшие с сайтом проблемы. Используйте ArcGIS Server 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.

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

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

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

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

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

Подсказка:

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

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

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

По умолчанию только свойства Уровень (Level), Время (Time), Сообщение (Message) и Источник (Source) отображаются в окне сообщений журнала. Если вы хотите добавить или удалить свойства с экрана, выберите Столбцы (Columns).

Подсказка:

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

В приведенных ниже разделах эта информация описывается более подробно.

Уровень

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

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

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

Время

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

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

Источник

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

Например:

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

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

Компьютер

Каждый компьютер с ГИС-сервером, участвующий в сайте, поддерживает собственный набор журналов, относящихся к этому компьютеру. Также, если вы зарегистрировали ArcGIS Data Store на вашем сайте, каждое Data Store (хранилище данных) регистрирует сообщения, относящиеся к данной машине.

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

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

Код

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

Прошедшее время

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

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

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

Процесс

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

Поток

Поток процессов сервера, создавшего сообщения.

Имя метода

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

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

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

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

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

Возраст

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

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

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

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

Подсказка:

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

Источник

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

Примечание:

Источники Admin, Server, Rest и Soap, представленные ниже, собраны под уровнем Система сервера (Server Framework) фильтра Источник (Source). Для запроса данных источников выберите Система сервера (Server Framework) из ниспадающего фильтра Источник (Source).

Источник	Описание
Admin	Указывает, что сообщение зарегистрировано администрирующим 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.
<имя_сервиса>.GlobeServer	Источник – сервис глобуса.
<имя_сервиса>.GPServer	Источник – сервис геообработки.
CachingTools.GPServer	Источник состоит из предварительно настроенных инструментов кэширования, установленных с ArcGIS Server.
PrintingTools.GPServer	Источник – предварительно настроенный сервис PrintingTools, установленный с ArcGIS Server.
PublishingTools.GPServer	Источник состоит из предварительно настроенных инструментов издания, установленных с ArcGIS Server.
<имя_сервиса>.ImageServer	Источник – сервис изображений.
<имя_сервиса>.JPIPServer	Источник – сервис JPIP.
<имя_сервиса>.KmlServer	Источник – сервис KML.
<имя_сервиса>.MapServer	Источник – картографический сервис.
<имя_сервиса>.MobileServer	Источник – сервис мобильных данных.
<имя_сервиса>.NAServer	Источник – сервис сетевого анализа.
<имя_сервиса>.WCSServer	Источник – веб-сервис покрытий.
<имя_сервиса>.WFSServer	Источник – сервис веб-объектов.
<имя_сервиса>.WMServer	Источник – сервис Workflow Manager.
<имя_сервиса>.WMSServer	Источник – картографический веб-сервис.
<имя_сервиса>.WMTSServer	Источник – WMTS-сервис.
<имя_сервиса>.WPSServer	Источник – сервис веб-обработки.
<servicename>.SceneServer	Источник – сервис сцены.
<имя_сервиса>.SchematicsServer	Источник – сервис схематики.
<имя_сервиса>.SearchServer	Источник – поисковый сервис.
SampleWorldCities.MapServer	Источник – предварительно настроенный картографический сервис SampleWorldCities, установленный с ArcGIS Server.
Search.SearchServer	Источник – предварительно настроенный поисковый сервис, установленный с ArcGIS Server.
Search_indexer.GPServer	Источник – предварительно настроенный сервис геообработки _indexer, поддерживающий поисковый сервис.
<имя_поискового_сервиса>_indexer.GPServer	Источник – сервис геообработки _indexer, поддерживающий поисковый сервис.

Компьютер

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

Перемещение по страницам журналов сервера

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

Если запрос возвращает более 1000 сообщений, перейдите на следующую страницу записей, нажав кнопку Ранее, расположенную в нижней части окна журнала. Аналогичным образом перейдите на страницу вперед, нажав кнопку Позднее.

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

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

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

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

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

Щёлкните Удалить журналы для удаления всех сообщений журналов с каждого сервера ГИС, участвующего в сайте. Вам потребуется подтвердить удаление всех журналов после нажатия кнопки Удалить журналы.

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

Отзыв по этому разделу?