Troubleshooting Hasura GraphQL Engine Errors

Introduction

This section provides references that can help in troubleshooting errors when developing with Hasura.

Logs

In order to find out about the origins of an error, it can be helpful to check the logs.

Metrics and distributed tracing in Hasura Cloud

Hasura Cloud includes metrics and distributed tracing which makes troubleshooting faster. For more information, see Metrics and Tracing in Hasura Cloud.

Server logs

For errors that come from the Hasura server, server logs will give you more insights. For details on how you can access these logs, as well as different log types, visit this page.

Console logs

Should there be any error coming from the Hasura Console UI, they will show up in the Browser dev tools.

Remote service logs

Errors can come from a remote service, such as Remote Schemas, Events or Actions. In this case, check the errors of the respective remote service. For Actions, check out this debugging page.

GraphQL Errors

Encountering errors while using GraphQL? Learn about typical issues like schema mismatches, query failures, and permission settings, along with their solutions, visit the page

Performance Issues

Performance bottlenecks can hinder your application's efficiency. Explore strategies to identify and resolve slow queries, high memory usage, and latency problems, visit the page

Observability

Observability is key to understanding system behavior. Learn about monitoring, logging, and tracing practices to gain insights into your application's health and performance, visit the page

Database docs

If you come across a database error, it will be helpful to check their logs:

• Postgres documentation.

Couldnt find what you are looking for?

GitHub issues

It's possible that someone with the same problem has created a GitHub issue on the Hasura repo. If you don't come across an issue with solution in your search, feel free to create a new issue.

Get Support

Whether you have a pricing question, want a custom demo, need technical support, or simply have a suggestion, our team is ready to assist you, Hasura Support.

Hasura blog

The Hasura blog contains a lot of useful resources including tutorials. You can use the search functionality to find what you're looking for.

Discord

If you didn't find a solution in any of the above mentioned sections or if you prefer to troubleshoot with the community, feel free to join our Discord server. Other users might have come across the same issues, and the Hasura community on Discord is very active and helpful.