twenty/packages/twenty-tinybird/README.md
Ana Sofia Marin Alexandre f06cdbdfc6
refactor webhookAnalytics call and enrich analytics module (#8253)
**TLDR**

Refactor WebhoonAnalytics Graph to a more abstract version
AnalyticsGraph (in analytics module). Thus enabling the components to be
used on different instances (ex: new endpoint, new kind of graph).

**In order to test:**

1. Set ANALYTICS_ENABLED to true
2. Set TINYBIRD_JWT_TOKEN to the ADMIN token from the workspace
twenty_analytics_playground
3. Set TINYBIRD_JWT_TOKEN to the datasource or your admin token from the
workspace twenty_analytics_playground
4. Create a Webhook in twenty and set wich events it needs to track
5. Run twenty-worker in order to make the webhooks work.
6. Do your tasks in order to populate the data
7. Enter to settings> webhook>your webhook and the statistics section
should be displayed.

---------

Co-authored-by: Félix Malfait <felix@twenty.com>
2024-11-08 10:00:51 +01:00

1.7 KiB

How to use

Create a virtual enviroment and install tinybird

python3 -m venv .venv
source .venv/bin/activate
pip install tinybird-cli

Authenticate using your admin token from your workspace (twenty_analytics_cli_playground)

tb auth -i

** List of available regions:
[1] us-east4 (gcp) (https://app.us-east.tinybird.co)
[2] europe-west3 (gcp) (https://app.tinybird.co/gcp/europe-west3)
[3] us-east-1 (aws) (https://app.tinybird.co/aws/us-east-1)
[4] us-west-2 (aws) (https://app.tinybird.co/aws/us-west-2)
[5] eu-central-1 (aws) (https://app.tinybird.co/aws/eu-central-1) <- this
[0] Cancel

Use region [5]:
Copy the "admin your@email" token from from https://app.tinybird.co/tokens and paste it here: <pasted Token>
** Auth successful!
** Configuration written to .tinyb file, consider adding it to .gitignore

You can also log in using your twenty_analytics_token without passing into the interactive mode:

tb auth --token <your twenty_analytics_token >
** Auth successful!
** Configuration written to .tinyb file, consider adding it to .gitignore

To sync your changes to Tinybird use:

tb push --force --push-deps

To pull data from Tinybird use:

tb pull

Things I learned:

  • When creating Materialied Views think about populating it first using the files from the fixtures
  • When pushing your pipes prefer to push one by one so you can have more coherent error messages
  • The Include files will be nodes that will be added at the start of your node in Tinybird UI
  • It's best to stick only with only the CLI or the UI when developping in Tinybird
  • If you want to format the data us the tb fmt command, perhaps we can add it to the linter in a next pull request.