Merge pull request #242789 from mkhribech/Update-metrics-call-automation

Create call-automation-metrics

Author: Stacyrch140

articles/communication-services/concepts/analytics/logs/call-automation-metrics.md

@@ -0,0 +1,60 @@
+---
+title: Call automation metrics definitions for Azure Communication Service
+titleSuffix: An Azure Communication Services concept document
+description: This document covers definitions of call automation metrics available in the Azure portal.
+author: mkhribech
+manager: timmitchell
+services: azure-communication-services
+ms.author: mkhribech
+ms.date: 06/23/2023
+ms.topic: conceptual
+ms.service: azure-communication-services
+ms.subservice: data
+---
+# Call automation metrics overview
+
+Azure Communication Services currently provides metrics for all ACS primitives. [Azure Metrics Explorer](../../../../azure-monitor\essentials\metrics-getting-started.md) can be used to plot your own charts, investigate abnormalities in your metric values, and understand your API traffic by using the metrics data that call automation requests emit.
+
+## Where to find metrics
+
+Primitives in Azure Communication Services emit metrics for API requests. These metrics can be found in the Metrics tab under your Communication Services resource. You can also create permanent dashboards using the workbooks tab under your Communication Services resource.
+
+## Metric definitions
+
+All API request metrics contain three dimensions that you can use to filter your metrics data. These dimensions can be aggregated together using the `Count` aggregation type and support all standard Azure Aggregation time series including `Sum`, `Average`, `Min`, and `Max`.
+
+More information on supported aggregation types and time series aggregations can be found [Advanced features of Azure Metrics Explorer](../../../../azure-monitor/essentials/metrics-charts.md#aggregation).
+
+- **Operation** - All operations or routes that can be called on the Azure Communication Services Chat gateway.
+- **Status Code** - The status code response sent after the request.
+- **StatusSubClass** - The status code series sent after the response. 
+
+### Call Automation API requests
+
+The following operations are available on Call Automation API request metrics:
+
+| Operation / Route  | Description                                                                                    |
+| -------------------- | ---------------------------------------------------------------------------------------------- |
+| Create Call           | Create an outbound call to user. 
+| Answer Call           | Answer an inbound call. |
+| Redirect Call         | Redirect an inbound call to another user. |
+| Reject Call           | Reject an inbound call. |
+| Transfer Call To Participant   |  Transfer 1:1 call to another user.   |
+| Play                  | Play audio to call participants.  |
+| PlayPrompt            | Play a prompt to users as part of the Recognize action. |
+| Recognize             | Recognize user input from call participants. |
+| Add Participants      |  Add a participant to a call.    |
+| Remove Participants   | Remove a participant from a call.   |
+| HangUp Call           | Hang up your call leg. | 
+| Terminate Call        | End the call for all participants.  | 
+| Get Call              | Get details about a call.     |
+| Get Participant       |  Get details on a call participant.   |
+| Get Participants      |  Get all participants in a call.   |
+| Delete Call           |  Delete a call.    |
+| Cancel All Media Operations | Cancel all ongoing or queued media operations in a call. | 
+
+
+
+## Next steps
+
+- Learn more about [Data Platform Metrics](../../../../azure-monitor/essentials/data-platform-metrics.md).