Skip to main content

Error and info logging

Zuora

Error and info logging

The Z Logger object stores log records of Error and Info types.

  • Error type - Records error details whenever an exception occurs from Quote Studio UI.
  • Info type - Records the time spent on the server side during
    • Preview call
    • Rules execution
    • Saving preview metrics

The Error logs are available from Quotes version 10.40 onwards.

A Log Cleanup Job is created to clear the log records. It is scheduled for 2:00 AM daily, based on the Administrator’s time zone.

This setting is available from Quotes version 10.40 onwards.

Enable error logging

Follow these steps to enable error logging: 

  1. Navigate to Zuora Config > Advanced Quoting Configuration Settings.
  2. Click Enable Error Logging to enable error logging and click Save.
  3. Refresh the Advanced Quoting Configuration Settings page.
  4. Enter the number of retention days in the Retention Days field and click Save.
    The default value is 7 days.

When the Enable Error Logging setting is disabled, the cleanup job is deleted.

Z logger fields

The following table lists the Z logger fields.

Field label and API name Type and description

Details
(zqu__Details__c)

Long Text Area(131072)

This field stores the time spent on the server side during the preview call, rules execution, and saving preview metrics. This field populates only for Info type logs.

Error Message
(zqu__Error_Message__c)

Text Area (255)

This field stores the description of the generated error

Keep?
(zqu__Keep__c)

Checkbox

This field stores information on whether the record should be deleted or retained.

Log Level
(zqu__Log_Level__c)

Picklist

This field stores the type of the log record. Picklist values:

  • Error
  • Info
  • Debug
Log Name

Auto Number

This field stores the name of the record in the format Log-{0000}.

Method Name
(zqu__Method_Name__c)

Text(255)

This field stores the method name from where the log record is created in the format 'ClassName.MethodName'.

Parent Id
(zqu__Parent_Id__c)

Text(255)

This field stores the parent record's ID [Account/Opportunity/Quote] for tracking purposes.

Stack Trace
(zqu__Stack_Trace__c)

Long Text Area(131072)

This field stores the stack trace to identify where the error is generated in the code.

User Id

Text(255)

This field stores the ID of the logged-in user.

Log samples

This section shows some log samples:

Error log sample 1 

Name

zqu__Log_Level__c

zqu__Error_Message__c

zqu__Stack_Trace__c

zqu__Parent_Id__c

zqu__Method_Name__c

zqu__Details__c

Log-0008

Error

System.MathException: Divide by 0

Class.zqu.QuoteStudioController.applyRules: line 1221, column 1

a0xRu0000049nnBIAQ

   

Error log sample 2

Name

zqu__Log_Level__c

zqu__Error_Message__c

zqu__Stack_Trace__c

zqu__Parent_Id__c

zqu__Method_Name__c

zqu__Details__c

Log-0010

Error

Code: 58730030, Message: The Charge is not allowed to be updated before the last segment effective start date 2025-03-03.

QuoteStudioController.previewSummaries

 

a0xRu0000048vlDIAQ

   

Log info sample 1 - rules execution

Name

zqu__Log_Level__c

zqu__Error_Message__c

zqu__Stack_Trace__c

zqu__Parent_Id__c

zqu__Method_Name__c

zqu__Details__c

Log-0039

 

 

 

 

 

Info

     

QuoteStudioController.applyRules

Method Enter - applyRules - 2025-03-05 15:03:39

Rule Execution options - ruleIdsToExecute: ()

Rule Execution options - forceExecuteRules: false

Rule Execution options - includeRemovedRatePlan: false

Deserialize Rule Execution Options - Duration - 22 ms

Deserialize QuoteState - Duration - 24 ms

Rule Execution - Duration - 4514 ms

Method Exit - applyRules - 2025-03-05 15:03:43

Log info sample 2 - preview call

Name

zqu__Log_Level__c

zqu__Error_Message__c

zqu__Stack_Trace__c

zqu__Parent_Id__c

zqu__Method_Name__c

zqu__Details__c

Log-0041

 

 


 

Info

     

QuoteStudioController.previewSummaries

Method Enter - previewSummaries - 2025-03-05 15:03:53

requestId: a0xRu0000049ns1IAA_New Subscription_1741187031227

Deserialize QuoteState - Duration - 84 ms

Preview API call - Duration - 2775 ms

Preview Execution - Duration - 8507 ms

Method Exit - previewSummaries - 2025-03-05 15:04:02

Log info sample 3 - saving preview metrics

Name

zqu__Log_Level__c

zqu__Error_Message__c

zqu__Stack_Trace__c

zqu__Parent_Id__c

zqu__Method_Name__c

zqu__Details__c

og-0041

 

 

 

 

 

Info

     

QuoteStudioController.previewSummaries

Method Enter - savePreviewMetrics - 2025-03-05 15:04:42
quoteStateJson: {"subscriptionActions":null,"subscription":{"rampIntervals":[],"productTimelines":{"&BzUTtck4mCsKc8uVSMJfw":{"versions":[{"record":{"attributes":{"type":"zqu__QuoteRatePlan__c","url":"/services/data/v6...Deserialize QuoteState - Duration - 33 ms
Order Preview Response Execution - Duration - 5890 ms
Process Successful Preview Execution - Duration - 1015 ms
Save Preview Metrics Execution - Duration - 8166 ms
Method Exit - savePreviewMetrics - 2025-03-05 15:04:51