Nesta página: monitore a confiabilidade e o desempenho das chamadas de API feitas pelo seu jornada para sistemas de terceiros, para que você possa detectar rapidamente problemas de integração, latência e limites de limitação.
A página de relatórios Ação personalizada permite monitorar a confiabilidade e o desempenho das chamadas de API feitas de suas jornadas para sistemas de terceiros. Esses relatórios ajudam a identificar rapidamente problemas de integração, gargalos de latência ou limites de limitação/limitação que podem afetar a entrega.
A página Relatórios de ação personalizados funciona como outros Relatórios de tempo integral no Journey Optimizer. Para obter detalhes sobre as funcionalidades do painel, consulte esta documentação.
Para acessar a página de relatórios Ação personalizada, clique em
➡️ Saiba mais sobre a configuração de ações personalizadas
Além da página de relatórios Ação personalizada, você pode usar Adobe Experience Platform Query Service para criar consultas para relatar métricas de desempenho de ação personalizada. Exemplos de consulta estão disponíveis em esta seção.
KPIs kpis
Os KPIs (Indicadores-chave de desempenho) de Ação personalizada atuam como um painel centralizado, fornecendo uma exibição consolidada da integridade operacional e da confiabilidade das suas chamadas de ação personalizadas. Essas métricas permitem avaliar o desempenho, identificar gargalos e garantir integrações estáveis com sistemas externos.
-
Chamadas com êxito: número total de chamadas HTTP que retornaram uma resposta válida sem erro.
-
4xx/5xx errors: número de chamadas com falha devido a erros do lado do cliente (4xx) ou do lado do servidor (5xx), destacando problemas de configuração ou falhas de ponto de extremidade.
-
Limites de tempo: número de chamadas que falharam porque excederam o tempo máximo de resposta. Isso ajuda a exibir problemas de latência ou desempenho com pontos de extremidade externos.
-
Chamadas limitadas: Número de chamadas bloqueadas devido a limites de limitação, garantindo que os sistemas downstream não sejam sobrecarregados.
-
Média de RPS: número de solicitações por segundo processadas pela ação personalizada durante o intervalo de tempo selecionado.
-
Latência média: tempo médio de resposta de ponta a ponta (em milissegundos) para todas as chamadas HTTP, incluindo chamadas bem-sucedidas, erros e tempos limite.
-
Latência média de êxito: tempo médio de resposta de ponta a ponta (em milissegundos) somente para chamadas bem-sucedidas, excluindo solicitações com falha e tempos limite.
-
Tempo médio da fila: Tempo médio (em milissegundos) gasto com chamadas aguardando na fila de execução antes de serem enviadas. Isso se aplica somente a endpoints com limitação, nos quais o Journey Optimizer enfileira chamadas quando o limite de taxa de transferência é atingido.
Chamadas ao longo do tempo calls
O gráfico Chamadas ao longo do tempo mostra a tendência do KPI de chamadas HTTP ao longo do período selecionado para o relatório. A granularidade da série temporal depende do intervalo de tempo selecionado. Por exemplo:
- Para um relatório de 7 dias, cada ponto de dados mostrará os KPIs para um dia.
- Se você selecionar um intervalo de tempo de 1 dia, o gráfico mostrará os KPIs por hora.
- Se você selecionar um intervalo de tempo de 1 hora, o gráfico mostrará os KPIs por minuto.
➡️Consulte a seção KPIs para obter uma descrição das métricas de chamada HTTP
Latência ao longo do tempo latency-overtime
O gráfico Latência ao longo do tempo visualiza a tendência das métricas de latência ao longo do período selecionado. Essa visualização de série temporal permite rastrear padrões de desempenho, identificar períodos de latência de pico e monitorar o impacto de otimizações ou alterações do sistema ao longo do tempo.
➡️Consulte a seção KPIs para obter uma descrição das métricas de Latência
Detalhamento de chamadas breakdown
A tabela Detalhamento de chamadas fornece um detalhamento hierárquico das métricas de chamadas HTTP, desde as métricas gerais por ponto de extremidade no nível superior até as métricas por Ação personalizada usando cada ponto de extremidade até as jornadas que dependem delas no nível inferior.
➡️Consulte a seção KPIs para obter uma descrição das métricas de chamada HTTP
Detalhamento de latência latency-breakdown
A tabela Detalhamento de latência fornece um detalhamento das métricas de latência em suas ações personalizadas. Essa visualização ajuda a identificar quais endpoints ou ações específicos estão tendo problemas de desempenho, permitindo que você identifique e resolva gargalos de latência de maneira eficaz.
➡️Consulte a seção KPIs para obter uma descrição das métricas de Latência
Vídeo tutorial video
O vídeo abaixo mostra como monitorar a confiabilidade e o desempenho das chamadas de API feitas de suas jornadas para sistemas de terceiros.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to use the Custom action reporting page to monitor the reliability and performance of the API calls your journeys make to third-party systems.
Intents:
- Access the Custom action reporting page from the Actions homepage
- Review the Custom action KPIs for operational health and reliability
- Track HTTP call KPI trends over time with the Calls over time graph
- Analyze latency patterns with the Latency over time graph
- Drill into metrics per endpoint, custom action, and journey with the breakdown tables
Glossary:
- Custom action reporting page: The reporting page that lets you monitor the reliability and performance of API calls made from your journeys to third-party systems; it functions like other All-time reports (product-specific)
- Capped calls: Number of calls that were blocked due to capping limits, ensuring downstream systems are not overloaded (product-specific)
- Average queue time: Average time (in milliseconds) calls spent waiting in the execution queue before being sent (product-specific)
- Calls breakdown: A hierarchical table breaking metrics down from per endpoint, to per Custom Action using each endpoint, to the journeys that rely on them (product-specific)
Guardrails:
- Average queue time only applies to throttled endpoints, where Journey Optimizer queues up calls when the throughput limit is reached.
- Average latency covers all HTTP calls, including successful calls, errors, and timeouts, while Average successful latency covers successful calls only, excluding failed requests and timeouts.
- The granularity of the Calls over time series depends on the selected time range: a 7 day report shows KPIs per day, a 1-day time range shows KPIs per hour, and a 1-hour time range shows KPIs per minute.
Terminology:
- Canonical name: Custom action reporting page — Acronym: n/a — variants: Custom action report
- Synonyms: “Average RPS” = “requests per second processed by the custom action over the selected time range”
- Do not confuse: “4xx/5xx errors” (failed calls due to client-side or server-side errors) ≠ “Timeouts” (calls that exceeded the maximum response time) ≠ “Capped calls” (calls blocked due to capping limits)
- Do not confuse: “Average latency” (all HTTP calls) ≠ “Average successful latency” (successful calls only)
FAQ:
- Q: What does the Custom action reporting page monitor? — It monitors the reliability and performance of API calls made from your journeys to third-party systems, helping you identify integration issues, latency bottlenecks, or throttling and capping limits.
- Q: How do I access the Custom action reporting page? — Click the Monitoring icon from your Actions homepage.
- Q: What is the difference between Average latency and Average successful latency? — Average latency is the average response time for all HTTP calls including successful calls, errors, and timeouts, while Average successful latency is for successful calls only, excluding failed requests and timeouts.
- Q: When does Average queue time apply? — It only applies to throttled endpoints, where Journey Optimizer queues up calls when the throughput limit is reached.
- Q: Can I report on custom action performance outside this page? — Yes, you can use Adobe Experience Platform Query Service to build queries on custom action performance metrics.