Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

Trace.SetServerLogPath

Enables logging per thread for server.

Component Version macOS Windows Linux Server iOS SDK
Trace 10.4 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "Trace.SetServerLogPath"; Path )   More

Parameters

Parameter Description Example
Path The native folder path. "/tmp"

Result

Returns OK or error.

Description

Enables logging per thread for server.
Only useful on server, where multiple scripts may run in parallel and each may log to its own file.
We suggest to use /tmp folder as this gets cleaned on server restart, but FileMaker's log folder may also work.
Does nothing if called on client.

Be aware that FileMaker Server reuses threads and the logs append the files, so when a script is done, the log file gets reused for another script.

See also Trace.SetWithTimes to enable times in trace log.
Since this function also enables trace if not yet running, there is no need to call Trace function.

This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
For Server be aware that server has limited permissions and may not be able to access all files on a computer.

Examples

Set tmp as log folder:

Set Variable [ $r; Value: MBS( "Trace.SetServerLogPath"; "/tmp" ) ]

Log to FileMaker's log folder on a Linux server:

MBS( "Trace.SetServerLogPath"; "/opt/FileMaker/FileMaker Server/Logs/")

Enables logging on Windows Server:

Set Variable [ $r; Value: MBS( "Trace.SetServerLogPath"; "C:\Program Files\FileMaker\FileMaker Server\Logs\\") ]

Setup logging on server with multiple log files and times:

Set Variable [ $r; Value: MBS( "Trace.SetWithTimes"; 1) ]
Set Variable [ $r; Value: MBS( "Trace.SetServerLogPath"; "/Library/FileMaker Server/Logs/") ]
Set Variable [ $r; Value: MBS( "Trace") ]

See also

Release notes

Blog Entries

This function is free to use.

Created 31st August 2020, last changed 9th September 2021


Trace.SetErrorsOnly - Trace.SetWithTimes