Configuring Logging Options
To help troubleshoot issues, you can enable logging in the connector.
Important:
- Only enable logging long enough to capture an issue. Logging decreases performance and can consume a large quantity of disk space.
- The settings for logging apply to every connection that uses the Simba Couchbase ODBC Driver, so make sure to disable the feature after you are done using it.
Logging is configured through connector-wide settings in the simba.couchbaseodbc.ini
file, which apply to all connections that use the connector.
To enable logging:
- Open the
simba.couchbaseodbc.ini
configuration file in a text editor. - To specify the level of information to include in log files, set the
LogLevel
property to one of the following numbers: - Set the
LogPath
key to the full path to the folder where you want to save log files. - Set the
LogFileCount
key to the maximum number of log files to keep. - Set the
LogFileSize
key to the maximum size of each log file in bytes. - Save the
simba.couchbaseodbc.ini
configuration file. - Restart your ODBC application to make sure that the new settings take effect.
LogLevel Value | Description |
---|---|
|
Disables all logging. |
|
Logs severe error events that lead the connector to abort. |
|
Logs error events that might allow the connector to continue running. |
|
Logs events that might result in an error if action is not taken. |
|
Logs general information that describes the progress of the connector. |
|
Logs detailed information that is useful for debugging the connector. |
|
Logs all connector activity. |
Note:
After the maximum number of log files is reached, each time an additional file is created, the connector deletes the oldest log file.
Note:
After the maximum file size is reached, the connector creates a new file and continues logging.
The Simba Couchbase ODBC Driver produces the following log files at the location you specify using the LogPath
key:
- A
simbacouchbaseodbcdriver.log
file that logs connector activity that is not specific to a connection. - A
simbacouchbaseodbcdriver_connection_[Number].log
file for each connection made to the database, where [Number] is a number that identifies each log file. This file logs connector activity that is specific to the connection.
To disable logging:
- Open the
simba.couchbaseodbc.ini
configuration file in a text editor. - Set the
LogLevel
key to0
. - Save the
simba.couchbaseodbc.ini
configuration file. - Restart your ODBC application to make sure that the new settings take effect.
- Connector Logging Configuration Options
- Testing the Connection on page 1
- Configuring the Connector
- Specifying the Locations of the Connector Configuration Files on page 1