You are looking at the docs for the unreleased master branch of Dgraph. The latest version is v20.11.
Report Issue Edit Page

Log Format

Dgraph’s log format comes from the glog library and is formatted as follows:

Lmmdd hh:mm:ss.uuuuuu threadid file:line] msg...

Where the fields are defined as follows:

	L                A single character, representing the log level (eg 'I' for INFO)
	mm               The month (zero padded; ie May is '05')
	dd               The day (zero padded)
	hh:mm:ss.uuuuuu  Time in hours, minutes and fractional seconds
	threadid         The space-padded thread ID as returned by GetTID()
	file             The file name
	line             The line number
	msg              The user-supplied message

Log Verbosity

To increase log verbosity, you have set the flag -v=3 (or -v=2) which will enable verbose logging for everything. You can set this flag on both Zero and Alpha nodes.

Note This requires a restart of the node itself.

Query Logging

You can dynamically turn query logging on or off. To toggle query logging on, send the following GraphQL mutation to the /admin endpoint of an Alpha node (e.g. localhost:8080/admin):

mutation {
  config(input: {logRequest: true}) {
    response {
      code
      message
    }
  }
}

The response should look like the following:

{
  "data": {
    "config": {
      "response": {
        "code": "Success",
        "message": "Config updated successfully"
      }
    }
  },
  "extensions": {
    "tracing": {
      "version": 1,
      "startTime": "2020-12-07T14:53:28.240420495Z",
      "endTime": "2020-12-07T14:53:28.240569604Z",
      "duration": 149114
    }
  }
}

Also, the Alpha node will print the following INFO message to confirm that the mutation has been applied:

I1207 14:53:28.240516   20143 config.go:39] Got config update through GraphQL admin API

When enabling query logging this prints the queries/mutation that Dgraph Alpha receives from Ratel, Client etc. In this case, the Alpha log will print something similar to:

I1201 13:06:26.686466   10905 server.go:908] Got a query: query:"{\n  query(func: allofterms(name@en, \"Marc Caro\")) {\n  uid\n  name@en\n  director.film\n  }\n}"  

As you can see, we got the query that Alpha received, to read it in the original DQL format just replace every \n with a new line, any \t with a tab character and \" with ":

{
  query(func: allofterms(name@en, "Marc Caro")) {
  uid
  name@en
  director.film
  }
}

Similarly, you can turn off query logging by setting logRequest to false in the /admin mutation.

mutation {
  config(input: {logRequest: false}) {
    response {
      code
      message
    }
  }
}