+
+* [Manual deployment](#manual)
+* [Cloudformation deployment](#cloudformation)
+{:.branching-tabs}
+
+
+
+
+#### Deploying logzio-mysql-logs via Docker on ECS manually
+
+**Before you begin, you'll need**:
+
+* MySQL database hosted on Amazon RDS
+* An active account with Logz.io
+
+
+
+
+##### Create a Log Group on Cloudwatch
+
+Create on Cloudwatch a Log Group named `/aws/ecs/logzio-mysql-logs`.
+
+##### Download the task definition JSON
+
+Download the task definition JSON file that matches your use case:
+
+**Using AWS Keys to authenticate:**
+
+```shell
+wget https://raw.githubusercontent.com/logzio/logzio-mysql-logs/master/ecs/ecs-ec2/task-definition-keys.json
+```
+
+**Using IAM Role to authenticate:**
+
+```shell
+wget https://raw.githubusercontent.com/logzio/logzio-mysql-logs/master/ecs/ecs-ec2/task-definition-iam.json
+```
+
+##### Configure the task
+
+In your prefered text editor, open the JSON file that you downloaded in the previous step and replace the following:
+
+| Parameter | Description |
+|---|---|
+| `<
>` | Your Logz.io log shipping token. {% include log-shipping/log-shipping-token.html %} |
+| `<>` | Listener URL. {% include log-shipping/listener-var.html %} |
+| `<>` | The RDS identifier of the host that you want to read logs from. |
+| `<>` | Your AWS region. |
+| `<>` | AMI access credentials for RDS logs access (permissions for `download-db-log-file-portion` and `describe-db-log-files` are needed). Applies if you chose to authenticate with **AWS Keys**. |
+| `<>` | AMI secret credentials for RDS logs access (permissions for `download-db-log-file-portion` and `describe-db-log-files` are needed). Applies if you chose to authenticate with **AWS Keys**. |
+| `<>` | The path to the RDS error log file. |
+| `<>` | The path to the RDS slow query log file. |
+| `<>` | The path to the RDS general log file. |
+| `<>` | The task execution role. Applies if you chose to authenticate with **IAM Role**. Make sure the role has all the appropriate policies. |
+
+##### Add your task definition
+
+1. In your [Amazon ECS Classic Console](https://console.aws.amazon.com/ecs/) menu, go to **Task Definitions** and click on **Create new Task Definition**.
+
+2. In the **Step 1: Select launch type compatibility** screen, choose **EC2** and click **Next step**.
+
+3. In the **Step 2: Configure task and container definitions** screen, scroll down and click on the **Configure via JSON** button.
+
+4. In the text-box, delete the existing text and paste your configured task definition JSON. Press **Save**, then press **Create**.
+
+##### Run the task
+
+1. Once the task has been created, click on the **Actions** button, then choose **Run Task**.
+
+2. In the **Run Task** screen, choose **EC2** as your **Launch type**.
+
+3. Choose the cluster you want to ship logs from.
+
+4. For **Placement Templates**, choose **One Task Per Host**.
+
+5. Click on **Run Task**.
+
+##### Check Logz.io for your logs
+
+Give your logs some time to get from your system to ours, and then open [Kibana](https://app.logz.io/#/dashboard/kibana).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+* [Manual deployment](#manual)
+* [Cloudformation deployment](#cloudformation)
+{:.branching-tabs}
+
+
+
+
+#### Deploying logzio-mysql-logs via Docker on ECS with Fargate manually
+
+**Before you begin, you'll need**:
+
+* MySQL database hosted on Amazon RDS
+* An active account with Logz.io
+
+
+
+
+##### Create a Log Group on Cloudwatch
+
+Create on Cloudwatch a Log Group named `/aws/ecs/logzio-mysql-logs`.
+
+##### Download the task definition JSON
+
+Download the task definition JSON file that matches your use case:
+
+**Using AWS Keys to authenticate:**
+
+```shell
+wget https://raw.githubusercontent.com/logzio/logzio-mysql-logs/master/ecs/ecs-fargate/task-definition-keys.json
+```
+
+**Using IAM Role to authenticate:**
+
+```shell
+wget https://raw.githubusercontent.com/logzio/logzio-mysql-logs/master/ecs/ecs-fargate/task-definition-iam.json
+```
+
+##### Configure the task
+
+In your prefered text editor, open the JSON file that you downloaded in the previous step and replace the following:
+
+| Parameter | Description |
+|---|---|
+| `<
>` | Your Logz.io log shipping token. {% include log-shipping/log-shipping-token.html %} |
+| `<>` | Listener URL. {% include log-shipping/listener-var.html %} |
+| `<>` | The RDS identifier of the host that you want to read logs from. |
+| `<>` | Your AWS region. |
+| `<>` | AMI access credentials for RDS logs access (permissions for `download-db-log-file-portion` and `describe-db-log-files` are needed). Applies if you chose to authenticate with **AWS Keys**. |
+| `<>` | AMI secret credentials for RDS logs access (permissions for `download-db-log-file-portion` and `describe-db-log-files` are needed). Applies if you chose to authenticate with **AWS Keys**. |
+| `<>` | The path to the RDS error log file. |
+| `<>` | The path to the RDS slow query log file. |
+| `<>` | The path to the RDS general log file. |
+| `<>` | The task execution role. Applies if you chose to authenticate with **IAM Role**. Make sure the role has all the appropriate policies. |
+
+##### Add your task definition
+
+1. In your [Amazon ECS Classic Console](https://console.aws.amazon.com/ecs/) menu, go to **Task Definitions** and click on **Create new Task Definition**.
+
+2. In the **Step 1: Select launch type compatibility** screen, choose **EC2** and click **Next step**.
+
+3. In the **Step 2: Configure task and container definitions** screen, scroll down and click on the **Configure via JSON** button.
+
+4. In the text-box, delete the existing text and paste your configured task definition JSON. Press **Save**, then press **Create**.
+
+##### Run the task
+
+1. Once the task has been created, click on the **Actions** button, then choose **Run Task**.
+
+2. In the **Run Task** screen, choose **EC2** as your **Launch type**.
+
+3. Choose the cluster you want to ship logs from.
+
+4. For **Placement Templates**, choose **One Task Per Host**.
+
+5. Click on **Run Task**.
+
+##### Check Logz.io for your logs
+
+Give your logs some time to get from your system to ours, and then open [Kibana](https://app.logz.io/#/dashboard/kibana).
+
+
+
+
+
+
+
+
+
+
+
+
+
+