Skip to content
v2.1.0

Errors and insights

Error badges in Traffic, flagged N+1 and duplicate calls, filtering with has:insight, and the Timing tab. Narrated, with sound. The dark and light versions follow the site's theme.

A red dot marks a row whose response has errors and no data, or an HTTP error. An amber dot marks errors with partial data. Point at the dot to read the first error, its code first (FORBIDDEN: Not allowed…).

Above the response, each GraphQL error gets a row:

  • its code (extensions.code, or what other servers use instead) and its full message;
  • where: the path, written as in code (viewer.orders[1]), which opens that node in the response, and the line and column in the query;
  • what the code usually means, for common codes such as UNAUTHENTICATED, FORBIDDEN, BAD_USER_INPUT and GRAPHQL_VALIDATION_FAILED;
  • Details, folded: the rest of extensions (a request id, for example) and the server’s stack trace, one frame per line.
An Orders response with three errors: FORBIDDEN with its path and location, GRAPHQL_VALIDATION_FAILED with its line and column, and INTERNAL_SERVER_ERROR, each with a sentence explaining the code.An Orders response with three errors: FORBIDDEN with its path and location, GRAPHQL_VALIDATION_FAILED with its line and column, and INTERNAL_SERVER_ERROR, each with a sentence explaining the code.
One row per error, with its code, where it happened and what the code means.

The first five errors show; Show more lists the rest. Fold the list to its first message with the arrow, and Copy errors copies them as JSON. The nodes errors point at are tinted in the response tree.

A request that failed over HTTP names its status above the response (401 Unauthorized, 504 Gateway Timeout…) with what it usually means and where to look. One that got no response at all shows failed in the Status column, with the likely causes: the network, DNS or TLS, CORS or a blocking extension, or the page cancelling it. When a server or a proxy answers with an HTML error page instead of JSON, Wireglass says so and gives the page’s title.

A Checkout mutation that got 401 Unauthorized: a banner explains the status above an UNAUTHENTICATED error saying the token expired.A Checkout mutation that got 401 Unauthorized: a banner explains the status above an UNAUTHENTICATED error saying the token expired.
A failed status, named and explained, above the GraphQL error that came with it.

Operations that use something their endpoint’s schema deprecates are flagged DEPRECATED in the list: a field, a query, mutation or subscription, an argument, an input field or an enum value, whether it is written in the query or passed in the variables. Point at the flag to read what is deprecated and why. Request lists each one with the schema’s reason and where it is used: a line and column in the query, or a path in the variables such as $input.giftNote.

Traffic with three operations flagged DEPRECATED. The selected CreateOrder lists Mutation.createOrder, a deprecated mutation, and OrderInput.giftNote, a deprecated input field used in the variables.Traffic with three operations flagged DEPRECATED. The selected CreateOrder lists Mutation.createOrder, a deprecated mutation, and OrderInput.giftNote, a deprecated input field used in the variables.
CreateOrder uses a deprecated mutation and passes a deprecated input field in its variables.

The check uses a schema Wireglass already has for the endpoint: one loaded in the client, which is kept. When there is none, Request says the operation wasn’t checked and offers Load schema, which sends an introspection query to that endpoint with the request’s own headers. Nothing is sent until you click it.

Each row shows a waterfall bar, its size and its duration. A ⚑ flags:

  • a duplicate call: same operation and variables within 500 ms,
  • a possible N+1: more than 5 calls of one operation with different variables within 1 s,
  • a large response: over 1 MB.

These are hints and may be intentional. Thresholds are in Settings under Traffic.

Shows the HAR phases, the insights with an explanation, and the resolver tree and cost when the response has extensions.tracing or extensions.cost.

Type these in the Traffic filter box:

Filter Shows
has:insight Rows with a flag
slow:>500ms Operations slower than 500 ms
size:>1mb Responses over 1 MB
has:mocked Rows answered by a mock
has:deprecated Operations that use something the schema deprecates