OSDU サービス ログと Azure Monitor を統合する
Azure Data Manager for Energy では、診断設定を使用した OSDU サービス ログの Azure Monitor へのエクスポートがサポートされています。 この機能は、OSDU サービスのトラブルシューティング、デバッグ、監視を向上するのに役立ちます。 ここでの手順は、Airflow や Elastic などの他のログを Azure Monitor と統合する方法と似ています。
前提条件
既存の Log Analytics ワークスペース。 このワークスペースは、Log Analytics ワークスペースで Kusto 照会言語 (KQL) クエリ エディターを使って OSDU サービス ログのクエリを実行するために使われます。 役に立つリソース: Azure portal で Log Analytics ワークスペースを作成する。
既存の ストレージ アカウント: OSDU サービス ログの JSON ダンプを格納するために使われます。 ストレージ アカウントは、Log Analytics ワークスペースと同じサブスクリプションに含まれている必要はありません。
OSDU サービス ログ統合の診断設定の有効化
Microsoft Azure Data Manager for Energy の概要ページを開きます。
左側のパネルから [診断設定] を選びます。
[診断設定の追加] を選択します。 診断設定名を選択し、選択した宛先にログを送信するサービスを [カテゴリ] で選択します。
[ログ] セクションでは、診断設定を作成する 1 つ以上の 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 サービス ログの収集を開始したので、ログ データで興味深いデータが特定されたときに事前に通知するログ クエリ アラートを作成します。