Message Trace no Exchange Admin Center: Troubleshooting Passo a Passo

O Message Trace é a ferramenta número um de diagnóstico de fluxo de email no Exchange Online. Permite seguir o percurso exacto de qualquer mensagem — do remetente ao destinatário — através de todos os filtros, regras de transporte e serviços de protecção. É o primeiro passo em qualquer ticket de email não entregue, e frequentemente o único passo necessário.

Com a nova interface GA (disponível desde Julho de 2025), o Message Trace suporta agora até 90 dias de histórico de dados (em janelas de 10 dias por pesquisa) e inclui melhorias significativas de performance e filtros. Este artigo cobre a interface web e os novos cmdlets PowerShell em detalhe.

1. Aceder ao Message Trace — interface web

Existem dois caminhos para aceder ao Message Trace:

Permissões necessárias: A função mínima para usar o Message Trace é View-Only Recipients ou qualquer função que inclua permissões de leitura de mail flow. Administradores globais e Exchange Administrators têm acesso completo por defeito.

A página do Message Trace tem três separadores principais:

2. Pesquisa básica — os campos essenciais

Ao clicar em Start a trace, abre um painel lateral com os campos de pesquisa. Para a maioria dos tickets de helpdesk, preencher apenas três campos é suficiente:

3. Filtros avançados e pesquisas guardadas

Para troubleshooting mais específico, o painel de pesquisa tem campos adicionais que permitem filtrar com mais precisão:

Guardar pesquisas frequentes

Após configurar um conjunto de filtros úteis (ex: pesquisa de emails falhados nas últimas 48h), é possível guardar a pesquisa para reutilização futura:

1. Configurar os filtros pretendidos no painel de pesquisa
2. Clicar em Save this query antes de executar a pesquisa
3. Dar um nome descritivo — ex: “Emails falhados últimas 48h”
4. A pesquisa fica disponível no separador Custom queries para todos os administradores do tenant

4. Interpretar os resultados — statuses e eventos

A lista de resultados mostra uma linha por mensagem com as colunas: Date, Sender, Recipients, Subject, Status e Size. O campo Status é o mais importante:

5. Detalhe de mensagem — ler a cadeia de eventos

Ao clicar numa mensagem nos resultados, abre o painel de detalhe com a cadeia completa de eventos que a mensagem atravessou. Esta cadeia é o elemento mais valioso para diagnóstico aprofundado — permite ver exactamente em que ponto o email foi retido, transformado ou rejeitado.

Campos de cabeçalho do detalhe

Eventos mais comuns na cadeia de eventos

6. Pesquisa histórica — dados com mais de 10 dias

A pesquisa em tempo real (near-real-time) cobre os últimos 10 dias. Para dados mais antigos — até 90 dias — é necessário usar o relatório histórico, que é processado de forma assíncrona e entregue em CSV.

Iniciar pesquisa histórica via PowerShell

# Iniciar pesquisa histórica (para dados > 10 dias)
Start-HistoricalSearch -ReportTitle "Email Falhado - Janeiro 2026" `
    -StartDate "01/01/2026" `
    -EndDate "10/01/2026" `
    -ReportType MessageTrace `
    -SenderAddress "[email protected]" `
    -RecipientAddress "[email protected]" `
    -NotifyAddress "[email protected]"

# Verificar estado das pesquisas históricas activas
Get-HistoricalSearch | Select-Object JobId, ReportTitle, Status, StartDate, EndDate, SubmitDate

7. PowerShell — Get-MessageTraceV2 e Get-MessageTraceDetailV2

Pesquisas básicas com Get-MessageTraceV2

Connect-ExchangeOnline -UserPrincipalName [email protected]

