将 OSDU 服务日志与 Azure Monitor 集成

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 服务日志集成启用诊断设置

1. 打开 Microsoft Azure Data Manager for Energy Overview 页面。

2. 从左侧面板中选择“诊断设置”。

   

3. 选择“添加诊断设置”。 选择诊断设置名称，并在“类别”下选择要将日志发送到所选目标的服务。

   

4. 在“日志”部分下，可以选择一个或多个要为其创建诊断设置的 OSDU 服务。 根据需要选择 “存档”到存储帐户 和/或 “发送到 Log Analytics”工作区 。

   

5. 验证要存档日志或与之集成的订阅、存储帐户和 Log Analytics 工作区。

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

1. 导航到左侧面板中的 “日志 ”选项卡。

2. 展开“日志管理”类别下的表列表。 使用诊断设置导出的 OSDU 服务日志显示在 OEPDataplaneLogs 表中。

3. 移动到编辑器窗格。 在这里，可以编写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 服务日志，请创建一个日志查询警报，以在日志数据中标识有趣的数据时主动通知。