Partilhar via


Capacidade de suporte: melhores práticas para parceiros

Este documento fornece orientações para os parceiros da Fabric sobre como dar suporte aos seus clientes. Ele abrange as práticas recomendadas para manter, salvar e correlacionar cabeçalhos de solicitação importantes, bem como recomendações para registro, monitoramento e suporte.

Descrição geral

O Fabric permite que parceiros terceirizados integrem seus serviços à plataforma usando o Fabric Development Kit. Este documento descreve as práticas de suporte que os parceiros devem seguir para garantir uma solução de problemas eficaz e suporte ao cliente.

Cabeçalhos dos Pedidos

O Fabric expõe dois cabeçalhos importantes em solicitações feitas entre o cliente e o Fabric, que são cruciais para a capacidade de suporte:

  • ActivityId: um ID globalmente exclusivo que pode ser usado por você, o desenvolvedor, para correlacionar a solicitação com seus sistemas quando um usuário do Fabric interage com sua carga de trabalho.
  • RequestId: Um ID exclusivo globalmente que nos ajuda (Fabric) a correlacionar sua solicitação com nossos rastreamentos, o que nos ajudará a investigar o problema e ajudá-lo. Se você não puder determinar o problema do seu lado usando o ActivityId, você pode nos fornecer o RequestId ao relatar um problema. Certifique-se de manter e salvar o RequestId para que ele possa ser facilmente fornecido mais tarde.

Práticas recomendadas para suporte

Para oferecer suporte eficaz aos seus clientes, é essencial manter, salvar e correlacionar esses IDs. Aqui estão algumas melhores práticas:

1. Registo

  • Retenção de logs: certifique-se de que os logs sejam retidos por um período suficiente para permitir uma solução de problemas eficaz.
  • Registro detalhado: inclua o ActivityId e RequestId em todas as entradas de log relevantes. Isso irá ajudá-lo a rastrear o fluxo de uma solicitação através do seu sistema.

2. Monitorização

  • Monitoramento em tempo real: Implemente o monitoramento em tempo real para detetar e alertar sobre problemas à medida que eles ocorrem. Isso inclui monitorar as taxas de solicitação, as taxas de erro e o desempenho do sistema.
  • Correlação com cabeçalhos: certifique-se de que suas ferramentas de monitoramento possam correlacionar logs e métricas usando o ActivityId e RequestId. Isso irá ajudá-lo a identificar e diagnosticar problemas rapidamente.

3. Apoio

  • Suporte ao cliente: Treine sua equipe de suporte para solicitar o e RequestId quando lidar com problemas do ActivityId cliente. Isso agilizará o processo de solução de problemas.
  • Documentação: forneça documentação clara aos seus clientes sobre como obter e usar esses IDs ao relatar problemas.

Fluxo de Trabalho de Exemplo

  1. Entrada de log: Quando uma solicitação é recebida, registre o ActivityId e RequestId junto com outras informações relevantes.
  2. Monitor: Use ferramentas de monitoramento para acompanhar a solicitação em tempo real, correlacionando com os IDs.
  3. Solução de problemas: Se surgir um problema, use o ActivityId e RequestId para rastrear a solicitação através de seus logs e sistemas.
  4. Suporte: Quando um cliente relata um problema, peça o ActivityId e RequestId localize rapidamente os logs relevantes e forneça assistência. Se o problema não puder ser determinado do seu lado, forneça o RequestId suporte ao Fabric para investigação adicional.

Conclusão

Seguindo essas práticas recomendadas, os parceiros podem oferecer suporte eficaz a seus clientes na plataforma de dados Fabric, garantindo um processo de solução de problemas contínuo e eficiente. Registro adequado, monitoramento, gerenciamento de solicitações e protocolos de suporte são essenciais para manter a alta qualidade do serviço e a satisfação do cliente.