如何在Application Insights中排除Api Management Service特定404故障日志

核心思路 #

通过Azure API Management（APIM）的出站策略，针对特定端点的404响应修改遥测属性，让Application Insights将其判定为成功请求，而非故障。

具体实现步骤 #

1. 登录Azure门户，进入你的APIM实例。
2. 定位到需要调整的目标API或具体端点。
3. 在该端点的设计标签页中，编辑出站策略，添加以下配置：

<outbound>
    <!-- 匹配目标端点路径（示例为/api/resources/{id}，请替换为实际路径） -->
    <choose>
        <when condition="@(context.Request.Path.ToString().StartsWith("/api/resources/") && context.Response.StatusCode == 404)">
            <!-- 将遥测的success属性设为true，避免被标记为故障 -->
            <set-telemetry-properties>
                <property name="success" value="true" />
            </set-telemetry-properties>
        </when>
    </choose>
    <!-- 保留原有出站策略逻辑 -->
    <base />
</outbound>

配置说明 #

• 路径匹配：修改context.Request.Path.ToString().StartsWith("/api/resources/")中的路径，确保只匹配你需要排除的特定端点，避免影响其他返回404的故障场景。
• 条件扩展：如果需要更精准的控制，可以结合请求方法（如context.Request.Method == "GET"）或其他请求属性来完善判断条件。
• 生效逻辑：当满足条件时，success属性会被覆盖为true，Application Insights接收遥测数据时会将该请求判定为成功，不再计入故障统计。

验证方式 #

配置完成后，触发目标端点返回404的场景，查看Application Insights的失败请求面板，确认该请求不再被标记为故障。

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