ログ・エントリ情報

このトピックでは、ログ・エントリ内の一部の情報について説明します。

クラスタ・モードのDgraphゲートウェイの場合、このログに記録された情報は、リクエストのライフ・サイクルをトレースする際に役立ちます。

すべてのDgraph Gateway ODLログ・エントリには、この例で示すように、OESの前にメッセージの番号とテキストが付いています:

OES-000135: Endeca Server has successfully initialized

ロギング・レベル

ログ・レベル(重大度の降順)は次のとおりです:

ODLログ・レベル	意味
`INCIDENT_ERROR`	製品のバグに起因して、Oracle Supportに報告する必要がある重大な問題を示します。一般に、これらのメッセージは、かなり重要なイベントを説明し、これによって通常のプログラム実行を妨げることがあります。
`ERROR`	管理者からの即座の対処が必要で、製品の不具合によるものではない重大な問題を示しています。
`WARNING`	管理者が確認する必要のある潜在的な問題を示します。
`NOTIFICATION`	情報メッセージのメッセージ・レベル。このレベルは、通常、主要サブコンポーネントや機能のアクティブ化または非アクティブ化などの、主要なライフサイクル・イベントを示します。これはデフォルトのレベルです。
`TRACE`	管理者にとって意味のある、パブリックAPIエントリや終了ポイントなどのイベントのデバッグ情報。

これらのレベルでは、関連しないメッセージに負荷をかけることなく、適切な粒度で関心のあるイベントを監視できます。開発環境でアプリケーションを最初に設定するときは、NOTIFICATIONレベルを使用してほとんどのメッセージを取得し、より詳細なレベル(本番)に変更できます。

ログに記録されたリクエストのタイプとコンテンツ

サーバーに新しいリクエストが到着すると、リクエストのSOAPメッセージが分析されます。 SOAP本文から、各リクエストのリクエスト・タイプ(allocateBulkLoadPortなど)が決定されてログに記録されます。複雑なリクエスト(Conversationなど)はこれ以上分析され、詳細な情報が必要に応じてログに記録されます。ログ・レベルがDEBUGの場合、この情報がログに記録されることに注意してください。

たとえば、ConversationリクエストはServer1に送信されます。更新後、サーバー上のログに次のようなエントリが含まれる場合があります:

OES-000239: Receive request 512498665 of type 'Conversation'. This request does the
   following queries: [RecordCount, RecordList]
OES-000002: Timing event: start 512498665 ...
OES-000002: Timing event: DGraph start 512498665 ...
OES-000002: Timing event: DGraph end 512498665 ...
OES-000002: Timing event: end 512498665 ...

この例に示すように、Server1がリクエストを受け取ると、それはルーティング表からノードを選択し、リクエストをそのノードにトンネルします。ルーティングされたリクエストは、そのノードで処理されます。 Dgraphリクエスト・ログでは、リクエストIDを使用してHTTPヘッダー内でリクエストを追跡することもできます。

ログ収集タイムスタンプおよび結果

収集操作では、開始タイムスタンプと終了タイムスタンプが記録されます。操作の最後に、収集結果も記録されます(追加されたレコード数、削除されたレコード数、更新されたレコード数、置換されたレコード数、追加または更新されたレコード数)。

ログ・エントリは、次の例のようになります:

OES-000002: Timing event: start ingest into Dgraph "http://host:7010"
OES-000002: Timing event: end ingest into Dgraph "http://host:7010" (1 added, 1 deleted, 0 replaced, 0 updated, 0 added or updated)

リクエストおよびDgraphの合計処理時間

ログの4つの計算タイムスタンプは、StudioからDgraphに移動して戻る問合せのタイム・ポイントを記録します。問合せパスを次の図に示します:

問合せパスに沿って生成される4つのタイムスタンプ。

4つのタイムスタンプは次のとおりです:

Timestamp1: Dgraphゲートウェイは、Studioからのリクエストの処理を開始
Timestamp2: DgraphゲートウェイはリクエストをDgraphに転送
Timestamp3: DgraphゲートウェイでDgraphからレスポンスを受信
Timestamp4: Dgraphゲートウェイがリクエストの処理を終了します

リクエストの合計時間コストを判断するために、タイムスタンプの差異が計算されてログに記録されます:

(Timestamp4 - Timestamp1)は、Dgraph Gatewayでのリクエスト処理時間の合計です。
(Timestamp3 - Timestamp2)は、Dgraph処理時間です。

ログ・エントリは、次の例のようになります:

OES-000240: Total time cost(Request processing) of request 512498665 : 1717 ms
OES-000240: Total time cost(Dgraph processing) of request 512498665 : 424 ms