次の方法で共有

Windows Mobile および Windows CE デバイスのログの構成方法

  • [アーティクル]

適用対象: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

Microsoft System Center Configuration Manager 2007 のモバイル デバイス用ログにより、管理者は、モバイル デバイスおよびサーバーにおけるモバイル デバイス管理アクティビティの評価およびトラブルシューティングを行うことができます。Configuration Manager 2007 では、モバイル デバイスのログ機能が大幅に強化されました。Configuration Manager 2007 には、SMSTrace.exe を使用してデバイス クライアント ログを読み取る機能、およびログ フレームワークを使用してモバイル デバイスのログの詳細レベルを構成する機能があります。モバイル デバイスのクライアント ログ フレームワークは、モバイル デバイスのレジストリ設定で構成します。次の 3 レベルの範囲で設定を構成できます。

  • ［コンポーネント］

  • グローバル

  • 既定

設定範囲

記録可能な各プロセスはコンポーネント名を指定します。コンポーネント範囲でログ設定を指定すると、そのコンポーネント範囲が存在する場合はその範囲が使用されます。コンポーネント範囲にログ設定が存在しない場合、グローバル範囲で宣言されているログ設定が使用されます。グローバル範囲に設定が存在しない場合は、ログ フレームワークで定義した既定設定が使用されます。

グローバル範囲のログ設定は、次のレジストリ キーに保存されます。 HKLM\Comm\ApplicationDownload\Logging.

コンポーネント範囲のログ設定は、グローバル キーのサブキーに保存されます。サブキーの名前は、HKLM\Comm\ApplicationDownload\Logging\<コンポーネント名> のようにコンポーネント名になります。たとえばプロセスが "Component1" をコンポーネント名として呼び出す場合、そのコンポーネントのプロセスは、次のキーの設定によって制御されます。 HKLM\Comm\ApplicationDownload\Logging\Component1.

最小値および最大値

一部のログ設定のフレームワークでは、最小値および最大値が定義されています。このため、ユーザーは、モバイル デバイスに悪影響がある値をレジストリに設定したり、意味のある情報を収集するには小さすぎる値を設定したりすることができません。

レジストリ設定値が許容最小値より小さい場合は、最小値が使用されます。レジストリ設定値が許容最大値より大きい場合は、最大値が使用されます。

［設定］

使用可能なログ設定について、次の表で説明します。この設定は、グローバルおよびコンポーネントの両方のレジストリ キーに保存できます。設定名は、キーの下のレジストリ値の名前です。

設定名 ［種類］ 最小値 最大値 既定値 説明

LogDirectory

REG_SZ

該当なし

該当なし

Windows Mobile Smartphone 2003 の "\Temp\DMClientLogs" は、\Storage\temp\DMClientLogs にリダイレクトされます。

ログ ファイルが作成されるディレクトリ。

MaxLogSizeBytes

DWORD

1024 (1 KB)

1048576 (1 MB)

32 KB

ファイルがロール オーバーする前のコンポーネントのログ ファイルの最大サイズ (バイト単位)。

MaxLogCount

DWORD

2

24

5

コンポーネントのログ ファイルの最大数。ファイル数がこの制限を超えた場合は、最も古いファイルが削除されます。

LogLevel

DWORD

0 (詳細)

3 (エラー)

3 (エラー)

ログに書き込まれるログ ステートメントの最小タイプを指定します。ログ ステートメントがこの設定を下回る場合、そのログ ステートメントは無視されます。3 (エラー) より高い値を指定すると、すべてのステートメントがログ ファイルに書き込まれません(実質的にログが無効になります)。

ログ フレームワークは、設定の変更をすぐには検出しません。設定は、クライアント サービスの起動時に読み取られます。更新した設定を適用するには、変更後にデバイス管理サービスを再起動する必要があります。これは、デバイス管理コントロール パネルで実行できます。

モバイル デバイス クライアントのインストールのログ ファイル

モバイル デバイスでモバイル デバイス クライアント インストールを実行すると、モバイル デバイスにログ ファイルが生成されます。インストールが完了したことをログ ファイルで確認できます。クライアント インストールが正常に終了すると、次のログ ファイルがモバイル デバイスに作成されます。

  • DMInstaller[date:time].log

  • DMClientSetup[date:time].log

  • DMSvc[date:time].log

名前付け規則

ログ フレームワークでは、コンポーネントごとに一連のログ ファイルが管理されます。ログ プロセスが呼び出されると、新しいログ ファイルが作成されるか、コンポーネントの既存ログ ファイルが開きます。ログ ファイルは、次の説明のようにロール オーバーするまで書き込まれます。すべてのログ ファイル名は次の形式になっています。

<コンポーネント名>-<日付>-<時刻>.log

  • <コンポーネント名> は、InitLogger 関数に渡されたコンポーネントの名前です。

  • <日付> は、ログ ファイルが生成された日付であり、YYYYMMDD という形式になります。

  • <時刻> は、ログ ファイルが作成された UTC 時刻であり、hhmmss という形式になります。

たとえばコンポーネント名が "Component1" であり、ログ ファイルが 2006 年 6 月 13 日午前 1 時 5 分に作成された場合、ログ ファイル名は Component1-20060613-130500.log になります。

