Send feedback on this topic.
Teradata.Client.Provider
Logging and Tracing on Linux
.NET Data Provider for Teradata > Developer's Guide > Product Support, Troubleshooting and Error Messages > Troubleshooting > Logging and Tracing on Linux

Logging and Tracing for the .NET Data Provider for Teradata uses the Linux Trace Toolkit Next Generation (Lttng). Logging can be activated as described below.

In order to perform logging on Linux the following tools must be installed:

Detailed steps:

  1. Create the file TeradataLogging.config in the same directory as your application executable.
    You may copy the following example file.
    The options that should be enabled will depend on the nature of the issue you are having.

  2. Open a terminal window and execute the next 3 steps within the same shell.

  3. Execute the following commands:

    export COMPlus_EnableEventLog=1
    export COMPlus_EventSourceFilter=Teradata-Data-Provider
    lttng create teradata-trace
    lttng enable-event -u --tracepoint DotNETRuntime:EventSource
    lttng start

    The root path under which the log files will be created is displayed.
    Example: ~/lttng-traces/teradata-trace-20180101-120000

  4. Run your application in order to reproduce the issue.

  5. After your application completes, or logging is no longer required, execute the following commands:

    lttng stop
    lttng destroy
  6. Execute the following command:

    babeltrace ~/lttng-traces/teradata-trace-timestamp >> output_file_name

    where timestamp is the date/time of the path displayed when you started lttng
    and output-file-name is the log file you wish to create.

  7. Analyze the results using the file created in the previous step.

Note that the content of the data messages sent/received from Teradata is not currently available on Linux.