Skip to main content
Import a log file when you want a quick look at recent AI agent traffic, or to fill the days before a live connector was set up. The file is read during the upload and then discarded: it’s never stored.
Only requests from the last seven days are kept. Older rows are dropped as timestamp_out_of_range. File import is for diagnostics and short backfills, not for loading history.

Limits

Upload the plain, uncompressed text file.

Upload a file

1

Create an import source

In Agent Analytics, select Connect source, choose Log file import and select Generate credentials. The upload area appears in the same step.
2

Choose the file

Select a .csv, .log, .txt, .ndjson or .jsonl file and select Import.
3

Read the receipt

The import runs in the background. Select Refresh to update its status (queued, running, done or failed). When it’s done, the receipt shows rows read, agent events accepted, duplicates and rows dropped.
Imported events are labelled as file imports, so they never affect the health of your live sources.

Formats

The format is detected from the file name and its first line.

CSV

A header row is required. Column names are matched case-insensitively against these aliases; other columns are ignored, so an export with extra columns is safe to upload. Rows without a host use the source’s domain.

Common and Combined Log Format

Standard Apache and Nginx access logs. CLF has no host, so every line is attributed to the source’s domain, and no duration or cache status is available. Use the Combined format: plain Common Log Format has no user agent, so no line can be recognized as an AI agent.

NDJSON

One JSON object per line (or a single JSON array), with the fields of the Custom HTTP connector.

Duplicates

Uploading the same file to the same source again is refused with “This file was already imported for this source”. A file whose import failed can be uploaded again.

Next steps

Choose a live connector

Keep data flowing after the backfill.

Custom HTTP

Stream records from your own pipeline.
Last modified on November 18, 2026