OSDU サービス ログと Azure Monitor を統合する

Azure Data Manager for Energy では、診断設定を使用して OSDU サービス ログを Azure Monitor にエクスポートできます。 この機能は、OSDU サービスのトラブルシューティング、デバッグ、監視を向上するのに役立ちます。 ここでの手順は、エアフローやエラスティックなどの他のログを Azure Monitor と統合する方法と似ています。

前提条件

  • 既存の Log Analytics ワークスペース。 このワークスペースは、Log Analytics ワークスペースの Kusto 照会言語 (KQL) クエリ エディターを使用して OSDU サービス ログのクエリを実行するために使用されます。 役に立つリソース: Azure portal で Log Analytics ワークスペースを作成する

  • 既存 のストレージ アカウント: OSDU サービス ログの JSON ダンプを格納するために使用されます。 ストレージ アカウントは、Log Analytics ワークスペースと同じサブスクリプションに含まれている必要はありません。

OSDU サービス ログ統合の診断設定の有効化

  1. Microsoft Azure Data Manager for Energy の [概要 ] ページを開きます。

  2. 左側のパネルから [診断設定] を選択します。

    Screenshot shows that the list of OSDU services currently supported is visible on the diagnostic settings overview page.

  3. [診断設定の追加] を選択します。 診断設定名を選択し、選択した宛先にログを送信するカテゴリサービスを選択します。

    Screenshot to show that users can select all or a few log categories while creating a diagnostic setting.

  4. [ログ] セクションでは、診断設定を作成する 1 つまたは複数の OSDU サービスを選択できます。 必要に応じて、[ストレージ アカウントへのアーカイブ] または [Log Analytics ワークスペースに送信] を選択します。

    Screenshot shows that export to multiple destinations can be configured with just one diagnostic setting.

  5. ログをアーカイブまたは統合するサブスクリプション、ストレージ アカウント、Log Analytics ワークスペースを確認します。

Log Analytics ワークスペースでの OSDU サービス ログの操作

  1. 左側のパネルの [ ログ ] タブに移動します。

  2. [ログ管理] カテゴリの下にあるテーブルの一覧を展開します。 診断設定を使用してエクスポートされた OSDU サービス ログが OEPDataplaneLogs テーブルに表示されます。

  3. エディター ウィンドウに移動します。 ここでは、Kusto 照会言語 (KQL) クエリを記述して、OSDU サービス ログをフィルター処理し、関連するログのみを表示できます。

    Screenshot shows the different parts of a Log Analytics workspace interface.

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 サービス ログを収集したら、ログ データで興味深いデータが識別されたときに事前に通知されるログ クエリ アラートを作成します。