Partilhar via

Visualize seus vestígios

  • Artigo

Importante

Os itens marcados (visualização) neste artigo estão atualmente em visualização pública. Essa visualização é fornecida sem um contrato de nível de serviço e não a recomendamos para cargas de trabalho de produção. Algumas funcionalidades poderão não ser suportadas ou poderão ter capacidades limitadas. Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.

Depois de instrumentar seu aplicativo para registrar rastreamentos, vamos explicar como você pode exibir seus rastreamentos em soluções locais e na nuvem para depurar seu aplicativo.

Exibir seus rastreamentos para depuração local

Para habilitar rastreamentos localmente, você tem duas opções:

  1. Usando o Prompty, você pode rastrear seu aplicativo com o SDK do Azure AI Inference, que oferece visibilidade aprimorada e solução de problemas simplificada para aplicativos baseados em LLM. Este método segue a especificação OpenTelemetry capturando e visualizando os detalhes de execução interna de qualquer aplicação de IA, melhorando assim a experiência geral de desenvolvimento. Para saber mais, consulte Debugging Prompty.
  2. Aspire Dashboard : Um painel OpenTelemetry gratuito ou de código aberto para obter informações detalhadas sobre as suas aplicações na sua máquina de desenvolvimento local. Para saber mais, consulte Painel do Aspire .

Exibir seus rastreamentos no portal do Azure AI Foundry

Antes de iniciar sessão no portal do Azure AI Foundry, anexe um recurso do Application Insights ao seu projeto.

  1. Navegue até o seu projeto no portal do Azure AI Foundry.
  2. Selecione a página Rastreamento no lado esquerdo.
  3. Selecione Criar novo para anexar um novo recurso do Application Insights ao seu projeto.
  4. Forneça um nome e selecione Criar.

Animação de ir para o rastreamento e criar um recurso do Application Insight.

Em seguida, instale o opentelemetry SDK:

%pip install azure-monitor-opentelemetry

Agora habilite o rastreamento com saída para o console:

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 AI Studio project page.")
    exit()
    
configure_azure_monitor(connection_string=application_insights_connection_string)

Finalmente, execute uma chamada de inferência. A chamada é registrada no Azure AI Studio. Esse código imprime um link para os rastreamentos.

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']}")

Selecione o link e comece a exibir rastreamentos no Azure AI Studio!

Depurar e filtrar rastreamentos

Em seu projeto, você pode filtrar seus rastreamentos como achar melhor.

Ao selecionar um rastreamento, posso percorrer cada extensão e identificar problemas enquanto observo como meu aplicativo está respondendo.

Animação de rastreamentos de filtragem no portal.

Atualize o recurso anexado do Application Insights

Para atualizar o recurso do Application Insights anexado ao seu projeto, vá para Gerenciar fonte de dados e Editar para alternar para um novo recurso do Application Insights.

Captura de tela do pop-up gerenciar fontes de dados destacando o botão de edição.

Exibir seus rastreamentos no Azure Monitor

Se você registrou rastreamentos usando o trecho de código anterior, estará pronto para exibir seus rastreamentos no Azure Monitor Application Insights. Você pode abrir no Application Insights em Gerenciar fonte de dados e usar a exibição de detalhes da transação de ponta a ponta para investigar mais.

Para obter mais informações sobre como enviar rastreamentos do Azure AI Inference para o Azure Monitor e criar o recurso do Azure Monitor, consulte a documentação do Azure Monitor OpenTelemetry .

Veja seus traços e extensões de IA generativas

No projeto do estúdio de IA do Azure, você também pode abrir seu painel personalizado que fornece informações especificamente para ajudá-lo a monitorar seu aplicativo de IA generativa.

Nesta Pasta de Trabalho do Azure, você pode exibir suas extensões de IA de geração e ir para a exibição de detalhes de transação de ponta a ponta do Azure Monitor para aprofundar e investigar.

Saiba mais sobre como usar esta pasta de trabalho para monitorar seu aplicativo, consulte a documentação da Pasta de Trabalho do Azure.

Conteúdos relacionados