Added documentations

Author: Yoichi Kawasaki

README.md

@@ -1,9 +1,38 @@
 # azure-database-scaler
-Event driven Logic App and Functions that scale-up or scale-down the capacity of your Azure database service instance (Currently only vCore # is supported)
+Event driven Azure Logic App & Functions App that scale-up or scale-down the capacity of your Azure database service instance (Currently only vCore # is supported)
 
+Targets Azure Databases to scale in this project:
+- [Azure Database for MySQL](https://azure.microsoft.com/en-us/services/mysql/)
+- [Azure Database for PostgreSQL](https://azure.microsoft.com/en-us/services/postgresql/)
+
+What to scale up/down?
+- vCores ([What is vCore?](https://docs.microsoft.com/en-us/azure/mysql/concepts-pricing-tiers#compute-generations-vcores-and-memory))
+
+How to scale up/down?
+- azure-database-scaler starts scaling-up or scaling-down the number of vCore when it is triggered by Azure Monitor Metric Alerts (Alerts providers must be either `Microsoft.DBforMySQL` or `Microsoft.DBforPostgreSQL`)
+- azure-database-scaler scale-up or scale-down the number of vCore within the same database tier & the same compute generations (Gen4 / Gen5) of your instance in the way like:
+    - Basic Tier: 1 <-> 2
+    - General Purpose Tier: 2 <-> 4 <-> 8 <-> 16 <-> 32
+    - Memory Optimized Tier: 2 <-> 4 <-> 8 <-> 16 <-> 32
+- azure-database-scaler scale-up the number of vCore when Alert Operator of triggering Alerts is either `GreaterThan` or `GreaterThanOrEqual`
+- azure-database-scaler scale-down the number of vCore when Alert Operator of triggering Alerts is either `LessThan` or `LessThanOrEqual`
+
+Architecture:
+![](images/architecture-overview.png)
+
+Relevant Services:
+- [Azure Database for MySQL](https://azure.microsoft.com/en-us/services/mysql/)
+- [Azure Database for PostgreSQL](https://azure.microsoft.com/en-us/services/postgresql/)
+- [Azure Functions](https://azure.microsoft.com/en-us/services/functions/)
+- [Azure Logic Apps](https://azure.microsoft.com/en-us/services/logic-apps/)
+- [Azure Monitor Alerts (Classic)](https://docs.microsoft.com/en-us/azure/monitoring-and-diagnostics/monitoring-overview-alerts)
+- [Azure Monitor Alerts (New)](https://docs.microsoft.com/en-us/azure/monitoring-and-diagnostics/monitoring-overview-unified-alerts)
+- [Slack (for notification)](https://slack.com)
 
 ## How to deploy the scaler app
 - [How to deploy the database scaler app](./docs/HOW-TO-DEPLOY-APP.md)
 
-## How to setup autoscale trigger
-- [How to setup Azure Alerts for autoscaling Azure Database Services](./docs/HOW-TO-SETUP-ALERTS.md)
+## How to setup Azure Metric Monitor for Autoscaling
+- [[Classic Metric Alert] How to setup Azure Monitor Metric Alerts](./docs/HOW-TO-SETUP-ALERTS.md)
+- \[New Metric Alert\] How to setup Azure Monitor Metric Alerts
+

docs/HOW-TO-DEPLOY-APP.md

@@ -10,6 +10,9 @@ pip install -U azure-cli
 ```
 [NOTE] you can skip azure-cli installation if you execute bash commands from [Azure Cloud Shell](https://docs.microsoft.com/en-us/azure/cloud-shell/overview). I recommend you to use [Azure Cloud Shell Bash](https://docs.microsoft.com/en-us/azure/cloud-shell/overview) as it's browser based and you can run anywhere
 
+![](../images/azure-cloud-shell-bash.png)
+
+
 ## Create Resources and Deploy applications
 
 ### 1. Create Resource Group
@@ -93,7 +96,7 @@ Get the following functions' URLs (scheme + host/path + query) in the Azure Port
 - webhookhandler
 
 Here is how you get get-sas-token function's URL.
-![](../images/screenshot-functions-url.png)
+![](../images/webhookhandler-url.png)
 
 Once you get `webhookhandler` function URL, replace `WebhookSubscribeAPIEndpoint` value with `webhookhandler` function URL in `project.conf` like this:
 ```
@@ -107,5 +110,6 @@ Create Azure Logic App Account and deploy a workflow to the account by running a
 scripts/setup-logicapp.sh
 ```
 
-### 8. Configure Connection to your Slack account
+### 8. Authorize the logic app to access your Slack account
 
+![](../images/slack-authorization-steps.png)

docs/HOW-TO-SETUP-ALERTS.md

@@ -1,3 +1,4 @@
 # How to setup Azure Alerts for Azure Database autoscaling
 
 
+![](../images/alert-configuration-steps.png)