Skip to content

Commit 502a7d8

Browse files
authored
Merge pull request #246710 from alexbuckgit/alexbuckgit/docutune-autopr-20230729-210427-8387361-ignore-build
[BULK] DocuTune - Fix formatting issues (part 5)
2 parents 815832a + 7222644 commit 502a7d8

9 files changed

+830
-819
lines changed

articles/communication-services/tutorials/end-of-call-survey-tutorial.md

Lines changed: 37 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -17,21 +17,21 @@ ms.subservice: calling
1717

1818
# Use the End of Call Survey to collect user feedback
1919

20-
> [!NOTE]
20+
> [!NOTE]
2121
> End of Call Survey is currently supported only for our JavaScript / Web SDK.
2222
2323
This tutorial shows you how to use the Azure Communication Services End of Call Survey for JavaScript / Web SDK.
2424

2525

2626
## Prerequisites
2727

28-
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
28+
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
2929

30-
- [Node.js](https://nodejs.org/) active Long Term Support(LTS) versions are recommended.
30+
- [Node.js](https://nodejs.org/) active Long Term Support(LTS) versions are recommended.
3131

32-
- An active Communication Services resource. [Create a Communication Services resource](../quickstarts/create-communication-resource.md). Survey results are tied to single Communication Services resources.
33-
- An active Log Analytics Workspace, also known as Azure Monitor Logs. See [End of Call Survey Logs](../concepts/analytics/logs/end-of-call-survey-logs.md).
34-
- To conduct a survey with custom questions using free form text, you need an [App Insight resource](../../azure-monitor/app/create-workspace-resource.md#create-a-workspace-based-resource).
32+
- An active Communication Services resource. [Create a Communication Services resource](../quickstarts/create-communication-resource.md). Survey results are tied to single Communication Services resources.
33+
- An active Log Analytics Workspace, also known as Azure Monitor Logs. See [End of Call Survey Logs](../concepts/analytics/logs/end-of-call-survey-logs.md).
34+
- To conduct a survey with custom questions using free form text, you need an [App Insight resource](../../azure-monitor/app/create-workspace-resource.md#create-a-workspace-based-resource).
3535

3636

3737
> [!IMPORTANT]
@@ -44,7 +44,7 @@ The End of Call Survey feature should be used after the call ends. Users can rat
4444

4545
The following code snips show an example of one-to-one call. After the end of the call, your application can show a survey UI and once the user chooses a rating, your application should call the feature API to submit the survey with the user choices.
4646

47-
We encourage you to use the default rating scale. However, you can submit a survey with custom rating scale. You can check out the [sample application](https://github.com/Azure-Samples/communication-services-web-calling-tutorial/blob/main/Project/src/MakeCall/CallSurvey.js) for the sample API usage.
47+
We encourage you to use the default rating scale. However, you can submit a survey with custom rating scale. You can check out the [sample application](https://github.com/Azure-Samples/communication-services-web-calling-tutorial/blob/main/Project/src/MakeCall/CallSurvey.js) for the sample API usage.
4848

4949

5050
### Rate call only - no custom scale
@@ -85,7 +85,7 @@ call.feature(Features.CallSurvey).submitSurvey({
8585
```
8686

8787
### Handle errors the SDK can send
88-
``` javascript
88+
``` javascript
8989
call.feature(Features.CallSurvey).submitSurvey({
9090
overallRating: { score: 3 }
9191
}).catch((e) => console.log('error when submitting survey: ' + e))
@@ -95,7 +95,7 @@ call.feature(Features.CallSurvey).submitSurvey({
9595

9696
## Find different types of errors
9797

98-
98+
9999

100100
### Failures while submitting survey:
101101

@@ -126,7 +126,7 @@ The API will return the following error messages if data validation fails or the
126126
```
127127

128128
- One 408 (timeout) when event discarded:
129-
129+
130130
```
131131
{ message: "Please try again.", code: 408 }
132132
```
@@ -137,15 +137,15 @@ The API will return the following error messages if data validation fails or the
137137
### Default survey API configuration
138138

139139
| API Rating Categories | Cutoff Value* | Input Range | Comments |
140-
| ----------- | ----------- | -------- | -------- |
140+
| ----------- | ----------- | -------- | -------- |
141141
| Overall Call | 2 | 1 - 5 | Surveys a calling participant’s overall quality experience on a scale of 1-5. A response of 1 indicates an imperfect call experience and 5 indicates a perfect call. The cutoff value of 2 means that a customer response of 1 or 2 indicates a less than perfect call experience. |
142142
| Audio | 2 | 1 - 5 | A response of 1 indicates an imperfect audio experience and 5 indicates no audio issues were experienced. |
143143
| Video | 2 | 1 - 5 | A response of 1 indicates an imperfect video experience and 5 indicates no video issues were experienced. |
144144
| Screenshare | 2 | 1 - 5 | A response of 1 indicates an imperfect screen share experience and 5 indicates no screen share issues were experienced. |
145145

146146

147147

148-
> [!NOTE]
148+
> [!NOTE]
149149
>A question’s indicated cutoff value in the API is the threshold that Microsoft uses when analyzing your survey data. When you customize the cutoff value or Input Range, Microsoft analyzes your survey data according to your customization.
150150
151151

@@ -167,17 +167,17 @@ about their audio, video, and screen share experience. You can also
167167
customize input ranges to suit your needs. The default input range is 1
168168
to 5 for Overall Call, Audio, Video, and
169169
Screenshare. However, each API value can be customized from a minimum of
170-
0 to maximum of 100.
170+
0 to maximum of 100.
171171

172172
### Customization examples
173173

174174

175175
| API Rating Categories | Cutoff Value* | Input Range |
176-
| ----------- | ----------- | -------- |
177-
| Overall Call | 0 - 100 | 0 - 100 |
178-
| Audio | 0 - 100 | 0 - 100 |
179-
| Video | 0 - 100 | 0 - 100 |
180-
| Screenshare | 0 - 100 | 0 - 100 |
176+
| ----------- | ----------- | -------- |
177+
| Overall Call | 0 - 100 | 0 - 100 |
178+
| Audio | 0 - 100 | 0 - 100 |
179+
| Video | 0 - 100 | 0 - 100 |
180+
| Screenshare | 0 - 100 | 0 - 100 |
181181

182182
> [!NOTE]
183183
> A question’s indicated cutoff value in the API is the threshold that Microsoft uses when analyzing your survey data. When you customize the cutoff value or Input Range, Microsoft analyzes your survey data according to your customization.
@@ -189,11 +189,11 @@ In addition to using the End of Call Survey API you can create your own survey q
189189
- Build a UI in your application that will serve custom questions to the user and gather their input, lets assume that your application gathered responses as a string in the `improvementSuggestion` variable
190190

191191
- Submit survey results to ACS and send user response using App Insights:
192-
``` javascript
193-
currentCall.feature(SDK.Features.CallSurvey).submitSurvey(survey).then(res => {
194-
// `improvementSuggesstion` contains custom, user response
192+
``` javascript
193+
currentCall.feature(SDK.Features.CallSurvey).submitSurvey(survey).then(res => {
194+
// `improvementSuggesstion` contains custom, user response
195195
if (improvementSuggestion !== '') {
196-
appInsights.trackEvent({
196+
appInsights.trackEvent({
197197
name: "CallSurvey", properties: {
198198
// Survey ID to correlate the survey
199199
id: res.id,
@@ -202,9 +202,9 @@ In addition to using the End of Call Survey API you can create your own survey q
202202
}
203203
});
204204
}
205-
});
206-
appInsights.flush();
207-
```
205+
});
206+
appInsights.flush();
207+
```
208208
User responses that were sent using AppInsights are available under your App Insights workspace. You can use [Workbooks](../../update-center/workbooks.md) to query between multiple resources, correlate call ratings and custom survey data. Steps to correlate the call ratings and custom survey data:
209209
- Create new [Workbooks](../../update-center/workbooks.md) (Your ACS Resource -> Monitoring -> Workbooks -> New) and query Call Survey data from your ACS resource.
210210
- Add new query (+Add -> Add query)
@@ -234,34 +234,33 @@ User responses that were sent using AppInsights are available under your App Ins
234234

235235
> [!IMPORTANT]
236236
> You must enable a Diagnostic Setting in Azure Monitor to send the log data of your surveys to a Log Analytics workspace, Event Hubs, or an Azure storage account to receive and analyze your survey data. If you do not send survey data to one of these options your survey data will not be stored and will be lost. To enable these logs for your Communications Services, see: [End of Call Survey Logs](../concepts/analytics/logs/end-of-call-survey-logs.md)
237-
238237

239238
### View survey data with a Log Analytics workspace
240239

241-
You need to enable a Log Analytics Workspace to both store the log data of your surveys and access survey results. To enable these logs for your Communications Service, see: [End of Call Survey Logs](../concepts/analytics/logs/end-of-call-survey-logs.md).
240+
You need to enable a Log Analytics Workspace to both store the log data of your surveys and access survey results. To enable these logs for your Communications Service, see: [End of Call Survey Logs](../concepts/analytics/logs/end-of-call-survey-logs.md).
242241

243-
- You can also integrate your Log Analytics workspace with Power BI, see: [Integrate Log Analytics with Power BI](../../../articles/azure-monitor/logs/log-powerbi.md).
242+
- You can also integrate your Log Analytics workspace with Power BI, see: [Integrate Log Analytics with Power BI](../../../articles/azure-monitor/logs/log-powerbi.md).
244243

245244
## Best practices
246245
Here are our recommended survey flows and suggested question prompts for consideration. Your development can use our recommendation or use customized question prompts and flows for your visual interface.
247246

248247
**Question 1:** How did the users perceive their overall call quality experience?
249-
We recommend you start the survey by only asking about the participants’ overall quality. If you separate the first and second questions, it helps to only collect responses to Audio, Video, and Screen Share issues if a survey participant indicates they experienced call quality issues.
248+
We recommend you start the survey by only asking about the participants’ overall quality. If you separate the first and second questions, it helps to only collect responses to Audio, Video, and Screen Share issues if a survey participant indicates they experienced call quality issues.
250249

251250

252-
- Suggested prompt: “How was the call quality?”
253-
- API Question Values: Overall Call
251+
- Suggested prompt: “How was the call quality?
252+
- API Question Values: Overall Call
254253

255254
**Question 2:** Did the user perceive any Audio, Video, or Screen Sharing issues in the call?
256255
If a survey participant responded to Question 1 with a score at or below the cutoff value for the overall call, then present the second question.
257256

258-
- Suggested prompt: “What could have been better?”
259-
- API Question Values: Audio, Video, and Screenshare
257+
- Suggested prompt: “What could have been better?
258+
- API Question Values: Audio, Video, and Screenshare
260259

261260
### Surveying Guidelines
262-
- Avoid survey burnout, don’t survey all call participants.
263-
- The order of your questions matters. We recommend you randomize the sequence of optional tags in Question 2 in case respondents focus most of their feedback on the first prompt they visually see.
264-
- Consider using surveys for separate Azure Communication Services Resources in controlled experiments to identify release impacts.
261+
- Avoid survey burnout, don’t survey all call participants.
262+
- The order of your questions matters. We recommend you randomize the sequence of optional tags in Question 2 in case respondents focus most of their feedback on the first prompt they visually see.
263+
- Consider using surveys for separate Azure Communication Services Resources in controlled experiments to identify release impacts.
265264

266265

267266
## Next steps
@@ -270,6 +269,6 @@ If a survey participant responded to Question 1 with a score at or below the cut
270269

271270
- Learn more about the End of Call Survey, see: [End of Call Survey overview](../concepts/voice-video-calling/end-of-call-survey-concept.md)
272271

273-
- Learn how to use the Log Analytics workspace, see: [Log Analytics Tutorial](../../../articles/azure-monitor/logs/log-analytics-tutorial.md)
272+
- Learn how to use the Log Analytics workspace, see: [Log Analytics Tutorial](../../../articles/azure-monitor/logs/log-analytics-tutorial.md)
274273

275-
- Create your own queries in Log Analytics, see: [Get Started Queries](../../../articles/azure-monitor/logs/get-started-queries.md)
274+
- Create your own queries in Log Analytics, see: [Get Started Queries](../../../articles/azure-monitor/logs/get-started-queries.md)

articles/cosmos-db/cassandra/troubleshoot-nohostavailable-exception.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,15 +12,15 @@ ms.custom: ignite-2022
1212
---
1313

1414
# Troubleshoot NoHostAvailableException and NoNodeAvailableException
15-
NoHostAvailableException is a top-level wrapper exception with many possible causes and inner exceptions, many of which can be client-related. This exception tends to occur if there are some issues with the cluster or connection settings, or if one or more Cassandra nodes are unavailable.
15+
NoHostAvailableException is a top-level wrapper exception with many possible causes and inner exceptions, many of which can be client-related. This exception tends to occur if there are some issues with the cluster or connection settings, or if one or more Cassandra nodes are unavailable.
1616

1717
This article explores possible reasons for this exception, and it discusses specific details about the client driver that's being used.
1818

1919
## Driver settings
2020
One of the most common causes of NoHostAvailableException is the default driver settings. We recommend that you use the [settings](#code-sample) listed at the end of this article. Here is some explanatory information:
2121

2222
- The default value of the connections per host is 1, which we don't recommend for Azure Cosmos DB. We do recommend a minimum value of 10. Although more aggregated Request Units (RU) are provided, increase the connection count. The general guideline is 10 connections per 200,000 RU.
23-
- Use the Azure Cosmos DB retry policy to handle intermittent throttling responses. For more information, see the Azure Cosmos DB extension libraries:
23+
- Use the Azure Cosmos DB retry policy to handle intermittent throttling responses. For more information, see the Azure Cosmos DB extension libraries:
2424
- [Driver 3 extension library](https://github.com/Azure/azure-cosmos-cassandra-extensions)
2525
- [Driver 4 extension library](https://github.com/Azure/azure-cosmos-cassandra-extensions/tree/release/java-driver-4/1.0.1)
2626
- For multi-region accounts, use the Azure Cosmos DB load-balancing policy in the extension.
@@ -54,7 +54,7 @@ Apply one of the following options:
5454

5555
### All hosts tried for query failed
5656
When the client is set to connect to a region other than the primary contact point region, during the initial few seconds at startup, you'll get one of the following exception messages:
57-
57+
5858
- For Java driver 3: `Exception in thread "main" com.datastax.driver.core.exceptions.NoHostAvailableException: All host(s) tried for query failed (no host was tried)at [email protected]/com.datastax.driver.core.exceptions.NoHostAvailableException.copy(NoHostAvailableException.java:83)`
5959

6060
- For Java driver 4: `No node was available to execute the query`
@@ -76,29 +76,29 @@ Use CosmosLoadBalancingPolicy in [Java driver 3](https://github.com/Azure/azure-
7676
// https://docs.datastax.com/en/developer/java-driver/3.6/manual/socket_options/
7777
SocketOptions socketOptions = new SocketOptions()
7878
.setReadTimeoutMillis(90000); // default 12000
79-
79+
8080
// connection pooling options (default values are 1s)
8181
// https://docs.datastax.com/en/developer/java-driver/3.6/manual/pooling/
8282
PoolingOptions poolingOptions = new PoolingOptions()
8383
.setCoreConnectionsPerHost(HostDistance.LOCAL, 10) // default 1
8484
.setMaxConnectionsPerHost(HostDistance.LOCAL, 10) // default 1
8585
.setCoreConnectionsPerHost(HostDistance.REMOTE, 10) // default 1
8686
.setMaxConnectionsPerHost(HostDistance.REMOTE, 10); //default 1
87-
87+
8888
// Azure Cosmos DB load balancing policy
8989
String Region = "West US";
9090
CosmosLoadBalancingPolicy cosmosLoadBalancingPolicy = CosmosLoadBalancingPolicy.builder()
9191
.withWriteDC(Region)
9292
.withReadDC(Region)
9393
.build();
94-
94+
9595
// Azure Cosmos DB retry policy
9696
CosmosRetryPolicy retryPolicy = CosmosRetryPolicy.builder()
9797
.withFixedBackOffTimeInMillis(5000)
9898
.withGrowingBackOffTimeInMillis(1000)
9999
.withMaxRetryCount(5)
100100
.build();
101-
101+
102102
Cluster cluster = Cluster.builder()
103103
.addContactPoint(EndPoint).withPort(10350)
104104
.withCredentials(UserName, Password)
@@ -115,7 +115,7 @@ Use CosmosLoadBalancingPolicy in [Java driver 3](https://github.com/Azure/azure-
115115
// driver configurations
116116
// https://docs.datastax.com/en/developer/java-driver/4.6/manual/core/configuration/
117117
ProgrammaticDriverConfigLoaderBuilder configBuilder = DriverConfigLoader.programmaticBuilder();
118-
118+
119119
// connection settings
120120
// https://docs.datastax.com/en/developer/java-driver/4.6/manual/core/pooling/
121121
configBuilder
@@ -124,7 +124,7 @@ Use CosmosLoadBalancingPolicy in [Java driver 3](https://github.com/Azure/azure-
124124
.withDuration(DefaultDriverOption.REQUEST_TIMEOUT, Duration.ofSeconds(90)) // default 2
125125
.withClass(DefaultDriverOption.RECONNECTION_POLICY_CLASS, ConstantReconnectionPolicy.class) // default ExponentialReconnectionPolicy
126126
.withBoolean(DefaultDriverOption.METADATA_TOKEN_MAP_ENABLED, false); // default true
127-
127+
128128
// load balancing settings
129129
// https://docs.datastax.com/en/developer/java-driver/4.6/manual/core/load_balancing/
130130
String Region = "West US";
@@ -138,7 +138,7 @@ Use CosmosLoadBalancingPolicy in [Java driver 3](https://github.com/Azure/azure-
138138
// retry policy
139139
// https://docs.datastax.com/en/developer/java-driver/4.6/manual/core/retries/
140140
configBuilder
141-
.withClass(DefaultDriverOption.RETRY_POLICY_CLASS, CosmosRetryPolicy.class)
141+
.withClass(DefaultDriverOption.RETRY_POLICY_CLASS, CosmosRetryPolicy.class)
142142
.withInt(CosmosRetryPolicyOption.FIXED_BACKOFF_TIME, 5000)
143143
.withInt(CosmosRetryPolicyOption.GROWING_BACKOFF_TIME, 1000)
144144
.withInt(CosmosRetryPolicyOption.MAX_RETRIES, 5);

articles/cosmos-db/postgresql/reference-metadata.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -411,7 +411,7 @@ function.
411411

412412
- Setting a node capacity exception by hostname pattern:
413413

414-
```postgresql
414+
```postgresql
415415
CREATE FUNCTION v2_node_double_capacity(nodeidarg int)
416416
RETURNS boolean AS $$
417417
SELECT

0 commit comments

Comments
 (0)