> ## Documentation Index > Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt > Use this file to discover all available pages before exploring further. # Métricas de email > Consulte envio, reputação, feedback, engajamento, mensagens pendentes e latência por meio de Telemetry. Email publica métricas de recursos em Telemetry. Abra **Deliverability** para comparar todas as identidades ou a aba **Metrics** de uma identidade. Os controles compartilhados dos gráficos selecionam o período e o intervalo de atualização. Ler gráficos exige `telemetry:ReadMetrics` na conta e região selecionadas. ## Escopo e amostragem As métricas têm os rótulos `region` 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 prefixo `basaltic_email_`. | Sufixo | Tipo | Significado | | - | - | - | | `messages_accepted_total` | Contador | Mensagens aceitas para envio. | | `messages_sent_total` | Contador | Primeira aceitação SMTP de cada mensagem. | | `messages_failed_total` | Contador | Primeira falha de envio registrada para cada mensagem. | | `bytes_accepted_total` | Contador | Bytes nos corpos de mensagens aceitas. | | `messages_queued` | Medidor | Mensagens aguardando envio. | | `messages_sending` | Medidor | Mensagens com uma tentativa em andamento. | | `oldest_queued_message_age_seconds` | Medidor | Idade da mensagem pendente mais antiga; zero quando não há pendências. | | `send_duration_seconds_sum` | Contador | Tempo acumulado do enfileiramento até a primeira aceitação SMTP. | | `send_duration_seconds_count` | Contador | Mensagens incluídas na soma de latência. | | `opens_total` | Contador | Eventos de abertura registrados, incluindo repetições. | | `clicks_total` | Contador | Eventos de clique registrados, incluindo repetições. | | `rejections_total` | Contador | Solicitações de envio rejeitadas antes da aceitação. | | `bounces_total` | Contador | Eventos registrados de retorno de falha. | | `complaints_total` | Contador | Eventos registrados de reclamação. | | `reputation_sends_24h` | Medidor | Envios na última avaliação de reputação de 24 horas. | | `reputation_bounces_24h` | Medidor | Eventos de retorno de falha nessa janela de avaliação. | | `reputation_complaints_24h` | Medidor | Eventos de reclamação nessa janela de avaliação. | | `reputation_bounce_ratio` | Medidor | Retornos de falha avaliados divididos pelos envios; zero quando não há envios. | | `reputation_complaint_ratio` | Medidor | Reclamações avaliadas divididas pelos envios; zero quando não há envios. | 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](/pt/email/sending) para o significado dos estados. ## Recebimento e DMARC | Sufixo | Tipo | Significado | | - | - | - | | `messages_received_total` | Contador | Mensagens recebidas aceitas, desde a ativação desta métrica. | | `bytes_received_total` | Contador | Bytes MIME codificados completos aceitos, incluindo anexos. | | `received_spam_total` | Contador | Mensagens aceitas marcadas como spam. | | `received_malware_total` | Contador | Mensagens aceitas em quarentena por malware. | | `received_unverified_total` | Contador | Mensagens aceitas sem alinhamento autenticado do remetente. | | `receipt_notifications_pending` | Medidor | Notificações de recebimento não publicadas cujas mensagens não expiraram. | | `oldest_receipt_notification_age_seconds` | Medidor | Idade da notificação de recebimento pendente mais antiga. | | `dmarc_reports_7d` | Medidor | Combinações distintas de emissor, relatório e intervalo. | | `dmarc_messages_7d` | Medidor | Contagens de mensagens relatadas nesses intervalos. | | `dmarc_pass_7d`, `dmarc_fail_7d` | Medidor | Mensagens relatadas que passaram em uma verificação de alinhamento ou falharam nas duas. | | `dmarc_dkim_aligned_7d`, `dmarc_spf_aligned_7d` | Medidor | Mensagens relatadas que passaram em cada verificação de alinhamento. | | `dmarc_quarantined_7d`, `dmarc_rejected_7d` | Medidor | Disposições relatadas. | 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.