ComusThumbz Documentation
HTML Markdown Print/PDF Plain Text
Admin Login

Documentation Menu


Admin Access

Grabber History

What This Page Does

This page shows a detailed log of every grab and import operation that has occurred on your site. It tracks automated grabs, manual grabs, CSV imports, and model feed grabs. Use this page to monitor how much content is being imported, which feeds are performing well, and whether any errors are occurring.

[Screenshot: grabber-history-overview]

How to Get Here

Navigate to Admin Panel > Grabber > History

You can also reach this page from the navigation bar at the top of any grabber page by clicking History.

Understanding the Page

Dashboard Stats

At the top of the page, four cards summarize your grabber activity. These numbers update based on the filters you apply:

Card What It Shows
Total Grabs The total number of grab operations recorded
Total Imported The total number of videos successfully imported across all operations
Imported Today How many videos were imported today
Average per Grab The average number of videos imported per grab operation

Filter Controls

Below the dashboard, you can narrow down the history using several filters:

Filter What It Does
Date From Show only operations on or after this date
Date To Show only operations on or before this date
Site Show only operations from a specific source site
Action Type Show only a specific type of operation
Feed Show only operations from a specific feed

Action Types

Each grab operation is tagged with an action type so you can tell what triggered it:

Action What It Means Badge Color
Manual Grab You clicked a "Grab Now" button to run a feed manually Blue
Cron Grab The automated scheduler ran this feed Green
CSV Import Videos were imported from a CSV file Orange
Model Grab A performer-linked feed ran Purple
Grab A general grab operation Cyan

History Table

The main area shows each grab operation as a row:

Column What It Shows
Log ID A unique number for each log entry
Timestamp When the operation occurred
Action What type of operation it was (shown as a colored badge)
Site Which source site was used
Feed Name Which feed triggered this operation
Batch ID Groups related imports from the same run together
Found How many videos were found on the source
Imported How many new videos were added to your library
Skipped How many were skipped as duplicates
Failed How many could not be imported due to errors
Duration How long the operation took
Error Any error message that occurred
Details Expandable section with additional technical information

Common Tasks

How to Check Today's Import Activity

  1. Open the Grabber History page.
  2. The Imported Today card in the dashboard immediately shows you how many videos were imported today.
  3. For more detail, set the Date From filter to today's date and click Apply Filters.
  4. The table now shows only today's grab operations.

How to Find Problems with a Specific Feed

  1. Select the feed from the Feed dropdown in the filter controls.
  2. Click Apply Filters.
  3. Review the history for that feed. Look for entries with high Failed counts or Error messages.
  4. Check the Duration column -- unusually long durations may indicate the source site is slow or blocking your requests.

How to Check if Automated Grabbing is Working

  1. Set the Action Type filter to Cron Grab.
  2. Click Apply Filters.
  3. If you see recent entries with green "Cron Grab" badges, your automated system is running correctly.
  4. If there are no recent cron entries, the scheduled task may not be running. Contact your administrator.

How to Review CSV Import Results

  1. Set the Action Type filter to CSV Import.
  2. Click Apply Filters.
  3. Each CSV import shows how many videos were found, imported, skipped (duplicates), and failed.
  4. Click the Details section on any entry for additional information about what was processed.

How to View Activity for a Specific Date Range

  1. Enter a start date in the Date From field.
  2. Enter an end date in the Date To field.
  3. Click Apply Filters.
  4. The dashboard stats and table update to show only activity within that date range.

Reading the Results

Understanding the Numbers

For each grab operation, the four count columns tell the full story:

  • Found -- How many videos the grabber detected on the source. A high Found count means the source has plenty of content matching your feed.
  • Imported -- How many new videos were added. This is the number that grows your library.
  • Skipped -- How many were already in your library. High skip counts are normal for feeds that run frequently, as the source pages often show the same videos.
  • Failed -- How many could not be imported. Occasional failures are normal, but consistently high failure rates indicate a problem.

Understanding Duration

The Duration column shows how long each operation took:

  • Milliseconds (ms) -- Very fast operations, typically cached or empty results
  • Seconds (s) -- Normal speed for most grab operations
  • Minutes (m:ss) -- Longer operations, usually large CSV imports or feeds with detail enrichment enabled
Tip: If durations are consistently increasing for a specific site, it may be throttling your requests. Consider reducing the Max Videos per Grab for that feed or increasing the cURL Timeout in Grabber Settings.

Tips for New Users

Tip:
  • Check the history daily. A quick glance at the dashboard tells you if your grabber is healthy and producing results.
  • Watch the Imported Today card. If this drops to zero unexpectedly, something may have stopped working.
  • Use date filters for reporting. Set a date range to see weekly or monthly import totals for planning.
  • Monitor failed counts. A few failures per run are normal, but a sudden spike in failures usually means a source site has changed or is blocking your requests.
  • Compare feeds. Use the Feed filter to compare which feeds are producing the most content and disable underperforming ones.

Troubleshooting

No history entries appear

What you see: The history table is empty.

How to fix it:

  1. Check your filters -- you may have a filter set that excludes all results. Click Clear Filters to reset.
  2. If the table is still empty after clearing filters, no grab operations have been recorded yet. Create a feed and run it to generate history entries.

 

All entries show high failed counts

What you see: Most grab operations show a large number of failures.

How to fix it:

  1. Click the Details section on a failed entry to see more information about the error.
  2. Common causes include: source site is offline, source site has changed its layout, or your server's internet connection has issues.
  3. Check the Feed Sources guide to see if the affected site is currently supported and working.
  4. Try increasing the cURL Timeout in Grabber Settings.

 

Cron Grab entries have stopped appearing

What you see: You see old cron entries but nothing recent, even though Auto-Grab is enabled.

How to fix it:

  1. Go to Grabber Settings and verify that Enable Auto-Grab is checked.
  2. The scheduled background task on your server may have stopped. Contact your administrator to check and restart it.

 

Dashboard numbers seem wrong

What you see: The stats cards show unexpected numbers.

How to fix it:

  1. Check your active filters. The dashboard stats are affected by filters, so they may be showing a filtered subset of data.
  2. Clear all filters to see the total numbers across all time.

 

Page When to Use It
Grabber Settings To adjust global settings like timeouts, automation, and filtering
Grabber Feeds To create or modify the feeds whose results appear in the history
Model Feeds To manage performer-linked feeds
RSS Feeds To manage RSS feed imports
CSV Import To perform bulk CSV imports (which then appear in the history)
Feed Sources To check which source sites are currently working
Video Management To find and manage the videos that were imported

Last Updated: 2026-02-22
Guide Version: 1.0

Related Pages