Agent Types

Overview of all Bigeye agent types managed by the Agent CLI

The Agent CLI manages six agent types, each serving a different purpose in the Bigeye platform. Agents are either long-running services or on-demand processes.

Long-Running Services

These agents run continuously as Docker containers and are managed with start and stop commands.

  • Data Source Agent — Connects to your data warehouses (Snowflake, BigQuery, Databricks, etc.) and collects metadata for monitoring in Bigeye.
  • SDS Agent — Scans data sources for sensitive data such as PII. Runs as two interconnected containers (Java + Python).
  • Cross-Source Agent — Compares data across multiple sources for consistency validation.

On-Demand Agents

These agents run as short-lived containers that execute a task and exit.

  • Lineage Plus Agent — Collects lineage metadata from databases, BI tools, and ETL platforms. Supports email notifications, log retention, and scheduled runs via jobs.
  • DataHealth Agent — Collects data quality information and summarizes it in data catalog integrations (i.e. Alation).
  • External Monitors Agent — Integrates with external monitoring tools like dbt tests. Can create monitors, submit results, or both.

Common Commands

All agent types share these commands:

CommandDescription
configure [--overwrite]Update agent-specific configuration
upgradePull the latest Docker image for the agent
logsView agent container logs
share-diagnostics [-m MESSAGE]Upload logs to Bigeye for troubleshooting