From 1f2699a2eeb8ec952bc2cf0f6adc2648e33c1960 Mon Sep 17 00:00:00 2001
From: Jag Singh <38117269+jzingh98@users.noreply.github.com>
Date: Wed, 23 Dec 2020 13:30:32 -0800
Subject: [PATCH] Init - CA Notify
---
CCRStoAPI/__init__.py | 9 +++
CCRStoAPI/acquire_data.py | 39 ++++++++++++
CCRStoAPI/config.py | 21 +++++++
CCRStoAPI/function.json | 20 ++++++
CCRStoAPI/pre_check.py | 50 +++++++++++++++
CCRStoAPI/process_data.py | 101 +++++++++++++++++++++++++++++++
CCRStoAPI/sample.dat | 3 +
CCRStoAPI/verification_server.py | 36 +++++++++++
CCRStoAPI/write_back.py | 15 +++++
README.md | 51 +++++++++++++++-
host.json | 15 +++++
images/NetworkDiagram.png | Bin 0 -> 269687 bytes
local.settings.json | 22 +++++++
proxies.json | 4 ++
requirements.txt | 39 ++++++++++++
15 files changed, 424 insertions(+), 1 deletion(-)
create mode 100644 CCRStoAPI/__init__.py
create mode 100644 CCRStoAPI/acquire_data.py
create mode 100644 CCRStoAPI/config.py
create mode 100644 CCRStoAPI/function.json
create mode 100644 CCRStoAPI/pre_check.py
create mode 100644 CCRStoAPI/process_data.py
create mode 100644 CCRStoAPI/sample.dat
create mode 100644 CCRStoAPI/verification_server.py
create mode 100644 CCRStoAPI/write_back.py
create mode 100644 host.json
create mode 100644 images/NetworkDiagram.png
create mode 100644 local.settings.json
create mode 100644 proxies.json
create mode 100644 requirements.txt
diff --git a/CCRStoAPI/__init__.py b/CCRStoAPI/__init__.py
new file mode 100644
index 0000000..b503c0f
--- /dev/null
+++ b/CCRStoAPI/__init__.py
@@ -0,0 +1,9 @@
+import azure.functions as func
+import logging
+from .process_data import orchestrate_epochs
+
+
+def main(req: func.HttpRequest) -> func.HttpResponse:
+ logging.info("main".upper())
+ orchestrate_epochs()
+ return func.HttpResponse('Completed')
diff --git a/CCRStoAPI/acquire_data.py b/CCRStoAPI/acquire_data.py
new file mode 100644
index 0000000..dcdcc8a
--- /dev/null
+++ b/CCRStoAPI/acquire_data.py
@@ -0,0 +1,39 @@
+import logging
+import snowflake.connector
+from .config import DB_PASSWORD, DB_SCHEMA, ACQUIRE_DATA_QUERY
+
+
+def acquire_data():
+ logging.info('acquire_data'.upper())
+ df = get_data_from_snowflake()
+ data = []
+ for index, row in df.iterrows():
+ data.append(row)
+ return data
+
+
+def get_data_from_snowflake():
+ logging.info('get_data_from_snowflake'.upper())
+ try:
+ con = get_connection()
+ results_iterable = con.cursor().execute(ACQUIRE_DATA_QUERY)
+ logging.info("Total Records: " + str(results_iterable.rowcount))
+ df = results_iterable.fetch_pandas_all()
+ logging.info(df)
+ return df
+ except Exception as e:
+ logging.error("Exception in get_data_from_snowflake: " + str(e))
+ return e
+
+
+def get_connection():
+ logging.info('get_connection'.upper())
+ return snowflake.connector.connect(
+ user='CANOTIFY_USER',
+ password=DB_PASSWORD,
+ account='your_snowflake_account',
+ database='CA_NOTIFY',
+ schema=DB_SCHEMA,
+ warehouse='VWH_CA_NOTIFY',
+ role='CA_NOTIFY_ROLE'
+ )
diff --git a/CCRStoAPI/config.py b/CCRStoAPI/config.py
new file mode 100644
index 0000000..edca0d1
--- /dev/null
+++ b/CCRStoAPI/config.py
@@ -0,0 +1,21 @@
+import os
+
+# VERIFICATION SERVER
+APHL_ADMIN_API_KEY = os.environ['APP_APHL_ADMIN_API_KEY']
+APHL_ADMIN_URL = os.environ['APP_APHL_ADMIN_URL']
+
+# TWILIO
+ACCOUNT_SID = os.environ['APP_TWILIO_ACCT_ID']
+AUTH_TOKEN = os.environ['APP_TWILIO_TOKEN']
+
+# DATABASE
+ACQUIRE_DATA_QUERY = os.environ['APP_ACQUIRE_DATA_QUERY']
+INSERT_WRITEBACK_QUERY = os.environ['APP_INSERT_WRITEBACK_QUERY'] + " "
+VAL = "('{}',{},Current_timestamp())"
+DB_SCHEMA = os.environ['APP_DB_SCHEMA']
+DB_PASSWORD = os.environ['APP_DB_PASSWORD']
+
+# THROUGHPUT
+EPOCH_COUNT = int(os.environ['APP_EPOCH_COUNT'])
+BATCH_SIZE = int(os.environ['APP_BATCH_SIZE'])
+SLEEP_TIME = float(os.environ['APP_SLEEP_TIME'])
\ No newline at end of file
diff --git a/CCRStoAPI/function.json b/CCRStoAPI/function.json
new file mode 100644
index 0000000..b8dc650
--- /dev/null
+++ b/CCRStoAPI/function.json
@@ -0,0 +1,20 @@
+{
+ "scriptFile": "__init__.py",
+ "bindings": [
+ {
+ "authLevel": "function",
+ "type": "httpTrigger",
+ "direction": "in",
+ "name": "req",
+ "methods": [
+ "get",
+ "post"
+ ]
+ },
+ {
+ "type": "http",
+ "direction": "out",
+ "name": "$return"
+ }
+ ]
+}
diff --git a/CCRStoAPI/pre_check.py b/CCRStoAPI/pre_check.py
new file mode 100644
index 0000000..dd4f855
--- /dev/null
+++ b/CCRStoAPI/pre_check.py
@@ -0,0 +1,50 @@
+import logging
+import threading
+from twilio.rest import Client
+from twilio.base.exceptions import TwilioRestException
+from .config import ACCOUNT_SID, AUTH_TOKEN
+
+
+twilio_client = Client(ACCOUNT_SID, AUTH_TOKEN)
+
+
+def pre_check_and_annotate(objects_list):
+ logging.info("execute_pre_check: ".upper())
+ annotated_list = []
+ threads = []
+ for request_obj in objects_list:
+ logging.info("Creating Thread For: ".upper() + str(request_obj))
+ annotated_list.append(request_obj)
+ x = threading.Thread(target=is_phone_valid, args=(request_obj,))
+ threads.append(x)
+ for thread in threads:
+ logging.info("Starting Thread: ".upper() + str(thread))
+ thread.start()
+ for thread in threads:
+ logging.info("Joining Thread: ".upper() + str(thread))
+ thread.join()
+ return annotated_list
+
+
+def is_phone_valid(request_obj):
+ logging.info("is_phone_valid: ".upper() + str(request_obj))
+ if twilio_lookup_is_valid_mobile(request_obj["phone"]):
+ request_obj["pre_check"] = True
+ else:
+ request_obj["pre_check"] = False
+
+
+def twilio_lookup_is_valid_mobile(phone):
+ logging.info("validate_phone_number: ".upper() + str(phone))
+ try:
+ phone_number = twilio_client.lookups.phone_numbers(
+ str(phone)).fetch(type=['carrier'])
+ if (phone_number.carrier['type']
+ and phone_number.carrier['type'] != "mobile") \
+ or len(phone) < 10 or len(phone) > 11:
+ return False
+ else:
+ return True
+ except TwilioRestException as e:
+ logging.info("Exception: " + str(phone) + " " + str(e))
+ return False
diff --git a/CCRStoAPI/process_data.py b/CCRStoAPI/process_data.py
new file mode 100644
index 0000000..faa515c
--- /dev/null
+++ b/CCRStoAPI/process_data.py
@@ -0,0 +1,101 @@
+import logging
+import time
+import random
+import string
+import base64
+from .config import EPOCH_COUNT, BATCH_SIZE, SLEEP_TIME
+from .acquire_data import acquire_data
+from .pre_check import pre_check_and_annotate
+from .write_back import write_back
+from .verification_server import call_verification_server, evaluate_response
+
+
+def orchestrate_epochs():
+ logging.info("orchestrate_epochs".upper())
+ t0 = time.time()
+ for x in range(0, EPOCH_COUNT):
+ execute_single_epoch(x)
+ t1 = time.time()
+ total_time = t1 - t0
+ logging.info("TIME: " + str(total_time))
+
+
+def execute_single_epoch(epoch_num):
+ logging.info(f"execute_single_epoch: ${epoch_num}".upper())
+ data = acquire_data()
+ t0 = time.time()
+ if len(data):
+ orchestrate_batches(data)
+ else:
+ logging.info("Data length 0. Skipping processing")
+ t1 = time.time()
+ sleeptime = SLEEP_TIME - (t1 - t0)
+ logging.info("Sleeptime: " + str(sleeptime))
+ if sleeptime > 0:
+ time.sleep(sleeptime)
+
+
+def orchestrate_batches(data):
+ logging.info("orchestrate_batches")
+ batches = create_batches(data)
+ for index, batch in enumerate(batches):
+ logging.info("Now processing batch: " + str(index))
+ execute_single_batch(batch)
+
+
+def create_batches(data):
+ logging.info("create_batches")
+ for i in range(0, len(data), BATCH_SIZE):
+ yield data[i:i + BATCH_SIZE]
+
+
+def execute_single_batch(batch):
+ logging.info("process_batch: ".upper())
+ valid_recipients, invalid_recipients = generate_recipient_lists(batch)
+ data_object = {"codes": valid_recipients}
+ response = call_verification_server(data_object)
+ valid_recipients_evaluated = evaluate_response(response, valid_recipients)
+ write_back(valid_recipients_evaluated, invalid_recipients)
+
+
+def generate_recipient_lists(batch):
+ logging.info("generate_recipient_lists: ".upper())
+ objects_list = generate_request_objects_list(batch)
+ annotated_list = pre_check_and_annotate(objects_list)
+ valid_recipients = list(filter(
+ lambda x: x['pre_check'] is True, annotated_list))
+ invalid_recipients = list(filter(
+ lambda x: x['pre_check'] is False, annotated_list))
+ # Remove annotations
+ for item in valid_recipients:
+ del item['pre_check']
+ for item in invalid_recipients:
+ del item['pre_check']
+ return valid_recipients, invalid_recipients
+
+
+def generate_request_objects_list(batch):
+ logging.info("generate_list_of_request_objects: ".upper())
+ objects_list = []
+ for row in batch:
+ request_obj = generate_request_object(row)
+ objects_list.append(request_obj)
+ return objects_list
+
+
+def generate_request_object(row):
+ logging.info("create_request_object: ".upper() + str(row))
+ return {"testDate": str(row.DATE),
+ "testType": str(row.TESTTYPE),
+ "tzOffset": -420,
+ "phone": str(row.PHONE),
+ "padding": get_random_base64_string(),
+ "pre_check": False}
+
+
+def get_random_base64_string():
+ logging.info("get_random_base64_string".upper())
+ length = random.randint(5, 20)
+ letters = string.ascii_lowercase
+ result_str = ''.join(random.choice(letters) for i in range(length))
+ return base64.b64encode(result_str.encode('utf-8')).decode('ascii')
diff --git a/CCRStoAPI/sample.dat b/CCRStoAPI/sample.dat
new file mode 100644
index 0000000..26aac46
--- /dev/null
+++ b/CCRStoAPI/sample.dat
@@ -0,0 +1,3 @@
+{
+ "name": "Azure"
+}
\ No newline at end of file
diff --git a/CCRStoAPI/verification_server.py b/CCRStoAPI/verification_server.py
new file mode 100644
index 0000000..3f42ccd
--- /dev/null
+++ b/CCRStoAPI/verification_server.py
@@ -0,0 +1,36 @@
+import logging
+import json
+import requests
+from .config import APHL_ADMIN_URL, APHL_ADMIN_API_KEY
+
+
+def call_verification_server(request_obj):
+ logging.info("call_verification_server: ".upper() + str(request_obj))
+ try:
+ response = requests.post(APHL_ADMIN_URL, data=json.dumps(request_obj),
+ headers={
+ "content-type": "application/json",
+ "accept": "application/json",
+ "x-api-key": APHL_ADMIN_API_KEY})
+ logging.info("Google response = " + str(response))
+ return response.json()
+ except Exception as e:
+ logging.info("Google Exception = " + str(e))
+ return e
+
+
+def evaluate_response(response, valid_recipients):
+ logging.info("evaluate_response: ".upper())
+ if(response.get("error", "")):
+ logging.info("Error in Google response".upper())
+ for item in valid_recipients:
+ singletonresponse = call_verification_server({"codes": [item]})
+ if(singletonresponse.get("error")):
+ item["result"] = 0
+ else:
+ item["result"] = 1
+ else:
+ logging.info("No errors in Google response".upper())
+ for item in valid_recipients:
+ item["result"] = 1
+ return valid_recipients
diff --git a/CCRStoAPI/write_back.py b/CCRStoAPI/write_back.py
new file mode 100644
index 0000000..7a81682
--- /dev/null
+++ b/CCRStoAPI/write_back.py
@@ -0,0 +1,15 @@
+import logging
+from .config import INSERT_WRITEBACK_QUERY, VAL
+from .acquire_data import get_connection
+
+
+def write_back(valid_recipients_evaluated, invalid_recipients):
+ logging.info("write_back - V: ".upper() + str(valid_recipients_evaluated))
+ logging.info("write_back - I: ".upper() + str(invalid_recipients))
+ con = get_connection()
+
+ query_string = INSERT_WRITEBACK_QUERY
+ query_string += ','.join( [VAL.format(item["phone"],0) for item in invalid_recipients ] + [VAL.format(item["phone"],item["result"]) for item in valid_recipients_evaluated ])
+ con.cursor().execute(query_string)
+
+ return
diff --git a/README.md b/README.md
index f957436..8d6ecc6 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,50 @@
-# CaNotify
\ No newline at end of file
+# Introduction
+SMS Text CA citizens who may have been exposed to people having COVID19 symptoms.
+## Table of contents
+* [Open Source Code Repos](#open-source-code-repos)
+* [Programming Language](#programming-language)
+* [External Dependencies](#external-dependencies)
+* [Release Notes](#release-notes)
+* [Technical Details](#technical-details)
+* [Network Diagram](#network-diagram)
+
+#Open Source Code Repos
+https://github.com/StateOfCalifornia/CA_NOTIFY
+#Programming Language
+Python
+#External-Dependencies
+| SnowFlake
(Source Phone#)
Select 100 phone# @ a time
| Twillio
(Phone# Validation API)
Takes only one phone# at a time, but the batch program threaded 10 simultaneous run at a time
| Google
(SMS Text API)
SMS Text 10 phone# at a time
|
+|-------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|---|---|
+#Release Notes
+|12/13/2020| Threaded 10 simultaneous run (one phone# @ a time) through Twillio and batch 10 phone# at a time to Google. Mark (1) as text sent, (0) as no text sent. Update write back table to SnowFlake to filter out already processed phone# for next batch of ten (10).|
+|-------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|---|---|
+
+# Technical Details
+The execution of the CA Notify pipeline can be visualized as a series of epochs each consisting of multiple batches. The main function calls **orchestrate_epochs** to initiate this process. The number of epochs to execute in a single run of the pipeline is defined in the environment variable **EPOCH_COUNT**.
+
+The execution of each epoch occurs in **execute_single_epoch**. Each epoch consists of a single call to **acquire_data** to obtain up to 100 records in bulk from Snowflake, followed by a call to **orchestrate_batches.** Orchestrate_batches accepts the data obtained from Snowflake to iteratively create and execute batches of **BATCH_SIZE** using the **execute_single_batch** function.
+
+Before proceeding to discuss the specifics of **execute_single_batch**, it's worth noting that BATCH_SIZE and EPOCH_COUNT are hyperparameters that may be adjusted to optimize performance and reliability. Our constraints are the following:
+- BATCH_SIZE must be less than 10 due to Google Verification Server requirements.
+- EPOCH_COUNT should be as high as possible without being so high that the total execution lasts longer than two minutes (this is due to an Azure Functions constraint and may vary on other cloud environments)
+- The combined EPOCH_COUNT and BATCH_SIZE execution should yield runs that process as many records as possible without exceeding the max limit from Google Verification Server
+
+The optimal values for us were 3 for EPOCH_COUNT and 10 for BATCH_SIZE. To provide an additional buffer in cases where the epochs execute faster than the acceptable limit we enforce a minimum time of 60 Seconds per epoch (with any difference being made up with sleeps between epochs).
+
+**Execute_single_batch** runs the following sequence of steps on each batch:
+1. Preprocesses the phone numbers in each batch using generate_recepient_lists function. This function uses the Twilio lookup API via a call to pre_check_and_annotate in pre_check.py to determine whether a phone is a valid or invalid. The exact implementation of pre_check_and_annotate employs multithreading to process all the records in a batch in parallel.
+2. The valid_recepients list is wrapped into a Python object and passed to call_verification_server in verification_server.py.
+3. The response from the verification server is analyzed to denote whether each phone was successful or not by evaluate_response.
+4. Both the evaluated responses (in valid_recepients_evaluated) and invalid_recepients are passed to the writeback function. We only care about whether a message was successfully sent to the repience or not - not about why it wasn't sent in the event of a failure. Thus, valid_recepients_evaluated contains both passes that sent, and fails that failed on the Google verification server. Invalid_recepients contains those records that failed the pre check and were never even sent to the verification server. Write_back joins the results of these two lists and passes the data to Snowflake in a single write per batch.
+
+Both the evaluated responses (in valid_recepients_evaluated) and invalid_recepients are passed to the writeback function. We only care about whether a message was successfully sent to the repience or not - not about why it wasn't sent in the event of a failure. Thus, valid_recepients_evaluated contains both passes that sent, and fails that failed on the Google verification server. Invalid_recepients contains those records that failed the pre check and were never even sent to the verification server. Write_back joins the results of these two lists and passes the data to Snowflake in a single write per batch.
+
+The key optimization decision that significantly improved the throughput of our pipeline were:
+- Reading from Snowflake only once *per epoch*
+- Writing to Snowflake only once *per batch*
+- Calling the Google Verification server using the batch-issue endpoint
+- Parallelizing the calls to Twilio using multithreading
+#Network Diagram
+
+
+
diff --git a/host.json b/host.json
new file mode 100644
index 0000000..6ab6643
--- /dev/null
+++ b/host.json
@@ -0,0 +1,15 @@
+{
+ "version": "2.0",
+ "logging": {
+ "applicationInsights": {
+ "samplingSettings": {
+ "isEnabled": true,
+ "excludedTypes": "Request"
+ }
+ }
+ },
+ "extensionBundle": {
+ "id": "Microsoft.Azure.Functions.ExtensionBundle",
+ "version": "[1.*, 2.0.0)"
+ }
+}
diff --git a/images/NetworkDiagram.png b/images/NetworkDiagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..7f275a04384fe6743e8d6bef5a6957f64d960050
GIT binary patch
literal 269687
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 S>WjrgMQ
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