Notificaciones de ingesta de datos

El proceso de ingesta de datos en Adobe Experience Platform consta de varios pasos. Una vez que identifique los archivos de datos que deben ingerirse en Platform, el proceso de ingesta comienza y cada paso se produce de forma consecutiva hasta que los datos se incorporan correctamente o no. El proceso de ingesta se puede iniciar utilizando la API de ingesta de datos de Adobe Experience Platform o utilizando la interfaz de usuario Experience Platform.

Los datos cargados en Platform deben seguir varios pasos para llegar a su destino, al Data Lake o al Real-time Customer Profile almacén de datos. Cada paso implica procesar los datos, validarlos y, después, almacenarlos antes de pasarlos al siguiente paso. En función de la cantidad de datos introducidos, este proceso puede llevar mucho tiempo y siempre existe la posibilidad de que el proceso falle debido a errores de validación, semántica o procesamiento. En caso de error, es necesario corregir los problemas de datos y, a continuación, se debe reiniciar todo el proceso de ingesta utilizando los archivos de datos corregidos.

Para ayudar a monitorizar el proceso de ingesta, Experience Platform permite suscribirse a un conjunto de eventos que se publican en cada paso del proceso, notificándole al estado de los datos ingestados y cualquier posible fallo.

Registro de un enlace web para notificaciones de ingesta de datos

Para recibir notificaciones de ingesta de datos, debe utilizar Adobe Developer Console para registrar un enlace web en la integración de Experience Platform.

Siga el tutorial sobre suscribirse a Adobe I/O Event notifications para conocer los pasos detallados sobre cómo hacerlo.

IMPORTANTE

Durante el proceso de suscripción, asegúrese de seleccionar Platform notifications como proveedor de eventos y seleccione la suscripción de evento Data ingestion notification cuando se le solicite.

Recibir notificaciones de ingesta de datos

Una vez que haya registrado correctamente su vínculo web y se hayan introducido nuevos datos, puede empezar a recibir notificaciones de eventos. Estos eventos se pueden ver mediante el propio enlace web o seleccionando la pestaña Debug Tracing en la descripción general del registro de eventos del proyecto en Adobe Developer Console.

El siguiente JSON es un ejemplo de una carga útil de notificación que se enviaría a su enlace web en caso de un evento de ingesta por lotes fallido:

{
  "event_id": "93a5b11a-b0e6-4b29-ad82-81b1499cb4f2",
  "event": {
    "xdm:ingestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
    "xdm:customerIngestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
    "xdm:imsOrg": "{IMS_ORG}",
    "xdm:completed": 1598374341560,
    "xdm:datasetId": "5e55b556c2ae4418a8446037",
    "xdm:eventCode": "ing_load_failure",
    "xdm:sandboxName": "prod",
    "sentTime": "1598374341595",
    "processStartTime": 1598374342614,
    "transformedTime": 1598374342621,
    "header": {
      "_adobeio": {
        "imsOrgId": "{IMS_ORG}",
        "providerMetadata": "aep_observability_catalog_events",
        "eventCode": "platform_event"
      }
    }
  }
}
Propiedad Descripción
event_id Un ID único generado por el sistema para la notificación.
event Un objeto que contiene los detalles del evento que activó la notificación.
event.xdm:datasetId ID del conjunto de datos al que se aplica el evento de ingesta.
event.xdm:eventCode Código de estado que indica el tipo de evento que se activó para el conjunto de datos. Consulte el apéndice para conocer los valores específicos y sus definiciones.

Para ver el esquema completo de las notificaciones de eventos, consulte el repositorio público de GitHub.

Pasos siguientes

Una vez que haya registrado Platform notificaciones en el proyecto, puede ver los eventos recibidos de Project overview. Consulte la guía de seguimiento de eventos de Adobe I/O para obtener instrucciones detalladas sobre cómo rastrear los eventos.

Apéndice

La siguiente sección contiene información adicional sobre la interpretación de las cargas útiles de notificación de ingesta de datos.

Eventos de notificación de estado disponibles

En la tabla siguiente se enumeran las notificaciones de estado de ingesta de datos disponibles a las que puede suscribirse.

Código de evento Servicio de plataforma Estado Descripción del evento
ing_load_success Data Ingestion success Un lote se incorporó correctamente en un conjunto de datos dentro de Data Lake.
ing_load_failure Data Ingestion error No se pudo ingerir un lote en un conjunto de datos dentro de Data Lake.
ps_load_success Real-time Customer Profile success Se ha introducido correctamente un lote en el almacén de datos Profile.
ps_load_failure Real-time Customer Profile error No se pudo ingerir un lote en el almacén de datos Profile.
ig_load_success Identity Service success Los datos se cargaron correctamente en el gráfico de identidad.
ig_load_failure Identity Service error No se pudieron cargar los datos en el gráfico de identidad.
NOTA

Solo se proporciona un tema de evento para todas las notificaciones de ingesta de datos. Para distinguir entre diferentes estados, se puede utilizar el código de evento.

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now