テレメトリ ログを使用した Office ファイルおよびカスタム ソリューションのトラブルシューティング

Office 2013 テレメトリ ログ を使用して、Office 2013 と以前のバージョンの Office 用に構築されたソリューションの互換性に関する問題を特定します。

次の記事は、テレメトリ ログとその使用方法について説明します。 テレメトリ ログに表示される具体的な結果の詳細については、「Office の互換性に関する問題」を参照してください。

マイクロソフトは、数多くのリリースにわたって Office をカスタマイズ、自動化、および拡張するツールやフレームワークを提供してきました。 これによって、企業やユーザーが、生産性と効率性を向上させる Office アプリケーション用のソリューションやアドインを作成できるようになりました。 これらのソリューションは、単純な Visual Basic for Applications (VBA) マクロから堅牢な .NET Framework のカスタマイズまで、複雑さの範囲はさまざまです。 多くのユーザーは、ビジネスに不可欠なタスクの実施をこれらのソリューションに依存し、使用している Office アプリケーションにカスタマイズ機能を追加して使用していることにさえ気付いていないことがあります。

このような Office ソリューションの急増により、Office のバージョンのアップグレードは複雑になる可能性があります。 企業とユーザーは、重要で貴重なソリューションが新しいバージョンと完全に互換性があるかどうかはわかりません。 これらのソリューションでは、以前のバージョンの Office で使用できる機能とコンピューター コードが使用され、以降のバージョンでは非推奨になりました。 非推奨の機能を使用するソリューションが "ホスト" アプリケーションに読み込まれると、ソリューションの動作が異なる、エラーが発生する、読み込みに失敗する、またはホスト アプリケーションが失敗する可能性があります。

Excel 2013 を基に構築されたツールである Office 2013 のテレメトリ ログは、一部の Office 2013 アプリケーション内で発生するイベントを表示することで、開発者や経験豊富なユーザーが互換性の問題を診断するのに役立ちます。 このツールを使用すると、ユーザーは自分の作業環境で使用するアドインに関する潜在的な問題を特定し、企業の意思決定者に Office 2013 にアップグレードするかどうかを決定するために必要な情報を提供できます。 テレメトリ ログでは、Office 2013 アプリケーションのオブジェクト モデルの特定の変更や非推奨に関する詳細なフィードバックも提供されます。これにより、開発者は問題のあるコードやコントロールをすばやく特定してリファクタリングできます。 IT プロフェッショナルは、テレメトリ ログのコンパニオン ツールである Office 2013 のテレメトリ ダッシュボードを使用して、複数のクライアント間のソリューション正常性の傾向を表示できます。

詳細については、「Office テレメトリ ダッシュボードを展開する」を参照してください。

テレメトリ ログで監視する問題

ある Office 2013 アプリケーションで、Office ファイルまたはソリューションを読み込む、使用する、閉じるなどのイベントやエラーが発生すると、このアプリケーションは発生したイベントに関する情報を含む記録をローカル データ ストア (同じコンピューター上のデータベース) に追加します。 この記録は、イベントのタイトル、イベントのログを収集したアプリケーション、時間、ファイルまたはソリューションの名前、重大度、および発生したエラーの簡単な説明で構成されます。 最新の情報に更新すると、ローカル データ ストアに格納された記録のリストが テレメトリ ログ ワークブックに表示されます。

実行された Office 2013 アプリケーションの実行時ログ収集 API により、次のイベントが発生する度に記録がローカル データ ストアに作成されます。

• OnLoad: ファイルまたはソリューションが特定の Office 2013 アプリケーションに読み込まれると、ローカル データ ストアに記録が書き込まれます。 OnLoad イベントが発生すると、実行時エラーのログにファイル名、場所、およびその他の情報がローカル データ ストアに記録されます。

• OnClose: ファイルまたはソリューションがアプリケーション内で閉じられると、ローカル データ ストアに記録が書き込まれます。 記録には、ソリューションまたはファイルの名前、場所、およびイベントが発生したアプリケーションが書き込まれます。

• OnError: ある特定の Office 2013 アプリケーションのソリューションでエラーが見つかると、記録が書き込まれます。 記録には、ソリューションまたはファイルの名前と発生した実行時エラーまたは互換性の問題が書き込まれます。 既知の問題である場合は、エラーがその互換性の問題にマップされ、テレメトリ ログ にそのように表示されることがあります。

テレメトリ ログ には、選択した Office 2013 アプリケーションについて、ファイルやソリューションの種類に関する多数の項目が表示されます。 実行時ログ収集 API によって監視されるファイルとソリューションの種類は、アプリケーションによって異なります。 監視されるソリューションの種類について詳しくは、表 1 を参照してください。

