Component: Trace 
-----------------

Debug logging of plugin calls to a log file, Console.app or DebugView.

| Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|
| [2.4](newinversion24.md "First functions introduced with version 2.4.") / [11.2](newinversion112.md "Newest functions in version 11.2.") | ✅ Yes | ✅ 82% | ✅ 82% | ✅ 82% | ✅ 82% |

  
| Item | Details | Server |
|:--|:--|:--|
| [Trace](Trace.md)   Starts logging all plugin calls to a text file. | All   2.4 | ✅ Server |
| [Trace.AreErrorNotificationsEnabled](TraceAreErrorNotificationsEnabled.md)   Checks whether error notifications are enabled. | Mac only   5.0 | ❌ Server |
| [Trace.DisableErrorNotifications](TraceDisableErrorNotifications.md)   Disables error notifications. | Mac only   5.0 | ❌ Server |
| [Trace.EnableErrorNotifications](TraceEnableErrorNotifications.md)   Enable error notifications. | Mac only   5.0 | ❌ Server |
| [Trace.GetErrorsOnly](TraceGetErrorsOnly.md)   Queries whether to trace only errors. | All   9.3 | ✅ Server |
| [Trace.GetServerLogPath](TraceGetServerLogPath.md)   Queries server log path. | All   10.4 | ✅ Server |
| [Trace.GetWithTimes](TraceGetWithTimes.md)   Queries whether to trace with times. | All   9.3 | ✅ Server |
| [Trace.IsEnabled](TraceIsEnabled.md)   Queries trace on/off status. | All   11.2 | ✅ Server |
| [Trace.IsPaused](TraceIsPaused.md)   Queries pause state of trace function. | All   11.2 | ✅ Server |
| [Trace.Off](TraceOff.md)   Disables tracing. | All   3.3 | ✅ Server |
| [Trace.Path](TracePath.md)   Queries current trace path. | All   11.2 | ✅ Server |
| [Trace.Pause](TracePause.md)   Pauses trace logging until you resume. | All   11.2 | ✅ Server |
| [Trace.Resume](TraceResume.md)   Resumes trace logging. | All   11.2 | ✅ Server |
| [Trace.SetErrorsOnly](TraceSetErrorsOnly.md)   Sets whether to only log trace. | All   9.3 | ✅ Server |
| [Trace.SetServerLogPath](TraceSetServerLogPath.md)   Enables logging per thread for server. | All   10.4 | ✅ Server |
| [Trace.SetWithTimes](TraceSetWithTimes.md)   Sets whether to include times in traces. | All   9.3 | ✅ Server |
| [Trace.WriteLine](TraceWriteLine.md)   Adds line to trace logging. | All   9.1 | ✅ Server |

17 functions shown.

These functions are free to use.

### Release notes

- **Version 15.2**
    - Changed tracing to log time with start script if [Trace.SetWithTimes](https://www.mbsplugins.eu/TraceSetWithTimes.shtml) function.
- **Version 12.4**
    - Fixed per thread storage to properly cleanup and avoid [trace](https://www.mbsplugins.eu/component_Trace.shtml) functions leak file handles on server if you use per thread trace files.
- **Version 11.2**
    - Added [Trace.IsEnabled](https://www.mbsplugins.eu/TraceIsEnabled.shtml) and [Trace.IsPaused](https://www.mbsplugins.eu/TraceIsPaused.shtml) functions.
    - Added [Trace.Path](https://www.mbsplugins.eu/TracePath.shtml) function.
    - Added [Trace.Pause](https://www.mbsplugins.eu/TracePause.shtml) and [Trace.Resume](https://www.mbsplugins.eu/TraceResume.shtml) functions.
    - Changed [Trace](https://www.mbsplugins.eu/component_Trace.shtml) function to create log file, which is readable by other applications like a good text editor.
- **Version 10.4**
    - Added [Trace.GetServerLogPath](https://www.mbsplugins.eu/TraceGetServerLogPath.shtml) and [Trace.SetServerLogPath](https://www.mbsplugins.eu/TraceSetServerLogPath.shtml) functions. Allows to have one trace log file per thread.
- **Version 9.3**
    - Added [Trace.GetErrorsOnly](http://www.mbsplugins.eu/TraceGetErrorsOnly.shtml), [Trace.GetWithTimes](http://www.mbsplugins.eu/TraceGetWithTimes.shtml), [Trace.SetErrorsOnly](http://www.mbsplugins.eu/TraceSetErrorsOnly.shtml) and [Trace.SetWithTimes](http://www.mbsplugins.eu/TraceSetWithTimes.shtml).
- **Version 9.1**
    - Added [Trace.WriteLine](http://www.mbsplugins.eu/TraceWriteLine.shtml) function to write text/data into trace logging.
- **Version 8.1**
    - Fixed [Trace.AreErrorNotificationsEnabled](http://www.mbsplugins.eu/TraceAreErrorNotificationsEnabled.shtml).

### Blog Entries

- [Free Tier for MBS FileMaker Plugin](https://www.mbsplugins.de/archive/2023-01-30/Free_Tier_for_MBS_FileMaker_Pl/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 12.4pr2](https://www.mbsplugins.de/archive/2022-08-15/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [Transactions with SQL functions](https://www.mbsplugins.de/archive/2022-04-28/Transactions_with_SQL_function/monkeybreadsoftware_blog_filemaker)
- [Install MBS Plugin on a FileMaker Server](https://www.mbsplugins.de/archive/2022-02-20/Install_MBS_Plugin_on_a_FileMa/monkeybreadsoftware_blog_filemaker)
- [Trace with parameter names](https://www.mbsplugins.de/archive/2022-01-24/Trace_with_parameter_names/monkeybreadsoftware_blog_filemaker)
- [New in MBS FileMaker Plugin 11.2](https://www.mbsplugins.de/archive/2021-05-26/New_in_MBS_FileMaker_Plugin_11/monkeybreadsoftware_blog_filemaker)
- [Neues MBS FileMaker Plugin 11.2](https://www.mbsplugins.de/archive/2021-05-18/Neues_MBS_FileMaker_Plugin_112/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 11.2 - More than 6500 Functions In One Plugin](https://www.mbsplugins.de/archive/2021-05-18/MBS_FileMaker_Plugin_112_-_Mor/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 11.2pr5](https://www.mbsplugins.de/archive/2021-05-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

### FileMaker Magazin

- [Ausgabe 2/2022, Seite 18](https://filemaker-magazin.de/neuigkeit/4174-Appetithappen-FMM_202202)
- [Ausgabe 2/2017, Seite 39](https://filemaker-magazin.de/neuigkeit/3930-Appetithappen-FMM_201702)

### Example Databases

- [DynaPDF/Catalog with tables](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/DynaPDF/Catalog%20with%20tables.shtml#1ScriptAnchor_)
- [DynaPDF/Report](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/DynaPDF/Report.shtml#1ScriptAnchor_)
- [List/QuickList Test](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/List/QuickList%20Test.shtml#2ScriptAnchor_)
- [List/Sort Benchmark](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/List/Sort%20Benchmark.shtml#11ScriptAnchor_)
- [Registration/Debugging and Registration](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Registration/Debugging%20and%20Registration.shtml#1Button66.0000000319.000000096.0000000479.0000000LayoutObjectAnchor_)
- [SmartCard/Belgian EID Reader](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/SmartCard/Belgian%20EID%20Reader.shtml#2ScriptAnchor_)

[HTML Version](component_Trace.shtml)