Share via


Enable Application Insights support in Copilot Studio

Enable Application Insights support in Copilot Studio Kit to enhance telemetry, monitor performance, and diagnose issues. Follow the step-by-step instructions to set up and configure Application Insights for your environment.

Prerequisite

An Application Insights resource that you created and an agent configured to send telemetry to it. Learn more in Connect your Copilot Studio copilot to Application Insights.

Register a new application in Azure portal

To enable Application Insights support in Copilot Studio Kit, register a new application in Microsoft Azure portal.

Note

If you already created an app registration for Copilot Studio Kit to use with user authentication, you can reuse that application for App Insights Results Enrichment instead of creating a new one. If that's the case, you can skip to step 3 after navigating to the existing app registration in Azure portal.

  1. Sign in to Azure portal

  2. Register a new application and add a new client secret for it. Make a note of the secret to use it as the App Insights Secret in the agent configuration (depending on the App Insights Secret Location configured).

  3. Note the Directory (tenant) and Application (client) IDs of the application to use them as the App Insights Tenant ID and App Insights Client ID in the agent configuration.

  4. Select View API permissions from Overview (or navigate to Manage > API permissions from the sidebar).

  5. Select Add a permission.

  6. Select APIs my organization uses and search for Application Insights API. Select Application Insights API from the list.

  7. Select Delegated permissions.

  8. Check Data.Read and proceed with Add permissions.

Screenshot of the Request API permissions view in Microsoft Azure portal.

Provide access to Application Insights resource

Grant your registered application access to the Application Insights resource:

  1. Go to the Application Insights resource in the Azure portal.
  2. Select Access control (IAM).
  3. Select Add role assignment.
  4. Select Reader from the list and select Next.
  5. Select Select members.
  6. Search and select your application from the list. Finish by selecting Select.
  7. Select Next to go to Review + assign.
  8. Review the permissions and select Review + assign at the bottom of the screen.

More information: Assign Azure roles using the Azure portal

Locate AppId

Make note of the AppId of your Application Insights resource to use it as the App Insights Application ID in the agent configuration.

To obtain the AppId:

  1. Go to your Application Insights resource from the Overview page of Azure portal.

  2. Select JSON View.

    Screenshot of a resource's Overview page in Microsoft Azure with JSON View highlighted in the upper right.

  3. In the JSON view that opens, find and note the value in properties.AppId. You can also find the same Application ID from Configure > API Access.

    Screenshot of the Resource JSON screen in Microsoft Azure with the AppId property highlighted.