System Log

Check whether scheduled jobs and background work ran, and read the errors when they did not.

Last updated About 2 hours ago

Introduction

Building Swell runs work in the background: scheduled jobs, imports, recalculations, integration syncs. The System Log is the record of that work. When something didn't happen and you want to know whether it ran at all, this is the page.

It's read-only. Nothing here changes your data.

Not seeing this page? Reach out to your company admin to update your permissions. See the Roles guide.

Step-by-Step Guide

Open the Log

Go to Settings → System Log.

Read a Row

Each row is one log entry. The columns are:

  1. Job Name. Which piece of background work this came from.

  2. Execution Date. When the job ran.

  3. Logged At. When this particular entry was written. A single job run can write several entries as it progresses.

  4. Message Type. Info for normal progress, Error for something that failed.

  5. Message. The detail. Long messages are truncated, so use Show more to expand one and Show less to collapse it again.

Narrow It Down

Use the date range filter to focus on the window you care about, and filter by message type when you only want failures. Working backwards from the time a user noticed the problem is usually faster than scrolling.

Tips

  1. Check here before reporting a bug. "The job didn't run" and "the job ran and errored" are different problems, and this page tells them apart.

  2. Copy the message when you contact us. The full expanded text saves a round trip.

  3. Watch Execution Date, not just Logged At. A job can log late for a run that happened earlier.

FAQ

An Error row appeared. Do I need to do something?

Not always. Some errors are retried automatically. If the outcome you expected is still missing after a while, send us the message.

Why is there no entry for something I expected to run?

That usually means the job never fired, which is worth telling us about. Note the date range you checked.

Can I re-run a job from here?

No. This page reports, it doesn't trigger. Contact support if something needs re-running.

Conclusion

The System Log answers one question well: did it run, and what did it say? Start here whenever background work seems to have skipped.

Need help? Hit the chat button or click "Ask" in the app. You can also reach us at support@buildingswell.com.