Pular para o conteúdo principal
Os destinos encaminham novos dados do projeto para o seu próprio receptor. Abra Configurações do projeto → Destinos para inspecionar os destinos, o status de entrega e os erros. A página do produto Drains explica as origens de dados, as configurações de destino e os formatos de entrega assinada.

​
Escolha a origem dos dados

Cada destino tem uma origem: As Análises precisam estar ativadas antes de você ativar um destino de análises. Os Logs não exigem as Análises. Nenhuma das origens inclui o corpo das mensagens, a identidade dos contatos ou credenciais. Os retratos de análises são preparados a cada hora para a última hora UTC concluída. Janelas móveis sobrepostas são observações; somá-las conta a atividade em dobro.

​
Adicione um destino

Proprietários e administradores da equipe gerenciam os destinos. Os membros veem os metadados dos destinos com as URLs de destino e os nomes dos cabeçalhos personalizados ocultos. Um projeto aceita até cinco destinos, somando as duas origens.
  1. Selecione Adicionar destino e escolha Logs ou Análises.
  2. Selecione Endpoint personalizado e informe um nome e uma URL HTTPS pública.
  3. Escolha JSON ou NDJSON. Um segredo de assinatura é gerado; copie-o para o seu receptor antes de salvar. Você pode substituí-lo, gerá-lo de novo ou apagá-lo para entregas sem assinatura.
  4. Adicione cabeçalhos personalizados se o seu receptor exigir.
  5. Selecione Adicionar destino.
Para Análises, escolha também o escopo de números e a janela móvel. A origem, o escopo de números, a janela e a codificação ficam fixos na criação; crie um novo destino para alterá-los. Os segredos de assinatura salvos e os valores dos cabeçalhos personalizados não são retornados na visualização da configuração. As integrações nativas estão marcadas como Em breve.

​
Aceite uma entrega

O seu receptor recebe um POST HTTPS. JSON usa application/json e um envelope {version, deliveryId, records}. NDJSON usa application/x-ndjson e um envelope {version, deliveryId, record} terminado por uma quebra de linha.
  • Quando um segredo de assinatura estiver configurado, verifique o HMAC-SHA256 calculado sobre o horário, um ponto e o corpo original da requisição. Inclua a quebra de linha final do NDJSON. Rejeite horários antigos e compare em tempo constante. Entregas sem assinatura não têm assinatura HMAC da Polymorfa.
  • Elimine duplicatas pelo Idempotency-Key, que corresponde ao deliveryId.
  • Retorne 2xx depois de aceitar o registro de forma durável. A entrega acontece pelo menos uma vez.
  • Outras respostas e falhas de conexão usam um número limitado de novas tentativas, com no máximo seis tentativas e não depois de 24 horas da entrada na fila.
Consulte envelopes de entrega e verificação de assinatura para ver os bytes exatos, os cabeçalhos e o cronograma de novas tentativas, e os campos do retrato de análises para ver a carga das análises.

​
Inspecione e pause

A lista de destinos mostra o status ativado ou pausado, as contagens de entregas pendentes e com falha e o último status HTTP ou erro registrado. Pausar interrompe novas entradas na fila e novos claims de entrega; uma requisição em andamento pode terminar. Retomar continua as entregas elegíveis que estão na fila. Excluir remove o destino e as entregas dele que estão na fila. Desativar as Análises exclui os retratos de análises na fila e interrompe a nova coleta. Reativar inicia um novo período de consentimento. Os dados que o seu receptor já aceitou seguem a sua própria política de retenção.

​
Colete métricas

Use a configuração do OpenTelemetry quando o seu destino espera métricas OTLP. O receptor Prometheus dela coleta medidores por janela; um destino envia os envelopes JSON ou NDJSON da Polymorfa. Eles usam formatos de receptor diferentes.

​
Dados de dispositivos e conversas

Os retratos de análises incluem deviceAnalytics e conversationBreakdown para cada número do escopo e para o resumo combinado. As linhas combinadas de conversa mantêm a faixa de conclusão, o código de chamada do país, o tipo de mensagem, a faixa de tamanho, a origem do envio, a classe de quantidade de dispositivos observada do cliente, as contagens de resultados e a latência total de resposta. Elas não contêm conteúdo de mensagens nem a identidade dos destinatários. Um destino envia o retrato do escopo. Aplique predicados de categoria às linhas combinadas dele para construir (build) as suas próprias visualizações filtradas. JSON e NDJSON trazem os mesmos campos de dados.