Merge pull request #219050 from paulth1/app-articles-batch-12

edit pass: App articles batch 12

Author: ShawnJackson

articles/azure-monitor/app/automate-custom-reports.md

@@ -1,39 +1,39 @@
 ---
 title: Automate custom reports with Application Insights data
-description: Automate custom daily/weekly/monthly reports with Azure Monitor Application Insights data
+description: Automate custom daily, weekly, and monthly reports with Azure Monitor Application Insights data.
 ms.topic: conceptual
 ms.date: 05/20/2019
 ms.reviewer: tilee
 ---
 
 # Automate custom reports with Application Insights data
 
-Periodical reports help keep a team informed on how their business critical services are doing. Developers, DevOps/SRE teams, and their managers can be productive with automated reports reliably delivering insights without requiring everyone to sign in the portal. Such reports can also help identify gradual increases in latencies, load or failure rates that may not trigger any alert rules.
+Periodical reports help keep a team informed on how their business-critical services are doing. Developers, DevOps/SRE teams, and their managers can be productive with automated reports that reliably deliver insights without requiring everyone to sign in to the portal. Such reports can also help identify gradual increases in latencies, load, or failure rates that might not trigger any alert rules.
 
 Each enterprise has its unique reporting needs, such as:
 
-* Specific percentile aggregations of metrics, or custom metrics in a report.
-* Have different reports for daily, weekly, and monthly roll-ups of data for different audiences.
-* Segmentation by custom attributes like region, or environment.
-* Group some AI resources together in a single report, even if they may be in different subscriptions or resource groups etc.
-* Separate reports containing sensitive metrics sent to selective audience.
-* Reports to stakeholders who may not have access to the portal resources.
+* Specific percentile aggregations of metrics or custom metrics in a report.
+* Different reports for daily, weekly, and monthly roll-ups of data for different audiences.
+* Segmentation by custom attributes like region or environment.
+* AI resources grouped together in a single report, even if they might be in different subscriptions or resource groups.
+* Separate reports that contain sensitive metrics sent to selective audiences.
+* Reports to stakeholders who might not have access to the portal resources.
 
-> [!NOTE] 
-> The weekly Application Insights digest email did not allow any customization, and will be discontinued in favor of the custom options listed below. The last weekly digest email will be sent on June 11, 2018. Please configure one of the following options to get similar custom reports (use the query suggested below).
+> [!NOTE]
+> The weekly Application Insights digest email didn't allow any customization and will be discontinued in favor of the custom options listed here. The last weekly digest email was sent on June 11, 2018. Configure one of the following options to get similar custom reports. Use the query that's suggested in this article.
 
