Skip to main content

​
What this is

The source report shows the ingestion health and status of a single source. It is available on the source details page under the SOURCE REPORT tab, and it is broadly divided into two panels:
  • Data Ingestion Details — lifetime record counts for the source, the split between records received, in progress, ingested and failed, and the ingestion efficiency.
  • File Ingestion Details — one row per file shared with Zeotap CDP, with its ingestion status for real-time and batch activation, its record counts, its size and its ingestion logs. This panel is only visible for batch data sources where data is being shared in files.

​
Prerequisites

Before you open a source report, confirm:
  • The source is created and its mapping is saved. Ingestion begins only after the source is mapped.
  • The source has completed at least one ingestion attempt, so the report has data to display.
  • You have permission to view source reports for the source you are investigating.

​
Open the source report

1

Open Sources

Open Sources in Zeotap CDP to see the source listing.
2

Open the source

Click the source name to navigate to the source report screen.
3

Select the SOURCE REPORT tab

On the source details page, select the SOURCE REPORT tab. Expected result: the Data Ingestion Details panel opens, followed by the File Ingestion Details panel for batch sources that share data in files.

​
Panel 1: Data Ingestion Details

Data Ingestion Details panel showing record counts, a pie chart and the ingestion efficiency for a source.

Figure 1 — The Data Ingestion Details panel on the SOURCE REPORT tab.

The Data Ingestion Details panel displays the count for the source lifetime and provides the following information:
  • Total Records Received — the total records received, minus the total in-progress records.
  • Total Records In Progress — the count of records that are being ingested.
  • Total Records Ingested — the count of records that are ingested and available for activation.
  • Total Records Failed — the count of records that failed to ingest during ingestion.
  • Pie chart — a visual representation of the records received versus in progress, versus failed, versus ingested.
  • Ingestion Efficiency — the percentage of total records ingested versus total records received (for the ingested records). If the status is Failed, the ingestion efficiency is shown as NA.
  • Download Report — clicking Download Report downloads an image snapshot of the source report in .png format.

​
View Graph

View Graph is only visible for streaming sources where Zeotap fetches or collects data. It displays the trend graph of the data received and processed for the source, by status. You can view the graph for periods ranging from the last 7 to 90 days, or set a custom date range, and you can filter by status.
Trend graph of records received and processed for a streaming source over a selected date range.

Figure 2 — The trend graph of data received and processed for a streaming source, with the date-range and status filters.

Once a source is mapped, ingestion may take up to 15 minutes to begin. This delay accounts for processing the data collected between the time the source was integrated and when it was mapped. After the initial ingestion starts, all subsequent records are ingested in real time as they arrive.

​
Panel 2: File Ingestion Details

The File Ingestion Details panel provides information about the file name, the status of ingestion for both real-time and batch activations, the count of records ingested versus the total record count, the file size (for flat files), and logs related to the ingestion process. This panel is only visible for batch data sources where data is being shared in files.
File Ingestion Details panel listing files with their ingestion status, records ingested, size and type.

Figure 3 — The File Ingestion Details panel, one row per file shared with Zeotap CDP.

You can filter the file ingestion details for the last 7, 30 or 90 days, with 7 days as the default filter. The panel also provides details on the total number of files dropped and shows their status.
Date-range filter on the File Ingestion Details panel with the count of files dropped and their status.

Figure 4 — The date filter, and the count of files dropped with their status.

​
Columns in the File Ingestion Details panel

For batch sources, ingestion of each file begins within 15 minutes from the time the source is mapped and the file is successfully dropped.

​
Status indicators

The Status column carries three indicators: one for the file drop itself, one for real-time activation and one for batch activation. A file becomes ready for real-time activation first — that is an intermediate state before the file moves on to batch activation.
Status indicators for file drop and for real-time and batch activation ingestion.

Figure 5 — The status of file drop and ingestion, shown for both real-time and batch activation types.

​
Ingestion logs

View Logs provides a detailed view of the file ingestion and its status. It also displays a list of errors identified in case of failure. To match an error title to the change required in your source data, see Understanding the Ingestion Log Error.
Ingestion log view for a file, listing the ingestion status and the errors identified.

Figure 6 — The Ingestion Log opened from View Logs, showing when the file was dropped, when ingestion started, and the records ingested versus rejected.

​
Verify that a file was ingested

1

Open the SOURCE REPORT tab

Open the source and select the SOURCE REPORT tab.
2

Set the date filter to cover the file drop

In File Ingestion Details, set the filter to the last 7, 30 or 90 days so that it covers the day the file was dropped. The default filter is 7 days.
3

Find the file and read its status

Locate the row for the file by its name, then read the Status column against the status indicators. A fully ingested file shows ingestion complete for real-time activation and ingestion complete for batch activation.
4

Compare the record counts

Check Records Ingested against the total record count for the file. If records are missing, open View Logs for the row to see the errors identified.

​
Troubleshooting

  • The File Ingestion Details panel is not visible. The panel is only visible for batch data sources where data is being shared in files. A streaming source shows only the Data Ingestion Details panel.
  • View Graph is not available. The graph is only visible for streaming sources where Zeotap fetches or collects data.
  • Records are counted as failed. Open View Logs for the file to read the errors identified, then correct the source data using Understanding the Ingestion Log Error and re-ingest.

​
FAQ

Once a source is mapped, ingestion may take up to 15 minutes to begin, because the data collected between integration and mapping is processed first. After the initial ingestion starts, subsequent records are ingested in real time as they arrive. For batch sources, ingestion of each file begins within 15 minutes from the time the source is mapped and the file is successfully dropped.
Ingestion efficiency is the percentage of total records ingested versus total records received. When the status is Failed, the ingestion efficiency is shown as NA instead of a percentage.
The Status column reports ingestion separately for real-time activation and for batch activation. A file becomes ready for real-time activation first, which is an intermediate state before it moves on to batch activation, so a file can show ingestion complete for real-time activation while batch activation is still in progress.
Yes. Click Download Report on the Data Ingestion Details panel to download an image snapshot of the source report in .png format.

​
Next steps

Last modified on September 24, 2026