Delen via

Uw traceringen visualiseren

  • Artikel

Belangrijk

Items die in dit artikel zijn gemarkeerd (preview) zijn momenteel beschikbaar als openbare preview. Deze preview wordt aangeboden zonder een service level agreement en we raden deze niet aan voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.

Na het instrumenteren van uw toepassing om traceringen te registreren, laten we eens kijken hoe u uw traceringen in zowel lokale als cloudoplossingen kunt bekijken om fouten in uw toepassing op te sporen.

Uw traceringen weergeven voor lokale foutopsporing

Als u traceringen lokaal wilt inschakelen, hebt u twee opties:

  1. Met Prompty kunt u uw toepassing traceren met de Azure AI-deductie-SDK, die verbeterde zichtbaarheid en vereenvoudigde probleemoplossing biedt voor LLM-toepassingen. Deze methode volgt de OpenTelemetry-specificatie, het vastleggen en visualiseren van de interne uitvoeringsdetails van elke AI-toepassing, waardoor de algehele ontwikkelervaring wordt verbeterd. Zie Foutopsporing prompty voor meer informatie.
  2. Aspire Dashboard : een gratis en opensource OpenTelemetry-dashboard voor uitgebreide inzichten in uw apps op uw lokale ontwikkelcomputer. Zie Aspire Dashboard voor meer informatie.

Uw traceringen weergeven in de Azure AI Foundry-portal

Voordat u zich kunt aanmelden bij de Azure AI Foundry-portal, voegt u een Application Insights-resource toe aan uw project.

  1. Navigeer naar uw project in de Azure AI Foundry-portal.
  2. Selecteer de pagina Tracering aan de linkerkant.
  3. Selecteer Nieuwe maken om een nieuwe Application Insights-resource aan uw project toe te voegen.
  4. Geef een naam op en selecteer Maken.

Animatie van het traceren en maken van een Application Insight-resource.

Installeer vervolgens de opentelemetry SDK:

%pip install azure-monitor-opentelemetry

Schakel nu tracering met uitvoer naar de console in:

import os
from azure.monitor.opentelemetry import configure_azure_monitor

os.environ['AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED'] = 'true'
# Enable Azure Monitor tracing
application_insights_connection_string = project.telemetry.get_connection_string()
if not application_insights_connection_string:
    print("Application Insights was not enabled for this project.")
    print("Enable it via the 'Tracing' tab in your Azure AI Foundry project page.")
    exit()
    
configure_azure_monitor(connection_string=application_insights_connection_string)

Voer ten slotte een deductieaanroep uit. De aanroep wordt vastgelegd in Azure AI Foundry. Met deze code wordt een koppeling naar de traceringen afgedrukt.

response = chat.complete(
    model="gpt-4o-mini",
    messages=[
        {"role": "system", "content": "You are an AI assistant that is a travel planning expert especially with National Parks."},
        {"role": "user", "content": "Hey, can you recommend me trails I should go on when I visit Mount Rainier?"},
    ]
)

print("View traces at:")
print(f"https://ai.azure.com/tracing?wsid=/subscriptions/{project.scope['subscription_id']}/resourceGroups/{project.scope['resource_group_name']}/providers/Microsoft.MachineLearningServices/workspaces/{project.scope['project_name']}")

Selecteer de koppeling en begin met het weergeven van traceringen in de Azure AI Foundry-portal.

Fouten opsporen en traceringen filteren

In uw project kunt u uw traceringen naar wens filteren.

Door een tracering te selecteren, kan ik elke periode doorlopen en problemen identificeren terwijl ik bekijk hoe mijn toepassing reageert.

Animatie van filtertraceringen in de portal.

Uw gekoppelde Application Insights-resource bijwerken

Als u de Application Insights-resource wilt bijwerken die is gekoppeld aan uw project, gaat u naar Gegevensbron beheren en Bewerken om over te schakelen naar een nieuwe Application Insights-resource.

Schermopname van het pop-upvenster gegevensbronnen beheren met de knop Bewerken gemarkeerd.

Uw traceringen weergeven in Azure Monitor

Als u traceringen hebt vastgelegd met behulp van het vorige codefragment, bent u klaar om uw traceringen weer te geven in Azure Monitor Application Insights. U kunt in Application Insights openen vanuit De gegevensbron beheren en de weergave end-to-end transactiedetails gebruiken om verder te onderzoeken.

Zie de documentatie van Azure Monitor OpenTelemetry voor meer informatie over het verzenden van Azure AI-deductietraceringen naar Azure Monitor en het maken van Een Azure Monitor-resource.

Bekijk uw generatieve AI-spans en traceringen

Vanuit het Azure AI Foundry-project kunt u ook uw aangepaste dashboard openen dat u specifieke inzichten biedt om u te helpen uw generatieve AI-toepassing te bewaken.

In deze Azure-werkmap kunt u uw Gen AI-spanten bekijken en naar de weergave end-to-end transactiedetails van Azure Monitor springen om dieper in te gaan en te onderzoeken.

Zie de documentatie voor Azure Workbook voor meer informatie over het gebruik van deze werkmap om uw toepassing te bewaken.

Gerelateerde inhoud