Modify warehouse setup pages to include steps for event tracking (#587)

* redshift event tracking setup instructions

* bigquery event tracking setup instructions

* Event Tracking -> Track API

Author: petzel

docs/data-management/connecting-dwh/bigquery.md

@@ -14,7 +14,13 @@ Additionally, you will need to create a data environment for Eppo to write inter
 4. Click **CREATE SERVICE ACCOUNT** in the service accounts header.
 5. Under **Service account details**, add an _account name_, _ID_, and optional _description_.
 6. Click **CREATE**.
-7. Under **Service account permissions**, add the following role: `BigQuery Job User (roles/bigquery.jobUser)`
+7. Under **Service account permissions**, add the following roles:
+    - `BigQuery Job User (roles/bigquery.jobUser)`
+      - Required
+    - `Storage Admin (roles/storage.admin)`
+      - Optional; required for using Eppo's [Track API](/sdks/event-logging/event-tracking)
+      - Scoped to the Storage bucket to use for temporary storage of events before loading into BigQuery
+
 8. Click **CONTINUE**.
 9. (optional) Under **Grant users access** you may choose to grant other users access to your new service account.
 10. Click **CREATE KEY** to create a json [private key](https://cloud.google.com/iam/docs/creating-managing-service-account-keys).
@@ -62,6 +68,7 @@ Now that you have a proper Service Account created for Eppo with adequate privil
 - **BigQuery Dataset** - `eppo_output`
 - **BigQuery Project** - Name of the BQ project to which `eppo_output` belongs
 - **BigQuery Region** - The region in which you created the `eppo_output` dataset
+- **Storage Bucket (Optional)** - Cloud Storage bucket to use for staging of events logged with Eppo's [Track API](/sdks/event-logging/event-tracking) before inserting into BigQuery. Files will be automatically deleted from this bucket after insertion into BigQuery.
 
 5. Enter the values into the form (which should look like the screenshot below), then click `Test Connection`. Once this test succeeds, save your settings by clicking `Test and Save Connection`.
 

docs/data-management/connecting-dwh/redshift.md

@@ -16,7 +16,7 @@ For Eppo to connect to your Redshift database, you’ll need to allow our inboun
 6. Click **Add Rule** to add a new Inbound Rule.
    a. Set the Type to **Redshift**.
    b. Adjust the Port, if needed.
-   c. Enter the following into the Source field: 
+   c. Enter the following into the Source field:
 
 | IP Address |
 | --- |
@@ -105,6 +105,25 @@ You'll want to gather the following connection details from Redshift:
 
   You can also find your **Database Name** under the **Database configurations** section of the Properties tab.
 
+#### (Optional) Event tracking
+
+To use Eppo's [Event Tracking](/sdks/event-logging/event-tracking) with Redshift, additional configuration is required:
+
+- **S3 Bucket**: Eppo will write events to this bucket before bulk inserting into Redshift.
+
+  Files will be automatically deleted from this bucket after insertion into Redshift.
+
+- **AWS Region**: The region the Redshift cluster resides in
+
+- **Access Key ID**: Credentials of the service account Eppo can use to upload files to the S3 bucket
+
+- **Secret Access Key**: Credentials of the service account Eppo can use to upload files to the S3 bucket
+
+- **AWS IAM Role**: IAM role to use when running `COPY INTO` operations to load data from S3 into the Redshift instance.
+
+  This role needs permissions to `LIST` and the contents of the above S3 bucket as well as `GET` objects within the S3 bucket.
+
+
 #### (Optional) SSH Tunnel
 
 Eppo supports connecting to a Redshift cluster over an SSH tunnel.
@@ -139,6 +158,7 @@ Now that you have a proper User created for Eppo with adequate privileges, you c
 - **Database name** - **Database name** from [previous section](#gather-redshift-connection-details)
 - **Schema name** - `eppo_output`
 - **Port** - **Database port** from [previous section](#gather-redshift-connection-details)
+- **[Optional] Event Tracking Configuration** - values from [previous section](#gather-redshift-connection-details)
 
 4. Enter the values into the form (which should look like the screenshot below), then click `Test Connection`. Once this test succeeds, save your settings by clicking `Test and Save Connection`.