estimate unavailable. Actual indexable text may differ from file size due to binary content, formatting, or parsing behavior.
How to View Your Indexing Job Logs
Validated on 15 Apr 2026 • Last edited on 27 Apr 2026
DigitalOcean Knowledge Bases let you store, index, and retrieve data from private files, websites, Spaces buckets, and other sources to power retrieval-augmented generation with your own content.
When you create or update a knowledge base, its data sources are indexed. Each indexing job is logged and can be downloaded as a CSV for debugging or auditing.
View Indexing Job Logs
To track these indexing jobs, go to the DigitalOcean Control Panel, in the left menu, click DATA SERVICES, and then click Knowledge Bases.
Then, select the knowledge base you want to view indexing job logs for, and then click its Activity tab.
View a Indexing Job in Progress
Above the Activity section, the indexing job shows real-time progress. When the job finishes, its status helps you interpret the results:
- Completed: All files indexed successfully.
- No Changes: No updates were detected in the data sources and no files or URLs were re-indexed.
- Partially Completed: Some files were indexed, but others were skipped or failed. This may create gaps in your knowledge base results.
- Failed: No files were indexed, usually due to a system or configuration issue (for example, formatting problems or unsupported characters).
If you try to run another indexing job while another one is in progress, the new job is skipped since only one job can run at a time.
View Completed Indexing Jobs
Under the Activity section, you can see the 15 most recent indexing jobs. Since only 15 jobs are stored, we recommend downloading the CSV by clicking Download Details for each index job ran.
Under the Activity section, each logged indexing job shows:
- The overall status (see above).
- The token count with the indexing rate (for example, “0 tokens @ $0.09/1M”). You only pay for successfully indexed data, and prices are rounded down to two decimal places. For more details on indexing costs, see knowledge base pricing.
- How many files were indexed, skipped, or failed (for example, “Indexed 0 of 2 files/URLs (0%)”).
- A date and timestamp of when the indexing job ran.
- A Download Details option to download the indexing job as a CSV file.
File-level details, such as filenames and error reasons, are only available in the downloadable CSV. Files with unchanged content are skipped to avoid extra charges.
If files fail, click Download Details for that run, review the errors, fix the data, then re-upload the file and re-run the job. If the file continues to fail, contact support.