CLI companion tool to support dq-tools package and more
Project description
diqu [Experimental]
CLI companion tool supporting the Alert / Notification for and more.
Installation
pip install diqu [--upgrade]
📓 NOTE: The DWH module should get installed already if you use diqu
in a dbt project, if not, please perform additional step, for example, to install snowflake module:
pip install "snowflake-connector-python[pandas]"
pip install "snowflake-connector-python[secure-local-storage]"
Usage
dbt run -s dq_tools
diqu alert \
--project-dir /path/to/dbt/project \
--to slack --to jira
Sample logs
04:33:17 diqu: INFO - Run with diqu==1.0.0 🏃
04:33:19 diqu: INFO - Using dbt project at: /path/to/dbt/project
04:33:19 diqu: INFO - Using dbt profiles.yml at: ~/.dbt
04:33:19 diqu: INFO - Using snowflake connection
04:33:19 diqu: INFO - Looking for the query in: /path/to/site-packages/diqu/packages/include/dq_tools__get_test_results.sql
04:33:23 diqu: INFO - Alerting to: SLACK
04:33:23 diqu: INFO - ✅ Done > Slack
04:33:23 diqu: INFO - Alerting to: JIRA
04:33:23 diqu: INFO - ✅ Done > JIRA
In particular to the alert module, here are the additional configurations:
-
For SLACK, you need to use the environment variables to configure the Slack Channel:
export SLACK_TOKEN=your_token export SLACK_CHANNEL=your_channel_name diqu alert --to slack
-
For JIRA, you need to use the environment variables to configure the JIRA Board:
export JIRA_SERVER=your_jira_server e.g. https://your_value.atlassian.net/ export JIRA_AUTH_USER=your_service_account e.g. dqt_user@your_value.com export JIRA_AUTH_PASSWORD=your_service_token e.g. ATATTxxxxx export JIRA_PROJECT_ID=your_project_id e.g. 106413 export JIRA_ISSUE_TYPE=your_issue_type, default to "Bug" export JIRA_OPEN_ISSUES_FILTER_BY_SUMMARY=your_issue_filter_on_title, default to "dq-tools" export ISSUE_DEPRECATED_WINDOW_IN_DAYS=your_issue_deprecation_time_in_day, default to "3" export ISSUE_UPDATE_WINDOW_IN_DAYS=your_issue_historical_data_update_window_in_days, default to "14" diqu alert --to jira
How to Contribute
See CONTRIBUTING.md
About Infinite Lambda
Infinite Lambda is a cloud and data consultancy. We build strategies, help organisations implement them and pass on the expertise to look after the infrastructure.
We are an Elite Snowflake Partner, a Platinum dbt Partner and two-times Fivetran Innovation Partner of the Year for EMEA.
Naturally, we love exploring innovative solutions and sharing knowledge, so go ahead and:
🔧 Take a look around our Git
✏️ Browse our tech blog
We are also chatty, so:
#️⃣ Follow us on LinkedIn
👋🏼 Or just get in touch
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.