Skip to main content

Bigeye CLI offers developer tools for maintaining your developer workspace.

Project description

Bigeye CLI

Version: 0.3.27

Installation

Setting up your local/build environment

Mac with Pyenv

  1. Install brew
  2. Install pyenv
  3. Install python and define a default global:
pyenv install 3.8.10
pyenv global 3.8.10

Conda

  1. Install conda
  2. Create environment with python3.8
conda create -n bigeye_env python=3.8
conda activate bigeye_env

Linux

Most linux distributes include a default python distribution and we recommend using that default.

Installing bigeye

You can install the Bigeye CLI from your command line with the following command:

pip3 install bigeye-cli

Credential

Run the following command to get logged into your Bigeye workspace from the CLI:

bigeye credential

There are two ways to authenticate: basic authentication and browser authentication.

Basic Authentication

If you select basic authentication, the CLI will prompt you to enter your Bigeye username and password. This will create a default credential file at ~/.bigeye/default_cred.json. This credential will be used for all CLI commands calls unless an environment variable is explicitly provided.

base_url: "https://app.bigeye.com",
user: "some_user+some_company@bigeye.com",
password: "fakepassword1234"

You can create an environment variable for your workspace credential file, this is helpful if you are managing multiple workspaces and need to flip between them. Add the following to your ~/.bashrc or ~/.zshrc file:

export BIGEYE_API_CRED_FILE=/some/path/to/bigeye_cred_file.json

Lastly, if you want to specify the credential per command, you can always pass a -b parameter with the file path for the desired credential.

Browser Authentication

Alternatively, you can use browser authentication. Login to your bigeye workspace on a Chrome, Chromium or Firefox browser. Run bigeye credential and select browser_auth when prompted in the CLI and follow the instructions. If you use Chrome profiles, make sure to specify the profile email address you are logged into.

Note: your authentication will only be valid so long as your browser session is active.

Basic Usage

$ bigeye --help

Tab/Auto Completion

Bigeye supports tab/auto completion for many different shells. For example, run:

$ bigeye --install-completion zsh

ZSH Completion

Verify that the following has been added to your shell rc file:

autoload -Uz compinit
zstyle :completion:* menu select
fpath+=~/.zfunc

If you are having trouble with auto complete then add the following below the 3 lines above.

compinit

CLI Documentation

bigeye workspace

Workspace Commands for Bigeye CLI

Usage:

$ bigeye workspace [OPTIONS] COMMAND [ARGS]...

Options:

  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.

Commands:

  • schedule-all-metrics: Schedule all metrics in a workspace.
  • unschedule-all-metrics

bigeye workspace schedule-all-metrics

Schedule all metrics in a workspace.

Usage:

