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

Параметры ведения журнала в глобальной области хранятся в следующем разделе реестра: HKLM\Comm\ApplicationDownload\Logging.

Параметры ведения журнала в области компонента хранятся в подразделе глобального раздела. Этот подраздел имеет имя компонента, как показано в следующем примере: HKLM\Comm\ApplicationDownload\Logging\<Имя_компонента>. Например, если в качестве имени компонента процесс вызывает имя "Component1", процессом этого компонента можно управлять с помощью параметров следующего раздела: HKLM\Comm\ApplicationDownload\Logging\Component1.

Минимальное и максимальное значения

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

Инфраструктура ведения журнала не обнаруживает изменений в параметрах динамически. Параметры считываются при запуске службы клиента. Чтобы обновленные параметры вступили в силу, после внесения изменений необходимо перезапустить службу управления устройствами. Это можно сделать с помощью значка "Управление устройствами" панели управления.

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

• DMInstaller[дата:время].log
  
  
• DMClientSetup[дата:время].log
  
  
• DMSvc[дата:время].log
  
  

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

<Имя_компонента>-<Отметка_даты>-<Отметка_времени>.log

• <Имя_компонента> — это имя компонента, передаваемое в функцию InitLogger.
  
  
• <Отметка_даты> — это дата создания файла журнала в формате "ДДММГГГГ".
  
  
• <Отметка_времени> — это универсальное координированное время (UTC) создания файла журнала в формате "ччммсс".
  
  

Например, если имя компонента — "Component1", и файл журнала был создан 13 июня 2006 г. в 13:05 (UTC), имя файла журнала будет следующим: Component1-13062006-130500.log.

Когда размер файла журнала превышает значение параметра MaxLogSizeBytes, файл "продолжается". Это означает, что он закрывается, и создается новый файл. Когда общее число файлов журнала для компонента (открытых в настоящее время и "продолженных") превышает значение параметра MaxLogCount, самый старый файл удаляется.

Инфраструктура ведения журнала создает записи журнала в формате, удобном для чтения с помощью средства просмотра журналов SMS Trace (smstrace.exe). Ниже перечислены элементы, которые содержит каждая запись.

• Текст журнала: текст журнала, созданный макросом ведения журнала (подробные сведения, информационные сообщения, предупреждения, сообщения об ошибках).
  
  
• Отметка времени (местное время).
  
  
• Отметка даты (местное время).
  
  
• Тип журнала: 0 — для журнала подробных сведений, 1 — для журнала информационных сообщений, 2 — для журнала предупреждений, 3 — для журнала сообщений об ошибках.
  
  
• Поток
  
  
• Исходный файл
  
  

Включение уровней ведения журнала

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

• Уровень подробных сведений: используйте журнал подробных сведений только для сообщений, которые помогают персоналу службы поддержки и службе поддержки Майкрософт при поиске и устранении неполадок в мобильном устройстве. При подробном ведении журнала предоставляются подробные сведения. Примеры данных, регистрируемых при подробном ведении журнала: события входа в функцию трассировки и выхода из нее; параметры, переданные в функции, и т. д. Подробные сообщения записываются в файл журнала, если параметр LogLevel имеет значение 0.
  
  

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

• Уровень информационных сообщений: используйте информационный журнал для сообщений, которые уведомляют конечного пользователя или персонал службы поддержки о не связанных с ошибками событиях, касающихся функциональных аспектов мобильного устройства. Примеры — начало и окончание выполнения той или иной функции, например "Загрузка пакета" или "Загрузка пакета завершена". Информационные сообщения записываются в файл журнала, если параметр LogLevel имеет значение 1 или менее.
  
  
• Уровень предупреждающих сообщений: используйте предупреждающие сообщения журнала для уведомления пользователя о состоянии ошибки, которое обрабатывается и не означает сбой в работе мобильного устройства, но может быть полезно для дальнейшего изучения. Предупреждающие сообщения записываются в файл только в том случае, если параметр LogLevel имеет значение 2 или менее.
  
  
• Уровень сообщений об ошибках: используйте сообщения об ошибках журнала для уведомления пользователя о состоянии ошибки, которое означает сбой в функциональном аспекте продукта, например "Не удалось загрузить пакет" или "Проверка хэша пакета завершилась неуспешно". Сообщения об ошибках всегда записываются в файл журнала.
  
  

