Panoramica dei log delle chiamate di Servizi di comunicazione di Azure

Servizi di comunicazione di Azure offre funzionalità di registrazione che è possibile usare per monitorare ed eseguire il debug della soluzione. Queste funzionalità vengono configurate tramite il portale di Azure.

Il contenuto di questo articolo riguarda i log abilitati tramite Monitoraggio di Azure (vedere anche domande frequenti). Per abilitare questi log per Servizi di comunicazione, vedere Abilitare la registrazione nelle impostazioni di diagnostica.

Importante

Se si desidera analizzarli, è necessario raccogliere i log. Per altre informazioni, vedere: Ricerca per categorie archiviare i log?

Azure non archivia i dati del log delle chiamate a meno che non si abiliti queste impostazioni di diagnostica specifiche. I dati delle chiamate non sono retroattivi. I dati vengono accumulati dopo aver creato le impostazioni di diagnostica.

Come usare i log delle chiamate

È consigliabile raccogliere tutti i log delle chiamate disponibili in una risorsa di Log Analytics in modo da poter monitorare l'utilizzo delle chiamate e migliorare la qualità delle chiamate e ricevere nuovi log da Servizi di comunicazione di Azure quando vengono rilasciati.

Esistono due strumenti principali che è possibile usare per monitorare le chiamate e migliorare la qualità delle chiamate.

• Dashboard di informazioni dettagliate vocali e video
• Diagnostica delle chiamate

È consigliabile usare i dashboard del dashboard voce e video insights per avviare eventuali indagini sulla qualità e usare la diagnostica delle chiamate in base alle esigenze per esplorare le singole chiamate quando sono necessari dettagli granulari.

Log disponibili

Servizi di comunicazione di Azure crea otto log delle chiamate:

Log di riepilogo delle chiamate:

Questi dati di log arrivano in Monitoraggio di Azure più velocemente rispetto ai log di riepilogo delle chiamate ed è consigliabile usare questi log anziché lo schema del log di riepilogo delle chiamate. Questo log contiene informazioni di base sulla chiamata, inclusi tutti gli ID, i timestamp, gli endpoint e le informazioni dell'SDK pertinenti.

Per altre informazioni, vedere: Chiamare lo schema del log degli aggiornamenti di riepilogo

Log di riepilogo delle chiamate:

Questo log è un sottoinsieme dello schema del log aggiornamenti di riepilogo delle chiamate. Contiene informazioni di base sulla chiamata, inclusi tutti gli ID, i timestamp, gli endpoint e le informazioni dell'SDK pertinenti. Per una latenza dei log più rapida, usare invece i log di riepilogo delle chiamate.

Per altre informazioni, vedere: Schema del log di riepilogo delle chiamate

Chiamare i log degli aggiornamenti di diagnostica:

Questi dati di log arrivano in Monitoraggio di Azure più velocemente rispetto ai log di diagnostica delle chiamate ed è consigliabile usare questi log anziché lo schema del log di diagnostica delle chiamate. Questo log contiene informazioni sul flusso multimediale di chiamata di un partecipante, insieme a un set di metriche che indicano la qualità delle misurazioni dell'esperienza.

Per altre informazioni, vedere: Chiamare lo schema del log degli aggiornamenti di diagnostica

Chiamare i log di diagnostica:

Questo log è un subset dello schema del log degli aggiornamenti della diagnostica delle chiamate. Contiene informazioni sul flusso, insieme a un set di metriche che indicano la qualità delle misurazioni dell'esperienza. Per una latenza dei log più rapida, usare invece i log di riepilogo delle chiamate.

Per altre informazioni, vedere: Chiamare lo schema del log di diagnostica

Chiamare i log delle operazioni client:

Contengono eventi client di chiamata dettagliati. Questi eventi di log vengono generati per ogni EndpointId durante una chiamata e il numero di log eventi generati dipenderà dalle operazioni eseguite dal partecipante durante la chiamata.

Per altre informazioni, vedere: Chiamare lo schema del log delle operazioni client

Chiamare i log delle statistiche dei supporti client:

Contengono valori dettagliati del flusso multimediale. Questi log vengono generati per ogni flusso multimediale in una chiamata. Per ogni EndpointId all'interno di una chiamata (incluso il server), Servizi di comunicazione di Azure crea un log distinto per ogni flusso multimediale (audio o video, ad esempio) tra gli endpoint. Il volume di dati generati in ogni log dipende dalla durata della chiamata e dal numero di flussi multimediali nella chiamata.

In una chiamata P2P ogni log contiene dati relativi a ognuno dei flussi in uscita associati a ogni endpoint. In una chiamata di gruppo, ogni flusso associato a endpointType = "Server" crea un log contenente i dati dei flussi in ingresso. Tutti gli altri flussi creano log che contengono dati dei flussi in uscita per tutti gli endpoint non server. Nelle chiamate di gruppo usare il valore participantId come chiave per unire i log in ingresso e in uscita relativi a una connessione partecipante distinta.