$ bigeye workspace schedule-all-metrics [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -type, --time_interval_type INTEGER: Time interval type. UNDEFINED_TIME_INTERVAL_TYPE:0 HOURS_TIME_INTERVAL_TYPE:1 MINUTES_TIME_INTERVAL_TYPE:2 SECONDS_TIME_INTERVAL_TYPE:3 DAYS_TIME_INTERVAL_TYPE:4 WEEKDAYS_TIME_INTERVAL_TYPE:5 MARKET_DAYS_TIME_INTERVAL_TYPE:6 [default: 1]
  • -value, --interval_value INTEGER: Number of intervals to set on all metric schedules. If 0 use unschedule all metrics. [required]
  • --help: Show this message and exit.

bigeye workspace unschedule-all-metrics

Usage:

$ bigeye workspace unschedule-all-metrics [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • --help: Show this message and exit.

bigeye bigconfig

Bigconfig Commands for Bigeye CLI

Usage:

$ bigeye bigconfig [OPTIONS] COMMAND [ARGS]...

Options:

  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.

Commands:

  • apply: Applies a purge of deployed metrics or...
  • plan: Executes a plan for purging sources or...

bigeye bigconfig apply

Applies a purge of deployed metrics or applies Bigconfig files from the input path/current working directory to the Bigeye workspace.

Usage:

$ bigeye bigconfig apply [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -ip, --input_path TEXT: (Optional) Input path containing Bigconfig files. If no input path is defined then currentworking directory will be used. [default: /Users/andrew/repos/semantic-data-platform/bigeye-integrations/bigeye-cli]
  • -op, --output_path TEXT: (Optional) Output path where reports and fixme files will be saved. If no output path is defined then current working directory will be used. [default: /Users/andrew/repos/semantic-data-platform/bigeye-integrations/bigeye-cli]
  • -psn, --purge_source_name TEXT: List of source names to purge E.g. -psn source_1 -psn source_2.
  • -purge_all, --purge_all_sources: Purge all sources: True or False. [default: False]
  • --help: Show this message and exit.

bigeye bigconfig plan

Executes a plan for purging sources or processing bigconfig files in the input path/current working directory.

Usage:

$ bigeye bigconfig plan [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -ip, --input_path TEXT: (Optional) Input path containing Bigconfig files. If no input path is defined then currentworking directory will be used. [default: /Users/andrew/repos/semantic-data-platform/bigeye-integrations/bigeye-cli]
  • -op, --output_path TEXT: (Optional) Output path where reports and fixme files will be saved. If no output path is defined then current working directory will be used. [default: /Users/andrew/repos/semantic-data-platform/bigeye-integrations/bigeye-cli]
  • -psn, --purge_source_name TEXT: List of source names to purge E.g. -psn source_1 -psn source_2.
  • -purge_all, --purge_all_sources: Purge all sources: True or False. [default: False]
  • --help: Show this message and exit.

bigeye catalog

Catalog Commands for Bigeye CLI

Usage:

$ bigeye catalog [OPTIONS] COMMAND [ARGS]...

Options:

  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.

Commands:

  • add-source: Adds a source to specified Bigeye workspace.
  • backfill-autothresholds: Backfills autothresholds by warehouse id,...
  • backfill-metrics: Backfills metrics by warehouse id, schema...
  • delete-metrics: Delete metrics in a warehouse id, by schema...
  • delete-source: Delete a source from specified Bigeye...
  • deploy-all-autometrics: Deploys all Autometrics to specified...
  • get-metric-info: Outputs metric info to a file.
  • get-metric-queries: Gets the debug queries for all metrics by...
  • get-table-info: Outputs table info to a file for an entire...
  • rebuild: Rebuilds/Reprofiles a source by warehouse id...
  • regen-autometrics: Regenerates Autometrics by warehouse id OR...
  • run-metrics: Runs metrics by warehouse id, schema names,...
  • schedule-all-metrics: Updates schedule for all metrics in a...
  • set-metric-time: Sets metric times from a list of possible...
  • unschedule-all-metrics: Unschedule all metrics by warehouse, schema...
  • unset-metric-time: Unsets metric times for whole warehouse or...

bigeye catalog add-source

Adds a source to specified Bigeye workspace. Supports either source configs stored in AWS Secrets manager OR locally in file.

Usage:

$ bigeye catalog add-source [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -sn, --secret_name TEXT: The name of the secret to retrieve from AWS Secrets Manager
  • -srn, --secret_region_name TEXT: AWS Secret Manager Region Name [default: us-west-2]
  • -sccf, --source_catalog_config_file TEXT: The file containing the necessary parameters for adding a source to Bigeye.
  • --help: Show this message and exit.

bigeye catalog backfill-autothresholds

Backfills autothresholds by warehouse id, schema names, and/or table ids.

Usage:

$ bigeye catalog backfill-autothresholds [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID
  • -sn, --schema_name TEXT: List of Schema Names. E.g. -sn schema_1 -sn schema_2.
  • -tid, --table_id INTEGER: Table IDs. E.g. -tid 123 -tid 124
  • --help: Show this message and exit.

bigeye catalog backfill-metrics

Backfills metrics by warehouse id, schema names, and/or table ids.

Usage:

$ bigeye catalog backfill-metrics [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID
  • -sn, --schema_name TEXT: List of Schema Names. E.g. -sn schema_1 -sn schema_2.
  • -tid, --table_id INTEGER: Table IDs. E.g. -tid 123 -tid 124
  • --delete_history: Delete metric run history
  • --help: Show this message and exit.

bigeye catalog delete-metrics

Delete metrics in a warehouse id, by schema names, or by table_ids. Also, can filter by multipe metric types.

Usage:

$ bigeye catalog delete-metrics [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID
  • -sn, --schema_name TEXT: List of Schema Names. E.g. -sn schema_1 -sn schema_2.
  • -tid, --table_id INTEGER: Table IDs. E.g. -tid 123 -tid 124
  • -m, --metric_type TEXT: Delete by name of the metric type.UNDEFINED_PREDEFINED_METRIC_NAME, PERCENT_NULL, COUNT_NULL, PERCENT_EMPTY_STRING, COUNT_EMPTY_STRING, PERCENT_UNIQUE, PERCENT_VALUE_IN_LIST, AVERAGE, MIN, MAX, SUM, COUNT_ROWS, COUNT_DISTINCT, HOURS_SINCE_MAX_DATE, HOURS_SINCE_MAX_TIMESTAMP, COUNT_TRUE, PERCENT_TRUE, COUNT_FALSE, PERCENT_FALSE, COUNT_USA_PHONE, PERCENT_USA_PHONE, COUNT_USA_ZIP_CODE, PERCENT_USA_ZIP_CODE, PERCENT_UUID, COUNT_TIMESTAMP_STRING, PERCENT_TIMESTAMP_STRING, COUNT_DUPLICATES, COUNT_USA_STATE_CODE, PERCENT_USA_STATE_CODE, VARIANCE, SKEW, KURTOSIS, GEOMETRIC_MEAN, HARMONIC_MEAN, COUNT_UUID, COUNT_CUSIP, PERCENT_CUSIP, COUNT_SEDOL, PERCENT_SEDOL, COUNT_ISIN, PERCENT_ISIN, COUNT_LEI, PERCENT_LEI, COUNT_FIGI, PERCENT_FIGI, COUNT_PERM_ID, PERCENT_PERM_ID, COUNT_NAN, PERCENT_NAN, COUNT_LONGITUDE, PERCENT_LONGITUDE, COUNT_LATITUDE, PERCENT_LATITUDE, COUNT_NOT_IN_FUTURE, PERCENT_NOT_IN_FUTURE, COUNT_DATE_NOT_IN_FUTURE, PERCENT_DATE_NOT_IN_FUTURE, MEDIAN, PERCENTILE, COUNT_NOT_NULL, STRING_LENGTH_AVERAGE, STRING_LENGTH_MIN, STRING_LENGTH_MAX, COUNT_SSN, PERCENT_SSN, COUNT_EMAIL, PERCENT_EMAIL, ROWS_INSERTED, HOURS_SINCE_LAST_LOAD, COUNT_READ_QUERIES, PERCENT_NOT_NULL, FRESHNESS, VOLUME
  • --help: Show this message and exit.

bigeye catalog delete-source

Delete a source from specified Bigeye workspace.

Usage:

$ bigeye catalog delete-source [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: The ID of the warehouse to delete.
  • --help: Show this message and exit.

bigeye catalog deploy-all-autometrics

Deploys all Autometrics to specified warehouse OR warehouse and list of schema names OR warehouse and list of table ids.

Usage:

$ bigeye catalog deploy-all-autometrics [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Deploy autometrics to all tables in warehouse.
  • -sn, --schema_name TEXT: List of Schema Names. E.g. -sn schema_1 -sn schema_2.
  • -tid, --table_id INTEGER: Table IDs. E.g. -tid 123 -tid 124
  • -lbd, --lookback_days INTEGER: Look back days for the metrics. [default: 7]
  • --ops_only: Deploy only operational metrics [default: True]
  • --help: Show this message and exit.

bigeye catalog get-metric-info

Outputs metric info to a file. Includes metric configuration and details about recent runs.

Usage:

$ bigeye catalog get-metric-info [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID
  • -sn, --schema_name TEXT: List of Schema Names. E.g. -sn schema_1 -sn schema_2.
  • -tid, --table_id INTEGER: Table IDs. E.g. -tid 123 -tid 124or schema names.
  • -ms, --metric_status [HEALTHY|ALERTING|UNKNOWN]: Used to query metric of particular status.
  • -op, --output_path TEXT: File to write the failed metric configurations to. [required]
  • --conf_only: Output only the metric configuration. [default: False]
  • --help: Show this message and exit.

bigeye catalog get-metric-queries

Gets the debug queries for all metrics by warehouse id, schema names, or table ids.

Usage:

$ bigeye catalog get-metric-queries [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID
  • -sn, --schema_name TEXT: List of Schema Names. E.g. -sn schema_1 -sn schema_2.
  • -tid, --table_id INTEGER: Table IDs. E.g. -tid 123 -tid 124
  • -op, --output_path TEXT: File to write the failed metric configurations to. [required]
  • --help: Show this message and exit.

bigeye catalog get-table-info

Outputs table info to a file for an entire warehouse, certain schemas, or certain tables.

Usage:

$ bigeye catalog get-table-info [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID
  • -sn, --schema_name TEXT: List of Schema Names. E.g. -sn schema_1 -sn schema_2.
  • -tid, --table_id INTEGER: Table IDs. E.g. -tid 123 -tid 124
  • -tn, --table_name TEXT: Table Namess. E.g. -tn some_table -tn some_other_table
  • -op, --output_path TEXT: File to write the failed metric configurations to. [required]
  • --help: Show this message and exit.

bigeye catalog rebuild

Rebuilds/Reprofiles a source by warehouse id or a schema by warehouse id and schema name.

Usage:

$ bigeye catalog rebuild [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID [required]
  • -sn, --schema_name TEXT: Schema Name
  • --help: Show this message and exit.

bigeye catalog regen-autometrics

Regenerates Autometrics by warehouse id OR warehouse id and list of schema names OR list of table ids.

Usage:

$ bigeye catalog regen-autometrics [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID. If none will look for Table IDs. If value then will pull all table ids for warehouse
  • -sn, --schema_name TEXT: List of Schema Names E.g. -sn schema_1 -sn schema_2. Do not include warehouse name -- GREENE_HOMES_DEMO_STANDARD.CONFORMED is fully qualified and CONFORMED is the schema name.
  • -tid, --table_id INTEGER: List of Table IDs. E.g. -tid 123 -tid 124
  • --help: Show this message and exit.

bigeye catalog run-metrics

Runs metrics by warehouse id, schema names, and/or table ids

Usage:

$ bigeye catalog run-metrics [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID
  • -sn, --schema_name TEXT: List of Schema Names. E.g. -sn schema_1 -sn schema_2.
  • -tid, --table_id INTEGER: Table IDs. E.g. -tid 123 -tid 124
  • --help: Show this message and exit.

bigeye catalog schedule-all-metrics

Updates schedule for all metrics in a warehouse.

Usage:

$ bigeye catalog schedule-all-metrics [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID
  • -type, --time_interval_type INTEGER: Time interval type. UNDEFINED_TIME_INTERVAL_TYPE:0 HOURS_TIME_INTERVAL_TYPE:1 MINUTES_TIME_INTERVAL_TYPE:2 SECONDS_TIME_INTERVAL_TYPE:3 DAYS_TIME_INTERVAL_TYPE:4 WEEKDAYS_TIME_INTERVAL_TYPE:5 MARKET_DAYS_TIME_INTERVAL_TYPE:6 [default: 1]
  • -value, --interval_value INTEGER: Number of intervals to set on all metric schedules. If 0 use unschedule all metrics. [required]
  • --help: Show this message and exit.

bigeye catalog set-metric-time

Sets metric times from a list of possible metric column names. Can set for whole warehouse or for a list of table IDs.

Usage:

$ bigeye catalog set-metric-time [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID
  • -sid, --schema_id INTEGER: Schema ID
  • -tid, --table_id INTEGER: List of table IDs.
  • -cn, --metric_column_name TEXT: Possible metric column names.. [required]
  • -r, --replace: replace metric times if already present on tables? Default is false. [default: False]
  • --help: Show this message and exit.

bigeye catalog unschedule-all-metrics

Unschedule all metrics by warehouse, schema or tables.

Usage:

$ bigeye catalog unschedule-all-metrics [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID
  • -sn, --schema_name TEXT: List of Schema Name. E.g. -sn schema_1.
  • -tid, --table_id INTEGER: Table IDs. E.g. -tid 123 -tid 124
  • --help: Show this message and exit.

bigeye catalog unset-metric-time

Unsets metric times for whole warehouse or for a list og table IDs.

Usage:

$ bigeye catalog unset-metric-time [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse ID
  • -tid, --table_id INTEGER: List of table IDs.
  • --help: Show this message and exit.

bigeye metric

Metric Commands for Bigeye CLI

Usage:

$ bigeye metric [OPTIONS] COMMAND [ARGS]...

Options:

  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.

Commands:

  • get-info: Outputs metric info to a file.
  • get-metric-queries: Gets the debug queries for all metrics by...
  • run: Run metric by id(s)
  • upsert: Upsert single metric from file.
  • upsert-from-path: Upsert multiple metrics from files stored in...

bigeye metric get-info

Outputs metric info to a file. Includes metric configuration and details about recent runs.

Usage:

$ bigeye metric get-info [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -mid, --metric_id INTEGER: Metric Ids. [required]
  • -ms, --metric_status [HEALTHY|ALERTING|UNKNOWN]: Used to query metric of particular status.
  • -op, --output_path TEXT: File to write the failed metric configurations to. [required]
  • --conf_only: Output only the metric configuration. [default: False]
  • --help: Show this message and exit.

bigeye metric get-metric-queries

Gets the debug queries for all metrics by warehouse id, schema names, or table ids.

Usage:

$ bigeye metric get-metric-queries [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -mid, --metric_id INTEGER: Metric Ids. [required]
  • -op, --output_path TEXT: File to write the failed metric configurations to. [required]
  • --help: Show this message and exit.

bigeye metric run

Run metric by id(s)

Usage:

$ bigeye metric run [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -mid, --metric_id INTEGER: Metric Ids. [required]
  • --help: Show this message and exit.

bigeye metric upsert

Upsert single metric from file.

Usage:

$ bigeye metric upsert [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -f, --file TEXT: File containing SimpleUpsedrtMetricRequest or MetricConfiguration [required]
  • -t, --file_type [SIMPLE|FULL]: Metric File Type. Simple conforms to SimpleUpsertMetricRequest and Full conforms to MetricConfiguration [required]
  • -wid, --warehouse_id INTEGER: (Optional) Warehouse ID. If specified it will reduce the text based search for the table.warehouse
  • -mid, --metric_id INTEGER: (Optional) Metric Id. If specified it will reduce the text based search for existing metric.
  • --help: Show this message and exit.

bigeye metric upsert-from-path

Upsert multiple metrics from files stored in path.

Usage:

$ bigeye metric upsert-from-path [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -twid, --target_warehouse_id INTEGER: Deploy Metrics to target Warehouse ID. [required]
  • -sp, --source_path TEXT: Source path file containing the metrics to migrate. [required]
  • --help: Show this message and exit.

bigeye issue

Issues Commands for Bigeye CLI

Usage:

$ bigeye issue [OPTIONS] COMMAND [ARGS]...

Options:

  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.

Commands:

  • get-issues: Gets issues and writes info to files.
  • update-issue: Updates an issue in Bigeye and returns the...

bigeye issue get-issues

Gets issues and writes info to files.

Usage:

$ bigeye issue get-issues [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -wid, --warehouse_id INTEGER: Warehouse IDs.
  • -sn, --schema_name TEXT: Schema names
  • -mid, --metric_id INTEGER: Metric IDs.
  • -sla, --sla_id INTEGER: SLA IDs
  • -iid, --issue_id INTEGER: Issue IDs
  • -op, --output_path TEXT: File to write the failed metric configurations to. [required]
  • --help: Show this message and exit.

bigeye issue update-issue

Updates an issue in Bigeye and returns the Issue object from the protobuff.

Usage:

$ bigeye issue update-issue [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -iid, --issue_id INTEGER: Issue ID [required]
  • -status, --issue_status TEXT: The status update. Options are ACKNOWLEDGED or CLOSED.
  • -by, --updated_by TEXT: The user providing the update.
  • -m, --message TEXT: The message to attach to the issue.
  • -cl, --closing_label TEXT: Used to train Bigeye when closing an issue. Options are TRUE_POSITIVE, FALSE_POSITIVE, EXPECTED.
  • --help: Show this message and exit.

bigeye deltas

Deltas Commands for Bigeye CLI

Usage:

$ bigeye deltas [OPTIONS] COMMAND [ARGS]...

Options:

  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.

Commands:

  • cicd: Creates a delta based on...
  • create-delta: Creates deltas between tables from a Simple...
  • run-delta: Runs a delta by Delta ID.
  • suggest-deltas: Suggests and creates Deltas with default...

bigeye deltas cicd

Creates a delta based on SimpleDeltaConfiguration and integrates the results with the provided VCS vendor.

Usage:

$ bigeye deltas cicd [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration as a base64 encoded string [required]
  • -dcc, --delta_cicd_config TEXT: The yaml file containing the parameters for the DeltaCICDConfig class [required]
  • --help: Show this message and exit.

bigeye deltas create-delta

Creates deltas between tables from a Simple Delta configuration file that contains multile delta configurations. Enforces 1:1 column comparisons by case-insensitive column names if no column mappings are declared in configuration.

Usage:

$ bigeye deltas create-delta [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -dc, --delta_conf TEXT: Simple Delta configuration file. [required]
  • --help: Show this message and exit.

bigeye deltas run-delta

Runs a delta by Delta ID.

Usage:

$ bigeye deltas run-delta [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -did, --delta_id INTEGER: Id of delta. [required]
  • --help: Show this message and exit.

bigeye deltas suggest-deltas

Suggests and creates Deltas with default behavior and outputs all Simple Delta Configurations to a file.

Usage:

$ bigeye deltas suggest-deltas [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -swid, --source_warehouse_id INTEGER: Source Warehouse ID
  • -twid, --target_warehouse_id INTEGER: Source Warehouse ID
  • -swn, --source_warehouse_name TEXT: Source Warehouse Name
  • -twn, --target_warehouse_name TEXT: Source Warehouse Name
  • -snp, --schema_name_pair TEXT: Fully qualified schema name pairs. e.g. -snp source_schema_1:target_schema_1 -snp source_warehouse.source_schema:target_warehouse.target_schema
  • -op, --output_path TEXT: File to write the failed metric configurations to. [required]
  • --help: Show this message and exit.

bigeye sla

SLA Commands for Bigeye CLI

Usage:

$ bigeye sla [OPTIONS] COMMAND [ARGS]...

Options:

  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.

Commands:

  • add-metric: Add metric to an SLA.
  • backfill-metrics: Backfill all metrics in an SLA.
  • get-metric-info: Get metric info for all metrics in SLA.
  • get-metric-queries: Gets the debug queries for all metrics by...
  • migrate-from-json: Loads metrics from SLA oriented metric info...
  • run-metrics: Run all metrics in an SLA.

bigeye sla add-metric

Add metric to an SLA.

Usage:

$ bigeye sla add-metric [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -mid, --metric_id INTEGER: Metric ID [required]
  • -sid, --sla_id INTEGER: SLA ID [required]
  • --help: Show this message and exit.

bigeye sla backfill-metrics

Backfill all metrics in an SLA.

Usage:

$ bigeye sla backfill-metrics [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • --from_slas: Scrapes all SLAs in customer workspace for Metric Info. [default: False]
  • --sla_ids INTEGER: SLA IDs. Scrape certain SLAs for Metric Info.
  • --delete_history: Delete metric run history
  • --help: Show this message and exit.

bigeye sla get-metric-info

Get metric info for all metrics in SLA.

Usage:

$ bigeye sla get-metric-info [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • --from_slas: Scrapes all SLAs in customer workspace for Metric Info. [default: False]
  • --sla_ids INTEGER: SLA IDs. Scrape certain SLAs for Metric Info.
  • -op, --output_path TEXT: File to write the failed metric configurations to. [required]
  • --help: Show this message and exit.

bigeye sla get-metric-queries

Gets the debug queries for all metrics by warehouse id, schema names, or table ids.

Usage:

$ bigeye sla get-metric-queries [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -sid, --sla_id INTEGER: SLA ID [required]
  • -op, --output_path TEXT: File to write the failed metric configurations to. [required]
  • --help: Show this message and exit.

bigeye sla migrate-from-json

Loads metrics from SLA oriented metric info output. Used to migrate metrics from one warehouse to another, identical, warehouse

Usage:

$ bigeye sla migrate-from-json [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -twid, --target_warehouse_id INTEGER: Deploy Metrics to target Warehouse ID. [required]
  • -ip, --input_path TEXT: Path to read from. [required]
  • -kn, --keep_notifications: Keep Notifications from versioned or templated metric configuration. [default: False]
  • -kid, --keep_ids: Keep Metric and SLA IDs from versioned or templated metric configuration. If kept this would update existing metrics and slas. If not kept it would create new. [default: False]
  • --help: Show this message and exit.

bigeye sla run-metrics

Run all metrics in an SLA.

Usage:

$ bigeye sla run-metrics [OPTIONS]

Options:

  • -b, --bigeye_conf TEXT: Bigeye Basic Auth Configuration File
  • -sid, --sla_id INTEGER: SLA ID [required]
  • --help: Show this message and exit.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bigeye_cli-0.3.27.tar.gz (33.1 kB view hashes)

Uploaded Source

Built Distribution

bigeye_cli-0.3.27-py3-none-any.whl (38.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page