ストリームデータ処理基盤 uCosminexus Stream Data Platform - Application Framework システム構築・運用ガイド
形式
sdptrced {-file <トレースファイル名>[ <トレースファイル名>…] [-time [<開始時刻>][,<終了時刻>]] [-threadid <スレッドID>[ <スレッドID>…]] [-csv]|-help}
機能
APIトレース情報を編集して出力します。
実行権限
運用ユーザー
コマンド実行の前提条件
このコマンドの実行には,次のファイルが必要です。
格納先ディレクトリ
<運用ディレクトリ>\bin\
引数
-file <トレースファイル名>[ <トレースファイル名>…]
編集するトレースファイルのパス名を絶対パスで指定します。複数のトレースファイル名を指定する場合は,トレースファイル名とトレースファイル名の間を半角スペースで区切って指定します。
-time [<開始時刻>][,<終了時刻>]
出力したいトレース情報が取得された開始時刻と終了時刻を,次の形式で指定します。
開始時刻と終了時刻は,スペースを挿入しないでコンマで区切って指定します。
時刻の指定方法によって,それぞれ,次のように出力されます。
-threadid <スレッドID>[ <スレッドID>…]
指定されたスレッドIDのスレッドによって出力されたトレース情報だけ出力します。
スレッドIDは,半角数字で指定します。指定できる値は,0〜9223372036854775807です。複数のスレッドIDを指定する場合は,スレッドIDとスレッドIDの間を半角スペースで区切って指定します。
-csv
トレース情報の編集結果をCSV形式で表示します。
-help
コマンドの使用方法を表示します。
このオプションが指定された場合,トレース情報の出力およびオプションの不正チェックはしないでコマンドを終了します。
注意事項
戻り値
値 | 意味 |
---|---|
0 | コマンドが正常終了しました。 |
1 | コマンドが異常終了しました。 |
出力形式
出力形式を次に示します。出力例については,「6.3.2 APIトレースの詳細」を参照してください。
Ver Kind File aa-aa-aa bbb cc...cc Date Time nSec Current Parent Root EventID dddd/dd/dd ee:ee:ee fffffffff gg...gg-hh...hh ii...ii-jj...jj kk...kk-ll...ll 0xmmmmmmmm Rc Data noo...oo pp...pp
Ver,Kind,File aa-aa-aa,bbb,cc...cc Date,Time,nSec,Current,Parent,Root,EventID,Rc,Data dddd/dd/dd,ee:ee:ee,fffffffff,gg...gg-hh...hh,ii...ii-jj...jj,kk...kk-ll...ll,0xmmmmmmmm, noo...oo,pp...pp
出力形式中の,各変数の意味を次に示します。
変数 | 意味 |
---|---|
aa-aa-aa | トレースファイルを出力したStream Data Platform - AFのバージョン情報 |
bbb | トレースファイルの種別情報 次のどちらかが表示されます。
|
cc...cc | トレースファイルのパス(絶対パス) |
dddd/dd/dd | トレースの出力年月日(年/月/日) |
ee:ee:ee | トレースの出力時刻(時:分:秒) |
fffffffff | トレース出力時刻のナノ秒の部分(9けたの10進数) |
gg...gg-hh...hh | このトレースに割り当てられた通番(スレッドID(19けたの10進数)-処理通番(10けたの10進数)) |
ii...ii-jj...jj※ | 予備領域 19けたの10進数-10けたの10進数で出力されます。 |
kk...kk-ll...ll | トレースの起点に割り当てた通番(スレッドID(19けたの10進数)-処理通番(10けたの10進数)) トレースの起点とは,このトレースを取得した処理で扱ったタプルがクエリに入力(またはクエリ内で生成)された時点です。この通番が同じトレースは,同じタプルに対する一連の処理であることを示します。 |
mmmmmmmm | イベントID(8けたの16進数) 次のどちらかが表示されます。
|
noo...oo※ | 予備領域 nは符号部です。符号部を含めて11けたの10進数で出力されます。nには半角スペースが表示されます。 |
pp...pp | トレース情報を取得したクエリ名称(クエリ名称の先頭から最大32バイト) |
All Rights Reserved. Copyright (C) 2010, 2014, Hitachi, Ltd.