Visualisieren von Azure KI-Suche-Protokollen und -Metriken mit Power BI

Hinweis

Azure KI-Suche ist über das Azure Portal, REST-APIs und Azure SDKs verfügbar. Es unterstützt auch Foundry IQ, die verwaltete Wissensschicht, die Unternehmensinhalte in wiederverwendbare, berechtigungsfähige Wissensbasen für Agenten im Microsoft Foundry-Portal transformiert.

Azure KI-Suche kann Vorgangsprotokolle und Dienstmetriken an ein Azure Storage-Konto senden, die dann in Power BI visualisiert werden können. In diesem Artikel werden die Schritte und die Verwendung einer Power BI-Vorlagen-App zum Visualisieren der Daten erläutert. Die Vorlage enthält Informationen zu Abfragen, Indizierung, Vorgängen und Dienstmetriken.

Hinweis

Die Power BI-Vorlage wird derzeit mit dem älteren Produktnamen Azure Cognitive Search in AppSource- und In-App-Berichtsbezeichnungen aufgeführt.

Einrichten der Protokollierung und Installieren der Vorlage

  1. Aktivieren Sie Metriken und Ressourcenprotokollierung für Ihren Suchdienst:

    1. Erstellen oder identifizieren Sie ein vorhandenes Azure Storage-Konto, in dem Sie die Protokolle archivieren können.
    2. Wechseln Sie im Azure-Portal zu Ihrem Suchdienst.
    3. Wählen Sie unter „Überwachung“ die Option Diagnoseeinstellungen aus.
    4. Klicken Sie auf Diagnoseeinstellung hinzufügen.
    5. Aktivieren Sie In einem Speicherkonto archivieren, geben Sie Ihre Speicherkontoinformationen an, und aktivieren Sie OperationLogs und AllMetrics.
    6. Wählen Sie Speichern.

  2. Sobald die Protokollierung aktiviert ist, werden Protokolle und Metriken generiert, während Sie den Suchdienst verwenden. Es kann bis zu einer Stunde dauern, bis protokollierte Ereignisse in Azure Storage angezeigt werden. Suchen Sie nach einem Insights-logs-operationlogs-Container für Vorgänge und einen Insights-metrics-pt1m-Container für Metriken. Überprüfen Sie Ihr Speicherkonto für diese Container, um sicherzustellen, dass Daten zum Visualisieren vorhanden sind.

  3. Suchen Sie die Power BI-App-Vorlage im Marketplace für Power BI-Apps, und installieren Sie sie in einem neuen oder vorhandenen Arbeitsbereich. Die Vorlage wird als Azure Cognitive Search aufgeführt: Protokolle und Metriken analysieren.

  4. Nachdem Sie die Vorlage installiert haben, wählen Sie sie in der Liste der Apps in Power BI aus.

    Screenshot, der die Kachel der Power BI-Vorlagen-App mit dem früheren Namen Azure Cognitive Search zeigt.

  5. Wählen Sie Ihre Daten verbinden.

    Screenshot, der zeigt, wie Sie eine Verbindung mit Ihren Daten in der Power BI-Vorlagen-App herstellen.

  6. Geben Sie den Namen des Speicherkontos ein, das Ihre Protokolle und Metriken enthält. Standardmäßig betrachtet die App die Daten der letzten 10 Tage, aber dieser Wert kann mit dem Parameter Tage geändert werden.

    Screenshot, der zeigt, wie Sie den Namen des Speicherkontos und die Anzahl von Tagen auf der Seite

  7. Wählen Sie Schlüssel als Authentifizierungsmethode aus, und geben Sie Ihren Speicherkontoschlüssel an. Wählen Sie Keine oder Privat als Datenschutzebene aus. Klicken Sie auf Anmelden, und beginnen Sie den Ladevorgang.

    Screenshot, der zeigt, wie Sie die Authentifizierungsmethode, den Kontoschlüssel und die Datenschutzstufe auf der Verbindungsseite festlegen.

  8. Warten Sie, bis die Daten aktualisiert sind. Dies kann eine Weile dauern, je nachdem, wie viele Daten Sie nutzen. Der folgende Indikator zeigt Ihnen, ob die Daten noch aktualisiert werden.

    Screenshot, der zeigt, wie die Informationen auf der Seite „Datenaktualisierung“ gelesen werden.

  9. Wählen Sie Azure Cognitive Search-Bericht (früherer Berichtsname) aus, um den Bericht anzuzeigen.

    Screenshot, der zeigt, wie der Bericht auf der Seite „Datenaktualisierung“ ausgewählt wird.

  10. Aktualisieren Sie die Seite nach dem Öffnen des Berichts, damit sie mit Ihren Daten geöffnet wird.

    Screenshot des Power BI-Berichts.

Ändern von App-Parametern

Wenn Sie Daten aus einem anderen Speicherkonto visualisieren oder die Anzahl der abzufragenden Daten ändern möchten, führen Sie die folgenden Schritte aus, um die Parameter "Days" und "StorageAccount " zu ändern.

  1. Navigieren Sie zu ihren Power BI-Apps, suchen Sie Ihre Search-App, und wählen Sie die Aktion Bearbeiten aus, um zum Arbeitsbereich zu gelangen.

  2. Wählen Sie aus den Datasetoptionen Einstellungen aus.

    Screenshot, der zeigt, wie Einstellungen aus den Datasetoptionen im Power BI Arbeitsbereich ausgewählt werden.

  3. Ändern Sie auf der Registerkarte „Datasets“ die Parameterwerte, und wählen Sie Anwenden aus. Wenn ein Problem mit der Verbindung vorliegt, aktualisieren Sie die Anmeldeinformationen für die Datenquelle auf derselben Seite.

  4. Navigieren Sie zurück zum Arbeitsbereich, und wählen Sie Jetzt aktualisieren aus den Datasetoptionen aus.

    Screenshot: Auswählen der Option „Jetzt aktualisieren“.

  5. Öffnen Sie den Bericht, um die aktualisierten Daten anzuzeigen. Möglicherweise müssen Sie den Bericht auch aktualisieren, um die neuesten Daten anzuzeigen.

Fehlerbehebung bei Berichten

Wenn Ihre Daten nicht angezeigt werden, probieren Sie die folgenden Schritte zur Problembehandlung aus:

  1. Öffnen Sie den Bericht, und aktualisieren Sie die Seite, um sicherzustellen, dass Sie die neuesten Daten anzeigen. Der Bericht enthält eine Option zum Aktualisieren der Daten. Wählen Sie diese Option aus, um die neuesten Daten zu erhalten.

  2. Stellen Sie sicher, dass der angegebene Speicherkontoname und der angegebene Zugriffsschlüssel korrekt sind. Der Speicherkontoname sollte dem Konto entsprechen, das mit ihren Suchdienstprotokollen konfiguriert wurde.

  3. Vergewissern Sie sich, dass Ihr Speicherkonto die Container "insights-logs-operationlogs " und "insights-metrics-pt1m" enthält und dass jeder Container Daten enthält. Die Protokolle und Metriken werden in mehreren Ordnerebenen geschachtelt.

  4. Überprüfen Sie, ob das Dataset weiterhin aktualisiert wird. Der Aktualisierungsstatusindikator wird oben in Schritt 8 angezeigt. Wenn die Aktualisierung noch immer ausgeführt wird, warten Sie, bis die Aktualisierung beendet ist, um den Bericht zu öffnen und zu aktualisieren.

Nächste Schritte

  • Last updated on