When PhotoStructure encounters errors, it may automatically send a report to our error system, Sentry.
These error help us determine both what resulted in the error, and how to resolve it in the future.
What’s included in an error report? #
- Operating system (macOS, Linux distribution, Windows) and version/build
- Hardware information (RAM free/used, and CPU make/model)
- Mounted volume metadata (mount points, free/used, and if the volume is remote)
- Recent health check results (viewable in the “About” page)
- Your email address, if you’ve provided it via the
- Context around the error
- Recent log messages
What are in log messages? #
Log messages can (but do not always) include:
- Synchronization progress information (including directories that are included and excluded from imports)
- Health check metadata
- Path names to files that PhotoStructure is processing
- Metadata extracted from imported files
What’s not included in error reports? #
Error reports never include actual image content from any of your photos and videos.
PhotoStructure also uses Sentry’s enhanced privacy and data scrubbers for all error reports.
What’s actually sent? #
A JSON file with the full error report payload is saved into your
directory on your local disk when error reports are sent.
How frequently are these sent? #
Only unexpected or internal errors result in an error report. Ideally, these events are rare.
PhotoStructure limits the number of error reports sent per day, via the
setting. The default is 3 events per day.
How to opt out of sending error reports #
You can opt out of all error reporting via advanced
settings. Shut down PhotoStructure, open your library
false, save your changes, and restart
How to manually send your logs #
If you’ve been asked to send more in-depth logs, first off: thank you for your time and assistance, and sorry if PhotoStructure is misbehaving for you.
Step 1: Shut down PhotoStructure, and set
Make sure PhotoStructure is shut down.
Then, edit your
Alternatively, if it’s more convenient, you can set the
environment variable to
info. If you’re using PhotoStructure for Desktops on
launchctl setenv PS_LOG_LEVEL info.
The other valid log levels are
error(the default, only reports egregious problems),
warn(includes minor and expected errors),
info(tracks high-level execution paths), and
Step 2: Start PhotoStructure and reproduce the error #
If this involves sync problems, just let it run for a couple minutes.
Then shut down PhotoStructure.
Step 3: Send us your log directory #
If you’re on a desktop, navigate to the logs directory, right-click, select
“create archive” or “compress…", and then email us the zipfile or
The default log directory is
%APPDATA%\PhotoStructure\logson Windows, and