Documentation
How-to guides

Upload a slow-query log

Rank queries from a MySQL-format slow log and send one for deeper analysis.

5 min read

Before you upload

  • Slow-query log upload requires a paid plan.
  • Use a MySQL-format slow log saved as a text or log file, up to 50 MB.
  • The file must contain parsed query-time records and SQL statements; an empty or unsupported format produces no ranked queries.

Upload the log

  1. Open a thread. In an empty thread, choose Upload Slow Query Log. In an active thread, select the paperclip in the composer.
  2. Choose the file. Select the .log or .txt file. Keep the thread open while the upload and parsing complete.
  3. Confirm the ranked table appears. A successful upload groups equivalent query shapes and shows their count, average and maximum duration, and rows examined.

Choose a query to analyze

  1. Sort by the signal that matters. Sort by count, average duration, maximum duration, or rows examined. Expand a row to review the example SQL.
  2. Select Analyze. The query is placed in the composer. Review it, remove sensitive literal values when needed, and send it through the normal paste-analysis pipeline.
  3. Review the recommendation. Read the diagnosis, evidence, confidence, fix zone, and proposed change before taking action.

Resolve upload errors

Upgrade required
Open Settings → Billing and choose a plan that includes slow-query log upload.
File too large
Reduce the file to 50 MB or less, preserving complete query-time records.
No slow queries found
Confirm that the file uses MySQL slow-log records with Query_time metadata followed by SQL statements.
Upload failed
Check the connection, keep the original file unchanged, and retry once. If it persists, contact support without attaching an unsanitized log.