Skip to content

Commit 8a6cfdf

Browse files
authored
Merge pull request #271569 from MicrosoftDocs/main
4/9 11:00 AM IST Publish
2 parents 3d09600 + 5f7e01f commit 8a6cfdf

File tree

62 files changed

+1569
-1256
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

62 files changed

+1569
-1256
lines changed

articles/ai-services/speech-service/whisper-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Whisper Model via Azure AI Speech might be best for:
6161

6262
Regional support is another consideration.
6363
- The Whisper model via Azure OpenAI Service is available in the following regions: EastUS 2, India South, North Central, Norway East, Sweden Central, and West Europe.
64-
- The Whisper model via Azure AI Speech is available in the following regions: Australia East, Central US, East US, North Central US, South Central US, Southeast Asia, and West Europe.
64+
- The Whisper model via Azure AI Speech is available in the following regions: Australia East, East US, North Central US, South Central US, Southeast Asia, UK South, and West Europe.
6565

6666
## Next steps
6767

articles/ai-studio/tutorials/deploy-chat-web-app.md

Lines changed: 1 addition & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ ms.service: azure-ai-studio
77
ms.custom:
88
- ignite-2023
99
ms.topic: tutorial
10-
ms.date: 2/8/2024
10+
ms.date: 4/8/2024
1111
ms.reviewer: eur
1212
ms.author: aahi
1313
author: aahill
@@ -219,14 +219,6 @@ To avoid incurring unnecessary Azure costs, you should delete the resources you
219219

220220
## Remarks
221221

222-
### Remarks about adding your data
223-
224-
Although it's beyond the scope of this tutorial, to understand more about how the model uses your data, you can export the playground setup to prompt flow.
225-
226-
:::image type="content" source="../media/tutorials/chat-web-app/prompt-flow-open.png" alt-text="Screenshot of the chat playground with the open in prompt flow button in view." lightbox="../media/tutorials/chat-web-app/prompt-flow-open.png":::
227-
228-
Following through from there you can see the graphical representation of how the model uses your data to construct the response. For more information about prompt flow, see [prompt flow](../how-to/prompt-flow.md).
229-
230222
### Chat history
231223

232224
With the chat history feature, your users will have access to their individual previous queries and responses.

articles/aks/upgrade-aks-cluster.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ When you perform an upgrade from an *unsupported version* that skips two or more
2525
* If you're using the Azure CLI, this article requires Azure CLI version 2.34.1 or later. Run `az --version` to find the version. If you need to install or upgrade, see [Install Azure CLI][azure-cli-install].
2626
* If you're using Azure PowerShell, this article requires Azure PowerShell version 5.9.0 or later. Run `Get-InstalledModule -Name Az` to find the version. If you need to install or upgrade, see [Install Azure PowerShell][azure-powershell-install].
2727
* Performing upgrade operations requires the `Microsoft.ContainerService/managedClusters/agentPools/write` RBAC role. For more on Azure RBAC roles, see the [Azure resource provider operations][azure-rp-operations].
28+
* Starting with 1.30 kubernetes version and 1.27 LTS versions the beta apis will be disabled by default when you upgrade to them.
2829

