In order to troubleshoot issues occurring in your implementation of Vitess PlanetScale support will need as much context as possible.


When you reach out you should include, if possible, a summary/overview deployment document of what components are involved and how they interconnect, etc. Customers often maintain something like this for internal support purposes.


Beyond the overview deployment document, we recommend that for the best support experience, customers collect as many of the items listed below as possible from production Vitess systems:

  • Logs (vtgate, vttablet, underlying MySQL)
  • Metrics (vtgate, vttablet, underlying MySQL)
  • Other statistics (MySQL processlist, MySQL InnoDB engine status, etc.)
  • Application DB pool configurations
  • Load balancer configurations (if in the MySQL connection path)
  • Historical load patterns


In some cases at the highest support tiers, customers can choose to give PlanetScale the ability to log into their Vitess/MySQL systems to help debug issues.