Alation
Bigeye integrates with Alation via the Bigeye Data Health Agent.
Version requirement
Required Alation API Version: greater than 2022.3
How it works
The Health tab will contain a list of Bigeye Metrics (rules) each with an associated column name (object name), status, the current observed value for the metric, description of the metric, and last updated timestamp. Users can click on the Rule link to access the metric in Bigeye, where they can get additional detail about an alert and review issues that have been raised for an alert. They can also click on the object name to access the Alation Column page and see the status for each.
Source Configuration
In order to identify the appropriate tables in Alation, users will need to add the data source ID from Alation to the corresponding source in Bigeye. To do so, a user with the Admin or Owner role must select Enable Alation Integration under Settings > Advanced Settings > Integrations in Bigeye.
Customer Credential
Each customer needs to provide the authentication detail for both Bigeye and their external catalog. Follow the below credential format for Alation.
Multiple workspaces
An additional parameter called bigeye_workspace_id needs to be added to the credential below when multiple workspaces are in place. See below on where to find it. In addition, the customer will need a separate credential per workspace. Although not required, if each credential has its own unique Alation refresh token, then the integration can update the token automatically when it is close to expiration.
API Key support
When using an API key for Bigeye authentication, the parameter bigeye_workspace_id MUST be configured as part of the credential.
{
"alation_user_id": 1234,
"alation_refresh_token": "1234sometoken1234",
"alation_base_url": "https://myorg.alation.com",
"bigeye_username": "[email protected]",
"bigeye_password": "myserviceaccountpasswordisfake",
"bigeye_base_url": "https://app.bigeye.com",
"bigeye_api_key": "bigeye_apk_somekey",
}
NOTE: When using an API key for Bigeye, you do not need the parameters bigeye_username or bigeye_password.
Sourcing Credential Details
- Basic auth credential for Bigeye.
- Bigeye URL
- https://app.bigeye.com by default OR the customerโs vanity URL.
- Bigeye Service Account User ID
- Bigeye user IDs are email addresses
- Bigeye Service Account Password
- ********For Bigeye SSO:********
- Go to
https://<customer base URL>/request-password-reset?email=<email>
- Set password
- Go to
- ********For Bigeye SSO:********
- Bigeye Workspace ID
- Found in Bigeye URL. e.g. https://app.bigeye.com/w/<bigeye_workspace_ID>
- Bigeye URL
- API credential for external catalog.
- Alation
- Alation Base URL
- https://CUSTOMER.alationcatalog.com for cloud SaaS OR the customerโs vanity URL.
- Alation User ID (Minimum role of Source Admin)
- Find this in the URL for the
User Profile
https://<<customer>>.alationcatalog.com/user/1234/
1234 is the user ID
- Find this in the URL for the
- Alation Refresh Token
- Create a refresh token under the
Account Settings :: Authorization
menu. Ensure you are creating a refresh token and not an API token.
- Create a refresh token under the
Optional Features
Bigeye can surface additional information in Alation such as Virtual Tables and data quality summaries at the data source and schema levels of the catalog. For more information on how to enable these and what they look like, contact Bigeye.
Updated about 2 months ago