Common SDK errors and warnings in Gentrace
GT_OtelNotConfiguredError
OpenTelemetry SDK does not appear to be configured
Affected SDKs: Node.js, Python
Description: This warning appears when the OpenTelemetry SDK is not properly configured. Without proper configuration, Gentrace features like interaction()
, evalOnce()
/eval()
, traced()
, and evalDataset()
/eval_dataset()
will not record any data to the Gentrace UI.
Resolution:
GT_PipelineInvalidError
Pipeline ID 'xxx' is not a valid UUID
Affected SDKs: Python, Node.js
Description: This error occurs when the provided pipeline ID is not a valid UUID format. Pipeline IDs in Gentrace must be valid UUIDs.
Resolution: Verify the pipeline ID matches what’s shown in the Gentrace UI. Pipeline IDs should be in UUID format. See the pipelines reference for more information.
GT_PipelineNotFoundError
Pipeline 'xxx' does not exist or is not accessible
Affected SDKs: Python, Node.js
Description: The specified pipeline ID does not exist in your Gentrace account or is not accessible with the current API key.
Resolution:
GT_PipelineUnauthorizedError
Access denied to pipeline 'xxx'
Affected SDKs: Python, Node.js
Description: Your API key does not have the necessary permissions to access the specified pipeline.
Resolution: Check that your GENTRACE_API_KEY
has the correct permissions for the pipeline you’re trying to access. See the pipelines reference for more information about pipeline permissions.
GT_AutoInitializationWarning
Gentrace was automatically initialized from environment variables
Affected SDKs: Python, Node.js
Description: This warning appears when Gentrace is automatically initialized from environment variables rather than explicitly calling gentrace.init()
. This can cause issues with custom options and instrumentations.
Resolution: Ensure gentrace.init()
is called at the very beginning of your application before using any decorators: