Condividi tramite


Usare lo strumento di traccia in tempo reale per Servizio Azure SignalR

Lo strumento di traccia in tempo reale è una singola applicazione Web per l'acquisizione e la visualizzazione di tracce live in Servizio Azure SignalR. Le tracce in tempo reale possono essere raccolte in tempo reale senza alcuna dipendenza da altri servizi.

È possibile abilitare e disabilitare la funzionalità di traccia in tempo reale con una singola selezione. È anche possibile scegliere qualsiasi categoria di log a cui si è interessati.

Nota

Le tracce live vengono conteggiate come messaggi in uscita.

L'uso di Microsoft Entra ID per accedere allo strumento di traccia in tempo reale non è supportato.

Aprire lo strumento di traccia in tempo reale

Quando si abilita una chiave di accesso, si usa un token di accesso per autenticare lo strumento di traccia in tempo reale. In caso contrario, si usa Microsoft Entra ID per autenticare lo strumento.

Per verificare se è stata abilitata una chiave di accesso, passare alla pagina Chiavi per Servizio Azure SignalR nel portale di Azure.

Passaggi se è stata abilitata una chiave di accesso

  1. Passare alla pagina portale di Azure e Servizio Azure SignalR.
  2. Nel menu a sinistra, in Monitoraggio, selezionare Impostazioni di traccia dinamica.
  3. Selezionare Abilita traccia dinamica.
  4. Selezionare il pulsante Salva e attendere l'applicazione delle modifiche.
  5. Selezionare Apri strumento di traccia dinamica.

Screenshot of selections for opening the live trace tool.

Passaggi se non è stata abilitata una chiave di accesso

Assegnare l'autorizzazione API dello strumento di traccia in tempo reale a se stessi

  1. Passare alla pagina portale di Azure e Servizio Azure SignalR.
  2. Seleziona Controllo di accesso (IAM).
  3. Nella nuova pagina selezionare +Aggiungi e quindi selezionare Assegnazione di ruolo.
  4. Nella nuova pagina selezionare la scheda Ruoli funzione processo, selezionare il ruolo proprietario Servizio SignalR e quindi selezionare Avanti.
  5. Nella pagina Membri fare clic su +Seleziona membri.
  6. Nel nuovo pannello cercare e selezionare i membri e quindi fare clic su Seleziona.
  7. Selezionare Rivedi e assegna e attendere la notifica di completamento.

Aprire lo strumento

  1. Passare alla pagina portale di Azure e Servizio Azure SignalR.
  2. Nel menu a sinistra, in Monitoraggio, selezionare Impostazioni di traccia dinamica.
  3. Selezionare Abilita traccia dinamica.
  4. Selezionare il pulsante Salva e attendere l'applicazione delle modifiche.
  5. Selezionare Apri strumento di traccia dinamica.

Screenshot of opening the tool for live tracing.

Accedi con il tuo account Microsoft

  1. Quando si apre la finestra di accesso Microsoft nello strumento di traccia in tempo reale, immettere le credenziali. Se non viene visualizzata alcuna finestra di accesso, assicurarsi di consentire finestre popup nel browser.
  2. Attendere la visualizzazione di Ready (Pronto ) sulla barra di stato.

Acquisire tracce in tempo reale

Nello strumento di traccia in tempo reale è possibile:

  • Iniziare a acquisire tracce in tempo reale dall'istanza di Servizio Azure SignalR.
  • Cancellare le tracce in tempo reale acquisite.
  • Esportare le tracce live in un file. Il formato di file attualmente supportato è CSV.
  • Filtrare le tracce in tempo reale acquisite con una parola chiave specifica. I separatori (ad esempio, spazio, virgola o punto e virgola), se presenti, vengono considerati come parte della parola chiave .

Screenshot of capturing live traces with the live trace tool.

Le tracce in tempo reale acquisite dallo strumento contengono informazioni dettagliate per la risoluzione dei problemi.

Nome Descrizione
Time Registrare l'ora dell'evento.
Livello di log Livello di evento del log: Trace, Debug, Informational, Warningo Error.
Nome dell’evento Nome dell'operazione dell'evento del log.
Messaggio Messaggio dettagliato dell'evento del log.
Eccezione Eccezione di runtime del servizio Web PubSub di Azure.
Hub Nome dell'hub definito dall'utente.
ID Connessione ion Identità della connessione.
Tipo Connessione ion Tipo di connessione. I valori consentiti sono Server (connessioni tra server e servizio) e Client (connessioni tra client e servizio).
ID utente Identità dell'utente.
IP Indirizzo IP del client.
Server Sticky Modalità di routing del client. I valori consentiti sono Disabled, Preferrede Required. Per altre informazioni, vedere ServerStickyMode.
Trasporto Trasporto che il client può usare per inviare richieste HTTP. I valori consentiti sono WebSockets, ServerSentEventse LongPolling. Per altre informazioni, vedere HttpTransportType.
ID traccia messaggio Identificatore univoco per un messaggio.
Modello di route Modello di route dell'API.
Http, metodo Metodo HTTP: POST, GET, PUTo DELETE.
URL Localizzatore di risorse uniforme.
ID traccia Identificatore univoco per rappresentare una richiesta.
Codice di stato Codice di risposta HTTP.
Durata Durata tra la ricezione e l'elaborazione della richiesta.
Intestazioni Informazioni aggiuntive che il client e il server passano con una richiesta o una risposta HTTP.
ID chiamata Identificatore univoco per rappresentare una chiamata (disponibile solo per ASP.NET SignalR).
Tipo di messaggio Tipo del messaggio. Tra gli esempi sono inclusi BroadcastDataMessage, JoinGroupMessage e LeaveGroupMessage.

Passaggi successivi

Informazioni su come gestire i problemi comuni con lo strumento di traccia in tempo reale:

  • Per risolvere i problemi tipici in base alle tracce in tempo reale, vedere la guida alla risoluzione dei problemi.
  • Per la diagnosi automatica per trovare direttamente la causa radice o restringere il problema, vedere l'introduzione ai metodi di risoluzione dei problemi.