Monitorare i log dell'agente ospitato con l'interfaccia della riga di comando per sviluppatori di Azure

Visualizzare in streaming ed esaminare i log dell'agente ospitato in Microsoft Foundry distribuito per la risoluzione dei problemi e l'osservabilità. Si apprenderà come visualizzare i log della console, lo streaming in tempo reale, esaminare gli eventi di sistema, filtrare in base alla sessione e riconoscere i modelli di log comuni.

Prerequisiti

• Un agente ospitato distribuito. Per distribuirne una, vedere Distribuire un agente ospitato.
• Le estensioni azd di Foundry installate. Per la procedura di installazione, vedere Installare le estensioni azd Foundry.
• Una sessione autenticata di Azure Developer CLI. Eseguire azd auth login se necessario.
• Per i log specifici della sessione, un ID di sessione da una risposta azd ai agent invoke. Per richiamare un agente, vedere Richiamare un agente ospitato con l'interfaccia della riga di comando di Azure Developer.

Visualizzare i log recenti della console

• Recuperare i log recenti della console:

  azd ai agent monitor
  

  Questo comando recupera i log recenti della console, tra cui stdout e stderr, dall'ultima sessione invoke dell'agente. Se non esiste alcuna sessione, trasmette i log dei contenitori. Il comando viene chiuso dopo aver recuperato i log disponibili. Usa --follow per trasmettere continuamente in streaming.

Trasmettere i registri in tempo reale

• Trasmettere i log in modo continuo:

  azd ai agent monitor --follow
  

  Premi Ctrl+C per interrompere. Questa è la modalità più utile per il debug. Eseguirlo in un terminale durante l'invio di richieste in un altro.

Visualizzare i registri eventi di sistema

• Mostra gli eventi del ciclo di vita del contenitore anziché l'output della console:

  azd ai agent monitor --type system
  

  Usare i registri eventi di sistema per diagnosticare gli arresti anomali dei contenitori, i cicli di riavvio e i problemi delle risorse.

Visualizzare i log specifici della sessione

• Filtrare i log per una sessione dell'agente specifica:

  azd ai agent monitor --session-id <session-id>
  

• Combinare con --follow per lo streaming in tempo reale:

  azd ai agent monitor --session-id <session-id> --follow
  

  Per trovare gli ID sessione, controllare l'output di azd ai agent invoke. Stampa l'ID sessione per ogni richiesta.

Controllare la lunghezza del log

• Mostra le ultime 100 righe:

  azd ai agent monitor --tail 100
  

  L'intervallo è compreso tra 1 e 300. Il valore predefinito è 50.

Monitorare un agente specifico

• Nei progetti multiservizio passare il nome dell'agente:

  azd ai agent monitor my-agent
  

Riconoscere i modelli di log comuni

Seguire un flusso di lavoro di debug

Una tipica sessione di debug è simile alla seguente:

1. Trasmettere i log in un unico terminale:

   azd ai agent monitor --follow
   

2. Inviare una richiesta in un altro terminale:

   azd ai agent invoke "Test message"
   

3. Controllare i log per individuare i modelli di errore o il comportamento imprevisto.

4. Controllare gli eventi di sistema se l'agente non risponde:

   azd ai agent monitor --type system
   

Per un flusso di lavoro di debug completo, vedere Eseguire il debug di un agente ospitato.

Contenuti correlati

• Esegui il debug di un agente ospitato per flussi di lavoro diagnostici passo passo.
• Testa un agente ospitato per le strategie di validazione prima della produzione.
• Isolare le sessioni dell'agente ospitato per utente per i log delle sessioni isolate.