Per altre informazioni, vedere: Chiamare lo schema del log delle serie temporali delle statistiche multimediali del client

Log del sondaggio di fine chiamata:

Questi log vengono popolati quando il client chiamante Web invia un sondaggio alla fine della chiamata. È possibile usare questi log per apprendere la percezione soggettiva della qualità delle chiamate dagli utenti.

Per altre informazioni, vedere: Panoramica della fine del sondaggio di chiamata

Chiamare i log delle metriche:

Questi log contengono metriche di chiamata aggregate nei contenitori giornalieri in base a attributi come versione dell'SDK, nome del sistema operativo e codice secondario degli errori. Questi log vengono usati nel dashboard di informazioni dettagliate vocali e video per visualizzare grafici a lungo termine di affidabilità, qualità e prestazioni in base al numero di chiamate API SDK riuscite e non riuscite di varie operazioni.

Per altre informazioni, vedere: Chiamare lo schema del log delle metriche

Concetti relativi ai dati

Le descrizioni generali seguenti dei concetti relativi ai dati sono specifiche per le chiamate vocali e video. È importante esaminare questi concetti per comprendere il significato dei dati acquisiti nei log.

Entità e ID

Acquisire familiarità con i termini seguenti:

• Chiamata: come rappresentato nei dati, una chiamata è un'astrazione illustrata da correlationId. I valori per correlationId sono univoci per ogni chiamata e sono associati al tempo in base a callStartTime e callDuration.

• Partecipante: rappresenta la connessione tra un endpoint e il server. Un partecipante (participantId) è presente solo quando la chiamata è una chiamata di gruppo.

• Endpoint: si tratta dell'entità più univoca, rappresentata da endpointId. Ogni chiamata è un evento che contiene dati di due o più endpoint. Gli endpoint rappresentano i partecipanti alla chiamata.

  EndpointType indica se l'endpoint è un utente umano (PSTN o VoIP), un bot o il server che gestisce più partecipanti all'interno di una chiamata. Quando un valore endpointType è "Server", all'endpoint non viene assegnato un ID univoco. È possibile analizzare endpointType e il numero di valori endpointId per determinare quanti utenti e altri partecipanti non umani (bot e server) partecipano a una chiamata.

  Gli SDK nativi per Android e iOS riutilizzano per un utente lo stesso valore endpointId in più chiamate, in modo da poter comprendere le esperienze nelle varie sessioni. Questo processo è diverso da quello degli endpoint basati sul Web, che generano sempre un nuovo valore endpointId per ogni nuova chiamata.

• Stream: l'entità più granulare. Esiste un flusso per ogni direzione (in ingresso o in uscita) e un valore mediaType (ad esempio, Audio o Video).

Chiamate P2P e di gruppo

Nota

In questo articolo le chiamate P2P e di gruppo si trovano nello stesso tenant per impostazione predefinita. Tutti gli scenari di chiamata tra tenant vengono specificati di conseguenza in tutto l'articolo.

Esistono due tipi di chiamate, come rappresentato da callType:

• Chiamata peer-to-peer (P2P): connessione tra due soli endpoint, senza alcun endpoint server. Le chiamate P2P vengono avviate come una chiamata tra tali endpoint e non vengono create come evento di chiamata di gruppo prima della connessione.

  

• Chiamata di gruppo: qualsiasi chiamata con più di due endpoint connessi. Le chiamate di gruppo includono un endpoint server e la connessione tra ogni endpoint e il server. Le chiamate P2P che aggiungono un altro endpoint durante la chiamata cessano di essere P2P e diventano una chiamata di gruppo. È possibile determinare la sequenza temporale del momento in cui ogni endpoint è stato aggiunto alla chiamata tramite le metriche participantStartTime e participantDuration.

  

Esempi di vari tipi di chiamata

Nota

In questo articolo le chiamate P2P e di gruppo si trovano nello stesso tenant per impostazione predefinita. Tutti gli scenari di chiamata tra tenant vengono specificati di conseguenza in tutto l'articolo.

Esempio: chiamata P2P

Il diagramma seguente rappresenta due endpoint connessi direttamente in una chiamata P2P. In questo esempio, Servizi di comunicazione crea due log di riepilogo delle chiamate (uno per ogni participantID valore) e quattro log di diagnostica delle chiamate (uno per ogni flusso multimediale).

Per i partecipanti del client di chiamata di Servizi di comunicazione di Azure è disponibile anche una serie di log delle operazioni client di chiamata e di log delle serie temporali delle statistiche multimediali del client. Il numero esatto di questi log dipende dal tipo di operazioni SDK che vengono chiamate e dalla durata della chiamata.

