外部データで CSV ファイルを作成

名前

イベント名。

start_tsc.[QPC|CLOCK_MONOTONIC_RAW|RDTSC|UTC]

イベント開始タイムスタンプ。このカラム名には、タイムスタンプ・カウンターのタイプを示す QPC|CLOCK_MONOTONIC_RAW、RDTSC または UTC サフィックスが付加されます。

• Windows* 上でパフォーマンス・カウンターを使用する場合 QPC (QueryPerformanceCounter) を指定し、Linux* 上で clock_gettime(CLOCK_MONOTONIC_RAW) を使用する場合 CLOCK_MONOTONIC_RAW を指定します。

• RDTSC カウンターを使用する場合、RDTSC を指定します。RDTSC の取得は次のように行います。

  • Microsoft* コンパイラーとインテル® コンパイラーでは、__rdtsc() 組込み関数を使用します

  • GCC* コンパイラーを使用する場合、次の関数を必要に応じてコードにコピーして呼び出します。

  #include <stdint.h>
   
  int64_t rdtsc() { 
      int64_t tstamp; 
  #if defined(__x86_64__) 
      asm( "rdtsc\n\t」 
               "shlq $32,%%rdx\n\t" 
               "or %%rax,%%rdx\n\t" 
               "movq %%rdx,%0\n\t" : "=g"(tstamp) : : "rax", "rdx" ); 
  #elif defined(__i386__) 
      asm( "rdtsc\n": "=A"(tstamp) ); 
  #else 
      #error NYI 
  #endif 
      return tstamp; 
  }

• 日付と時間が使用される場合、UTC を指定します。指定形式は YYYY-MM-DD hh:mm:ss.sssss です。小数点以下の値は任意です。

end_tsc

イベント終了タイムスタンプ。

pid

必要に応じてプロセス ID を指定します。このフィールドに値が存在しなくても、次の条件が満たされれば (稀なケースを除いて) 結果のインポートには影響しません。

• スレッド ID は、収集時間フレーム内にオペレーティング・システムによって再利用されます。

• 同じスレッド ID を持つ異なるスレッドは、csv ファイルのレコードを生成します。

• タイムスタンプは不正確であり、データは同じスレッド ID を持つ複数のスレッドに分類される可能性があります。

このフィールドをデータ内の空の値とするか、ファイルヘッダーとデータの両方から完全に除外できます。

tid

必要に応じてスレッド ID を指定します。このフィールドに値が指定されると、間隔はタスクとして解釈されます。それ以外は間隔はフレームとして解釈され表示されます。

このフィールドはデータ内の空の値とするか、ファイルヘッダーとデータの両方から完全に除外できます。

tsc.[QPC|CLOCK_MONOTONIC_RAW|RDTSC|UTC]

イベント開始タイムスタンプ。このカラムは、タイムスタンプ・カウンターの種類を示すQPC|CLOCK_MONOTONIC_RAW、RDTSC、またはUTCサフィックスがあります。

• パフォーマンス・カウンターを使用する場合、Windows* ではQPC(QueryPerformanceCounter) を指定し、Linux* 上でCLOCK_MONOTONIC_RAWを使用する場合、CLOCK_MONOTONIC_RAWを指定します。

• RDTSC カウンターを使用する場合、RDTSCを指定します。Windows* で RDTSC を取得するには、__rdtsc()組込み関数を使用します。Linux* で RDTSC を使用する場合、次の関数を必要に応じてコードにコピーして呼び出します。

  #include <stdint.h>
   
  int64_t rdtsc() { 
      int64_t tstamp; 
  #if defined(__x86_64__) 
      asm( "rdtsc\n\t」 
               "shlq $32,%%rdx\n\t" 
               "or %%rax,%%rdx\n\t" 
               "movq %%rdx,%0\n\t" : "=g"(tstamp) : : "rax", "rdx" ); 
  #elif defined(__i386__) 
      asm( "rdtsc\n": "=A"(tstamp) ); 
  #else 
      #error NYI 
  #endif 
      return tstamp; 
  }

• 日付と時間が使用される場合、UTC を指定します。指定形式は YYYY-MM-DD hh:mm:ss.sssss です。小数点以下の値は任意です。

CounterName1

イベント名。カウンターはそれぞれのカラムを持ちます。COUNTサフィックスは累積カウンター値を指定する際に使用します。INSTサフィックスは瞬間カウンター値を指定する際に使用します。

pid

必要に応じてプロセス ID を指定します。このフィールドに値が存在しなくても、次の条件が満たされれば (稀なケースを除いて) 結果のインポートには影響しません。

• スレッド ID は、収集時間フレーム内にオペレーティング・システムによって再利用されます。

• 同じスレッド ID を持つ異なるスレッドは、csv ファイルのレコードを生成します。

• タイムスタンプは不正確であり、データは同じスレッド ID を持つ複数のスレッドに分類される可能性があります。

このフィールドをデータ内の空の値とするか、ファイルヘッダーとデータの両方から完全に除外できます。

tid

必要に応じてスレッド ID を指定します。このフィールドに値が指定されると、間隔はタスクとして解釈されます。それ以外は間隔はフレームとして解釈され表示されます。

このフィールドはデータ内の空の値とするか、ファイルヘッダーとデータの両方から完全に除外できます。