Compatibilidad: procedimientos recomendados para asociados

En este documento se proporcionan instrucciones para los asociados de Fabric sobre cómo ayudar a sus clientes. Trata los procedimientos recomendados para mantener, guardar y correlacionar encabezados de solicitud importantes, así como recomendaciones para el registro, la supervisión y el soporte técnico.

Información general

Fabric permite a los asociados de terceros integrar sus servicios en la plataforma mediante el Kit de desarrollo de Fabric. En este documento se describen los procedimientos de compatibilidad que deben seguir los asociados para garantizar una solución de problemas eficaz y la asistencia al cliente.

Encabezados de solicitud

Fabric expone dos encabezados importantes en las solicitudes realizadas entre el cliente y Fabric, que son cruciales para la compatibilidad:

• ActivityId: un identificador único global que puede usar usted, el desarrollador, para correlacionar la solicitud con los sistemas cuando un usuario de Fabric interactúa con la carga de trabajo.
• RequestId: un identificador único global que nos ayuda (Fabric) a correlacionar su solicitud con nuestros seguimientos, lo que nos ayudará a investigar el problema y ayudarle. Si no puede determinar el problema al final mediante ActivityId, puede proporcionarnos RequestId al informar de un problema. Asegúrese de mantener y guardar RequestId para que se pueda proporcionar fácilmente más adelante.

Procedimientos recomendados para la compatibilidad

Para ayudar eficazmente a los clientes, es esencial mantener, guardar y correlacionar estos identificadores. Estos son algunos procedimientos recomendados:

1. Registro

• Retención de registros: asegúrese de que los registros se conservan durante un período suficiente para permitir una solución de problemas eficaz.
• Registro detallado: incluya ActivityId y RequestId en todas las entradas de registro pertinentes. Esto le ayudará a realizar un seguimiento del flujo de una solicitud a través del sistema.

2. Supervisión

• Supervisión en tiempo real: implemente la supervisión en tiempo real para detectar y alertar sobre los problemas a medida que se producen. Esto incluye la supervisión de las tasas de solicitudes, las tasas de error y el rendimiento del sistema.
• Correlación con encabezados: asegúrese de que las herramientas de supervisión pueden correlacionar registros y métricas mediante ActivityId y RequestId. Le ayudará a identificar problemas y diagnosticarlos rápidamente.

3. Soporte técnico

• Asistencia al cliente: entrene al equipo de soporte técnico para solicitar ActivityId y RequestId al tratar con los problemas del cliente. Esto acelerará el proceso de solución de problemas.
• Documentación: proporcione documentación clara a los clientes sobre cómo obtener y usar estos identificadores al notificar problemas.

Flujo de trabajo de ejemplo

1. Entrada de registro: cuando se recibe una solicitud, registre ActivityId y RequestId junto con otra información relevante.
2. Supervisión: utilice herramientas de supervisión para realizar un seguimiento de la solicitud en tiempo real, en correlación con los identificadores.
3. Solución de problemas: si surge un problema, use ActivityId y RequestId para realizar un seguimiento de la solicitud a través de los registros y sistemas.
4. Soporte: cuando un cliente informa de un problema, solicite ActivityIdy RequestId para buscar rápidamente los registros pertinentes y proporcionar asistencia. Si no puede determinar el problema por su cuenta, proporcione RequestId al equipo de asistencia técnica de Fabric para una investigación más detallada.

Conclusión

Siguiendo estos procedimientos recomendados, los asociados pueden ayudar eficazmente a sus clientes en la plataforma de datos de Fabric, lo que garantiza un proceso de solución de problemas sin obstáculos y eficaz. Los protocolos de registro, supervisión, administración de solicitudes y soporte técnico adecuados son esenciales para mantener la alta calidad del servicio y la satisfacción del cliente.