How To: Check Export Queue¶
Export submissions (to Mojix, MWE, or AIS) are saved as files in a queue. This guide shows how to check the queue status.
Step 1: Open the export queue folder¶
- Open File Explorer.
- Navigate to
C:\gatekeeper\conveyor\data\ais\ - Expected: You should see up to three subfolders:
| Folder | Purpose |
|---|---|
todo\ |
Pending submissions waiting to be sent |
processed\ |
Successfully sent submissions (archived by date) |
error\ |
Failed submissions that exceeded max retries |
Step 2: Check pending submissions¶
- Open the
todo\folder. - Count the files inside.
| Observation | Meaning |
|---|---|
| Folder is empty | No pending exports -- everything has been sent |
| A few files (1-5) | Normal -- recently created submissions being processed |
| Many files (10+) | Exports may be failing -- the queue is backing up |
| Files accumulating over time | The export service cannot reach the destination |
If files are accumulating, see Exports Failing.
Step 3: Check processed submissions¶
- Open the
processed\folder. - Inside you will see date-based subfolders (for example,
20260206\). - Files in these folders were successfully sent.
This confirms: Exports were working at some point. If processed\ has recent files but todo\ is now accumulating, the export service may have lost connectivity recently.
Step 4: Check error submissions¶
- Open the
error\folder (if it exists). - Inside you will see date-based subfolders.
- Each failed submission has two files:
- The original submission file (
.json) - A companion error file (
_ERROR.txt)
Reading the error file¶
Open the _ERROR.txt file in Notepad. It contains:
[MOJIX-EXPORT] Error Log for: submission-12345.json
Timestamp: 2026-02-06T10:30:00Z
Retry Count: 3/3
=== Submission Failure Details ===
StatusCode: 404
Error: Not Found
=== Response Body ===
{"error": "endpoint not found"}
=== Request Payload ===
{...the data that was sent...}
Key information: - StatusCode: The HTTP error code (see Export Errors Reference) - Error: Plain-text error description - Retry Count: How many times the submission was retried
Step 5: Check export statistics in the Diagnostics panel¶
- Open the Diagnostics panel (gear icon).
- Look for export statistics.
- Expected: Today's submission counts for each export service.
Step 6: What to do about backed-up exports¶
If exports are failing due to network issues¶
- Fix the network connectivity issue (see Check Network Connectivity).
- Files in
todo\will be automatically retried once the network is restored. - No action needed on the files themselves.
If files are in the error folder¶
- Files in
error\are NOT automatically retried. - After fixing the underlying issue, you can move the
.jsonfiles (not the_ERROR.txtfiles) back to thetodo\folder for reprocessing. - Or, if the data is no longer needed, leave them in the error folder.
If disk space is running low¶
- Old processed submissions in
processed\can be safely deleted. - Error submissions in
error\can be deleted if the data is no longer needed. - Do NOT delete files from
todo\unless you are sure they should not be sent.