Adding very basic diagnostic logging document for Cognitive Services. Will update over time based on traffic and feedback.

Author: erhopf

articles/azure-monitor/platform/diagnostic-logs-schema.md

@@ -49,7 +49,7 @@ The schema for resource diagnostic logs varies depending on the resource and log
 | Azure Batch |[Azure Batch diagnostic logging](../../batch/batch-diagnostics.md) |
 | Azure Database for MySQL | [Azure Database for MySQL diagnostic logs](../../mysql/concepts-server-logs.md#diagnostic-logs) |
 | Azure Database for PostgreSQL | [Azure Database for PostgreSQL diagnostic logs](../../postgresql/concepts-server-logs.md#diagnostic-logs) |
-| Cognitive Services | Schema not available. |
+| Cognitive Services | [Diagnostic Logging for Azure Cognitive Services](../../cognitive-services/diagnostic-logging.md) |
 | Content Delivery Network | [Azure Diagnostic Logs for CDN](../../cdn/cdn-azure-diagnostic-logs.md) |
 | CosmosDB | [Azure Cosmos DB Logging](../../cosmos-db/logging.md) |
 | Data Factory | [Monitor Data Factories using Azure Monitor](../../data-factory/monitor-using-azure-monitor.md) |
@@ -203,4 +203,3 @@ The schema for resource diagnostic logs varies depending on the resource and log
 * [Stream resource diagnostic logs to **Event Hubs**](../../azure-monitor/platform/diagnostic-logs-stream-event-hubs.md)
 * [Change resource diagnostic settings using the Azure Monitor REST API](https://docs.microsoft.com/rest/api/monitor/diagnosticsettings)
 * [Analyze logs from Azure storage with Log Analytics](../../azure-monitor/platform/collect-azure-metrics-logs.md)
-

articles/cognitive-services/diagnostic-logging.md

@@ -1,19 +1,19 @@
 ---
-title: Diagnostic Logging
+title: Diagnostic Logging for Azure Cognitive Services
 titleSuffix: Cognitive Services - Azure
 description: This guide provides step-by-step instructions to enable diagnostic logging for an Azure Cognitive Service. These logs provide rich, frequent data about the operation of a resource that are used for issue identification and debugging.
 services: cognitive-services
 author: erhopf
 manager: cgronlun
 ms.service: cognitive-services
 ms.topic: article
-ms.date: 10/10/2018
+ms.date: 06/14/2019
 ms.author: erhopf
 ---
 
 # Enable diagnostic Logging for Azure Cognitive Services
 
-This guide provides step-by-step instructions to enable diagnostic logging for an Azure Cognitive Service. These logs provide rich, frequent data about the operation of a resource that are used for issue identification and debugging. Before you continue, you must have an Azure account with a subscription to at least one Cognitive Service, such as [Bing Web Search](), [Computer Vision](), or [LUIS]().
+This guide provides step-by-step instructions to enable diagnostic logging for an Azure Cognitive Service. These logs provide rich, frequent data about the operation of a resource that are used for issue identification and debugging. Before you continue, you must have an Azure account with a subscription to at least one Cognitive Service, such as [Bing Web Search](https://docs.microsoft.com/azure/cognitive-services/bing-web-search/overview), [Speech Services](https://docs.microsoft.com/azure/cognitive-services/speech-service/overview), or [LUIS](https://docs.microsoft.com/azure/cognitive-services/luis/what-is-luis).
 
 ## Prerequisites
 
@@ -23,14 +23,14 @@ To enable diagnostic logging, you'll need somewhere to store your log data. This
 * [Log Analytics](https://docs.microsoft.com/azure/monitoring-and-diagnostics/monitor-stream-diagnostic-logs-log-analytics) - A flexible log search and analytics tool that allows for analysis of raw logs generated by an Azure resource.
 
 > [!NOTE]
-> Additional configuration options are available. To learn more, see [Collect and consume log data from your Azure resources](https://docs.microsoft.com/en-us/azure/monitoring-and-diagnostics/monitoring-overview-of-diagnostic-logs).
+> Additional configuration options are available. To learn more, see [Collect and consume log data from your Azure resources](https://docs.microsoft.com/azure/monitoring-and-diagnostics/monitoring-overview-of-diagnostic-logs).
 
 ## Enable diagnostic log collection  
 
 Let's start by enabling diagnostic logging using the Azure portal.
 
 > [!NOTE]
-> To enable this feature using PowerShell or the Azure CLI, use the instructions provided in [Collect and consume log data from your Azure resources](https://docs.microsoft.com/en-us/azure/monitoring-and-diagnostics/monitoring-overview-of-diagnostic-logs#how-to-enable-collection-of-diagnostic-logs).
+> To enable this feature using PowerShell or the Azure CLI, use the instructions provided in [Collect and consume log data from your Azure resources](https://docs.microsoft.com/azure/monitoring-and-diagnostics/monitoring-overview-of-diagnostic-logs#how-to-enable-collection-of-diagnostic-logs).
 
 1. Navigate to the Azure portal. Then locate and select a Cognitive Services resource. For example, your subscription to Bing Web Search.   
 2. Next, from the left-hand navigation menu, locate **Monitoring** and select **Diagnostic settings**. This screen contains all previously created diagnostic settings for this resource.
@@ -51,30 +51,46 @@ Azure Storage is a robust object storage solution that is optimized for storing
 3. Use the available drop-downs to configure your query. For this example, let's set the time range to **Last 30 days** and the metric to **Transaction**.
 4. When the query is complete, you'll see a visualization of transaction over the last 30 days. To export this data, use the **Export to Excel** button located at the top of the page.
 
-Learn more about what you can do with diagnostic data in [Azure Storage](https://docs.microsoft.com/en-us/azure/storage/blobs/storage-blobs-introduction).
+Learn more about what you can do with diagnostic data in [Azure Storage](https://docs.microsoft.com/azure/storage/blobs/storage-blobs-introduction).
 
 ## View logs in Log Analytics
 
-<Some intro>
+Follow these instructions to explore log analytics data for your resource.
 
 1. From the Azure Portal, locate and select **Log Analytics** from the left-hand navigation menu.
 2. Locate and select the resource you created when enabling diagnostics.
 3. Under **General**, locate and select **Logs**. From this page, you can run queries against your logs.
 
 ### Sample queries
 
-Now that you've enabled data collection, run this query to see the 10 most recent logs:
+Run this query for all diagnostic logs from Azure Cognitivie Services for a specified time period:
 
+```kusto
+AzureDiagnostics
+| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"
 ```
-AzureDiagnostics | take 10
-```
 
-<-! Work with Greg to add additional queries ->
+Run this query to see the 10 most recent logs:
+
+```kusto
+AzureDiagnostics
+| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"
+| take 10
+```
 
-## Set an alert
+Run this query to group operations by **Resource**:
 
-<-! Work with Greg to provide context for alerts. ->
+```kusto
+AzureDiagnostics
+| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES" |
+summarize count() by Resource
+```
 
-## Schema
+## Next steps
 
-<-! Work with Greg to complete the JSON schema. ->
+* To understand how to enable logging, and also the metrics and log categories that are supported by the various Azure services, read both the [Overview of metrics](https://docs.microsoft.com/azure/monitoring-and-diagnostics/monitoring-overview-metrics) in Microsoft Azure and [Overview of Azure Diagnostic Logs](https://docs.microsoft.com/azure/azure-monitor/platform/diagnostic-logs-overview) articles.
+* Read these articles to learn about event hubs:
+  * [What is Azure Event Hubs?](https://docs.microsoft.com/azure/event-hubs/event-hubs-what-is-event-hubs)
+  * [Get started with Event Hubs](https://docs.microsoft.com/azure/event-hubs/event-hubs-csharp-ephcs-getstarted)
+* Read [Download metrics and diagnostic logs from Azure Storage](https://docs.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-dotnet#download-blobs).
+* Read [Understand log searches in Azure Monitor logs](https://docs.microsoft.com/azure/log-analytics/log-analytics-log-search-new).