Manage a bot
APPLIES TO: SDK v4
In your browser, navigate to the Azure portal. Select your bot resource, such as an Azure Bot. On the navigation pane you'll see the sections described below.
Azure Bot resource settings
The Azure Bot resource contains the settings described below.
General
At the top of the navigation pane are links for general information applicable to a bot.
| Link | Description |
|---|---|
| Overview | Contains high level information about the bot, such as a bot's Subscription ID and Messaging endpoint. On the overview pane, you can also download the bot source code. |
| Activity log | Provides detailed diagnostic and auditing information for Azure resources and the Azure platform they depend on. For more information, see Overview of Azure platform logs. |
| Access control (IAM) | Displays the access users or other security principals have to Azure resources. For more information, see View the access a user has to Azure resources. |
| Tags | Displays the tags to your Azure resources, resource groups, and subscriptions to logically organize them into a taxonomy. For more information, see Use tags to organize your Azure resources. |
Settings
In the Settings section are links for most of your bot's management options.
| Link | Description |
|---|---|
| Bot profile | Manages various bot profile settings, such as display name, icon, and description. |
| Configuration | Manages various bot settings, such as analytics, messaging endpoint, and OAuth connection settings. |
| Channels | Configures the channels your bot uses to communicate with users. |
| Pricing | Manages the pricing tier for the bot service. |
| Test in Web Chat | Uses the integrated Web Chat control to quickly test your bot. |
| Encryption | Manages your encryption keys. |
| Properties | Lists your bot resource properties, such as resource ID, subscription ID, and resource group ID. |
| Locks | Manages your resource locks. |
Monitoring
In the Monitoring section are links for most of your bot's monitoring options.
| Link | Description |
|---|---|
| Conversational analytics | Enables analytics to view the collected data with Application Insights. This Analytics blade will be deprecated. For more information, see Add telemetry to your bot and Analyze your bot's telemetry data. |
| Alerts | Configure alert rules and attend to fired alerts to efficiently monitor your Azure resources. For more information, see Overview of alerts in Microsoft Azure. |
| Metrics | Select a metric to see data in the proper chart. |
| Diagnostic settings | Diagnostic settings are used to configure streaming export of platform logs and metrics for a resource to the destination of your choice. For more information,see diagnostic settings. |
| Logs | Produce insights from Azure Monitor logs. |
Application service settings
A bot application, also known as an application service (App Service), has a set of application settings that you can access through the Azure portal. They're environment variables passed to the bot application code. For more information, see Configure an App Service app in the Azure portal.
- In your browser, navigate to the Azure portal.
- Search for your bot app service and select its name.
- The bot app service information is displayed.
Bot identity information
Follow these steps to add identity information to your bot's configuration file. The file differs depending on the programming language you use to create the bot.
Important
The Java version of the Bot Framework SDK only supports multi-tenant bots. The C#, JavaScript, and Python versions support all three application types for managing the bot's identity.
| Language | File name | Notes |
|---|---|---|
| C# | appsettings.json | Supports all three application types for managing your bot's identity. |
| JavaScript | .env | Supports all three application types for managing your bot's identity. |
| Java | application.properties | Only supports multi-tenant bots. |
| Python | config.py | Supports all three application types for managing your bot's identity. |
The identity information you need to add depends on the bot's application type. Provide the following values in your configuration file.
Available for C#, JavaScript, and Python bots.
| Property | Value |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
The client ID of the user-assigned managed identity. |
MicrosoftAppPassword |
Not applicable. Leave this blank for a user-assigned managed identity bot. |
MicrosoftAppTenantId |
The tenant ID of the user-assigned managed identity. |
Next steps
Now that you've explored the Bot Service blade in the Azure portal, learn about the Bot Framework Service, how bots communicate with users, and about activities, channels, HTTP POST requests, and more.