Подробное ведение журнала можно включить с помощью файла DMCommonInstaller.ini или ClientSettins.ini во время установки или обновления, задав для параметра EnableVerboseLogging значение True. При этом подробное ведение журнала включается на любом клиенте, установленном или обновленном с помощью данного файла DMCommonInstaller.ini или ClientSettings.ini. Подробное ведение журнала или любой уровень ведения журнала можно включить на конкретных мобильных устройствах, управляемых приложением Microsoft System Center Configuration Manager 2007, используя элемент конфигурации реестра для развертывания необходимых разделов реестра и значений из приведенной выше таблицы. Параметры журнала можно также изменить с помощью распространяемого с пакетом конфигурации параметра реестра элемента конфигурации. Изменения в параметрах ведения журнала вступают в силу только после перезагрузки клиента мобильного устройства. Это можно сделать, выполнив программный сброс мобильного устройства.

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

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

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

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

	Скопировать код
<wap-provisioningdoc> <characteristic type="Registry"> <characteristic type="HKLM\Comm\ApplicationDownload\Logging"> <parm-query name="LogDirectory"/> <parm-query name="MaxLogSizeBytes"/> <parm-query name="MaxLogCount"/> <parm-query name="LogLevel"/> </characteristic> </characteristic> </wap-provisioningdoc>

Настройка параметров ведения журнала

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

Скопировать код

<wap-provisioningdoc> <characteristic type="Registry"> <characteristic type="HKLM\Comm\ApplicationDownload\Logging"> <parm name="LogDirectory" value="\Temp\Logs" datatype="string"/> <parm name="MaxLogSizeBytes" value="7000" datatype="integer"/> <parm name="MaxLogCount" value="7" datatype="integer"/> <parm name="LogLevel" value="0" datatype="integer"/> </characteristic> </characteristic> </wap-provisioningdoc>

Файлы журналов клиентов мобильных устройств находятся в следующих местах:

• на клиентских компьютерах Configuration Manager 2007 с центром мобильных устройств или приложением ActiveSync;
  
  
• на устройствах Windows CE и Windows Mobile Pocket PC;
  
  
• на устройствах Windows Mobile 5 Smartphone и Windows Mobile 6 Standard;
  
  
• на устройствах Windows Mobile 2003 Smartphone.
  
  

  Местоположение	Путь	Файлы журналов
  На управляемых ПК Configuration Manager 2007 с приложением ActiveSync или центром мобильных устройств	%temp%\SmsDm во временной папке пользователя	DmClientXfer.log DmCommonInstaller.log DmInvExtension.log
  На всех устройствах Windows CE, Windows Mobile Pocket PC и Windows Mobile 6 Professional	\temp\DmClientLogs	DmCertEnroll...log DmClientSetup…log DmInstaller…log DmSvc…log DMCertResp.htm (в папке \temp)
  На устройствах Windows Mobile Smartphone 5 и Windows Mobile 6 Standard	\ Temp\DmClientLogs в папке хранилища мобильного устройства или \temp\DMClientLogs в файловой системе мобильного устройства	DmCertEnroll...log DmClientSetup…log DmInstaller…log DmSvc…log DMCertResp.htm
  На устройствах Windows Mobile Smartphone 2003	\Storage\temp\DMClientLogs	DmCertEnroll...log DmClientSetup…log DmInstaller…log DmSvc…log DMCertResp.htm
  На сервере сайта управления устройствами без установленного клиента Configuration Manager 2007	<Папка_установки> \ CCM \ Logs	DmClientHealth.log DmClientRegistration.log DmpDatastore.log DmpDiscovery.log DmpFileCollection.log DmpHardware.log DmpIsapi.log DmpSoftware.log DmpStatus.log FspIsapi.log
  	<Папка_установки> \Logs	DmpMSI.log DmpSetup.log Fspmgr.log fspMSI.log
  	\%windir%\System32\Logfiles\W3SVC1	Любые журналы IIS (именованные по дате и времени)
  На серверах сайта с установленными клиентами Configuration Manager 2007	Путь установки каталога Configuration Manager 2007: \%windir%\System32\CCM	DmClientHealth.log DmClientRegistration.log DmpDatastore.log DmpDiscovery.log DmpFileCollection.log DmpHardware.log DmpIsapi.log DmpSoftware.log DmpStatus.log FspIsapi.log

Задачи

Основные понятия

Другие ресурсы