能否用Invoke-AzOperationalInsightsQuery查询Azure APIM网关日志

你找不到对应Log Analytics工作区ID的根本原因是：API Management的「日志」边栏存在两种底层实现：

• 当你提前给APIM配置了指向独立Log Analytics工作区的诊断设置时，边栏会直接加载对应工作区的数据，此时确实存在可被Invoke-AzOperationalInsightsQuery调用的工作区ID
• 当你未配置诊断设置时，边栏只是复用了Log Analytics的前端交互界面，底层对接的是APIM内置的日志存储，不存在独立的Log Analytics工作区资源，自然无法通过原有命令查询。你在自有LA工作区中找不到ApiManagementGatewayLogs表，就属于第二种场景。

方案1：对接独立Log Analytics工作区（适配原有命令） #

如果需要沿用Invoke-AzOperationalInsightsQuery命令，先给APIM配置诊断规则即可：

1. 执行以下命令检查APIM现有诊断配置：

   Get-AzDiagnosticSetting -ResourceId "/subscriptions/<订阅ID>/resourceGroups/<APIM所属资源组>/providers/Microsoft.ApiManagement/service/<APIM服务名>"
   

2. 若返回结果中无指向Log Analytics工作区的日志规则，新建诊断规则，勾选ApiManagementGatewayLogs等需要的日志类别，指定到你有权限的Log Analytics工作区。
3. 等待10-15分钟日志同步完成后，目标LA工作区会自动生成ApiManagementGatewayLogs表，直接使用该工作区ID调用原有命令即可正常查询。

方案2：直接查询APIM内置存储（无需独立LA工作区） #

不需要额外配置诊断规则，直接调用Azure Monitor原生查询接口即可在PowerShell中执行KQL查询，和APIM日志边栏的查询能力完全一致，示例代码如下：

# 登录并选择对应订阅
Connect-AzAccount
Set-AzContext -SubscriptionId "<订阅ID>"

# 配置查询参数
$apimResourceId = "/subscriptions/<订阅ID>/resourceGroups/<APIM所属资源组>/providers/Microsoft.ApiManagement/service/<APIM服务名>"
$query = "ApiManagementGatewayLogs | where TimeGenerated > ago(1h) | take 20" # 替换为自定义KQL语句
$requestUri = "https://management.azure.com$($apimResourceId)/providers/Microsoft.Insights/query?api-version=2022-10-01"

# 发起请求并解析结果
$requestBody = @{ query = $query } | ConvertTo-Json
$response = Invoke-AzRestMethod -Method Post -Uri $requestUri -Payload $requestBody
$queryResult = $response.Content | ConvertFrom-Json

# 输出查询结果，$queryResult.tables[0].columns为列定义，$queryResult.tables[0].rows为具体日志行
$queryResult.tables[0].rows

• APIM内置日志默认保留期为15天，超期日志会自动清理；如果需要更长保留期，建议使用方案1将日志转发到独立Log Analytics工作区。
• 执行查询的身份（账号/服务主体）需要对APIM实例拥有监控读取权限，即至少分配Monitoring Reader角色。

内容的提问来源于stack exchange，提问作者user416593