-## To automate custom report emails
+## Automate custom report emails
 
 You can [programmatically query Application Insights](https://dev.applicationinsights.io/) data to generate custom reports on a schedule. The following options can help you get started quickly:
 
-* [Automate reports with Power Automate](../logs/logicapp-flow-connector.md)
-* [Automate reports with Logic Apps](automate-with-logic-apps.md)
-* Use the "Application Insights scheduled digest" [Azure function](../../azure-functions/functions-get-started.md) template in the Monitoring scenario. This function uses SendGrid to deliver the email. 
+* [Automate reports with Power Automate](../logs/logicapp-flow-connector.md).
+* [Automate reports with Azure Logic Apps](automate-with-logic-apps.md).
+* Use the **Application Insights scheduled digest** [Azure Functions](../../azure-functions/functions-get-started.md) template in the **Monitoring** scenario. This function uses SendGrid to deliver the email.
 
-    ![Azure function template](./media/automate-custom-reports/azure-function-template.png)
+    ![Screenshot that shows an Azure Functions template.](./media/automate-custom-reports/azure-function-template.png)
 
 ## Sample query for a weekly digest email
-The following query shows joining across multiple datasets for a weekly digest email like report. Customize it as required and use it with any of the options listed above to automate a weekly report.
+The following query shows joining across multiple datasets for a weekly digest email-like report. Customize it as required and use it with any of the options previously listed to automate a weekly report.
 
 ```AIQL
 let period=7d;
@@ -65,87 +65,87 @@ availabilityResults
 
 ## Application Insights scheduled digest report
 
-1. Create an Azure Function App.(Application Insights _On_ is required only if you want to monitor your new Function App with Application Insights)
+1. Create an Azure Functions app. Application Insights **On** is required only if you want to monitor your new Azure Functions app with Application Insights.
 
-   Visit the Azure Functions documentation to learn how to [create a function app](../../azure-functions/functions-get-started.md)
+   See the Azure Functions documentation to learn how to [create a function app](../../azure-functions/functions-get-started.md).
 
-2. Once your new Function App has completed deployment, select **Go to resource**.
+1. After your new Azure Functions app has finished deployment, select **Go to resource**.
 
-3. Select **New function**.
+1. Select **New function**.
 
-   ![Create a new Function screenshot](./media/automate-custom-reports/new-function.png)
+   ![Screenshot that shows Create a new function.](./media/automate-custom-reports/new-function.png)
 
-4. Select the **_Application Insights scheduled digest template_**.
+1. Select the **Application Insights scheduled digest** template.
 
      > [!NOTE]
-     > By default, function apps are created with runtime version 3.x. You must [target Azure Functions runtime version](../../azure-functions/set-runtime-version.md) **1.x** to use the Application Insights scheduled digest template. Go to Configuration > Function Runtime settings to change the runtime version. ![runtime screenshot](./media/automate-custom-reports/change-runtime-v.png)
+     > By default, function apps are created with runtime version 3.x. You must [target Azure Functions runtime version](../../azure-functions/set-runtime-version.md) **1.x** to use the Application Insights scheduled digest template. Go to **Configuration** > **Function runtime settings** to change the runtime version. ![Screenshot that shows the Function runtime settings tab.](./media/automate-custom-reports/change-runtime-v.png)
 
-   ![New Function Application Insights Template screenshot](./media/automate-custom-reports/function-app-04.png)
+   ![Screenshot that shows New Function Application Insights Template.](./media/automate-custom-reports/function-app-04.png)
 
-5. Enter an appropriate recipient e-mail address for your report and select **Create**.
+1. Enter an appropriate recipient email address for your report and select **Create**.
 
-   ![Function Settings screenshot](./media/automate-custom-reports/scheduled-digest.png)
+   ![Screenshot that shows Function Settings.](./media/automate-custom-reports/scheduled-digest.png)
 
-6. Select your **Function App** > **Platform features** > **Configuration**.
+1. Select **Function Apps** > **Platform features** > **Configuration**.
 
-    ![Azure Function Application settings screenshot](./media/automate-custom-reports/config.png)
+    ![Screenshot that shows Azure Function Application settings.](./media/automate-custom-reports/config.png)
 
-7. Create three new application settings with appropriate corresponding values ``AI_APP_ID``, ``AI_APP_KEY``, and ``SendGridAPI``. Select **Save**.
+1. Create three new application settings with the appropriate corresponding values ``AI_APP_ID``, ``AI_APP_KEY``, and ``SendGridAPI``. Select **Save**.
 
-     ![Function integration interface screenshot](./media/automate-custom-reports/app-settings.png)
+     ![Screenshot that shows Function integration interface.](./media/automate-custom-reports/app-settings.png)
 
-    (The AI_ values can be found under API Access for the Application Insights Resource you want to report on. If you don't have an Application Insights API Key, there is the option to **Create API Key**.)
+    You can find the AI_ values under **API Access** for the Application Insights resource you want to report on. If you don't have an Application Insights API key, use the **Create API Key** option.
 
    * AI_APP_ID = Application ID
    * AI_APP_KEY = API Key
    * SendGridAPI =SendGrid API Key
 
      > [!NOTE]
-     > If you don't have a SendGrid account you can create one. SendGrid's documentation for Azure Functions is [here](../../azure-functions/functions-bindings-sendgrid.md). If just want a minimal explanation of how to setup SendGrid and generate an API key one is provided at the end of this article. 
+     > If you don't have a SendGrid account, you can create one. For more information, see [Azure Functions SendGrid bindings](../../azure-functions/functions-bindings-sendgrid.md) for the SendGrid documentation for Azure Functions. If you want a brief explanation of how to set up SendGrid and generate an API key, one is provided at the end of this article.
 
-8. Select **Integrate** and under Outputs click **SendGrid ($return)**.
+1. Select **Integrate**. Under **Outputs**, select **SendGrid ($return)**.
 
-     ![Output screenshot](./media/automate-custom-reports/integrate.png)
+     ![Screenshot that shows Outputs.](./media/automate-custom-reports/integrate.png)
 
-9. Under the **SendGridAPI Key App Setting**, select your newly created App Setting for **SendGridAPI**.
+1. Under the **SendGridAPI Key App Setting**, select your newly created app setting **SendGridAPI**.
 
-     ![Run Function App screenshot](./media/automate-custom-reports/sendgrid-output.png)
+     ![Screenshot that shows SendGridAPI.](./media/automate-custom-reports/sendgrid-output.png)
 
-10. Run and test your Function App.
+1. Run and test your function app.
 
-     ![Test Screenshot](./media/automate-custom-reports/function-app-11.png)
+     ![Screenshot that shows Test.](./media/automate-custom-reports/function-app-11.png)
 
-11. Check your e-mail to confirm that the message was sent/received successfully.
+1. Check your email to confirm that the message was sent or received successfully.
 
-     ![E-mail subject line screenshot](./media/automate-custom-reports/function-app-12.png)
+     ![Screenshot that shows the E-mail subject line.](./media/automate-custom-reports/function-app-12.png)
 
 ## SendGrid with Azure
 
 These steps only apply if you don't already have a SendGrid account configured.
 
-1. From the Azure portal, select **Create a resource** > search for **SendGrid Email Delivery** > click **Create** > fill out the SendGrid specific create instructions.
+1. On the Azure portal, select **Create a resource**. Search for **SendGrid Email Delivery** and select **Create**. Fill out the SendGrid instructions.
 
-     ![Create SendGrid Resource Screenshot](./media/automate-custom-reports/sendgrid.png)
+     ![Screenshot that shows the SendGrid Create button.](./media/automate-custom-reports/sendgrid.png)
 
-2. Once created under SendGrid Accounts select **Manage**.
+1. Under **SendGrid Accounts**, select **Manage**.
 
-     ![Settings API Key Screenshot](./media/automate-custom-reports/sendgrid-manage.png)
+     ![Screenshot that shows the Manage button.](./media/automate-custom-reports/sendgrid-manage.png)
 
-3. This will launch SendGrid's site. Select **Settings** > **API Keys**.
+1. This action opens SendGrid's site. Select **Settings** > **API Keys**.
 
-     ![Create and View API Key App Screenshot](./media/automate-custom-reports/function-app-15.png)
+     ![Screenshot that shows API Keys under Settings.](./media/automate-custom-reports/function-app-15.png)
 
-4. Create an API Key > choose **Create & View**. (Review SendGrid's documentation on restricted access to determine what level of permissions is appropriate for your API Key. Full Access is selected here for example purposes only.)
+1. To create an API key, select **Create & View**. Review SendGrid's documentation on restricted access to determine what level of permissions is appropriate for your API key. **Full Access** is selected here only as an example.
 
-   ![Full access screenshot](./media/automate-custom-reports/function-app-16.png)
+   ![Screenshot that shows Full Access.](./media/automate-custom-reports/function-app-16.png)
 
-5. Copy the entire key, this value is what you need in your Function App settings as the value for SendGridAPI
+1. Copy the entire key. This value is what you need in your function app settings as the value for `SendGridAPI`.
 
-   ![Copy API key screenshot](./media/automate-custom-reports/function-app-17.png)
+   ![Screenshot that shows the API Key Created pane.](./media/automate-custom-reports/function-app-17.png)
 
 ## Next steps
 
 * Learn more about creating [Analytics queries](../logs/get-started-queries.md).
 * Learn more about [programmatically querying Application Insights data](https://dev.applicationinsights.io/)
 * Learn more about [Logic Apps](../../logic-apps/logic-apps-overview.md).
-* Learn more about [Microsoft Power Automate](https://ms.flow.microsoft.com).
+* Learn more about [Power Automate](https://ms.flow.microsoft.com).