パフォーマンスと診断のページからの分析ツールの実行

Visual Studio プロファイラーと診断ツールを使用して、Windows ストア アプリおよび Windows Phone アプリのパフォーマンス、メモリ使用量、エネルギー消費を分析できます。 パフォーマンスと診断ハブを使用すると、これらのツールを選択して実行し、1 つの診断に複数のツールの組み合わせ、それらが生成したレポートを管理することが簡単にできます。 ほとんどの配置ターゲットでツールを実行できます。 Windows Phone アプリには、電話またはエミュレーターを使用します。 Windows ストア アプリには、Visual Studio コンピューター、シミュレーター、またはリモート PC を使用します。 データを収集したら、診断レポートにタイムライン グラフとデータの詳細ビューが表示されます。 パフォーマンスと診断レポートのフィルターと設定を使用して、データの重要な部分にフォーカスすることができます。

パフォーマンスと診断ハブのツール

パフォーマンスと診断ハブには、特定の種類のアプリ (XAML と C#/VB/C++ または HTML と JavaScript) で使用できるツールと単一の診断で使用できるツールが示されます。

この記事の内容

• クイック スタート: 診断データの収集

• 診断データの収集

  ユーザー マークを追加して、診断データでの場所を識別します。 | スタートアップ プロジェクトの設定 | 分析ターゲットの設定 | 診断セッションで実行するツールの選択 | 診断セッションの開始と停止

• 診断セッション ファイルを開く

• パフォーマンスと診断データ ページ

• トラブルシューティング

クイック スタート: 診断データの収集

1. Visual Studio でプロジェクトを開きます。

2. 配置場所を設定します。

   	Windows Phone アプリは電話または Visual Studio エミュレーターの 1 つに配置できます。
   	Windows ストア アプリは、Visual Studio コンピューター、Visual Studio シミュレーター、またはネットワークに接続されたコンピューターまたはタブレットに配置できます。 メモ: リモート PC またはタブレットで診断セッションを実行するには、Visual Studio Remote Tools がインストールされていて、リモート ターゲットで実行されている必要があります。 以下を参照してください。リモート マシンでの Visual Studio からの Windows ストア アプリの実行

   デバッガーのツール バーのデバッグの場所の一覧で、アプリの配置場所を選択します。 次に電話アプリの一覧を示します。

   

3. パフォーマンスと診断セッションを開きます。 [デバック] メニューの [パフォーマンスと診断] をクリックします (ショートカット キー: Alt + F2 キー)。

4. パフォーマンスと診断ハブで、1 つ以上のツールを選択して、セッションで実行します。 プロジェクトの種類およびプログラミング言語に適用されるツールのみが表示されます。 診断ツールを選択すると、同じ診断セッションで実行できないツールの選択が無効になります。 次に、選択したツールが JavaScript アプリを検索する方法を示します。

   

5. 診断セッションを開始するには、[開始] をクリックします。

6. データを収集するシナリオを実行します。

   セッションを実行している間に、ツールによってはパフォーマンスと診断ページのリアルタイム データが表示されます。

   

7. 診断セッションを終了するには、[コレクションの停止] をクリックします。

診断データの収集

ユーザー マークを追加して、診断データでの場所を識別します。 | スタートアップ プロジェクトの設定 | 分析ターゲットの設定 | 診断セッションで実行するツールの選択 | 診断セッションの開始と停止

ユーザー マークを追加して、診断データでの場所を識別します。

また、タイムライン ルーラーの領域を識別できるようにプロファイル データにユーザー マークを追加できます。

マークは、タイムライン上でメソッドが実行された時点に、オレンジ色の三角形として表示されます。 マークの上にマウス ポインターを置くと、メッセージと時刻がツールヒントとして表示されます。 複数のユーザー マークが近接している場合、マークはマージされてツールヒントのデータはまとめられます。 タイムラインの表示を拡大すると、マークを分離できます。

C#、Visual Basic、C++ コードへのマークの追加

C#、Visual Basic、C++ コードにマークを追加するには、まず Windows.Foundation.Diagnostics LoggingChannel オブジェクトを作成します。 次に、マークするコードの位置に LoggingChannel.LogMessage メソッドの呼び出しを挿入します。 呼び出しでは LoggingLevel.Information を使用します。

メソッドが実行されると、ユーザー マークがメッセージと共にプロファイル データに追加されます。

説明

コードにログ チャネルを追加する場合には、いくつかの課題があります。

ログを開く各チャネルには一意の名前が指定されている必要があります。 開いているチャンネルと同じ名前の新しいログ チャンネルを作成しようとすると、例外が発生します。

コードで名前が重複するのを避ける 1 つの方法は、静的 (VB の場合は共有) メソッドを使用して、固有の名前が保証されている LoggingChannel を返すことです。 固有の名前を提供するための GUID の使用例:

//using Windows.Foundation.Diagnostics
public static LoggingChannel GetLoggingChannel()
{
    var name = Guid.NewGuid().ToString();
    return new LoggingChannel(name);
}

'Imports Windows.Foundation.Diagnostics
Public Shared Function GetLoggingChannel() As LoggingChannel
    Dim Name = Guid.NewGuid().ToString()
    GetLoggingChannel = New LoggingChannel(Name)
End Function

//using namespace Windows::Foundation::Diagnostics;
static LoggingChannel^ MainPage::GetLoggingChannel()
{
    auto name = (ref new Guid())->ToString();
    auto channel = ref new LoggingChannel(name);
    return channel;
}

C# および VB: LoggingChannel オブジェクトの破棄

LoggingChannel オブジェクトはシステム リソースを使用するため、LoggingChannel の C# および VB のプロジェクションは System.IDisposableインターフェイスから派生しており、オブジェクトが CLR ガベージ コレクターによって破棄される前にリソースをリリースすることができます。 C++ コードでは、LoggingChannel オブジェクトがスコープ外に出ると、すぐにオブジェクトが破棄され、リソースがリリースされます。 ユーザー マークを診断セッション ファイルに追加する場合に使えるパターンの例を示します。

void MyScenario()
{
    var logLevel = LoggingLevel.Information;
    using(var channel = Utils.GetLoggingChannel())
    {
        channel.LogMessage("MyScenario Start", logLevel);
        // scenario code
        channel.LogMessage("MyScenario End", logLevel);
    }
}

Sub MyScenario()
    Dim logLevel = LoggingLevel.Information
    Using channel As LoggingChannel = Utils.GetLoggingChannel()
        channel.LogMessage("MyScenario Start", logLevel)
        'scenario code
        channel.LogMessage("MyScenario End", logLevel)
    End Using
End Sub

// m_channel resources are released when containing 
// object goes out of scope
LoggingChannel^ m_channel = MainPage::GetLoggingChannel();
LoggingLevel m_logLevel = LoggingLevel::Information;

void MyScenario()
{
    m_channel->LogMessage(L"MyScenario Start", m_logLevel);
    //scenario code
    m_channel->LogMessage(L"MyScenario Start", m_logLevel);
}

マークの JavaScript コードへの追加

ユーザー マークを追加するには、マークするコードの位置に次のコードを追加します。

if (performance && performance.mark) {
    performance.mark(markDescription);
}

markDescription は、ユーザー マークのツールヒントに表示されるメッセージを含む文字列です。

スタートアップ プロジェクトの設定

ソリューションに複数のアプリ プロジェクトが含まれている場合は、分析するプロジェクトがスタートアップ プロジェクトとして設定されていることを確認してください。 ソリューション エクスプローラーで、プロジェクトを選択し、コンテキスト メニューの [スタートアップ プロジェクトに設定] をクリックします。

配置場所の設定

Visual Studio コンピューターに直接接続されている Windows Phone または Visual Studio Phone エミュレーターで、電話アプリの診断セッションを実行できます。 Windows ストア アプリは、Visual Studio コンピューター、Visual Studio デバイス シミュレーター、またはネットワークで Visual Studio に接続されているか、USB ケーブルを使用したイーサネットで Visual Studio コンピューターに直接接続されているリモート デバイスで実行できます。 プロジェクト プロパティのデバッグ ページに配置ターゲットを設定することも、Visual Studio ツール バーのデバッグの場所の一覧からターゲットを選択することもできます。 次に、Windows ストア アプリの配置リストを示します。

[デバッグの場所] ツール バーでの選択内容がプロジェクト プロパティに保存されます。

分析ターゲットの設定

Visual Studio プロジェクトからアプリを起動するだけでなく、別のターゲットの診断セッションを実行することもできます。 たとえば、Windows App Store からインストールしたアプリのバージョンのパフォーマンスの問題を診断します。

診断セッションで実行するツールの選択

パフォーマンスと診断ハブで、1 つ以上のツールを選択して診断セッションを実行します。 プロジェクトの種類およびプログラミングに適用されるツールのみが表示されます。 診断ツールを選択すると、同じ診断セッションで実行できないツールの選択が無効になります。 次に、選択したツールが JavaScript アプリを検索する方法を示します。

診断セッションの開始と停止

診断セッションを開始するには、[開始] をクリックします。

診断セッションを終了して、データ分析を開始するには、ページの下部にある [コレクションの停止] をクリックします。

診断セッション ファイルを開く

診断セッションでデータのコレクションを停止すると、データはすぐに分析されて、パフォーマンスと診断レポートに表示されます。

また、パフォーマンスと診断ハブで直前に開かれた一覧から保存された .diagnosis セッション ファイルを開くことができます。

パフォーマンスと診断ハブの上部の [表示または非表示] ボタンをクリックして、直前に使用されたファイル リストを展開するか、または折りたたみます。

パフォーマンスと診断レポート

トラブルシューティング

診断イベントがドロップしました。レポートの一部の情報が不足しているか、正しくない可能性があります。

パフォーマンスと診断ツールでデータを収集すると、メモリおよび CPU の使用率が高くなることがあります。 データ収集ですべての診断イベントをログ記録できない場合、[パフォーマンスと診断] ページ上部にある情報バーにメッセージが表示されます。 レポートの一部のデータが不足しているか、無効である可能性があります。

この問題を解決するには、次の手順を実行してコンピューターのリソースの空き容量を増加させてから、診断セッションを再試行してみてください。

1. 診断セッションの一部でないその他のアプリを閉じます。

2. 収集するデータが少なくなるように、シナリオを簡略化します。

3. 1 セッションで使用する診断ツールを少なくします。

参照

その他の技術情報

パフォーマンス (Windows ストア アプリ)

Windows SDK LoggingSession サンプル