Supporto: procedure consigliate per i partner
Questo documento fornisce indicazioni pensate per i partner di Fabric su come supportare i clienti. Vengono illustrate le procedure consigliate per la gestione, il salvataggio e la correlazione di intestazioni di richiesta importanti, nonché raccomandazioni per la registrazione, il monitoraggio e il supporto.
Panoramica
Fabric consente ai partner di terze parti di integrare i propri servizi nella piattaforma usando il Kit di sviluppo Fabric. Questo documento descrive le procedure di supporto che i partner devono seguire per garantire una risoluzione dei problemi efficace e il supporto tecnico.
Intestazioni della richiesta
Fabric espone due intestazioni importanti nelle richieste effettuate tra il cliente e Fabric, fondamentali per il supporto:
- ActivityId: ID univoco globale che può essere usato dall'utente, lo sviluppatore, per correlare la richiesta ai sistemi quando un utente di Fabric interagisce con il carico di lavoro.
- RequestId: ID univoco globale che consente a Microsoft (Fabric) di correlare la richiesta con le tracce, che ci aiuteranno ad analizzare il problema e a fornire la giusta assistenza. Se non è possibile determinare il problema alla fine usando
ActivityId
, è possibile fornireRequestId
a Microsoft quando si segnala un problema. Assicurarsi di mantenere e salvareRequestId
in modo che possa essere facilmente fornito in un secondo momento.
Procedure consigliate per il supporto
Per supportare efficacemente i clienti, è essenziale gestire, salvare e correlare questi ID. Ecco alcune procedure consigliate:
1. Registrazione
- Conservazione dei log: assicurarsi che i log vengano conservati per un periodo sufficiente per consentire una risoluzione dei problemi efficace.
- Registrazione dettagliata: includere
ActivityId
eRequestId
in tutte le voci di log pertinenti. In questo modo è possibile tracciare il flusso di una richiesta tramite il sistema.
2. Monitoraggio
- Monitoraggio in tempo reale: implementare il monitoraggio in tempo reale per rilevare i problemi man mano che si verificano e avvisare l'utente di conseguenza. Sono inclusi il monitoraggio dei tassi di richiesta, i tassi di errore e le prestazioni del sistema.
- Correlazione con le intestazioni: assicurarsi che gli strumenti di monitoraggio possano correlare log e metriche usando
ActivityId
eRequestId
. Aiuta a identificare i problemi e a diagnosticarli rapidamente.
3. Supporto
- Supporto tecnico: formare il team di supporto per richiedere
ActivityId
eRequestId
quando si gestiscono i problemi dei clienti. In questo modo verrà accelerato il processo di risoluzione dei problemi. - Documentazione: fornire ai clienti una documentazione chiara su come ottenere e usare questi ID quando si segnalano problemi.
Esempio di flusso di lavoro
- Voce di log: quando viene ricevuta una richiesta, registrare
ActivityId
eRequestId
insieme ad altre informazioni pertinenti. - Monitoraggio: usare gli strumenti di monitoraggio per tenere traccia della richiesta in tempo reale, correlando con gli ID.
- Risoluzione dei problemi: se si verifica un problema, usare
ActivityId
eRequestId
per tracciare la richiesta tramite i log e i sistemi. - Supporto: quando un cliente segnala un problema, chiedere
ActivityId
eRequestId
per individuare rapidamente i log pertinenti e fornire assistenza. Se il problema non può essere determinato alla fine, fornireRequestId
al supporto di Fabric per ulteriori indagini.
Conclusione
Seguendo queste procedure consigliate, i partner possono supportare efficacemente i clienti nella piattaforma dati di Fabric, garantendo un processo di risoluzione dei problemi facile ed efficiente. La registrazione, il monitoraggio, la gestione delle richieste e i protocolli di supporto appropriati sono essenziali per mantenere una qualità elevata del servizio e la soddisfazione dei clienti.