Exportação

A exportação permite baixar em formato CSV compactado os eventos retornados por uma consulta da tela Explorar, respeitando os filtros e o intervalo de tempo aplicados.

Nova exportação

Na tela Explorar, configure os filtros desejados e execute a consulta. Em seguida, abra o menu de exportação e confirme. O arquivo é gerado em segundo plano e pode levar alguns minutos, dependendo do volume de registros.

Você pode fechar a janela enquanto o processamento ocorre: a exportação continua em segundo plano e fica disponível no histórico.

Histórico

O histórico lista as exportações realizadas pelos usuários da conta nos últimos 7 dias. Após esse período, os arquivos são removidos automaticamente. Consulte Limites e parâmetros para os limites de volume.

Formato do arquivo

O arquivo é entregue compactado em gzip, com a extensão .csv.gz. O CSV interno é codificado em UTF-8, com , como separador de colunas e aspas duplas em campos de texto que contenham caracteres especiais. A primeira linha contém o cabeçalho com o nome dos campos.

Outras características do conteúdo:

• datas e horas são gravadas em UTC, no formato ISO 8601;
• as linhas não seguem uma ordem definida. Ordene o arquivo após o download quando a ordem importar;
• campos marcados como sensíveis são exportados como digest HMAC, nunca em texto aberto.

Descrição embutida

Cada arquivo carrega a própria descrição, gravada como comentário do gzip. Ela traz a conta, o período exportado, o campo de data usado como referência, o número de linhas, o momento da geração, os filtros aplicados e a lista de colunas com nome e descrição de cada uma.

A descrição não faz parte do CSV: qualquer descompactador a ignora, e o arquivo lido por uma planilha ou por uma ferramenta de análise é exatamente o mesmo que seria gerado sem ela. Um arquivo encaminhado a outra pessoa carrega consigo a explicação do que contém.

A lista de colunas pode ser alterada sem aviso prévio. Use a exportação para análises pontuais; para integrações contínuas, prefira a API.