如何通过Bicep将Workbook与Application Insights等Azure资源关联？

一、关联Application Insights #

Workbook与Application Insights的关联核心是设置Workbook的sourceId属性为Application Insights的资源ID，无需额外配置。将两个资源放在同一个Bicep文件中，让Workbook直接引用AI的资源ID，部署时就能自动完成关联：

整合后的Bicep代码 #

// Application Insights 资源
@description('Application Insights 资源名称')
param appName string

@description('应用类型（兼容遗留字段，不影响实际部署）')
param appType string = 'web'

@description('部署区域')
param regionId string

@description('ARM部署来源标识')
param requestSource string

@description('关联的Log Analytics工作区ID')
param workspaceResourceId string

resource applicationInsights 'Microsoft.Insights/components@2020-02-02' = {
  name: appName
  location: regionId
  kind: 'other'
  properties: {
    Application_Type: appType
    Flow_Type: 'Bluefield'
    Request_Source: requestSource
    WorkspaceResourceId: workspaceResourceId
  }
}

// Workbook 资源
@description('Workbook实例的唯一GUID')
param workbookId string

@description('Workbook部署区域（建议和AI同区域）')
param workbookLocation string = regionId

@description('Workbook显示名称（资源组内需唯一）')
param workbookName string

@description('Workbook所属分类，可选值：workbook、tsg、Azure Monitor等')
param workbookType string = 'workbook'

resource workbook 'Microsoft.Insights/workbooks@2022-04-01' = {
  name: workbookId
  location: workbookLocation
  kind: 'shared'
  properties: {
    displayName: workbookName
    serializedData: '{"version":"Notebook/1.0","items":[{"type":1,"content":"{\\"json\\":\\"Hello World!\\"}","conditionalVisibility":null}],"isLocked":false}'
    version: '1.0'
    // 直接绑定Application Insights的资源ID，完成关联
    sourceId: applicationInsights.id
    category: workbookType
  }
}

// 输出资源ID，方便后续使用
output appInsightsResourceId string = applicationInsights.id
output workbookResourceId string = workbook.id

部署完成后，在Application Insights的左侧菜单「工作簿」中就能找到这个关联的Workbook。

二、关联App Service或其他资源 #

如果要关联App Service、VM、存储账户等其他Azure资源，逻辑完全一致——把Workbook的sourceId替换为目标资源的ID即可。以下是关联App Service的示例代码：

// App Service 资源
@description('App Service名称')
param appServiceName string

@description('部署区域')
param regionId string

@description('关联的App Service计划ID')
param appServicePlanId string

resource appService 'Microsoft.Web/sites@2022-09-01' = {
  name: appServiceName
  location: regionId
  properties: {
    serverFarmId: appServicePlanId
    httpsOnly: true
  }
}

// Workbook 资源
@description('Workbook实例唯一GUID')
param workbookId string

@description('Workbook显示名称')
param workbookName string

resource workbook 'Microsoft.Insights/workbooks@2022-04-01' = {
  name: workbookId
  location: regionId
  kind: 'shared'
  properties: {
    displayName: workbookName
    serializedData: '{"version":"Notebook/1.0","items":[{"type":1,"content":"{\\"json\\":\\"Hello World!\\"}","conditionalVisibility":null}],"isLocked":false}'
    version: '1.0'
    // 关联App Service的资源ID
    sourceId: appService.id
    category: 'workbook'
  }
}

关联后，Workbook会出现在对应资源的「工作簿」菜单下，无需额外配置。

流水线部署提醒 #

• 确保流水线使用的服务主体有部署Microsoft.Insights/workbooks和目标资源的权限
• 可以将workbookId、资源名称这类参数通过流水线变量传入，避免硬编码
• Workbook尽量和目标资源部署在同一区域，提升加载速度

内容的提问来源于stack exchange，提问作者Jennifer M.