Troubleshooting

Testing and problem solving throughout the Swallow platform

Throughout the Swallow platform, there are ways to sense-check your work and test and validate as you go.

Wherever you see a button saying 'View Logs', 'Download Model' or 'Download JSON', you'll be able to view or download JSON populated with test data, so that you can see your work in action, and isolate problems if necessary.

You'll find these buttons throughout the 'Build', 'Test' and 'Data' tabs, as well as on the 'Try Version' and 'Try Live' pages, after you've run a quote using your model.

Viewing logs while building

You can always dig a little deeper into any results by viewing the logs within your model.

On the 'Build' tab, if you click the 'Show Logs' button, all of your steps will expand to show the logs, so you can see how each result was calculated, split in detail. You can also download all logs as a JSON file.

Expanded logs for a 'Factors' step

At any stage in building your model, it's really simple to test your expression before you save it.

Simply click the 'Test' button in the bottom right of any 'Expression' form field, and you'll see either a green tick or a red cross next to a label reading 'View'.

Click the 'Test' button to see if your expression is working

This will tell you whether your syntax is written and parsing correctly or not.

Expression parsing successfully
Expression parsing unsuccessfully

Clicking the 'View' label will open up a debug menu that will show the JSON logs, allowing you to see how your expression is working with default data, to evaluate if it's doing what you expect it to.

Expanded JSON logs

Test data will automatically be generated from the 'Default' inputs you've set up in your INPUTS step. When you're editing a step, you can always see the test data or manually update it at any time in the bottom left of your sidebar.

Test data in the bottom left corner of the sidebar

Last updated