Kiln AI Docs
Kiln Website
  • Welcome to Kiln AI
  • Docs
    • Quickstart
    • Models and AI Providers
    • Synthetic Data Generation
    • Fine Tuning Guide
    • Evaluations
    • Guide: Train a Reasoning Model
    • Reasoning & Chain of Thought
    • Prompts
    • Reviewing and Rating
    • Collaboration
    • Organizing Datasets
    • Structured Data / JSON
    • Keyboard Shortcuts
    • Privacy
    • Repairing Responses
    • Troubleshooting & Logs
    • Contact Us
  • Developers
    • Python Library Setup
    • Rest API
    • Kiln Data Model
Powered by GitBook
On this page
  • First: Consider Model Errors
  • Second: Review the Error Message For Guidance
  • Third: Check The Logs
  1. Docs

Troubleshooting & Logs

How to troubleshoot errors from the logs

PreviousRepairing ResponsesNextContact Us

Last updated 9 days ago

First: Consider Model Errors

Most bug reports we get aren't actually bugs in Kiln, but models failing to perform the task asked of them. Please read the error messages carefully, and follow the suggestions.

  • If the error is related to structured data, see

  • Try another (smarter) model to see if the issue persists, of if it's isolated to a specific model.

Second: Review the Error Message For Guidance

Often the error message explains how to resolve the issue. Some examples:

  • Issues from connected services (no credit, rate-limits, etc) will need to be corrected with those services

  • "Model not found, inaccessible, and/or not deployed" - A Fireworks API message that the model needs to be re-deployed. For fine-tunes, Kiln can re-deploy the model for you - just open the fine-tune in the "Fine Tune" tab.

Third: Check The Logs

Kiln writes out error logs to the path `~/.kiln_ai/logs/*.log`.

Check your latest log file for a stack trace of any errors, which can help understand the issue. If you think it's a bug in Kiln and not a model issue, please , following the bug template and attaching logs.

file a bug
Troubleshooting Structured Data Issues