2930
> [!WARNING]
3031
> An AKS cluster upgrade triggers a cordon and drain of your nodes. If you have a low compute quota available, the upgrade might fail. For more information, see [increase quotas](../azure-portal/supportability/regional-quota-requests.md).
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
---
2+
title: SSH access to Azure Arc-enabled servers with PowerShell remoting
3+
description: Use PowerShell remoting over SSH to access and manage Azure Arc-enabled servers.
4+
ms.date: 04/08/2024
5+
ms.topic: conceptual
6+
ms.custom: references_regions
7+
---
8+
9+
# PowerShell remoting to Azure Arc-enabled servers
10+
SSH for Arc-enabled servers enables SSH based connections to Arc-enabled servers without requiring a public IP address or additional open ports.
11+
[PowerShell remoting over SSH](/powershell/scripting/security/remoting/ssh-remoting-in-powershell) is available for Windows and Linux machines.
12+
13+
## Prerequisites
14+
To leverage PowerShell remoting over SSH access to Azure Arc-enabled servers, ensure the following:
15+
- Ensure the requirements for SSH access to Azure Arc-enabled servers are met.
16+
- Ensure the requirements for PowerShell remoting over SSH are met.
17+
- The Azure PowerShell module or the Azure CLI extension for connecting to Arc machines is present on the client machine.
18+
19+
## How to connect via PowerShell remoting
20+
Follow the below steps to connect via PowerShell remoting to an Arc-enabled server.
21+
22+
#### [Generate a SSH config file with Azure CLI:](#tab/azure-cli)
23+
```bash
24+
az ssh config --resource-group <myRG> --name <myMachine> --local-user <localUser> --resource-type Microsoft.HybridCompute --file <SSH config file>
25+
```
26+
27+
#### [Generate a SSH config file with Azure PowerShell:](#tab/azure-powershell)
28+
```powershell
29+
Export-AzSshConfig -ResourceGroupName <myRG> -Name <myMachine> -LocalUser <localUser> -ResourceType Microsoft.HybridCompute/machines -ConfigFilePath <SSH config file>
30+
```
31+
---
32+
33+
#### Find newly created entry in the SSH config file
34+
Open the created or modified SSH config file. The entry should have a similar format to the following.
35+
```powershell
36+
Host <myRG>-<myMachine>-<localUser>
37+
HostName <myMachine>
38+
User <localUser>
39+
ProxyCommand "<path to proxy>\.clientsshproxy\sshProxy_windows_amd64_1_3_022941.exe" -r "<path to relay info>\az_ssh_config\<myRG>-<myMachine>\<myRG>-<myMachine>-relay_info"
40+
```
41+
#### Leveraging the -Options parameter
42+
Levering the [options](/powershell/module/microsoft.powershell.core/new-pssession#-options) parameter allows you to specify a hashtable of SSH options used when connecting to a remote SSH-based session.
43+
Create the hashtable by following the below format. Be mindful of the locations of quotation marks.
44+
```powershell
45+
$options = @{ProxyCommand = '"<path to proxy>\.clientsshproxy\sshProxy_windows_amd64_1_3_022941.exe -r <path to relay info>\az_ssh_config\<myRG>-<myMachine>\<myRG>-<myMachine>-relay_info"'}
46+
```
47+
Next leverage the options hashtable in a PowerShell remoting command.
48+
```powershell
49+
New-PSSession -HostName <myMachine> -UserName <localUser> -Options $options
50+
```
51+
52+
## Next steps
53+
54+
- Learn about [OpenSSH for Windows](/windows-server/administration/openssh/openssh_overview)
55+
- Learn about troubleshooting [SSH access to Azure Arc-enabled servers](ssh-arc-troubleshoot.md).
56+
- Learn about troubleshooting [agent connection issues](troubleshoot-agent-onboard.md).

articles/azure-arc/servers/toc.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -131,6 +131,8 @@
131131
items:
132132
- name: SSH access to Azure Arc-enabled servers
133133
href: ssh-arc-overview.md
134+
- name: PowerShell remoting to Azure Arc-enabled servers
135+
href: ssh-arc-powershell-remoting.md
134136
- name: Troubleshoot SSH access to Azure Arc-enabled servers
135137
href: ssh-arc-troubleshoot.md
136138
- name: Extended Security Updates
@@ -217,4 +219,4 @@
217219
- name: Regional availability
218220
href: https://azure.microsoft.com/explore/global-infrastructure/products-by-region/?products=azure-arc&regions=all
219221
- name: Product feedback
220-
href: https://feedback.azure.com/d365community/forum/5c778dec-0625-ec11-b6e6-000d3a4f0858
222+
href: https://feedback.azure.com/d365community/forum/5c778dec-0625-ec11-b6e6-000d3a4f0858

articles/azure-functions/durable/quickstart-netherite.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ If this isn't the case, we suggest you start with one of the following articles,
4242
> [!NOTE]
4343
> If your app uses [Extension Bundles](../functions-bindings-register.md#extension-bundles), you should ignore this section as Extension Bundles removes the need for manual Extension management.
4444
45-
You'll need to install the latest version of the Netherite Extension on NuGet. This usually means including a reference to it in your `.csproj` file and building the project.
45+
You need to install the latest version of the Netherite Extension on NuGet. This usually means including a reference to it in your `.csproj` file and building the project.
4646

4747
The Extension package to install depends on the .NET worker you are using:
4848
- For the _in-process_ .NET worker, install [`Microsoft.Azure.DurableTask.Netherite.AzureFunctions`](https://www.nuget.org/packages/Microsoft.Azure.DurableTask.Netherite.AzureFunctions).
@@ -93,7 +93,7 @@ Edit the storage provider section of the `host.json` file so it sets the `type`
9393
}
9494
```
9595

96-
The snippet above is just a *minimal* configuration. Later, you may want to consider [additional parameters](https://microsoft.github.io/durabletask-netherite/#/settings?id=typical-configuration).
96+
The snippet above is just a *minimal* configuration. Later, you may want to consider [other parameters](https://microsoft.github.io/durabletask-netherite/#/settings?id=typical-configuration).
9797

9898

9999
## Test locally
@@ -107,13 +107,16 @@ While the function app is running, Netherite will publish load information about
107107
> [!NOTE]
108108
> For more information on the contents of this table, see the [Partition Table](https://microsoft.github.io/durabletask-netherite/#/ptable) article.
109109
110+
> [!NOTE]
111+
> If you are using local storage emulation on a Windows OS, please ensure you're using the [Azurite](../../storage/common/storage-use-azurite.md) storage emulator and not the legacy "Azure Storage Emulator" component. Local storage emulation with Netherite is only supported via Azurite.
112+
110113
## Run your app on Azure
111114

112115
You need to create an Azure Functions app on Azure. To do this, follow the instructions in the **Create a function app** section of [these instructions](../functions-create-function-app-portal.md).
113116

114117
### Set up Event Hubs
115118

116-
You will need to set up an Event Hubs namespace to run Netherite on Azure. You can also set it up if you prefer to use Event Hubs during local development.
119+
You need to set up an Event Hubs namespace to run Netherite on Azure. You can also set it up if you prefer to use Event Hubs during local development.
117120

118121
> [!NOTE]
119122
> An Event Hubs namespace incurs an ongoing cost, whether or not it is being used by Durable Functions. Microsoft offers a [12-month free Azure subscription account](https://azure.microsoft.com/free/) if you’re exploring Azure for the first time.

articles/azure-monitor/app/app-insights-overview.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -215,6 +215,24 @@ Application Insights doesn't handle sensitive data by default, as long as you do
215215

216216
For archived information on this topic, see [Data collection, retention, and storage in Application Insights](/previous-versions/azure/azure-monitor/app/data-retention-privacy).
217217

218+
### What is the Application Insights pricing model?
219+
220+
Application Insights is billed through the Log Analytics workspace into which its log data ingested.
221+
The default Pay-as-you-go Log Analytics pricing tier includes 5 GB per month of free data allowance per billing account.
222+
Learn more about [Azure Monitor logs pricing options](https://azure.microsoft.com/pricing/details/monitor/).
223+
224+
### Are there data transfer charges between an Azure web app and Application Insights?
225+
226+
* If your Azure web app is hosted in a datacenter where there's an Application Insights collection endpoint, there's no charge.
227+
* If there's no collection endpoint in your host datacenter, your app's telemetry incurs [Azure outgoing charges](https://azure.microsoft.com/pricing/details/bandwidth/).
228+
229+
This answer depends on the distribution of our endpoints, *not* on where your Application Insights resource is hosted.
230+
231+
### Do I incur network costs if my Application Insights resource is monitoring an Azure resource (that is, telemetry producer) in a different region?
232+
233+
Yes, you may incur more network costs, which vary depending on the region the telemetry is coming from and where it's going.
234+
Refer to [Azure bandwidth pricing](https://azure.microsoft.com/pricing/details/bandwidth/) for details.
235+
218236
## Help and support
219237

220238
### Azure technical support
Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
title: General troubleshooting strategies - Overview
3+
titleSuffix: Azure Communication Services - Troubleshooting Guide
4+
description: Overview of general troubleshooting strategies
5+
author: enricohuang
6+
ms.author: enricohuang
7+
8+
services: azure-communication-services
9+
ms.date: 02/23/2024
10+
ms.topic: troubleshooting
11+
ms.service: azure-communication-services
12+
ms.subservice: calling
13+
---
14+
15+
# Overview of general troubleshooting strategies
16+
17+
Ensuring a satisfying experience during a call requires many elements to work together:
18+
19+
* stable network and hardware environment
20+
* good user interface design
21+
* timely feedback to the user on the current status and errors
22+
23+
To troubleshoot issues reported by users, it's important to identify where the issue is coming from.
24+
The issue could lie within the application, the SDK, or the user's environment such as device, network, or browser.
25+
26+
This article explores some debugging strategies that help you identify the root of the problem efficiently.
27+
28+
## Clarifying the issues reported by the users
29+
30+
First, you need to clarify the issues reported by the users.
31+
32+
Sometimes when users report issues, they may not accurately describe the problem, so there may be some ambiguity.
33+
For example, when users report experiencing a delay during a call,
34+
they may refer to a delay after the call is connected but before any sound is heard.
35+
Alternatively, they might refer to the delay experienced between two parties while they communicate with each other.
36+
37+
These two situations are different and require different approaches to identify and resolve the issue.
38+
It's important to gather more information from the user to understand the problem and address it accordingly.
39+
40+
## Understanding how often users and how many users encounter the issue
41+
42+
When the user reports an issue, we need to understand its reproducibility.
43+
Only happening once and always happening are different situations.
44+
45+
For some issues, you can also use [Call Diagnostics](../../../../concepts/voice-video-calling/call-diagnostics.md) tool and [Azure Monitor Log](../../../../concepts/analytics/logs/voice-and-video-logs.md) to understand how many users could have similar problems.
46+
47+
Understanding the issue reproducibility and how many users are affected can help you decide on the priority of the issue.
48+
49+
## Referring to documentation
50+
51+
The documentation for Azure Communication Services Calling SDK is rich and covers many subjects,
52+
including concept documents, quickstart guides, tutorials, known issues, and troubleshooting guides.
53+
54+
Take time to check the known issues and the service limitation page.
55+
Sometimes, the issues reported by users are due to limitations of the service itself. A good example would be the number of videos that can be viewed during a large meeting.
56+
The behavior of the user's browser or of its device could be the cause of the issue.
57+
58+
For example, when a mobile browser operates in the background or when the user phone is locked, it may exhibit various behaviors depending on the platform. The browser might cease sending video frames altogether or transmit solely black frames.
59+
60+
The troubleshooting guide, in particular, addresses various issues that may arise when using the ACS Calling SDK.
61+
You can check the list of common issues in the troubleshooting guide to see if there's a similar issue reported by the user,
62+
and follow the instructions provided to further troubleshoot the problem.
63+
64+
## Reporting an issue
65+
66+
If the issue reported by the user isn't present in the troubleshooting guide, consider reporting the issue.
67+
68+
In most cases, you need to provide the callId together with a clear description of the issue.
69+
If you're able to reproduce the issue, include details related to the issue. For instance,
70+
71+
* steps to reproduce the issue, including preconditions (platform, network conditions, and other information that might be helpful)
72+
* what result do you expect to see
73+
* what result do you actually see
74+
* reproducibility rate of the issue
75+
76+
For more information, see [Reporting an issue](./reporting-an-issue.md).
77+
78+
## Next steps
79+
80+
Besides the troubleshooting guide, here are some articles of interest to you.
81+
82+
* Learn how to [Optimizing Call Quality](../../../../concepts/voice-video-calling/manage-call-quality.md).
83+
* Learn more about [Call Diagnostics](../../../../concepts/voice-video-calling/call-diagnostics.md).
84+
* Learn more about [Troubleshooting VoIP Call Quality](../../../../concepts/voice-video-calling/troubleshoot-web-voip-quality.md).
85+
* See [Known issues](../../../../concepts/voice-video-calling/known-issues-webjs.md?pivots=all-browsers).
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
---
2+
title: General troubleshooting strategies - Reporting an issue
3+
titleSuffix: Azure Communication Services - Troubleshooting Guide
4+
description: Learn how to report an issue.
5+
author: enricohuang
6+
ms.author: enricohuang
7+
8+
services: azure-communication-services
9+
ms.date: 02/24/2024
10+
ms.topic: troubleshooting
11+
ms.service: azure-communication-services
12+
ms.subservice: calling
13+
---
14+
15+
# Reporting an issue
16+
17+
If the issue reported by the user can't be found in the troubleshooting guide, consider reporting the issue.
18+
19+
Sometimes the problem comes from the app itself.
20+
In this case, you can test the issue against the calling sample
21+
[https://github.com/Azure-Samples/communication-services-web-calling-tutorial](https://github.com/Azure-Samples/communication-services-web-calling-tutorial)
22+
to see if the problem can also be reproduced in the calling sample.
23+
24+
## Where to report the issue
25+
26+
When you want to report issues, there are several places to report them.
27+
You can refer to [Azure Support](../../../../support.md).
28+
29+
You can choose to create an Azure support ticket.
30+
Additionally, for the ACS Web Calling SDK, if you found an issue during development,
31+
you can also report it at [https://github.com/Azure/azure-sdk-for-js/issues](https://github.com/Azure/azure-sdk-for-js/issues).
32+
33+
## What to include when you report the issue
34+
35+
When reporting an issue, you need to provide a clear description of the issue, including:
36+
37+
* context
38+
* steps to reproduce the problem
39+
* expected results
40+
* actual results
41+
42+
In most cases, you also need to include details, such as
43+
44+
* environment
45+
* operation system and version
46+
* browser name and version
47+
* ACS SDK version
48+
* call info
49+
* `Call Id` (when the issue happened during a call)
50+
* `Participant Id` (if there were multiple participants in the call, but only some of them experienced the issue)
51+
52+
If you can only reproduce the issue on a specific device platform (for example, iPhone X), also include the device model when you report the issue.
53+
54+
Depending on the type of issue, we may ask you to provide logs when we investigate the issue.

0 commit comments

Comments
 (0)