Exemplos de consultas query-examples
Esta seção lista vários exemplos usados com frequência para consultar Eventos de etapa da Jornada no Data Lake.
Verifique se os campos usados em suas consultas têm valores associados no esquema correspondente.
- id: exclusiva para todas as entradas de evento de etapa. Dois eventos de etapa diferentes não podem ter a mesma ID.
- instanceId: instanceID é o mesmo para todos os eventos de etapa associados a um perfil em uma execução de jornada. Se um perfil entrar novamente na jornada, uma instanceId diferente será usada. Essa nova instanceId será a mesma para todos os eventos de etapa da instância reinserida (do início ao fim).
- profileID: a identidade do perfil correspondente ao namespace da jornada.
| note note |
|---|
| NOTE |
| Para fins de solução de problemas, recomendamos usar journeyVersionID em vez de journeyVersionName ao consultar jornadas. Saiba mais sobre os atributos de propriedades de jornada nesta seção. |
Casos de uso básicos/consultas comuns common-queries
Esta consulta fornece o número de perfis distintos que entraram na jornada especificada no período.
Consulta do Data Lake
| code language-sql |
|---|
|
Saiba como solucionar problemas de tipos de eventos descartados em jornada_step_events.
Esta consulta retorna o conjunto de regras rejeitado e as informações da regra quando um perfil é impedido de inserir uma jornada devido às regras de limitação ou qualificação.
Exemplo
| code language-sql |
|---|
|
Essa consulta conta os perfis distintos que apresentaram erros em cada nó de uma jornada, agrupados por nome de nó. Inclui todos os tipos de erros de execução de ação e erros de busca.
Consulta do Data Lake
| code language-sql |
|---|
|
Esta consulta conta o número total de eventos que foram descartados de uma jornada. Ele filtra vários códigos de evento de descarte, incluindo erros de trabalho de exportação de segmento, descartes do Dispatcher e descartes da máquina de estado.
Consulta do Data Lake
| code language-sql |
|---|
|
Esta consulta retorna todos os eventos de etapa e eventos de serviço para o perfil e a jornada fornecidos pelo tempo especificado em ordem cronológica.
Consulta do Data Lake
| code language-sql |
|---|
|
Essas consultas podem ser usadas, por exemplo, para estimar o tempo gasto em uma atividade de espera. Isso permite verificar se a atividade de espera está configurada corretamente.
Consulta do Data Lake
| code language-sql |
|---|
|
Consulta do Data Lake
| code language-sql |
|---|
|
O conjunto de dados de Eventos de etapa de Jornada contém todos os stepEvents e serviceEvents. stepEvents são usados em relatórios, pois se relacionam a atividades (evento, ações etc.) de perfis em uma jornada. serviceEvents são armazenados no mesmo conjunto de dados e indicam informações adicionais para fins de depuração, por exemplo, o motivo para um descarte de evento de experiência.
Este é um exemplo de consulta para verificar os detalhes de um serviceEvent:
Consulta do Data Lake
| code language-sql |
|---|
|
Erros de mensagem/ação message-action-errors
| accordion | ||||
|---|---|---|---|---|
| Lista de cada erro encontrado no jornada | ||||
|
Essa consulta permite listar cada erro encontrado no jornada ao executar uma mensagem/ação. Consulta do Data Lake
Exemplo
Esta consulta retorna todos os erros diferentes que ocorreram ao executar uma ação em uma jornada junto com a contagem de quantas vezes ela ocorreu. |
Consultas baseadas em perfil profile-based-queries
Esta consulta verifica se um perfil específico inseriu uma jornada, contando os eventos associados a esse perfil e a combinação de jornada.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
O resultado deve ser maior que 0. Esta consulta retorna o número exato de vezes que um perfil inseriu uma jornada.
Método 1: se o nome da mensagem não for exclusivo na jornada (ela é usada em vários locais).
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
O resultado deve ser maior que 0. Esta consulta informa apenas se a ação de mensagem foi executada com êxito no lado da jornada.
Método 2: se o nome da mensagem for exclusivo na jornada.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
A consulta retorna a lista de todas as mensagens juntamente com sua contagem invocada para o perfil selecionado.
Esta consulta recupera todas as ações de mensagem executadas com êxito para um perfil específico nos últimos 30 dias, agrupadas por nome de mensagem.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
A consulta retorna a lista de todas as mensagens juntamente com sua contagem invocada para o perfil selecionado.
Esta consulta retorna todas as jornadas inseridas por um perfil específico nos últimos 30 dias, juntamente com a contagem de entradas de cada jornada.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
A consulta retorna a lista de todos os nomes de jornada juntamente com o número de vezes que o perfil consultado inseriu a jornada.
Este query fornece um detalhamento diário do número de perfis distintos que inseriram uma jornada em um período especificado.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
O query retorna, para o período definido, o número de perfis que entraram na jornada a cada dia. Se um perfil inserido por meio de várias identidades, ele será contado duas vezes. Se a reentrada estiver ativada, a contagem de perfis poderá ser duplicada em dias diferentes se ela entrar novamente na jornada em dias diferentes.
Saiba como solucionar problemas de tipos de eventos descartados em jornada_step_events.
Consultas relacionadas ao público-alvo de leitura read-segment-queries
Esta consulta calcula a duração de um trabalho de exportação de público-alvo localizando a diferença de tempo entre o momento em que o trabalho foi enfileirado e o momento em que foi concluído.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
A consulta retorna a diferença de tempo, em minutos, entre o momento em que o trabalho de exportação de público-alvo foi enfileirado e o momento em que foi encerrado.
Esta consulta conta o número de perfis distintos que foram descartados devido a erros de duplicação de instância durante a atividade Ler público.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada porque estavam duplicadas.
Esta consulta retorna a contagem de perfis que foram descartados porque tinham um namespace inválido ou uma identidade ausente para o namespace necessário.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada porque tinham um namespace inválido ou nenhuma identidade para esse namespace.
Essa consulta conta os perfis que foram descartados porque um mapa de identidade necessário para a execução da jornada estava ausente.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada porque o mapa de identidade estava ausente.
Esta consulta identifica perfis que foram descartados quando a jornada estava sendo executada no modo de teste, mas o perfil não tinha o atributo testProfile definido como verdadeiro.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada porque o trabalho de exportação foi executado no modo de teste, mas o perfil não tinha o atributo testProfile definido como verdadeiro.
Esta consulta retorna a contagem de perfis que foram descartados devido a erros internos do sistema durante a execução da jornada.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada devido a um erro interno.
Esta consulta fornece uma visão geral abrangente da atividade Ler público, incluindo detalhes do trabalho de exportação de segmento, códigos de evento, status e contagens de perfil para todos os estágios do processo de exportação de público-alvo.
Consulta do Data Lake
| code language-sql |
|---|
|
Ele retornará todos os eventos de serviço relacionados à versão do jornada fornecida. Podemos acompanhar a cadeia de operações:
- criação de tópico
- exportar criação de trabalho
- finalização do trabalho de exportação (com métricas em perfis exportados)
- trabalhador processando desligamento
Também podemos detectar problemas como:
- erros no tópico ou na criação do trabalho de exportação (incluindo tempos limite em chamadas da API de exportação de público)
- trabalhos de exportação que podem ficar paralisados (caso em que, para uma determinada versão do jornada, não temos nenhum evento relacionado ao encerramento do trabalho de exportação)
- problemas do trabalhador, se recebermos um evento de desligamento do trabalho de exportação, mas nenhum trabalhador estiver processando um desligamento
IMPORTANTE: se não houver nenhum evento retornado por essa consulta, talvez seja devido a um dos seguintes motivos:
- a versão do jornada não atingiu o cronograma
- se a versão do jornada deveria ter acionado o trabalho de exportação chamando o orchestrator, algo deu errado no fluxo upstream: problema na implantação do jornada, evento comercial ou problema com o scheduler.
Essa consulta filtra códigos de evento de erro específicos relacionados a falhas de Leitura de público, como erros de criação de tópico, erros de chamada de API, tempos limite e trabalhos de exportação com falha.
Consulta do Data Lake
| code language-sql |
|---|
|
Essa consulta recupera o status de processamento de trabalhos de exportação de público-alvo, mostrando se eles tiveram êxito ou falharam junto com as métricas de exportação de perfil.
Consulta do Data Lake
| code language-sql |
|---|
|
Se nenhum registro for retornado, significa que:
- ocorreu um erro durante a criação do tópico ou do trabalho de exportação
- o trabalho de exportação ainda está em execução
Esta consulta combina contagens de perfis descartados com métricas de trabalho de exportação para fornecer uma exibição completa do desempenho da exportação de público-alvo para cada trabalho de exportação individual.
Consulta do Data Lake
| code language-sql |
|---|
|
Essa consulta agrega métricas gerais em todos os trabalhos de exportação para uma determinada versão do jornada, útil para jornadas recorrentes ou jornadas acionadas por eventos comerciais com reutilização de tópico.
Consulta do Data Lake
| code language-sql |
|---|
|
Esta consulta é diferente da anterior.
Ele retorna as métricas gerais de uma determinada versão do jornada, independentemente das tarefas que podem ter sido executadas para ele (no caso de jornadas recorrentes, eventos comerciais acionados por meio da reutilização de tópicos).
Consultas relacionadas à qualificação de público-alvo segment-qualification-queries
Esta consulta identifica perfis que foram descartados porque o status de realização do público-alvo não correspondia à configuração de Qualificação de público-alvo da jornada (por exemplo, configurado para "entra", mas o perfil "sai").
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta retorna todas as IDs de perfil que foram descartadas pela versão do jornada devido à realização incorreta do público-alvo.
Esta consulta recupera todas as qualificações de público-alvo ou eventos externos que foram descartados para um perfil específico devido a erros de serviço interno.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta retorna todos os eventos (eventos externos/eventos de qualificação de público-alvo) que foram descartados por qualquer outro motivo para um perfil.
Consultas baseadas em eventos event-based-queries
Essa consulta conta o número de vezes que um evento comercial foi recebido por uma jornada, agrupado por data, em um intervalo de tempo especificado.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta identifica quando um evento externo para um perfil específico foi descartado porque não havia nenhuma jornada ativa ou correspondente configurada para receber esse evento.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Saiba como solucionar problemas de tipos de eventos descartados em jornada_step_events.
Esta consulta recupera eventos externos que foram descartados para um perfil específico devido a erros internos de serviço, juntamente com a ID do evento e o código de erro.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Saiba como solucionar problemas de tipos de eventos descartados em jornada_step_events.
Essa consulta agrega todos os eventos descartados pela máquina de estado de jornada, agrupados por código de erro para ajudar a identificar os motivos mais comuns para descartes.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Saiba como solucionar problemas de tipos de eventos descartados em jornada_step_events.
Esta consulta identifica todos os eventos que foram descartados porque um perfil tentou inserir uma jornada novamente quando a reentrada não era permitida na configuração da jornada.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Saiba como solucionar problemas de tipos de eventos descartados em jornada_step_events.
Consultas comuns baseadas em jornada journey-based-queries
Essa consulta retorna uma contagem diária de versões exclusivas do jornada que tinham atividade, ajudando você a entender os padrões de execução da jornada ao longo do tempo.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
A consulta retorna, para o período definido, a contagem de jornadas exclusivas que são acionadas a cada dia. Um único acionamento de jornada em vários dias será contado uma vez por dia.
Consultas em instâncias do jornada journey-instances-queries
Essa consulta usa Expressões de tabela comuns (CTEs) para identificar os perfis que estão aguardando atualmente em um nó específico de uma jornada, localizando os perfis que passaram pelo nó, mas ainda não avançaram para os próximos nós.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta conta as instâncias do jornada que saíram durante um período de tempo especificado, incluindo saídas devido a erros de conclusão, erros, tempos limite ou erros de limite.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta fornece um detalhamento das saídas do jornada, mostrando o nome do nó e o status de saída de cada instância encerrada para ajudar a identificar onde e por que os perfis saíram da jornada.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Consultas relacionadas às métricas de desempenho de Ação personalizada query-custom-action
Esta consulta fornece métricas de desempenho para ações HTTP personalizadas, incluindo total de chamadas, chamadas bem-sucedidas, contagens de erros por tipo (4xx, 5xx, tempos limite, limitados) e taxa de transferência em solicitações por segundo para cada endpoint.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta fornece as mesmas métricas de desempenho da consulta anterior, mas organizadas como uma série de tempo, mostrando como o desempenho do endpoint varia ao longo do tempo com granularidade minuto a minuto.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta calcula os percentis de tempo de resposta para endpoints de ação personalizados, ajudando você a entender a distribuição de latência e identificar outliers de desempenho em diferentes limites de percentil.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Essa consulta fornece percentis de latência organizados como uma série de tempo, permitindo rastrear como os tempos de resposta do endpoint mudam ao longo do tempo em diferentes níveis de percentil.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta analisa os tempos de espera da fila para endpoints com limitação, mostrando os percentis de espera 50 e 95 para ajudar você a entender o impacto da limitação em suas ações personalizadas.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Essa consulta fornece percentis de tempo de espera de fila como uma série de tempo, permitindo monitorar como a limitação afeta os tempos de espera ao longo do tempo para cada endpoint.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta fornece um detalhamento dos erros de um endpoint específico, agrupados por tipo de erro e código de erro, incluindo informações sobre tentativas de repetição.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|