Prise en charge : Meilleures pratiques pour les partenaires

Ce document fournit des conseils aux partenaires de Fabric sur la façon de prendre en charge leurs clients. Il couvre les meilleures pratiques de maintenance, d’enregistrement et de corrélation des en-têtes de requête importants, ainsi que des recommandations pour la journalisation, la supervision et la prise en charge.

Vue d’ensemble

Fabric permet aux partenaires tiers d’intégrer leurs services à la plateforme à l’aide du Kit de développement Fabric. Ce document décrit les pratiques de prise en charge que les partenaires doivent suivre pour garantir une résolution des problèmes et un support client efficaces.

En-têtes de requête

Fabric expose deux en-têtes importants dans les requêtes faites entre le client et Fabric, qui sont cruciaux pour la prise en charge :

• ActivityId : un ID unique au monde qui peut être utilisé par vous, le développeur, pour corréler la requête avec vos systèmes lorsqu’un utilisateur Fabric interagit avec votre charge de travail.
• RequestId : un ID unique au monde qui nous aide (Fabric) à établir une corrélation entre votre requête et nos traces, ce qui nous permet d’enquêter sur le problème et de vous aider. Si vous ne parvenez pas à déterminer le problème de votre côté en utilisant les ActivityId, vous pouvez nous fournir les RequestId lors du signalement d’un problème. Assurez-vous que vous conservez et enregistrez les RequestId afin qu’elles puissent être facilement fournies ultérieurement.

Meilleures pratiques pour la prise en charge

Pour prendre en charge efficacement vos clients, il est essentiel de maintenir, d’enregistrer et de mettre en corrélation ces ID. Voici quelques bonnes pratiques :

1. Journalisation

• Rétention des journaux : assurez-vous que les journaux sont conservés pendant une période suffisante pour permettre une résolution efficace des problèmes.
• Journalisation détaillée : incluez les ActivityId et les RequestId dans toutes les entrées de journal pertinentes. Cela vous aidera à suivre le flux d’une requête via votre système.

2. Surveillance

• Surveillance en temps réel : mettez en œuvre une surveillance en temps réel pour détecter et alerter sur les problèmes au fur et à mesure qu’elles se produisent. Cela inclut la surveillance des taux de requêtes, des taux d’erreur et des performances système.
• Corrélation avec les en-têtes : assurez-vous que vos outils de surveillance peuvent mettre en corrélation les journaux et les métriques à l’aide des ActivityId et RequestId. Cela vous aidera à identifier et à diagnostiquer rapidement les problèmes.

3. Support

• Support client : formez votre équipe de support à demander les ActivityId et RequestId lorsqu’elle traite les problèmes des clients. Cela accélère le processus de résolution des problèmes.
• Documentation : fournissez une documentation claire à vos clients sur la façon d’obtenir et d’utiliser ces ID lors de la création de rapports de problèmes.

Exemple de workflow

1. Entrée du journal : lorsqu’une requête est reçue, connectez les ActivityId et RequestId avec d’autres informations pertinentes.
2. Surveiller : utilisez des outils de surveillance pour suivre la requête en temps réel, en corrélation avec les ID.
3. Résoudre les problèmes : si un problème se produit, utilisez les ActivityId et RequestId suivez la requête via vos journaux et systèmes.
4. Support : lorsqu’un client signale un problème, demandez-lui les ActivityId et RequestId pour localiser rapidement les journaux pertinents et fournir une aide. Si vous ne parvenez pas à résoudre le problème, transmettez les RequestId au service de support de Fabric pour qu’il procède à des recherches plus approfondies.

Conclusion

En suivant ces bonnes pratiques, les partenaires peuvent prendre en charge efficacement leurs clients sur la plateforme de données Fabric, ce qui garantit un processus de résolution des problèmes transparent et efficace. La journalisation, la surveillance, la gestion des requêtes et les protocoles de support appropriés sont essentielles pour maintenir la haute qualité de service et la satisfaction des clients.