Notificações de assimilação de dados

O processo de assimilação de dados no Adobe Experience Platform é composto por várias etapas. Depois de identificar os arquivos de dados que precisam ser assimilados no Platform, o processo de assimilação é iniciado e cada etapa ocorre consecutivamente até que os dados sejam assimilados com êxito ou falhem. O processo de ingestão pode ser iniciado usando o API de assimilação de dados do Adobe Experience Platform ou usando a Experience Platform interface do usuário.

Dados carregados em Platform deve seguir várias etapas para alcançar seu destino, a variável Data Lake ou Real-time Customer Profile armazenamento de dados. Cada etapa envolve processar os dados, validar os dados e armazenar os dados antes de passá-los para a próxima etapa. Dependendo da quantidade de dados assimilados, esse processo pode se tornar um processo demorado e sempre há uma chance de o processo falhar devido a erros de validação, semântica ou processamento. Em caso de falha, os problemas de dados precisam ser corrigidos e todo o processo de assimilação deve ser reiniciado usando os arquivos de dados corrigidos.

Para auxiliar no monitoramento do processo de ingestão, Experience Platform possibilita a assinatura de um conjunto de eventos publicados por cada etapa do processo, notificando o usuário ao status dos dados assimilados e a possíveis falhas.

Registrar um webhook para notificações de assimilação de dados

Para receber notificações de assimilação de dados, você deve usar Console do desenvolvedor do Adobe para registrar um webhook na integração com o Experience Platform.

Siga o tutorial em assinando com Adobe I/O Event notificações para obter etapas detalhadas sobre como fazer isso.

IMPORTANTE

Durante o processo de assinatura, certifique-se de selecionar Notificações da plataforma como provedor de evento, e selecione o Notificação da assimilação de dados assinatura de evento quando solicitado.

Receber notificações de assimilação de dados

Depois de registrar o webhook com êxito e os novos dados terem sido assimilados, você pode começar a receber notificações de eventos. Esses eventos podem ser exibidos usando o próprio webhook ou selecionando o Rastreamento de depuração na visão geral do registro de eventos do seu projeto no Adobe Developer Console.

O JSON a seguir é um exemplo de carga de notificação que seria enviada para o seu webhook no caso de um evento de ingestão em lote com falha:

{
  "event_id": "93a5b11a-b0e6-4b29-ad82-81b1499cb4f2",
  "event": {
    "xdm:ingestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
    "xdm:customerIngestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
    "xdm:imsOrg": "{ORG_ID}",
    "xdm:completed": 1598374341560,
    "xdm:datasetId": "5e55b556c2ae4418a8446037",
    "xdm:eventCode": "ing_load_failure",
    "xdm:sandboxName": "prod",
    "sentTime": "1598374341595",
    "processStartTime": 1598374342614,
    "transformedTime": 1598374342621,
    "header": {
      "_adobeio": {
        "imsOrgId": "{ORG_ID}",
        "providerMetadata": "aep_observability_catalog_events",
        "eventCode": "platform_event"
      }
    }
  }
}
Propriedade Descrição
event_id Uma ID exclusiva gerada pelo sistema para a notificação.
event Um objeto que contém os detalhes do evento que acionou a notificação.
event.xdm:datasetId A ID do conjunto de dados ao qual o evento de assimilação se aplica.
event.xdm:eventCode Um código de status que indica o tipo de evento que foi acionado para o conjunto de dados. Consulte a apêndice para valores específicos e suas definições.

Para exibir o esquema completo das notificações de evento, consulte repositório GitHub público.

Próximas etapas

Depois de se registrar Platform notificações ao seu projeto, você poderá visualizar os eventos recebidos do Visão geral do projeto. Consulte o guia em Rastreando eventos Adobe I/O para obter instruções detalhadas sobre como rastrear os eventos.

Apêndice

A seção a seguir contém informações adicionais sobre a interpretação de cargas de notificação de assimilação de dados.

Eventos de notificação de status disponíveis

A tabela a seguir lista as notificações de status da assimilação de dados disponíveis que podem ser assinadas.

Código do evento Serviço de plataforma Status Descrição do evento
ing_load_success Data Ingestion success Um lote foi assimilado com êxito em um conjunto de dados dentro do Data Lake.
ing_load_failure Data Ingestion falha Um lote não pôde ser assimilado em um conjunto de dados dentro do Data Lake.
ps_load_success Real-time Customer Profile success Um lote foi assimilado com êxito no Profile armazenamento de dados.
ps_load_failure Real-time Customer Profile falha Falha ao assimilar um lote no Profile armazenamento de dados.
ig_load_success Identity Service success Os dados foram carregados com êxito no gráfico de identidade.
ig_load_failure Identity Service falha Falha ao carregar dados no gráfico de identidade.
OBSERVAÇÃO

Há apenas um tópico de evento fornecido para todas as notificações de assimilação de dados. Para distinguir entre diferentes status, o código do evento pode ser usado.

Nesta página