ロールオーバー

ログ ファイルは、MaxLogSizeBytes 設定を超えると "ロール オーバー" します。つまり、そのログ ファイルは閉じて、新しいログ ファイルが作成されます。コンポーネントのログ ファイル総数 (現在開いているログ ファイル、およびロール オーバーしたログ ファイル) が MaxLogCount 設定を超えると、最も古いファイルが削除されます。

フォーマット

ログ フレームワークでは、SMS Trace (smstrace.exe) ログ ビューアが読み取ることができるフォーマットでログ エントリが書き込まれます。各エントリには次の項目が含まれます。

  • ログ テキスト - ログ マクロから出力されたログ テキスト (詳細、情報、警告、エラー)

  • タイムスタンプ (ローカル時刻)

  • 日付スタンプ (ローカル時刻)

  • ログ タイプ - 詳細の場合は 0、情報の場合は 1、警告の場合は 2、エラーの場合は 3

  • スレッド

  • ソース ファイル

ログ レベルの有効化

次のガイドラインを使用して、どのログ レベルを使用するかを判断してください。

  • 詳細 :モバイル デバイスの問題をトラブルシューティングするサポート要員および Microsoft サポート サービスに支援を要請するステートメントのみに、詳細ログ ステートメントを使用します。詳細ログでは詳細情報が提供されます。詳細ログに記録されるデータとしては、トレース機能の入出力、関数に渡されたパラメータなどがあります。詳細ログ ステートメントは、LogLevel が 0 である場合にログ ファイルに書き込まれます。

注意

詳細ログは慎重に使用してください。不正確な設定で使用すると、モバイル デバイスがログ ファイルで過負荷になることがあります。

  • 情報 :モバイル デバイスの機能的な側面に関連する、エラー以外のイベントについて、エンド ユーザーまたはサポート要員に通知するステートメントには、情報ログ ステートメントを使用します。例として、"パッケージのダウンロード中" や "パッケージ ダウンロードの正常終了" など、機能的な動作の開始および終了を挙げることができます。情報ログ ステートメントは、LogLevel 設定が 1 以下である場合にログ ファイルに書き込まれます。

  • 警告 :処理されてモバイル デバイスの機能障害を示していないが、さらに調査するために役立つエラー条件についてユーザーに通知するには、警告ログ ステートメントを使用します。警告ログ ステートメントは、LogLevel 設定が 2 以下である場合にファイルに書き込まれます。

  • ［エラー］:"パッケージ ダウンロード エラー" または "パッケージ ハッシュ検証エラー" など、製品の機能的な側面における障害を示すエラー条件についてユーザーに通知するには、エラー ログ ステートメントを使用します。エラー ログ ステートメントは、常にログ ファイルに書き込まれます。

詳細ログは、DMCommonInstaller.ini ファイルまたは ClientSettins.ini ファイルでセットアップ中またはアップグレード中に EnableVerboseLogging 値を True に設定すると有効になります。これにより、DMCommonInstaller.ini ファイルまたは ClientSettings.ini ファイルでインストールか更新が行われるすべてのクライアントで、詳細ログが有効になります。レジストリ構成項目を使用して必要なレジストリ キーおよび値を前述の表から展開すると、Microsoft System Center Configuration Manager 2007 によって管理される特定のモバイル デバイスで詳細ログまたは任意のログ レベルを有効にすることができます。構成パッケージで配布される構成項目レジストリ設定を使用し、ログ設定を変更することもできます。ログ設定の変更は、モバイル デバイス クライアントを再起動するまで有効になりません。これは、モバイル デバイスのソフト リセットを実行して行うことができます。

注意

Microsoft のサポート担当者の指示がない限り、詳細ログ レベルは使用しないことをお勧めします。詳細ログで提供されるデータには、企業サポート担当者にとって価値があまりありません。

ログ構成ドキュメントの例

ログ設定はレジストリに保存されるので、レジストリ構成サービス プロバイダ (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>

ログ ファイルの場所

モバイル デバイスのクライアント ログ ファイルは、次の場所にあります。

  • Mobile デバイス センターまたは Active Sync Configuration Manager 2007 のコンピュータ クライアント

  • Windows CE デバイスおよび Windows Mobile Pocket PC デバイス

  • Windows Mobile 5 Smartphone デバイスおよび Windows Mobile 6 Standard デバイス

  • Windows Mobile 2003 Smartphone デバイス

    ［場所］ ［パス］ ログ ファイル

    Active Sync または Mobile デバイス センター Configuration Manager 2007 の管理対象デスクトップ

    ユーザーの一時フォルダの %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

参照:

タスク

コンポーネントのログを有効にする方法

概念

モバイル デバイス クライアントのインストールまたはアップグレードの検証方法

その他のリソース

モバイル デバイス クライアント構成の .ini ファイルの編集方法
レジストリのプロパティ

その他の情報については、「Configuration Manager 2007 Information and Support」 (Configuration Manager 2007 の情報とサポート) を参照してください。
ドキュメント チームに連絡するには、次のアドレスに電子メールを送信してください。 SMSdocs@microsoft.com.