Dgraphリクエスト・ログ

Dgraphリクエスト・ログ(問合せログとも呼ばれます)には、処理されたリクエストごとに1つのエントリが含まれています。

リクエスト・ログ名と記憶域のロケーションは、Dgraph --logフラグによって指定されます。デフォルトでは、ログ・ファイルの名前およびロケーションは、次のように設定されています:

$BDD_HOME/dgraph/bin/dgraph.reqlog

Dgraphリクエスト・ログの形式は、次のフィールドで構成されます:

フィールド1 : タイムスタンプ(yyyy-MM-dd HH:mm:ss.SSS Z)。
フィールド2: クライアントIPアドレス。
フィールド3: リクエストID。
フィールド4: ECID. ECID (実行コンテキストID)は生成コンポーネントが関与する特定のリクエストの実行のグローバル一意識別子です。 ECIDは、別のコンポーネントで発生したエラー・メッセージの関連付けに使用できます。 ECIDはHTTPヘッダーからのものであるため、クライアントからDgraphに提供されない場合、ECID値はnullまたは未定義になることがあります。
フィールド5: レスポンス・サイズ(バイト)。
フィールド6: 合計時間(小数ミリ秒)。
フィールド7: 処理時間(小数ミリ秒)。
フィールド8: HTTPレスポンス・コード(クライアントの切断時に0)。
フィールド9: - (unused).
フィールド10: キュー・ステータス。リクエストの到着時、キュー内のリクエスト数(正の場合)または同じ優先順位の使用可能なスロット数(マイナスの場合)。
フィールド11: スレッドID。
フィールド12: HTTP URL (URLエンコード)。
フィールド13: HTTP POST本文(URLはエンコードされ、64キロバイトに切り捨てられます、デフォルトでは: - 空の場合)。
フィールド14: HTTPヘッダー(URLエンコード)。

フィールドには、情報が入力されていない場合や関連性がない場合は、ダッシュ(-)を入力します。リクエストはタイムスタンプ別にソートされます。

デフォルトでは、Dgraphにより、POSTリクエストの本文の内容が64Kで切り捨てられます。このデフォルト設定により、特に大量のレコードをDgraphデータベースに追加するプロセス中に、ディスク領域がログに節約されます。 POSTリクエスト本文の全コンテンツのログを確認する必要がある場合は、Oracle Supportに連絡してください。

Dgraphリクエスト・ログでgrepを使用しています

パフォーマンスの問題を診断する際、適切な文字列を持つgrepを使用して、Dgraphリクエスト・ログ内の個々のリクエストを検索できます。たとえば、次のような文字列を使用できます:

value%3D%22RefreshDate

Studioを使用している場合、リクエストを送信するポートレットのX-Endeca-Portlet-Id HTTP Headerを見つけると便利で、そのような場合はgrepが役に立ちます。次のようなものがあります:

X-Endeca-Portlet-Id: endecaresultslistportlet_WAR_endecaresultslistportlet_INSTANCE_5RKp_LAYOUT_11601

例として、次のように設定します:

PORTLET=endecaresultslistportlet_WAR_endecaresultslistportlet_INSTANCE_5RKp_LAYOUT_11601

次に、そのポートレットからの過去10リクエストの時間とレスポンス・コードを、次のようなコマンドで確認します:

grep $PORTLET Discovery.reqlog | tail -10 | cut -d ' ' -f 6,7,8

このコマンドでは、次のような出力が生成されます:

20.61 20.04 200
80.24 79.43 200
19.87 18.06 200
79.97 79.24 200
35.18 24.36 200
87.52 86.74 200
26.65 21.52 200
81.64 80.89 200
28.47 17.66 200
82.29 81.53 200

リクエストの関連付けに役立つHTTPヘッダーが他にもいくつかあります:

X-Endeca-Portlet-Id - アプリケーション内のポートレットの一意のID。
X-Endeca-Session-Id - ユーザー・セッションのID。
X-Endeca-Gesture-Id - エンドユーザー・アクションのID (StudioがCLIENTロギングを有効にしていない場合は入力されません)。
X-Endeca-Request-Id - 単一のDgraph Gatewayリクエストに対して複数のdgraphリクエストが送信されると、すべてのX-Endeca-Request-Idが同じになります。