# Dgraph出力ログ

Dgraph出力ログは、Dgraphのstdout/stderr出力が再マップされる場所です。

Dgraphでは、Dgraphの`--out`フラグで指定されたログ・ファイルに、stdout/stderr出力をリダイレクトします。デフォルトでは、ファイルの名前および場所は、次のようになります。

    $BDD_HOME/logs/dgraph.out

bdd.confファイルの`DGRAPH_OUT_FILE`パラメータを変更してからDgraphを再起動すると、新しい出力ログの場所を指定できます。

Dgraphのstdout/stderrログには、起動メッセージ、警告メッセージおよびエラー・メッセージが含まれています。Dgraphの`-v`フラグによって、ログの冗長度を増やすことができます。

## Dgraph出力ログの形式

Dgraph出力ログ・フィールドの形式は、次のとおりです。

- タイムスタンプ
- コンポーネントID
- メッセージ・タイプ
- ログ・サブシステム
- ジョブID
- メッセージ・テキスト

ログ・エントリ・フィールドおよびその説明は、次のとおりです。

ログ・エントリ・フィールド | 説明 | 例
--- | --- | ---
タイムスタンプ | 次のISO 8601拡張形式を使用した、メッセージが生成されたときのローカルの日時。
    YYYY-MM-DDTHH:mm:ss.sss(+|-)hh:mm
時間範囲は0から23で、ミリ秒とオフセット・タイムゾーンは必須です。 | `2016-03-18T13:25:30.600-04:00`
コンポーネントID | メッセージを生成したコンポーネントのID。"DGRAPH"はDgraph用にハードコードされます。 | `DGRAPH`
メッセージ・タイプ | メッセージのタイプ(ログ・レベル)。 `INCIDENT_ERROR` `ERROR` `WARNING` `NOTIFICATION` `TRACE` `UNKNOWN` | `WARNING`
ログ・サブシステム | メッセージを生成したログ・サブシステム。 | `{dgraph}`
ジョブID | 実行されるジョブのID。 | `[0]`
メッセージ・テキスト | ログ・メッセージのテキスト。 | `Starting HTTP server on port: 7010`

## Dgraphログ・サブシステム

Dgraph出力ログでログ・エントリを生成できるログ・サブシステムは次のとおりです。

- `background_merging` — Dgraphデータベース・メンテナンス・アクティビティに関するメッセージ。
- `bulk_ingest` - 一括ロード収集操作によって生成されたメッセージ。
- `cluster` - ZooKeeper関連のクラスタ操作に関するメッセージ。
- `database` — Dgraphデータベース操作に関するメッセージ。
- `datalayer` — Dgraphデータベース・ファイル使用量に関するメッセージ。
- `dgraph` - Dgraph一般操作に関連するメッセージ。
- `eql` — BDD問合せ言語のエンジンであるEQLから生成されたメッセージ。
- `eql_feature` — 特定のEQL機能の使用量情報を提供するメッセージ。
- `eve` - BDD問合せエバリュエータから生成されたメッセージ。
- `http` - Dgraph HTTP通信操作に関するメッセージ。
- `lexer` - OLT (Oracle Language Technology)サブシステムからのメッセージ。
- `splitting` - BDD問合せエバリュエータ分割タスクの結果生じたメッセージ。
- `ssl` - SSLサブシステムによって生成されたメッセージ。
- `task_scheduler` - Dgraphタスク・スケジューラ関連するメッセージ。
- `text_search_rel_rank` - テキスト検索時の関連度ランキング操作に関連するメッセージ。
- `text_search_spelling` - テキスト検索時のスペル修正操作に関連するメッセージ。
- `update` - 更新に関連するメッセージ。
- `workload_manager` - Dgraph Workload Managerからのメッセージ。
- `ws_request` - Webサービス間のリクエスト交換に関連するメッセージ。
- `xq_web_service` - XQueryベースのWebサービスから生成されたメッセージ。

これらのすべてのサブシステムには、デフォルトのログ・レベルである`NOTIFICATION`があります。

## Dgraph起動情報

最初のログ・エントリ(「Starting Dgraph」で始まるエントリ)にはDgraphのバージョン、起動フラグと引数、およびDgraphデータベース・ディレクトリのパスがリストされています。後続のエントリには追加の起動情報(システムのRAM容量および論理CPUの数、CPUのキャッシュ・トポロジ、作成されたWebサービス、HTTPポート番号、バルク・ロード・ポート番号など)が記録されます。

## Dgraphシャットダウン情報

Dgraphシャットダウン・プロセスの一部として、シャットダウンの合計時間を含むシャットダウンの詳細が記録されます。次に例を示します(読みやすいようにタイムスタンプは削除しています)。

    DGRAPH  NOTIFICATION  {dgraph}    [0]  Shutdown request received at Wed Oct 5 16:17:42
                                           2016.  Shutdown will complete when all outstanding
                                           jobs are complete.
    DGRAPH  WARNING       {cluster}   [0]  Lost connection to ZooKeeper: ZooKeeper connection lost
                                           (zk error -4)
    DGRAPH  NOTIFICATION  {cluster}   [0]  Finished closing zk connection
    DGRAPH  NOTIFICATION  {database}  [0]  Finished unmounting everything.
    DGRAPH  NOTIFICATION  {dgraph}    [0]  All dgraph transactions completed at Wed Oct 5
                                           16:17:43 2016, exiting normally (pid=14789)
    DGRAPH  NOTIFICATION  {database}  [0]  Finished unmounting everything.
    DGRAPH  NOTIFICATION  {dgraph}    [0]  Overall shutdown took 922 ms

## 出力ログの収集例

次のDgraph出力ログのスニペットは、収集操作の形式を示しています。読みやすいようにタイムスタンプは削除しています。

    DGRAPH  NOTIFICATION  {cluster}      [0]  Promoting to leader on database edp_cli_edp_c23fdc4c
    DGRAPH  NOTIFICATION  {database}     [0]  Mounting database edp_cli_edp_c23fdc4c
    DGRAPH  NOTIFICATION  {dgraph}       [0]  Initial DL version: 2
    DGRAPH  NOTIFICATION  {bulk_ingest}  [0]  MessageParser created
    DGRAPH  NOTIFICATION  {bulk_ingest}  [0]  Start ingest for collection: edp_cli_edp_c23fdc4c
                                              for database edp_cli_edp_c23fdc4c
    DGRAPH  NOTIFICATION  {bulk_ingest}  [0]  Starting bulk ingest operation REPLACE_RECORDS
                                              for database edp_cli_edp_c23fdc4c
    DGRAPH  NOTIFICATION  {bulk_ingest}  [0]  Ending bulk ingest for database edp_cli_edp_c23fdc4c
                                              at client's request
    DGRAPH  NOTIFICATION  {bulk_ingest}  [0]  Bulk ingest completed: Added 351 records and
                                              rejected 0 records, for database edp_cli_edp_c23fdc4c
    DGRAPH  NOTIFICATION  {bulk_ingest}  [0]  Final statistics: 0.060 MiB, 1.008 records seconds,
                                              0.060 MiB/s records throughput, 1.182 total seconds,
                                              0.051 MiB/s total throughput for database
                                              edp_cli_edp_c23fdc4c

`bulk_ingest`エントリは、351件のレコードを持つデータ・セットの収集を示しています。

- Dgraphログ・レベル
  このトピックではDgraphログ・レベルについて説明します。
- Dgraphログ・レベルの設定
  bdd.confの`DGRAPH_LOG_LEVEL`プロパティは、起動時のDgraphログ・サブシステムのログ・レベルを設定します。