telemetry:ReadMetrics na conta e região selecionadas.
Escopo e amostragem
As métricas têm os rótulosregion e identity_id e são isoladas por conta e organização. Inclua sempre a região desejada na consulta. Para uma identidade, filtre por seu UUID. Eventos sem uma identidade resolvida usam 00000000-0000-0000-0000-000000000000; eles contribuem para os gráficos da conta. Endereços de destinatários, URLs e IDs de mensagens não são rótulos de métricas.
As amostras são emitidas aproximadamente a cada 30 segundos. Os contadores persistem após reinícios de workers e exclusão do histórico de mensagens. Eles começam quando a coleta de métricas é habilitada, sem preenchimento retroativo. Uma taxa precisa de pelo menos duas amostras. Métricas de eventos podem atrasar em relação às de envio enquanto chegam feedbacks e eventos de engajamento.
Catálogo de métricas
Todos os nomes têm o prefixobasaltic_email_.
Use agregação por taxa para contadores. A latência SMTP média é a taxa de
send_duration_seconds_sum dividida pela taxa de send_duration_seconds_count. Use o valor mais recente para medidores de mensagens pendentes. Ao combinar identidades, preserve identity_id ao selecionar a amostra mais recente antes de somar os valores pendentes.
Gráficos de reputação
A aba Metrics da identidade mostra contagens de envios, retornos de falha e reclamações nas últimas 24 horas, além das taxas usadas pela política de envio. São medidores da avaliação persistida de reputação. Selecione a amostra mais recente de cada intervalo do gráfico; não aplique uma taxa de contador a eles. As proporções são frações: multiplique por 100 para exibir porcentagens. Mantenha as proporções no escopo de uma identidade; somá-las ou tirar sua média não produz uma taxa da conta. Cada ponto reflete a última janela de 24 horas do avaliador, mesmo quando você seleciona outro período no gráfico. A amostragem não inicia uma nova avaliação. Nenhuma amostra de reputação é emitida antes da primeira avaliação; uma identidade ainda não avaliada mostra ausência de dados, em vez de um zero saudável. O estado de suspensão e seu motivo permanecem visíveis na página da identidade.Interpretar os resultados corretamente
A aceitação SMTP não comprova entrega na caixa de entrada. Uma mensagem pode ser aceita e depois retornar uma falha ou gerar uma reclamação. O feedback conta eventos, não mensagens únicas afetadas. Aberturas e cliques incluem clientes automatizados e visitas repetidas. Dividir essas taxas pelas taxas de envio não produz uma taxa de engajamento por coorte, pois os eventos podem ser de mensagens mais antigas. Use os detalhes da mensagem, o engajamento por mensagem e os relatórios DMARC por identidade para investigar. Não há classificação por domínio destinatário. Consulte Envio para o significado dos estados.Recebimento e DMARC
Os medidores DMARC abrangem períodos de relatórios encerrados nos sete dias anteriores a cada observação. Relatórios costumam chegar atrasados: um novo relatório altera observações futuras em vez de reescrever amostras anteriores. Retransmissões idênticas são deduplicadas por emissor, relatório, intervalo, IP de origem e atributos de autenticação. Esses medidores não são contadores; use o valor mais recente, não uma taxa.
Inspecione IP de origem, emissor, intervalo, disposição e detalhes de autenticação com
GET /v1/identities/{identity_id}/dmarc-reports. Os registros de diagnóstico são mantidos por 180 dias e aceitam from, to, limit e marker. O intervalo filtra o fim do período relatado. IPs de origem, destinatários, IDs de relatórios e de mensagens nunca são rótulos de métricas. Registros de engajamento por mensagem e de rejeição permanecem separados dos gráficos agregados.