Logging
This section provides a complete list of the Logging properties you can configure in the connection string for this provider.
|
Property |
Description |
|
Logfile |
A filepath which designates the name and location of the log file. |
|
Verbosity |
The verbosity level that determines the amount of detail included in the log file. |
|
LogModules |
Core modules to be included in the log file. |
|
MaxLogFileSize |
A string specifying the maximum size in bytes for a log file (for example, 10 MB). |
|
MaxLogFileCount |
A string specifying the maximum file count of log files. |
Logfile
A filepath which designates the name and location of the log file.
Data Type
string
Default Value
""
Remarks
Once this property is set, the provider will populate the log file as it carries out various tasks, such as when authentication is performed or queries are executed. If the specified file doesn't already exist, it will be created.
Connection strings and version information are also logged, though connection properties containing sensitive information are masked automatically.
If a relative filepath is supplied, the location of the log file will be resolved based on the path found in the Location connection property.
For more control over what is written to the log file, you can adjust the Verbosity property.
Log contents are categorized into several modules. You can show/hide individual modules using the LogModules property.
To edit the maximum size of a single logfile before a new one is created, see MaxLogFileSize.
If you would like to place a cap on the number of logfiles generated, use MaxLogFileCount.
Verbosity
The verbosity level that determines the amount of detail included in the log file.
Data Type
string
Default Value
"1"
Remarks
The verbosity level determines the amount of detail that the provider reports to the Logfile. Verbosity levels from 1 to 5 are supported. These are detailed in the Logging page.
LogModules
Core modules to be included in the log file.
Data Type
string
Default Value
""
Remarks
Only the modules specified (separated by ';') will be included in the log file. By default all modules are included.
See the Logging page for an overview.
MaxLogFileSize
A string specifying the maximum size in bytes for a log file (for example, 10 MB).
Data Type
string
Default Value
"100MB"
Remarks
When the limit is hit, a new log is created in the same folder with the date and time appended to the end. The default limit is 100 MB. Values lower than 100 kB will use 100 kB as the value instead.
Adjust the maximum number of logfiles generated with MaxLogFileCount.
MaxLogFileCount
A string specifying the maximum file count of log files.
Data Type
int
Default Value
-1
Remarks
When the limit is hit, a new log is created in the same folder with the date and time appended to the end and the oldest log file will be deleted.
The minimum supported value is 2. A value of 0 or a negative value indicates no limit on the count.
Adjust the maximum size of the logfiles generated with MaxLogFileSize.