サポート可能性: パートナー向けのベスト プラクティス
このドキュメントでは、Fabric のパートナーが顧客をサポートする方法に関するガイダンスを提供します。 重要なリクエスト ヘッダーの維持、保存、関連付けのベスト プラクティスと、ログ記録、監視、サポートに関する推奨事項について説明します。
概要
Fabric を使用すると、サードパーティパートナーは Fabric 開発キットを使用してサービスをプラットフォームに統合できます。 このドキュメントでは、効果的なトラブルシューティングとカスタマー サポートを確保するためにパートナーが従う必要があるサポートのプラクティスについて説明します。
要求ヘッダー
Fabric は、顧客と Fabric の間で行われるリクエストで、サポート可能性にとって非常に重要な 2 つの重要なヘッダーを公開します。
- ActivityId: 開発者が、Fabric ユーザーがワークロードと対話するときに要求をシステムと関連付けるために使用できるグローバルに一意の ID。
- RequestId: グローバルに一意の ID です。これにより、Fabric はお客様のリクエストとトレースを関連付けることができ、問題の調査とサポートに役立ちます。
ActivityIdを使用してエンド で問題を特定できない場合は、問題を報告するときにRequestIdを Microsoft に提供できます。 後で簡単に提供できるように、RequestIdを維持して保存してください。
サポートのベスト プラクティス
顧客を効果的にサポートするには、これらの ID を維持、保存、関連付ける必要があります。 いくつかのベスト プラクティスを次に示します。
1. ログ記録
- ログの保持: 効果的なトラブルシューティングを可能にするために、ログが十分な期間保持されていることを確認します。
- 詳細なログ記録: 関連するすべてのログ エントリに
ActivityIdとRequestIdを含めます。 これは、システムを介して要求のフローをトレースするのに役立ちます。
2. 監視
- リアルタイム監視: リアルタイム監視を実装して、問題が発生したときに検出してアラートを生成します。 これには、要求レート、エラー率、システム パフォーマンスの監視が含まれます。
- ヘッダーとの相関関係: 監視ツールで、
ActivityIdとRequestIdを使用してログとメトリックを関連付けられるようにします。 これにより、問題を迅速に特定して診断できるようになります。
3. サポート
- カスタマー サポート: 顧客の問題に対処するときに
ActivityIdとRequestIdを要求するようにサポート チームをトレーニングします。 これにより、トラブルシューティング プロセスが迅速化されます。 - ドキュメント: 問題を報告するときにこれらの ID を取得して使用する方法について、顧客に明確なドキュメントを提供します。
ワークフローの例
- ログ エントリ: 要求を受信したら、
ActivityIdとRequestIdをその他の関連情報とともにログに記録します。 - 監視: 監視ツールを使用して要求をリアルタイムで追跡し、ID と関連付けます。
- トラブルシューティング: 問題が発生した場合は、
ActivityIdとRequestIdを使用して、ログとシステムを介して要求をトレースします。 - サポート: 顧客が問題を報告したら、関連するログをすばやく見つけて支援を提供するために、
ActivityIdとRequestIdを要求します。 問題が最終的に特定できない場合は、RequestIdを Fabric サポートに提供して、さらに調査を行ってください。
まとめ
これらのベスト プラクティスに従うことで、パートナーは Fabric データ プラットフォームで顧客を効果的にサポートし、シームレスで効率的なトラブルシューティング プロセスを実現できます。 高いサービス品質と顧客満足度を維持するには、適切なログ記録、監視、要求管理、サポート プロトコルが不可欠です。