Aktivieren der Diagnoseprotokollierung für Microsoft Foundry

Dieser Artikel enthält schrittweise Anleitungen zum Aktivieren der Diagnoseprotokollierung für eine Microsoft Foundry-Ressource. Diese Protokolle enthalten umfangreiche, häufige Daten über den Vorgang einer Ressource, die Sie zur Problemidentifikation und zum Debuggen verwenden können. Bevor Sie fortfahren, müssen Sie über ein Azure Konto mit einem Abonnement für mindestens eine Microsoft Foundry-Ressource verfügen.

Voraussetzungen

Um die Diagnoseprotokollierung zu aktivieren, müssen Sie einen Speicherort zum Speichern Ihrer Protokolldaten auswählen. In diesem Tutorial werden Azure Storage und Log Analytics verwendet.

  • Azure Storage speichert die Diagnoseprotokolle für die Richtlinienüberwachung, statische Analysen oder als Sicherung. Das Speicherkonto muss sich nicht im selben Abonnement wie die Ressource befinden, die Protokolle ausgibt, solange der Benutzer, der die Einstellung konfiguriert, über einen geeigneten Azure rollenbasierten Zugriffssteuerungszugriff (RBAC) für beide Abonnements verfügt.
  • Log Analytics – Ein flexibles Protokollsuche- und Analysetool, mit dem Sie rohe Protokolle analysieren können, die von einer Azure Ressource generiert werden.

Note

Aktivieren der Diagnoseprotokollierung

Aktivieren Sie zunächst die Diagnoseprotokollierung mithilfe des Azure Portals.

Note

Informationen zum Aktivieren dieses Features mithilfe von PowerShell oder der Azure CLI finden Sie unter "Sammeln und Nutzen von Protokolldaten aus Ihren Azure Ressourcen".

  1. Gehen Sie zum Azure-Portal. Suchen und wählen Sie dann eine Microsoft Foundry-Ressource aus.
  2. Suchen Sie als Nächstes im linken Navigationsmenü nach "Überwachung", und wählen Sie "Diagnoseeinstellungen" aus. Dieser Bildschirm enthält alle zuvor erstellten Diagnoseeinstellungen für diese Ressource.
  3. Wenn eine zuvor erstellte Diagnoseeinstellung vorhanden ist, die Sie verwenden möchten, wählen Sie sie jetzt aus. Wählen Sie andernfalls + Diagnoseeinstellung hinzufügen aus.
  4. Geben Sie einen Namen für die Einstellung ein. Wählen Sie In einem Speicherkonto archivieren und dann An Log Analytics senden aus.
  5. Wenn Sie zum Konfigurieren aufgefordert werden, wählen Sie das Speicherkonto und den OMS-Arbeitsbereich aus, den Sie zum Speichern Ihrer Diagnoseprotokolle verwenden möchten.

    Note

    Wenn Sie nicht über ein Speicherkonto oder einen OMS-Arbeitsbereich verfügen, folgen Sie den Anweisungen zum Erstellen eines Kontos.

  6. Wählen Sie Überwachungsprotokolle, Anforderungs- und Antwortprotokolle, Azure OpenAI-Anforderungsverwendung und AllMetrics aus. Eine Beschreibung der einzelnen verfügbaren Protokollkategorien finden Sie unter Azure OpenAI-Überwachungsdatenreferenz.
  7. Wählen Sie Speichern.

Es kann bis zu zwei Stunden dauern, bis die Protokollierungsdaten zum Abfragen und Analysieren verfügbar sind. Machen Sie sich also keine Sorgen, wenn Sie nichts sofort sehen.

Anzeigen von Protokollen in Azure Storage

