Solución de los problemas de integración

En esta página, se describe cómo obtener información sobre los errores que se produjeron en tus cargas de datos (catálogo y eventos de usuario) y predicciones.

Para obtener ayuda con la configuración de alertas, consulta Configura alertas.

Introducción

Proporcionar información de catálogo precisa y eventos de usuario a Recomendaciones IA es importante para obtener las recomendaciones de mejor calidad. Comprender el origen de los errores de carga y predicción de datos te ayuda a encontrar y corregir cualquier error en tu sitio.

Consulta los errores de integración agregada

Para ver los errores agregados generados por tus procesos de carga de datos y solicitudes de predicción, usa la página de errores.

Pestaña Errores

Haz clic en las pestañas para elegir entre Errores del catálogo de productos, Errores de eventos del usuario y Predecir errores. El sistema también registra los errores de las importaciones de eventos o catálogos de usuario, como una línea con formato incorrecto en tu archivo de Google Cloud Storage. Nuestro sistema registra hasta 100 errores por archivo de importación. Puedes definir el período de tiempo para el que se muestran los errores y filtrar según el tipo de error.

Puedes hacer clic en un error individual para ver los registros de ese error en Cloud Logging.

Este es un ejemplo de registros de un error individual:

Registros de errores

Puedes abrir los registros de errores individuales si expandes ese registro. Los registros de errores proporcionan más detalles sobre la solicitud, incluidas las cargas útiles de solicitud y respuesta, y detalles de error. Esta información puede ayudarte a determinar dónde se encuentra la llamada de método erróneo en tu sitio.

Por ejemplo, el siguiente es un registro de errores expandido para mostrar la información de la carga útil de la solicitud:

Vista detallada de registro

Si deseas obtener errores de JSON no válidos, puedes obtener más información sobre el problema si expandes el campo status:

Vista detallada de registro para error JSON

Cómo ver el estado de una operación de integración específica

Puedes ver el estado de una operación de integración específica en el panel de actividad de integración:

  1. Ve a la página de datos de Recomendaciones IA en Google Cloud Console.
    Ir a la página de datos de Recomendaciones IA

  2. Para abrir el panel de actividad de importación, haz clic en Ver actividad de importación en el lado derecho de la barra de botones.

    Puedes inspeccionar los errores de las operaciones de integración específicas.

  3. Haz clic en Ver registros en la columna Detalles de cualquier operación con un error para inspeccionar sus archivos de registro en Cloud Logging.

Panel de actividades de importación

