Diagnostics

If something in Gramax isn't working right, support may ask you to send logs or raise the logging level and reproduce the issue. Logging level and log export are configured in Settings → Application → Diagnostics.

How to Capture a Log for an Issue

Logs are only recorded from the moment the right level is turned on — nothing can be recovered retroactively. So:

1. Raise the logging level before reproducing the issue, not after.

2. Reproduce the steps that lead to the issue.

3. Right away, export the logs via Export logs — before restarting the app or closing the session.

4. Once the issue is captured, set the level back to Important or Off — at detailed levels, log files grow fast.

Logging Level

The more detailed the level, the more support can see when investigating an issue, but the larger the log files. By default, the Important level is on — it doesn't overload the logs but covers the main scenarios.

Levels from least to most detailed, each next one includes the previous:

• Off — no logs are recorded.

• Commands — command execution, app startup, high-level actions, crashes.

• Important — significant steps inside commands: publishing, syncing, autopull status, connecting and disconnecting from the server.

• Internal logic — internal work with Git, the catalog, and the file structure, plus key read operations.

• File operations — additionally, file write operations.

• Full — literally every operation, including reads. The most detailed and heaviest level.

No matter which level is selected, an error and the full chain of actions that led to it are always logged. The level only controls how much extra detail is kept around that error.

Next to the level, you can enable Output logs to console to also mirror them to the developer console (F12 -> Console).

Export Logs

In the same section, under Troubleshooting, click Export logs and choose a period:

• Current session — logs since the app was last started.

• Today.

• Last 7 days.

• All — the entire available log archive, the heaviest option.

Gramax will collect an archive and offer to save it to your computer. Attach this archive to your support request or bug report.

In the desktop version, you can also export logs via the Help → Export Event Log menu, choosing the same period.