Condividi tramite


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 fornire RequestId a Microsoft quando si segnala un problema. Assicurarsi di mantenere e salvare RequestId 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 e RequestId 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 e RequestId. Aiuta a identificare i problemi e a diagnosticarli rapidamente.

3. Supporto

  • Supporto tecnico: formare il team di supporto per richiedere ActivityId e RequestId 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

  1. Voce di log: quando viene ricevuta una richiesta, registrare ActivityId e RequestId insieme ad altre informazioni pertinenti.
  2. Monitoraggio: usare gli strumenti di monitoraggio per tenere traccia della richiesta in tempo reale, correlando con gli ID.
  3. Risoluzione dei problemi: se si verifica un problema, usare ActivityId e RequestId per tracciare la richiesta tramite i log e i sistemi.
  4. Supporto: quando un cliente segnala un problema, chiedere ActivityId e RequestId per individuare rapidamente i log pertinenti e fornire assistenza. Se il problema non può essere determinato alla fine, fornire RequestId 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.