Поддержка: рекомендации для партнеров

В этом документе содержатся рекомендации для партнеров Fabric по поддержке своих клиентов. В ней рассматриваются рекомендации по поддержанию, сохранению и сопоставлению важных заголовков запросов, а также рекомендации по ведению журнала, мониторингу и поддержке.

Обзор

Fabric позволяет сторонним партнерам интегрировать свои службы в платформу с помощью пакета средств разработки Fabric. В этом документе описаны методики поддержки, которые должны следовать партнерам, чтобы обеспечить эффективное устранение неполадок и поддержку клиентов.

Заголовки запроса

Fabric предоставляет два важных заголовка в запросах , сделанных между клиентом и Fabric, которые являются важными для поддержки:

• ActivityId: глобальный уникальный идентификатор, который можно использовать разработчиком, чтобы сопоставить запрос с системами, когда пользователь Fabric взаимодействует с рабочей нагрузкой.
• RequestId: глобальный уникальный идентификатор, который помогает нам (Fabric) сопоставлять запрос с нашими трассировками, что поможет нам изучить проблему и помочь вам. Если вы не можете определить проблему в конечном итоге с помощью ActivityId, вы можете предоставить RequestId нам доступ к нам при составлении отчетов о проблеме. Убедитесь, что вы поддерживаете и сохраняете его RequestId , чтобы его можно было легко предоставить позже.

Рекомендации по поддержке

Для эффективной поддержки клиентов важно поддерживать, сохранять и сопоставлять эти идентификаторы. Вот некоторые рекомендации:

1. Ведение журнала

• Хранение журналов. Убедитесь, что журналы хранятся в течение достаточного периода, чтобы обеспечить эффективное устранение неполадок.
• Подробное ведение журнала. Включите RequestId ActivityId и во все соответствующие записи журнала. Это поможет вам отслеживать поток запроса через систему.

2. Мониторинг

• Мониторинг в режиме реального времени. Реализация мониторинга в режиме реального времени для обнаружения и оповещения о проблемах при их возникновении. Это включает в себя мониторинг частоты запросов, частоты ошибок и производительности системы.
• Корреляция с заголовками. Убедитесь, что средства мониторинга могут сопоставлять журналы и метрики с помощью ActivityId и RequestId. Это поможет вам быстро определить и диагностировать проблемы.

3. Поддержка

• Поддержка клиентов: обучите свою службу поддержки, чтобы попросить ActivityId RequestId и при работе с проблемами с клиентами. Это ускорит процесс устранения неполадок.
• Документация. Предоставьте клиентам четкую документацию по получению и использованию этих идентификаторов при создании отчетов.

Пример рабочего процесса

1. Запись журнала: при получении запроса регистрируются ActivityId и RequestId вместе с другими соответствующими сведениями.
2. Монитор: используйте средства мониторинга для отслеживания запроса в режиме реального времени, коррелируя с идентификаторами.
3. Устранение неполадок. Если возникла проблема, используйте ActivityId запрос и RequestId трассировку запроса по журналам и системам.
4. Поддержка: когда клиент сообщает о проблеме, попросите ActivityId и RequestId быстро найти соответствующие журналы и предоставить помощь. Если проблема не может быть определена в конце, предоставьте RequestId поддержку Fabric для дальнейшего изучения.

Заключение

Следуя этим рекомендациям, партнеры могут эффективно поддерживать своих клиентов на платформе данных Fabric, обеспечивая простой и эффективный процесс устранения неполадок. Надлежащее ведение журнала, мониторинг, управление запросами и протоколы поддержки необходимы для поддержания высокого качества обслуживания и удовлетворенности клиентов.