Wenn Sie Diagnoseprotokolle an ein Speicherkonto weiterleiten, schreibt Azure Monitor die ausgegebenen Protokolleinträge als JSON-Blobs. Jede Protokollkategorie wird in einem eigenen Container mit dem Namen insights-logs-<category> gespeichert (zum Beispiel insights-logs-audit oder insights-logs-requestresponse).

  1. Suchen Sie im Azure Portal nach der Azure Storage Ressource, die Sie ausgewählt haben, wenn Sie Diagnoseeinstellungen aktiviert haben.
  2. Suchen Sie im linken Navigationsmenü nach Datenspeicher , und wählen Sie "Container" aus.
  3. Wählen Sie den insights-logs-<category>-Container der Protokollkategorie aus, die Sie überprüfen möchten, z. B. insights-logs-requestresponse.
  4. Navigieren Sie im Blobpfad tiefer, um die Protokolle für Ihre Ressource und den gewünschten Zeitraum zu finden. Die Blobs werden nach Ressourcen-ID und Zeitstempel organisiert, z. B.: resourceId=/SUBSCRIPTIONS/.../PROVIDERS/MICROSOFT.COGNITIVESERVICES/ACCOUNTS/<resource-name>/y=<year>/m=<month>/d=<day>/h=<hour>/m=00/PT1H.json.
  5. Wählen Sie das PT1H.json Blob aus, und wählen Sie dann "Herunterladen " aus, um es zu speichern. Jedes Blob enthält einen durch Zeilentrennzeichen getrennten JSON-Code, wobei jede Zeile ein einzelner Protokolldatensatz ist.

Weitere Informationen zum Speichern von Diagnoseprotokollen finden Sie unter Azure Ressourcenprotokolle. Informationen dazu, was Sie mit BLOB-Daten in Azure Storage tun können, finden Sie unter Azure Storage.

Anzeigen von Protokollen in Log Analytics

Gehen Sie anhand der folgenden Anweisungen vor, um die Log Analytics-Daten für Ihre Ressource zu untersuchen.

  1. Suchen Sie im Azure-Portal im Navigationsmenü auf der linken Seite nach Log Analytics, und wählen Sie die Option aus.
  2. Suchen Sie die Ressource, die Sie beim Aktivieren der Diagnose erstellt haben, und wählen Sie sie aus.
  3. Suchen Sie unter Allgemein nach Protokolle und wählen Sie diese Option aus. Sie können auf dieser Seite Abfragen für Ihre Protokolle ausführen.

Beispielabfragen

Im Folgenden finden Sie einige grundlegende Kusto-Abfragen, mit denen Sie Ihre Protokolldaten untersuchen können.

Führen Sie diese Abfrage für alle Diagnoseprotokolle aus Ihrer Microsoft Foundry-Ressource für einen bestimmten Zeitraum aus:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"

Führen Sie diese Abfrage aus, um die Anfrage-Latenz nach Statuscode zu messen, einschließlich der Perzentile P50, P90, P95 und P99:

AzureDiagnostics
| where TimeGenerated between (todatetime('<StartDateTime>') .. todatetime('<EndDateTime>'))
| where ResourceId has "<YourResourceID>"
| where Category == "RequestResponse"
| project TimeGenerated, ResponseCode = ResultSignature, DurationMs, OperationName
| summarize
    RequestCount = count(),
    P50 = percentile(DurationMs, 50),
    P90 = percentile(DurationMs, 90),
    P95 = percentile(DurationMs, 95),
    P99 = percentile(DurationMs, 99)
    by ResponseCode, OperationName
| order by RequestCount desc

Führen Sie diese Abfrage aus, um die Anforderungsanzahl nach Antwortcode zu messen:

AzureDiagnostics
| where TimeGenerated between (todatetime('<StartDateTime>') .. todatetime('<EndDateTime>'))
| where ResourceId has "<YourResourceID>"
| where Category == "RequestResponse"
| project TimeGenerated, ResponseCode = ResultSignature
| summarize RequestCount = count() by ResponseCode
| order by RequestCount desc

Führen Sie diese Abfrage aus, um alle ausgegebenen Metriken anzuzeigen:

AzureMetrics
| where TimeGenerated between (todatetime('<StartDateTime>') .. todatetime('<EndDateTime>'))
| project MetricName, Total, Count, Maximum, Minimum, Average, TimeGrain, UnitName

Nächste Schritte

  • Last updated on