你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将 OSDU 服务日志与 Azure Monitor 集成

项目
10/15/2024

Azure Data Manager for Energy 支持使用诊断设置将 OSDU 服务日志导出到 Azure Monitor。此功能可帮助你更好地对 OSDU 服务进行故障排除、调试和监视。此处的说明类似于如何将其他日志（如 Airflow 和 Elastic）与 Azure Monitor 集成。

先决条件

现有的 Log Analytics 工作区。此工作区用于使用 Log Analytics 工作区中的 Kusto 查询语言 (KQL) 查询编辑器查询 OSDU 服务日志。有用资源：在 Azure 门户中创建 Log Analytics 工作区。
现有存储帐户：用于存储 OSDU 服务日志的 JSON 转储。存储帐户不必与 Log Analytics 工作区在同一订阅中。

为 OSDU 服务日志集成启用诊断设置

打开 Microsoft Azure Data Manager for Energy 的概述页。
请从左侧面板中选择“诊断设置”。
选择“添加诊断设置”。选择诊断设置名称，然后选择要向其发送日志类别下的服务。
在“日志”部分下，可以选择一个或多个要为其创建诊断设置的 OSDU 服务。根据需要存档到存储帐户和/或发送到 Log Analytics工作区。
验证要存档日志或与之集成的订阅、存储帐户和 Log Analytics 工作区。

在 Log Analytics 工作区中使用 OSDU 服务日志

导航到左侧面板中的“日志”选项卡。
展开“日志管理”类别下的表列表。使用诊断设置导出的 OSDU 服务日志显示在 OEPDataplaneLogs 表中。
移动到编辑器窗格。在这里，可以编写 Kusto 查询语言 (KQL) 查询来筛选 OSDU 服务日志，并仅显示相关查询。

使用 OSDU 服务日志进行故障排除

在 Azure Monitor 中分析 OSDU 服务日志有助于识别与特定服务和 API 相关的错误和问题。检查工作流服务、分区服务或权利服务等服务的日志，以快速识别和解决 API 调用或服务功能中的任何问题。

Log Analytics 工作区查询编辑器支持 KQL 查询。下面是一些可能有用的示例查询：

用于筛选过去 6 小时内 Azure Data Manager for Energy 中特定服务生成的 OSDU 服务日志的查询。

OEPDataplaneLogs
| where TimeGenerated >= ago(6h)
| where _ResourceID contains "name-of-your-adme-instance"
| where Category = "DatasetLogs"

用于筛选导致当前错误的所有 OSDU 服务调用的日志的查询。

OEPDataplaneLogs
| where _ResourceID contains "name-of-your-adme-instance"
| where TimeGenerated >= startofday(ago(0d))
| where TimeGenerated < startofday(ago(-1d))
| where LogLevel != "INFO"

将 OSDU 服务日志存档到存储帐户

可以将 OSDU 服务日志存档到存储帐户，并利用 Azure Monitor 功能进行日志存档、保留策略等：

在诊断设置创建过程中指定用于存档日志的存储帐户。
设置存档日志的保留策略。
访问存储帐户中的日志以获取其他分析或长期存储。

后续步骤

收集 OSDU 服务日志后，请创建日志查询警报，以便在日志数据中识别出需要关注的数据时主动接收通知。

为 Azure 资源创建日志查询警报

通过