Data Source Agent

The Data Source agent connects to your data warehouses and collects metadata for monitoring in Bigeye. It runs as a long-lived Docker container that continuously communicates with the Bigeye platform.

Installation

# Run the installer and select SOURCE
./bigeye-agent install

After installation, add your database connectors:

./bigeye-agent add-connector -c snowflake

Commands

Start the Agent

./bigeye-agent source start

Starts the Data Source agent container. The agent runs continuously in the background, connecting to your configured data sources and reporting metadata to Bigeye.

Stop the Agent

./bigeye-agent source stop

Stops the running Data Source agent container.

View Logs

./bigeye-agent source logs

Prints the logs from the Data Source agent container to your console.

Update Configuration

# Re-enter configuration details
./bigeye-agent source configure

# Overwrite existing configuration with fresh values
./bigeye-agent source configure --overwrite

Option	Description
`--overwrite`, `-o`	Prompt for new configuration details even if configuration already exists (default: `false`)

Upgrade

./bigeye-agent source upgrade

Updates the Data Source agent to the latest Docker image version.

Share Diagnostics

# Share logs with Bigeye support
./bigeye-agent source share-diagnostics

# Include a message for context
./bigeye-agent source share-diagnostics -m "Agent failing to connect to Snowflake"

Uploads diagnostic information (logs) to Bigeye for troubleshooting assistance.

Option	Description
`--message`, `-m`	Message to include with the diagnostics for context

Infrastructure Requirements

8 GB RAM (e.g., AWS t3.xlarge, GCP e2-standard-4, Azure B4/D4)
4 CPU
25 GB disk space on /var