Power BI を使用して Azure AI 検索 のログとメトリックを視覚化する

注

Azure AI 検索は、Azure ポータル、REST API、およびAzure SDKから使用できます。 また、Foundry IQ は、エンタープライズ コンテンツを、Microsoft Foundry ポータルのエージェントの再利用可能なアクセス許可に対応したナレッジ ベースに変換するマネージド ナレッジ レイヤーです。

Azure AI 検索 は、操作ログとサービス メトリックを Azure Storage アカウントに送信します・これらは、Power BI で視覚化できます。 この記事では、Power BI テンプレート アプリを使用してデータを視覚化する手順と方法について説明します。 このテンプレートには、クエリ、インデックス作成、操作、サービス メトリックに関する情報が含まれています。

注

現在、Power BI テンプレートは、AppSource とアプリ内レポート ラベルにAzure Cognitive Searchレガシ製品名と共に一覧表示されています。

ログ記録を設定してテンプレートをインストールする

  1. 検索サービスに対してメトリックとリソースのログを有効にします。

    1. ログをアーカイブできる Azure Storage アカウントを作成するか、既存のアカウントを特定します
    2. Azure portal で、Search サービスに移動します。
    3. [監視] で、[診断設定] を選択します。
    4. [診断設定の追加] を選択します。
    5. [ストレージ アカウントへのアーカイブ] をオンにし、使用するストレージ アカウントの情報を入力して、[OperationLogs] と [AllMetrics] をオンにします。
    6. [保存] を選択します。
  2. ログ記録が有効になると、検索サービスを使用するときにログとメトリックが生成されるようになります。 ログに記録されたイベントが Azure Storage に表示されるまでに最大 1 時間かかることがあります。 操作用の insights-logs-operationlogs コンテナーとメトリック用の insights-metrics-pt1m コンテナーを探します。 これらのコンテナーのストレージ アカウントを調べて、視覚化するデータがあることを確認します。

  3. Power BI Apps マーケットプレース で Power BI アプリ テンプレートを見つけて、新しいワークスペースまたは既存のワークスペースにインストールします。 テンプレートは Azure Cognitive Search: ログとメトリックの分析として一覧表示されます。

  4. テンプレートをインストールしたら、Power BI のアプリの一覧からテンプレートを選択します。

    従来のAzure Cognitive Search名を持つ Power BI テンプレート アプリ タイルを示すスクリーンショット。

  5. [データを接続] を選択します。

    Power BI テンプレート アプリでデータに接続する方法を示すスクリーンショット。

  6. ログとメトリックが含まれているストレージ アカウントの名前を入力します。 既定では、アプリは過去 10 日間のデータを確認しますが、この値は [Days] パラメーターで変更できます。

    [データへの接続] ページでストレージ アカウント名と日数を入力する方法を示すスクリーンショット。

  7. 認証方法として [キー] を選択し、お使いのストレージ アカウント キーを指定します。 プライバシー レベルには [なし] または [非公開] を選択します。 [サインイン] をクリックして、読み込みプロセスを開始します。

    接続ページで認証方法、アカウント キー、プライバシー レベルを設定する方法を示すスクリーンショット。

  8. データが最新の情報に更新されるまで待ちます。 データの量によっては、時間がかかる場合があります。 次のインジケーターに基づいて、データがまだ更新中かどうかを確認できます。

    データ更新ページで情報を読む方法を示すスクリーンショット。

  9. レポートを表示するには、Azure Cognitive Search Report(旧レポート名)を選択します。

    データ更新ページでレポートを選択する方法を示すスクリーンショット。

  10. レポートを開いた後にページを更新し、データが表示されるようにします。

    Power BI レポートのスクリーンショット。

アプリのパラメーターを変更する

別のストレージ アカウントのデータを視覚化する場合、またはクエリするデータの日数を変更する場合は、次の手順に従って Days パラメーターと StorageAccount パラメーターを変更します。

  1. Power BI アプリに移動し、検索アプリを見つけて、 [編集] アクションを選択してワークスペースに進みます。

  2. データセットのオプションから [設定] を選択します。

    Power BI ワークスペースのデータセット オプションから [設定] を選択する方法を示すスクリーンショット。

  3. [データセット] タブで、パラメーターの値を変更し、[適用] を選択します。 接続に問題がある場合は、同じページでデータ ソースの資格情報を更新します。

  4. ワークスペースに戻り、データセットのオプションから [今すぐ更新] を選択します。

    [今すぐ更新] オプションを選択する方法を示すスクリーンショット。

  5. レポートを開くと、更新されたデータが表示されます。 また、最新のデータを表示するために、レポートを最新の情報に更新することが必要な場合もあります。

障害対応レポートの問題

データが表示されない場合は、次のトラブルシューティング手順を試してください。

  1. レポートを開き、ページを最新の情報に更新して、最新のデータが表示されていることを確認します。 データを最新の情報に更新するオプションがレポートにあります。 これを選択して最新のデータを取得します。

  2. 指定したストレージ アカウント名とアクセス キーが正しいことを確認します。 ストレージ アカウント名は、検索サービス ログに構成したアカウントに一致している必要があります。

  3. ストレージ アカウントにコンテナー insights-logs-operationlogs と insights-metrics-pt1m が含まれていること、および各コンテナーにデータがあることを確認します。 ログとメトリックは、複数のフォルダー レベルで入れ子になっています。

  4. データセットがまだ更新中であるかどうかを確認します。 更新状態インジケーターは、上記の手順 8 に示されています。 まだ更新中の場合は、更新が完了するまで待ってから、レポートを開いて最新の状態に更新します。

次のステップ