TRACING
クラスター内のすべてのノードの要求のトレースを有効または無効にします。
クラスター内のすべてのノードで行われたトランザクションのトレースを有効または無効にします。トレースを使用して、パフォーマンス問題のトラブルシューティングを行います。内部操作に関するトランザクションの詳細情報は、system_tracesキースペースに捕捉されます。クエリーを実行すると、セッションIDがクエリー結果に表示され、セッションIDやクライアント、セッション長などの高レベルの詳細を含むエントリーがsystem_traces.sessionテーブルに書き込まれます。各操作に関するさらに詳細なデータはsystem_traces.eventsテーブルに書き込まれます。
トレース情報は24時間保存されます。トレース情報を24時間以上保存するには、情報を別の場所にコピーします。確率的トレースの詳細については、「nodetool settraceprobability」を参照してください。
注:
セッションIDは、詳細なイベント情報を表示するためにSHOW SESSION tracing_session_idコマンドで使用されます。
構文
TRACING [ON | OFF]
| 構文規則 | 説明 |
|---|---|
| 大文字 | リテラル・キーワード。 |
| 小文字 | リテラル以外。 |
イタリック体 |
変数値。ユーザー定義値と置き換えます。 |
[] |
任意。角かっこ（ [] ）で任意指定のコマンド引数を囲みます。角かっこは入力しないでください。 |
( ) |
グループ。丸かっこ（( )）は、選択肢を含むグループを示します。丸かっこは入力しないでください。 |
| |
または。縦棒（ | ）で代替要素を区切ります。要素のいずれかを入力してください。縦棒は入力しないでください。 |
... |
繰り返し可能。省略記号（...）は、構文要素を必要な回数だけ繰り返すことができることを示します。 |
'Literal string' |
単一引用符（ ' ）でCQL文内のリテラル文字を囲みます。大文字を維持するには、単一引用符を使用します。 |
{ key : value } |
マップ・コレクション。中かっこ（ { } ）でマップ・コレクションまたはキーと値のペアを囲みます。コロンでキーと値を区切ります。 |
<datatype1,datatype2> |
セット、リスト、マップ、またはタプル。山かっこ（< >）で、セット、リスト、マップまたはタプル内のデータ型を囲みます。データ型はコンマで区切ります。 |
cql_statement; |
CQL文の終了。セミコロン（ ; ）ですべてのCQL文を終了します。 |
[--] |
コマンドライン・オプションとコマンド引数は、2つのハイフン（--）で区切ります。この構文は、引数がコマンドライン・オプションと間違われる可能性がある場合に役立ちます。 |
' <schema> ...</schema> ' |
検索CQLのみ：単一引用符（ ' ）でXMLスキーマ宣言全体を囲みます。 |
@xml_entity='xml_entity_type' |
検索CQLのみ：スキーマ・ファイルおよびsolrConfigファイル内のXML要素を上書きするための実体とリテラル値を示します。 |
例
書き込み要求のトレース
この例では、ccmによってMac OSX上に作成された3ノード・クラスターのトレース・アクティビティーを示します。レプリケーション係数3を持つキースペースと、「複合プライマリ・キーの使用」の従業員テーブルと同様のテーブルを使用して、コーディネーターが以下のアクションを実行することをトレースで示します。
- 行のレプリケーション先となるノードを特定する。
- 行をcommitlogおよびmemtableに書き込む。
- 要求の完了を確認する。
トレースを有効にします。
TRACING ON
レコードをcyclist_nameテーブルに挿入します。
INSERT INTO cycling.cyclist_name ( id, lastname, firstname ) VALUES ( e7ae5cf3-d358-4d99-b900-85902fda9bb0, 'FRAME', 'Alex' );
要求と各ステップが捕捉され、表示されます。
Tracing session: 9b378c70-b114-11e6-89b5-b7fad52e1885
activity | timestamp | source | source_elapsed | client
-----------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------+-----------+----------------+-----------
Execute CQL3 query | 2016-11-22 16:34:34.300000 | 127.0.0.1 | 0 | 127.0.0.1
Parsing INSERT INTO cycling.cyclist_name (id, lastname, firstname) VALUES (e7ae5cf3-d358-4d99-b900-85902fda9bb0, 'FRAME','Alex'); [Native-Transport-Requests-1] | 2016-11-22 16:34:34.305000 | 127.0.0.1 | 5935 | 127.0.0.1
Preparing statement [Native-Transport-Requests-1] | 2016-11-22 16:34:34.308000 | 127.0.0.1 | 9199 | 127.0.0.1
Determining replicas for mutation [Native-Transport-Requests-1] | 2016-11-22 16:34:34.330000 | 127.0.0.1 | 30530 | 127.0.0.1
Appending to commitlog [MutationStage-3] | 2016-11-22 16:34:34.330000 | 127.0.0.1 | 30979 | 127.0.0.1
Adding to cyclist_name memtable [MutationStage-3] | 2016-11-22 16:34:34.330000 | 127.0.0.1 | 31510 | 127.0.0.1
Request complete | 2016-11-22 16:34:34.333633 | 127.0.0.1 | 33633 | 127.0.0.1シーケンシャル・スキャンのトレース
1つの行が複数のSSTableに分散されています。cyclist_nameテーブルを対象とした読み取り要求のトレースが示すように、1つの行を読み取るために複数のSSTableからそれぞれの一部を読み取ることになります。
SELECT * FROM cycling.cyclist_name ;
クエリー結果が最初に表示され、次にセッションIDとセッションの詳細が表示されます。
id | firstname | lastname
--------------------------------------+-----------+-----------------
e7ae5cf3-d358-4d99-b900-85902fda9bb0 | Alex | FRAME
fb372533-eb95-4bb4-8685-6ef61e994caa | Michael | MATTHEWS
5b6962dd-3f90-4c93-8f61-eabfa4a803e2 | Marianne | VOS
220844bf-4860-49d6-9a4b-6b5d3a79cbfb | Paolo | TIRALONGO
6ab09bec-e68e-48d9-a5f8-97e6fb4c9b47 | Steven | KRUIKSWIJK
e7cd5752-bc0d-4157-a80f-7523add8dbcd | Anna | VAN DER BREGGEN
(6 rows)
Tracing session: 117c1440-b116-11e6-89b5-b7fad52e1885
activity | timestamp | source | source_elapsed | client
-------------------------------------------------------------------------------------------------------------------------------+----------------------------+-----------+----------------+-----------
Execute CQL3 query | 2016-11-22 16:45:02.212000 | 127.0.0.1 | 0 | 127.0.0.1
Parsing SELECT * FROM cycling.cyclist_name ; [Native-Transport-Requests-1] | 2016-11-22 16:45:02.212000 | 127.0.0.1 | 372 | 127.0.0.1
Preparing statement [Native-Transport-Requests-1] | 2016-11-22 16:45:02.212000 | 127.0.0.1 | 541 | 127.0.0.1
Computing ranges to query [Native-Transport-Requests-1] | 2016-11-22 16:45:02.213000 | 127.0.0.1 | 807 | 127.0.0.1
Submitting range requests on 257 ranges with a concurrency of 257 (0.3 rows per range expected) [Native-Transport-Requests-1] | 2016-11-22 16:45:02.213000 | 127.0.0.1 | 1632 | 127.0.0.1
Submitted 1 concurrent range requests [Native-Transport-Requests-1] | 2016-11-22 16:45:02.215000 | 127.0.0.1 | 3002 | 127.0.0.1
Executing seq scan across 1 sstables for (min(-9223372036854775808), min(-9223372036854775808)] [ReadStage-2] | 2016-11-22 16:45:02.215000 | 127.0.0.1 | 3130 | 127.0.0.1
Read 6 live and 0 tombstone cells [ReadStage-2] | 2016-11-22 16:45:02.216000 | 127.0.0.1 | 3928 | 127.0.0.1
Request complete | 2016-11-22 16:45:02.216252 | 127.0.0.1 | 4252 | 127.0.0.1