TRACING

クラスター内のすべてのノードの要求のトレースを有効または無効にします。

クラスター内のすべてのノードで行われたトランザクションのトレースを有効または無効にします。トレースを使用して、パフォーマンス問題のトラブルシューティングを行います。内部操作に関するトランザクションの詳細情報は、system_tracesキースペースに捕捉されます。

トレース・セッションでクエリーを実行すると、セッションIDがクエリー結果に示されます。セッションID、クライアント、セッション長などの高レベルの詳細を含むエントリーがsystem_traces.sessionテーブルに書き込まれます。各操作に関する詳細はsystem_traces.eventsテーブルに書き込まれます。

注: セッションIDは、詳細なイベント情報を表示するためにSHOW SESSION tracing_session_idコマンドで使用されます。

トレース情報は24時間保存されます。24時間を経過したトレース・データを保存する場合は、データを別の場所にコピーします。確率的トレースの詳細については、「nodetool settraceprobability」を参照してください。

ヒント: トレース情報の詳細については、DataStaxサポート・ブログのこの投稿を参照してください。ディスク上でデータを探す方法について詳しく説明されています。

構文

TRACING [ ON | OFF ]
1. 凡例
構文規則 説明
大文字 リテラル・キーワード。
小文字 リテラル以外。
イタリック体 変数値。ユーザー定義値と置き換えます。
[] 任意。角かっこ( [] )で任意指定のコマンド引数を囲みます。角かっこは入力しないでください。
( ) グループ。丸かっこ(( ))は、選択肢を含むグループを示します。丸かっこは入力しないでください。
| または。縦棒( | )で代替要素を区切ります。要素のいずれかを入力してください。縦棒は入力しないでください。
... 繰り返し可能。省略記号(...)は、構文要素を必要な回数だけ繰り返すことができることを示します。
'Literal string' 単一引用符( ' )でCQL文内のリテラル文字を囲みます。大文字を維持するには、単一引用符を使用します。
{ key : value } マップ・コレクション。中かっこ( { } )でマップ・コレクションまたはキーと値のペアを囲みます。コロンでキーと値を区切ります。
<datatype1,datatype2> セット、リスト、マップ、またはタプル。山かっこ(< >)で、セット、リスト、マップまたはタプル内のデータ型を囲みます。データ型はコンマで区切ります。
cql_statement; CQL文の終了。セミコロン( ; )ですべてのCQL文を終了します。
[--] コマンドライン・オプションとコマンド引数は、2つのハイフン(--)。この構文は、引数がコマンドライン・オプションと間違われる可能性がある場合に役立ちます。
' <schema> ... </schema> ' 検索CQLのみ:単一引用符( ' )でXMLスキーマ宣言全体を囲みます。
@xml_entity='xml_entity_type' 検索CQLのみ:スキーマ・ファイルおよびsolrConfigファイル内のXML要素を上書きするための実体とリテラル値を示します。
ON

トレースを有効にします。

OFF

トレースを無効にします。

書き込み要求のトレース

次の例は、3つのノード・クラスターでのトレース・アクティビティを示しています。クラスターには、レプリケーション係数3を持つキースペースと、「複合プライマリ・キーの仕様」のテーブルと同様の従業員テーブルがあります。

トレースは、コーディネーターが次のアクションを実行することを示します。

  • 行のレプリケーションのターゲット・ノードを特定する。
  • 行をコミット・ログおよび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
注: source_elapsedカラム値はソース・ノードでのイベントの経過時間です(マイクロ秒単位)。

シーケンシャル・スキャンのトレース

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