Ведение журналов Microsoft System Center Configuration Manager 2007 для мобильных устройств позволяет администраторам оценивать выполняемые на мобильном устройстве и сервере действия по управлению мобильными устройствами и выявлять причины возникновения проблем, связанных с этими действиями. Возможности ведения журналов для мобильных устройств в Configuration Manager 2007 значительно расширены. В Configuration Manager 2007 теперь предусмотрены возможность чтения журналов клиентов устройств с помощью программы SMSTrace.exe и возможность настройки уровня детализации ведения журналов на мобильных устройствах с помощью инфраструктуры ведения журналов. Инфраструктура ведения журнала клиента мобильного устройства настраивается посредством параметров реестра на мобильном устройстве. Существуют три уровня, где можно задавать параметры:

Область параметров

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

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

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

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

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

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

Параметры

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

Имя параметра Тип Мин. значение Макс. значение Значение по умолчанию Описание

LogDirectory

REG_SZ

Не применяется

Не применяется

"\Temp\DMClientLogs". В Windows Mobile Smartphone 2003 этот каталог перенаправляется в каталог \Storage\temp\DMClientLogs

Каталог, где создаются файлы журнала.

MaxLogSizeBytes

DWORD

1024 (1 КБ)

1048576 (1 МБ)

32 КБ

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

MaxLogCount

DWORD

2

24

5

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

LogLevel

DWORD

0 (подробные сведения)

3 (сообщения об ошибках)

3 (сообщения об ошибках)

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

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

Файлы журнала установки клиента мобильного устройства

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

  • 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

См. также