Tipos de errores

  • MISSING_FIELD: no se estableció un valor de campo obligatorio. Por ejemplo, falta el título de un artículo del catálogo.
  • INVALID_TIMESTAMP: La marca de tiempo no es válida. Por ejemplo, corresponde a una fecha demasiado lejana en el futuro o tiene un formato incorrecto.
  • FIELD_VALUE_TOO_SMALL: el valor del campo es menor que el mínimo requerido. por ejemplo, un precio negativo.
  • INCORRECT_JSON_FORMAT: el JSON de la solicitud tiene un formato incorrecto. Por ejemplo, falta una llave de apertura “{”.
  • INVALID_LANGUAGE_CODE: El código de idioma tiene un formato incorrecto.
  • FIELD_VALUE_EXCEEDED: El valor en el campo es mayor que el máximo permitido.
  • INVALID_RESOURCE_ID: El ID del recurso no es válido. Por ejemplo, un catalog_id no existe en el nombre del recurso.
  • FIELD_SIZE_EXCEEDED: la cantidad de entradas en el campo supera el límite máximo.
  • UNEXPECTED_FIELD: Un campo que debería estar vacío tiene un valor. Por ejemplo, una transacción para un evento de visualización de página de detalles.
  • INVALID_FORMAT: el campo no tiene un formato correcto, como una string con formato incorrecto
  • RESOURCE_ALREADY_EXISTS: Intentaste crear un recurso que ya existe, como un elemento de catálogo creado anteriormente.
  • INVALID_API_KEY: La clave de API no coincide con el proyecto de tu solicitud.
  • INSUFFICIENT_PERMISSIONS: no tienes permiso para ejecutar la solicitud; este error generalmente se relaciona con la falta de un permiso de IAM requerido.
  • UNJOINED_WITH_CATALOG: la solicitud incluye un ID de elemento de catálogo que no existe en el catálogo. Asegúrate de que el catálogo esté actualizado.
  • BATCH_ERROR: La solicitud tiene varios errores. Por ejemplo, una importación intercalada con 10 elementos que fallan en la validación por diferentes motivos.
  • INACTIVE_RECOMMENDATION_MODEL: Consultó un modelo que no está activo para la entrega.
  • ABUSIVE_ENTITY: El ID de visitante o ID de usuario asociado con la solicitud envió una cantidad anormal de eventos en un período corto.
  • FILTER_TOO_STRICT: El filtro de solicitud de predicción bloqueó todos los resultados de la predicción. Se muestran elementos populares genéricos (no personalizados), a menos que la llamada especificada strictFiltering como falso, en cuyo caso no se muestra ningún elemento. Algunas de las razones comunes por las que se produce este problema son las siguientes:

    • Especificas una etiqueta de filtro que no existe en tu catálogo. La actualización de una etiqueta de filtro puede demorar hasta un día en aplicarse.
    • El filtro es demasiado limitado.

Visualiza registros directamente

También puedes abrir los archivos de registro directamente en Logging. Por ejemplo, este vínculo abre los registros de todos los errores de Recomendaciones IA en la última hora:

Abrir registros de Recomendaciones IA

Visualiza métricas de carga de datos de alto nivel

Una vez que tu sistema de carga de datos se ejecute con éxito, también puedes usar las pestañas Catálogo y Evento en la página de datos de Recomendaciones IA para ver las métricas de errores de alto nivel en tus datos. para garantizar que todo funcione sin problemas.

También puedes agregar alertas para informarte si hay algún problema con tu sistema de carga de datos.

Resumen de datos de catálogo

Las estadísticas de datos de alto nivel en la pestaña Catálogo muestran cuántos elementos importaste, cuántos están en stock y cuándo fue la última vez que importaste los elementos del catálogo.

También puedes obtener una vista previa de los elementos del catálogo que subiste y filtrar según el ID de elemento del catálogo.

Datos de importación de catálogos

Estadísticas de grabación de eventos de usuarios

Para cada tipo de evento del usuario, puedes ver en la pestaña Eventos cuántos eventos has registrado, cuántos de ellos no se pueden asociar con un elemento del catálogo (eventos no unidos) y cómo difieren las cifras de períodos anteriores. Puedes elegir un período de tiempo de un día, una semana y un mes, o puedes ingresar un intervalo de tiempo personalizado.

Puedes ver un gráfico de los eventos de usuario transferidos a lo largo del tiempo y filtrarlos por tipo de evento del usuario.

Estadísticas de eventos del usuario

Eventos no unidos

Cuando un evento de usuario o una solicitud de predicción hace referencia a un elemento de catálogo que no se subió a Recomendaciones IA, se trata de un evento sin unir. Los eventos de usuarios no unidos aún se registran, y se manejan las solicitudes de predicción no unidas, pero no se pueden utilizar para mejorar aún más el modelo para predicciones futuras. Por esta razón, debes asegurarte de que tu porcentaje de eventos no registrados sea muy bajo tanto para los eventos del usuario como para las solicitudes de predicción.

Puedes ver el porcentaje de eventos no unidos de usuarios en la pestaña Eventos de la página Datos:

Eventos de usuario no unidos

Puedes ver el porcentaje de solicitudes de predicción no unidas en la página de posiciones:

Solicitudes de predicción sin unirse

Errores de la API

Puedes ver un gráfico de errores de la API a lo largo del tiempo si se muestra por nombre de método. Para ello, haz clic en Ver métricas de la API en la barra de botones de la página Errores.

¿Qué sigue?