表 1. テレメトリ ログ でトラッキングされる Office ファイルやソリューションの種類

テレメトリ ログ 2013 を使用する

Office 2013 をインストールすると、テレメトリ ログ がインストールされるほか、同じコンピューターにローカル データ ストアが作成され、前に挙げた Office 2013 アプリケーションで実行時ログ収集 API を使用できます。 ただし、テレメトリ ログ で監視を開始する前に、ソリューションまたはファイルがアプリケーションに読み込まれているか、開かれている必要があります。

次の手順を使用して、テレメトリ ログ に記録された Office の問題を表示します。

テレメトリ ログ の使用方法

1. テレメトリ ログ を開くには、次のいずれかの操作を行います。

   • Windows 7 の場合: [ スタート] メニューの [ すべてのプログラム] をクリックします。 次に、プログラムの一覧で、[ Microsoft Office 2013]、[ Office 2013 ツール] の順に展開し、[ テレメトリ ログ 2013] をクリックします。

     Excel 2013 で新しいブックが開きます。 このブックには、[イベント]、[システム情報]、および [ガイド] という 3 つのワークシートがあります。

   • Windows 8 の場合: 上方向にスワイプして AppBar を表示し、[ すべてのアプリ]、[ テレメトリ ログ 2013] の順に選択します。

     Excel 2013 で新しいブックが開きます。 このブックには、[イベント]、[システム情報]、および [ガイド] という 3 つのワークシートがあります。

2. 最新のイベント一覧を表示するには、[イベント] ワークシートの最上部にある [最新の情報に更新] をクリックします。

3. Office 2013 アプリケーションから収集されたイベント データを確認するには、[ イベント] ワークシートの表を確認します。

4. Office 2013 および テレメトリ ログ がインストールされたコンピューターの情報を確認するには、[ システム情報] ワークシートの情報を確認します。

テレメトリ ログには、記録されたイベントに関する簡単な情報が表示されます。 テレメトリ ログに表示される各レコードには、タイトルが含まれており、表示されるイベントの重大度が一覧表示されます。 エラーの場合、レコードにはエラーの説明と問題に対処するための手順も含まれます。 表示されるすべてのレコードが Office ソリューションによって発生したエラーを表すわけではないことに注意してください。テレメトリ ログには、ソリューションとファイルが正常に読み込まれたり閉じられたりするタイミングも表示されます。

たとえば、「非推奨オブジェクト モデル: Comment.Initial プロパティ」というタイトルの問題は、Word 2013 で開かれたソリューションまたはマクロ有効ファイルによって、コメントに関連付けられているコメント投稿者のイニシャルの取得が試行されると発生します。 Word 2013 ではコメント機能の操作性が向上しているため、既定ではコメント投稿者のイニシャルが表示されません。 以前のコメント機能のモデルに関連付けられている API は Word 2013 オブジェクト モデルに表示されませんが、下位互換性のために残されています。 「非推奨オブジェクト モデル: Comment.Initial」の問題は、API の使用を試行したファイル、イベントが発生したアプリケーション (Word 2013)、イベントが発生した時間と日付、およびエラーに関する簡単な説明と修復する方法を示します。

図 1. Office テレメトリ ログ

テレメトリ ログ には、既知の問題とともに重大度のレベルが表示されます。 前に挙げた例のように、オブジェクト モデルの一部が非推奨となっている問題の重大度は、多くの場合「情報」レベルです。 その一方で、他の既知の問題はより重大で、よりすばやいアクションが必要な場合があります。 テレメトリ ログ に表示される問題の重大度は、次のいずれかです。

• 情報 アプリケーションの互換性に即時の影響を与える問題ではないが、後でアクションを取る必要がある場合があります。 「非推奨オブジェクト モデル」のような問題の多くはこの重大度レベルです。
• 警告 データ損失や表示の忠実性の低下を引き起こす可能性のある問題です。
• 重大 機能の大幅な損失やアプリケーションのクラッシュを引き起こす可能性のある問題です。

表 2. テレメトリ ログに表示されるイベントの種類

以下の表 (表 2) を使用して、テレメトリ ログに表示されるレコードを解釈してください。

終わりに

テレメトリ ログ は、重要な Office ソリューションを監視するための簡単なツールを大企業、個人ユーザー、および開発者に提供します。 大規模なアップグレードの前に問題のある Office ソリューションを特定することによって、企業は Office 2013 を採用するコストをより正確に見積もることができます。

関連項目

• Office デベロッパー センター
• Office の互換性に関する問題
• Office テレメトリ ダッシュボードを展開する