Error Logs | Vantage BYOM - Error Logs - Teradata Vantage

Teradata Vantageā„¢ - Bring Your Own Model User Guide

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
Lake
VMware
Product
Teradata Vantage
Release Number
5.0
Published
October 2023
Language
English (United States)
Last Update
2023-12-19
dita:mapPath
fee1607120608274.ditamap
dita:ditavalPath
ayr1485454803741.ditaval
dita:id
fee1607120608274

byom.log

This feature is available with BYOM versions 3.00.00.01 and earlier.

Each node has a copy of the error log at /var/opt/teradata/byom.

The current error log is at /var/opt/teradata/byom.log.

If the error log exceeds 10 MB, the system saves three excess files, giving them these names:
  • /var/opt/teradata/byom.log.1
  • /var/opt/teradata/byom.log.2
  • /var/opt/teradata/byom.log.3

The log level for the error log is INFO. You cannot change this value.

Teradata recommends not changing the value of the Debug parameter to true, because logging the debugging information slows the scoring process.

BYOM_Trace

This feature is available with BYOM versions 3.00.00.02 and later and replaces the byom.log feature in earlier versions of the product. To save logs for debugging, you can create an error log by using the IsDebug('true') parameter in the predict functions. Logs are no longer saved under /var/opt/Teradata/BYOM. A database trace table is used to collect this information which does impact performance of the function, so using small data input sizes is recommended. To generate this log you must do the following:

  • Create a global trace table with the following SQL statement:
    CREATE GLOBAL TEMPORARY TRACE TABLE BYOM_Trace
    	(vproc_ID	BYTE(2)
    	,Sequence	INTEGER
    	,Trace_Output VARCHAR(31000) CHARACTER SET LATIN NOT CASESPECIFIC)
    	ON COMMIT PRESERVE ROWS;

    BYOM_Trace is just an example, you can customize the table name.

  • Turn on session function tracing:
    SET SESSION FUNCTION TRACE USING '' FOR TABLE BYOM_Trace;
  • Add the IsDebug('true') parameter to the USING clause and run your predict function.
  • Information is logged in the BYOM_Trace table and can be viewed with the following query:
    SELECT * FROM BYOM_Trace ORDER BY 2;
  • To turn off tracing once you have run your query, you can either log off the session or run the following query:
    SET SESSION FUNCTION TRACE OFF;

The trace table is temporary and the information is deleted if you log off from your session. If long term persistence is necessary, you can copy the table to a permanent table before leaving the session.