artifactable

artifactable is a notification service for your dbt project. You can subscribe to alerts for just the models you want to track by simply tagging your dbt models.

{{
  config(
    tags=[
        'notify:analytics_eng@acme.com',
        'notify:tom@acme.com'
    ]
  )
}}

You can also configure alerts for a collection of models from your dbt_project.yml file.

models:
  acme:
    core:
      +tags:
        - notify:analytics_eng@acme.com
        - notify:slas@acme.com
    marketing:
      +tags:
        - notify:marketing_analysts@acme.com

Quickstart

Install with pip.

pip install artifactable

Register an account.

artifactable register

Then run or test your dbt project or tests as you normally would, and upload your results to the artifactable service to send alerts about any build or test failures.

# Run your models or tests
dbt run

# Upload your results to send notifications
artifactable push

Running from a CI suite

To send alerts via a CI process, you'll need to set an environment variable ARTIFACTABLE_TOKEN that contains a token used to authenticate with our messaging service.

To find this token, log in to your account with your email and password.

artifactable login

Then view the credential details stored in the ~/.artifactable folder.

cat ~/.artifactable/user.json

You should see a field called token, which contains the token you need.

{
  "data": {
    "id": "1",
    "type": "users",
    "attributes": {
      "email": "tom@acme.com",
      
      // This one!
      "token": "94ac5c4e-7ebe-4857-9f8a-c112266b9151",
      "created-at": "2021-07-10T08:50:12.527Z",
      "confirmed-at": null
    }
  }
}

Then set that token in your environment. Note that the token will take priority over any value stored in ~/.artifactable.

export ARTIFACTABLE_TOKEN=94ac5c4e-7ebe-4857-9f8a-c112266b9151

You can now send alerts via the artifactable command without having to manually log in.

dbt test && artifactable push

Reference

Please use the --help command for a full list of options.

artifactable --help