Log record format

The log file is a gzip-compressed JSON+L file with one JSON object per line that represents a single log record entry. Each entry has the following format.

Log entry description

Field

Description

API_VERSION

Fauna API version.

BYTES_IN

Number of bytes in the request.

BYTES_OUT

Number of bytes in the response.

BYTE_READ_OPS

Number of read operations consumed by this query.

BYTE_WRITE_OPS

Number of write operations consumed by this query.

COMPUTE_OPS

Number of compute operations consumed by this query.

DATABASE

Database path of this entry. Each path entry is a database name. The first entry is the top-level database, and each included entry to the right is a child database. Dashboard queries have an empty database value.

FQL_SHAPE

Full request body with Personal Identifiable Data removed. Used to associate the log entry with a query to help debug and understand traffic.

QUERY_TIME_MS

Query processing time of this query in milliseconds.

RATE_LIMITS_HIT

An array of ops types that were limited or approaching rate limits:

  • read

  • write

  • compute

Example: [ "read", "compute" ]

REGION_GROUP

Query Region Group identifier.

REQUEST_HEADERS

HTTP request headers of this entry.

REQUEST_METHOD

HTTP request method of this entry.

RESPONSE_CODE

Query HTTP response code:

HTTP status Description

200

Successful query.

201

Query created a collection.

2xx

Query nearing rate limit as indicated by RATE_LIMITS_HIT. Valid response returned.

429

Rate limited. Query exceeds plan limit or service protection if there are no plan limits.

TAGS

List of tags included with the query. Empty {} indicates that the query includes no tags.

TRACEPARENT

Query W3C-compliant traceparent identifier. If you supplied an identifier and the logs do not include the identifier, you might have supplied an invalid identifier. If you provided an invalid identifier, Fauna generates a valid identifier.

TS

Query processing timestamp in UTC.

Example: "2023-01-18 22:11:39.529 Z"

TXN_RETRIES

Retry count. A value greater than zero indicates contention.

Example

{
    "API_VERSION": "4",
    "BYTES_IN": 132,
    "BYTES_OUT": 21,
    "BYTE_READ_OPS": 1050,
    "BYTE_WRITE_OPS": 0,
    "COMPUTE_OPS": 3,
    "DATABASE": [
        "read-test"
    ],
    "FQL_SHAPE": "Do(Map(Paginate(Documents(Collection(\"myCollection\"))), Lambda(\"x\", Get(Var(\"x\")))), null)",
    "QUERY_TIME_MS": 87,
    "RATE_LIMITS_HIT": [
        "read"
    ],
    "REGION_GROUP": "us-std",
    "REQUEST_HEADERS": "{\"driver_env\":\"driver=javascript-4.8.0; runtime=nodejs-v18.16.1; env=unknown; os=linux-5.10.147-133.644.amzn2.x86_64\",\"x_forwarded_for\":\"192.168.1.1\"}",
    "REQUEST_METHOD": "POST",
    "RESPONSE_CODE": "200",
    "TAGS": {},
    "TRACEPARENT": "00-df5aac21fb72d6d48ba27b39eabb6b1d-c02c6be678083fd6-00",
    "TS": "2023-06-06 16:15:35.388 Z",
    "TXN_RETRIES": 0
}

Is this article helpful? 

Tell Fauna how the article can be improved:
Visit Fauna's forums or email docs@fauna.com

Thank you for your feedback!