Esempio: Chiamata di gruppo

Il diagramma seguente rappresenta un esempio di chiamata di gruppo con tre valori participantId (ovvero tre partecipanti) e un endpoint server. Più valori endpointId possono potenzialmente comparire in relazione a più partecipanti, ad esempio quando questi rientrano in una chiamata dallo stesso dispositivo. Servizi di comunicazione crea un log di riepilogo della chiamata per ogni valore participantId. Crea quattro log di diagnostica delle chiamate: uno per ogni flusso multimediale per participantId.

Per i partecipanti alle chiamate di Servizi di comunicazione di Azure, i log delle operazioni del client di chiamata sono uguali a quelli delle chiamate P2P. Per ogni partecipante che usa l’SDK chiamate, è disponibile una serie di log delle operazioni del client di chiamata.

Per i partecipanti del client di chiamata di Servizi di comunicazione di Azure, i log delle operazioni del client di chiamata e i log delle serie temporali delle statistiche multimediali del client di chiamata client sono uguali a quelli delle chiamate P2P. Per ogni partecipante che usa l'SDK chiamate, sono disponibili una serie di log delle operazioni del client di chiamata e i log delle serie temporali delle statistiche multimediali del client di chiamata.

Esempio: Chiamata P2P tra più tenant

Il diagramma seguente rappresenta due partecipanti su più tenant connessi direttamente in una chiamata P2P. In questo esempio, Servizi di comunicazione crea un log di riepilogo della chiamata (uno per ogni partecipante) con versioni del sistema operativo e dell'SDK elaborate. Servizi di comunicazione crea anche quattro log di diagnostica delle chiamate (uno per ogni flusso multimediale). Ogni log contiene dati relativi al flusso in uscita di participantID.

Esempio: Chiamata di gruppo tra più tenant

Il diagramma seguente rappresenta l’esempio di una chiamata di gruppo con tre valori participantId su più tenant. Servizi di comunicazione crea un log di riepilogo della chiamata per ogni partecipante, con versioni del sistema operativo e dell'SDK elaborate. Servizi di comunicazione crea anche quattro log di diagnostica delle chiamate correlati a ogni participantId valore (uno per ogni flusso multimediale).

Nota

Questa versione supporta solo i log di diagnostica in uscita. Le versioni del sistema operativo e dell'SDK associate al bot e al partecipante possono essere elaborate perché Servizi di comunicazione tratta le identità dei partecipanti e dei bot allo stesso modo.

Domande frequenti

Ricerca per categorie archiviare i log?

La sezione seguente illustra questo requisito.

Servizi di comunicazione di Azure i log non vengono archiviati nell'account Azure per impostazione predefinita, quindi è necessario iniziare a archiviarli in modo da poter usare strumenti come dashboard voce e informazioni dettagliate video e chiamare la diagnostica. Per raccogliere questi log delle chiamate, è necessario abilitare un'impostazione di diagnostica che indirizza i dati delle chiamate a un'area di lavoro Log Analytics.

I dati non vengono archiviati retroattivamente, quindi si inizia a acquisire i log delle chiamate solo dopo aver configurato l'impostazione di diagnostica.

Per aggiungere impostazioni di diagnostica per la risorsa, seguire le istruzioni disponibili in Abilitare i log tramite Impostazioni di diagnostica in Monitoraggio di Azure. È consigliabile raccogliere inizialmente tutti i log. Dopo aver compreso le funzionalità in Monitoraggio di Azure, determinare quali log conservare e per quanto tempo. Quando si aggiunge l'impostazione di diagnostica, viene richiesto di selezionare i log. Per raccogliere tutti i log, selezionare allLogs.

Il volume, la conservazione e l'utilizzo dei dati in Log Analytics in Monitoraggio di Azure vengono fatturati tramite contatori dati di Azure esistenti. Per considerazioni specifiche relative ai costi, è consigliabile monitorare i criteri di utilizzo e conservazione dei dati. Per altre informazioni, vedere Controllo dei costi.

Se sono presenti più ID risorsa di Servizi di comunicazione di Azure, è necessario abilitare queste impostazioni per ogni ID risorsa.

Passaggi successivi

• Per informazioni sulle procedure consigliate per gestire la qualità e l'affidabilità delle chiamate, vedere: Migliorare e gestire la qualità delle chiamate

• Informazioni sul dashboard delle informazioni dettagliate per monitorare i log delle chiamate vocali e delle videochiamate.

• Per informazioni sull’uso dei log delle chiamate per diagnosticare problemi di qualità e affidabilità delle chiamate con Diagnostica chiamata, vedere: Diagnostica chiamata