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.

  1. In your browser, navigate to the Azure portal.
  2. Search for your bot app service and select its name.
  3. 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 and Python versions of the Bot Framework SDK only support multi-tenant bots. The C# and JavaScript 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 Only supports multi-tenant bots. Provide the identity properties as arguments to the os.environ.get method calls.

The identity information you need to add depends on the bot's application type. Provide the following values in your configuration file.

Only available for C# and JavaScript 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.