# Pesquisa básica: últimas 48h para um utilizador
Get-MessageTraceV2 -RecipientAddress "[email protected]" `
    -StartDate (Get-Date).AddDays(-2) -EndDate (Get-Date) |
    Select-Object Received, SenderAddress, RecipientAddress, Subject, Status |
    Format-Table -AutoSize

# Apenas mensagens com falha nas últimas 24h (todos os utilizadores)
Get-MessageTraceV2 -StartDate (Get-Date).AddDays(-1) -EndDate (Get-Date) -Status Failed |
    Select-Object Received, SenderAddress, RecipientAddress, Subject |
    Format-Table -AutoSize

# Mensagens para a quarentena nas últimas 48h
Get-MessageTraceV2 -StartDate (Get-Date).AddDays(-2) -EndDate (Get-Date) -Status Quarantined |
    Select-Object Received, SenderAddress, RecipientAddress, Subject |
    Sort-Object Received -Descending

Obter detalhe de uma mensagem específica

# Passo 1: Obter o MessageTraceId (Network Message ID) da mensagem
$trace = Get-MessageTraceV2 -SenderAddress "[email protected]" `
    -RecipientAddress "[email protected]" `
    -StartDate (Get-Date).AddHours(-4) `
    -EndDate (Get-Date)

# Ver os resultados
$trace | Select-Object Received, Subject, Status, MessageTraceId

# Passo 2: Obter o detalhe completo da mensagem (cadeia de eventos)
Get-MessageTraceDetailV2 -MessageTraceId $trace[0].MessageTraceId `
    -RecipientAddress "[email protected]" `
    -StartDate (Get-Date).AddHours(-4) `
    -EndDate (Get-Date) |
    Select-Object Date, Event, Action, Detail |
    Format-Table -AutoSize

Exportar resultados para CSV

# Exportar todos os emails falhados da última semana para CSV
Get-MessageTraceV2 -StartDate (Get-Date).AddDays(-7) -EndDate (Get-Date) -Status Failed |
    Select-Object Received, SenderAddress, RecipientAddress, Subject, Status, MessageTraceId |
    Export-Csv "C:\temp\emails_falhados_$(Get-Date -Format 'yyyyMMdd').csv" -NoTypeInformation -Encoding UTF8

Write-Host "Exportado para emails_falhados_$(Get-Date -Format 'yyyyMMdd').csv"

8. Casos práticos — exemplos reais de troubleshooting

Caso A — “Não recebi o email que o cliente disse que enviou”

1. Message Trace: Senders = endereço do cliente, Recipients = caixa de correio do utilizador, Time range = período reportado (+/- 2h, convertido para UTC
2. Se Delivered: verificar pasta Lixo, regras de inbox, arquivo automático do Outlook
3. Se FilteredAsSpam: verificar pasta Lixo → se email legítimo, adicionar domínio do cliente aos Safe Senders na política anti-spam
4. Se Quarantined: ir à quarentena e libertar o email se legítimo
5. Se não aparece nada: o cliente pode não ter enviado — pedir header do email para confirmar que passou pelo Exchange Online

Caso B — “O multifunções está a dar erro ao enviar email”

1. Message Trace: Senders = endereço configurado no multifunções, Time range = hora da tentativa
2. Se status Failed com código 5.7.57: o dispositivo não está autenticado — configurar SMTP relay via conector no EAC com IP autorizado
3. Se não aparece nada: o email nem chegou ao Exchange Online — verificar configuração SMTP no dispositivo (servidor, porta, TLS)
4. Verificar no EAC → Mail flow → Connectors se existe conector para o IP do multifunções

Caso C — “Emails para um domínio externo estão a falhar”

1. Message Trace: Senders = qualquer utilizador interno, Recipients = *@dominiodestino.com, Status = Failed
2. Abrir o detalhe da mensagem → identificar o código de erro e o IP de destino
3. Verificar o MX do domínio de destino com MXToolbox — está a resolver? O servidor de destino está online?
4. Se o erro inclui “550 5.7.1” ou similar: o servidor de destino está a rejeitar o email — pode ser reputação do IP ou problema SPF do remetente
5. Verificar se o IP do Exchange Online está em blacklist: usar MXToolbox Blacklist Check com os IPs de saída do tenant

9. Limitações e quando usar alternativas