Global Flags
Usage
You can run any Spectacles command with any of the following global flags.
All of these flags can also be configured with a config file, but dashes should be converted to underscores. For example, --client-id abc
becomes client_id: abc
in the config file. Many flags can also be set with an environment variable.
Options
api-version
Usage: --api-version 4.0
The version of the Looker API that Spectacles should use. The default version is 3.1. Spectacles does not support any Looker API version lower than 3.1.
Environment Variable: LOOKER_API_VERSION
base-url
Required. Usage: --base-url https://analyzely.looker.com
The URL of your Looker instance, without any additional characters after the domain (.com). For example, https://company-name.looker.com. The URL must include the https:// prefix.
Environment Variable: LOOKER_BASE_URL
client-id
Required. Usage: --client-id 4x2vgxNvCD3RYDM05gna
The client ID (username) of the API key that Spectacles will use to authenticate.
Looker API keys have two components, a client ID and a client secret. These keys have a many-to-one relationship with Looker users. You can read more about API keys and how to generate them in the Looker documentation.
Environment Variable: LOOKER_CLIENT_ID
client-secret
Required. Usage: --client-secret KDDwdDMm8MXyrJNqXBchbdmY
The client secret (password) of the API key that Spectacles will use to authenticate.
Looker API keys have two components, a client ID and a client secret. These keys have a many-to-one relationship with Looker users. You can read more about API keys and how to generate them in the Looker documentation.
Environment Variable: LOOKER_CLIENT_SECRET
config-file
Usage: --config-file config.yaml
A path to a YAML config file that holds additional configuration parameters. For example:
do-not-track
Usage: --do-not-track
By default, Spectacles creates an anonymous hash to identify validations and logs it with our event tracking provider. We use this data to understand how many different companies are using Spectacles and which validators are most popular.
Providing this flag will prevent Spectacles from firing a tracking request to our event tracking provider on runs. You can review the tracking code on GitHub here. Please submit an issue if you have any questions or concerns!
Environment Variable: SPECTACLES_DO_NOT_TRACK
log-dir
Usage: --log-dir spectacles-logs
A path to an alternate directory to log to. By default, Spectacles creates a directory called logs
in the working directory to save failed SQL queries and debug-level text logs.
Environment Variable: SPECTACLES_LOG_DIR
port
Usage: --port 8080
The port of your Looker instance's API. By default, Looker sets this as 19999, which is also the default for Spectacles. Most instances don't have a different port, unless it has been explictly configured by a Looker admin in the API Admin Settings.
Environment Variable: LOOKER_PORT
verbose
Usage: --verbose
Display extra logging at the debug level during Spectacles execution. This is helpful for debugging or submitting a bug report.
Spectacles logs to file at the debug level, regardless of whether or not this option is set.