Skip to main content
DataStore uses Python’s standard logging module. This guide shows how to configure logging for debugging.

Quick Start

Log Levels

Setting Log Level

Log Format

Simple Format (Default)

Query
Response

Verbose Format

Query
Response

What Gets Logged

DEBUG Level

  • SQL queries generated
  • Execution engine selection
  • Cache operations (hits/misses)
  • Operation timings
  • Data source information

INFO Level

  • Major operation completions
  • Configuration changes
  • Data source connections

WARNING Level

  • Deprecated feature usage
  • Performance warnings
  • Non-critical issues

ERROR Level

  • Query execution failures
  • Connection errors
  • Data conversion errors

Custom Logging Configuration

Using Python Logging

Log to File

Suppress Logging


Debugging Scenarios

Debug SQL Generation

Log output:

Debug Engine Selection

Log output:

Debug Cache Operations

Debug Performance Issues

Log output:

Production Configuration

Log Rotation


Environment Variables

You can also configure logging via environment variables:

Summary

Last modified on June 23, 2026