{"section":"tutorials","requestedLocale":"pt","requestedSlug":"audit","locale":"pt","slug":"audit","path":"docs/pt/tutorials/segurança/recursos-de-segurança-da-plataforma/audit.md","branch":"main","content":"Para aumentar a transparência e a confiança entre os usuários administrativos da sua loja, a VTEX registra diversas operações, seus autores e os horários em que elas ocorreram no **Audit**, um módulo utilizado para pesquisar e investigar este histórico com o auxílio de filtros.\n\nPara acessar a página do Audit no Admin VTEX, acesse **Apps > Apps instalados > Audit**, ou digite **Audit** na barra de busca. Nessa página, é possível realizar as seguintes ações:\n\n* [Buscar eventos no Audit](#buscar-eventos-no-audit)\n* [Verificar últimas buscas realizadas no Audit](#verificar-ultimas-buscas-realizadas-no-audit)\n\n> ℹ️ Para visualizar os eventos do Audit, é necessário ter um [perfil de acesso](/pt/docs/tutorials/perfis-de-acesso) associado ao [recurso](/pt/docs/tutorials/recursos-do-license-manager) *Insights Metrics*.\n\n\n\n## Buscar eventos no Audit\n\nO Audit possibilita realizar buscas por eventos a partir de filtros relacionados às informações a seguir: aplicação, data, ação, autor e detalhes do evento. A seguir, explicamos como utilizar os [filtros](#filtros) do Audit e como os [resultados](#resultados) são apresentados. Também demonstramos o uso de filtros com [exemplos](#exemplos-de-buscas) práticos.\n\n### Filtros\n\nConfira o passo a passo para buscar por um evento utilizando os filtros disponíveis no Audit:\n\n1. No Admin VTEX, acesse **Apps > Apps instalados > Audit**, ou digite _Audit_ na barra de busca. Você será conduzido(a) para a aba **Eventos de auditoria** do Audit.\n2. Em **Filtros**, no menu **Aplicação**, selecione a aplicação relacionada à busca.\n3. No menu **Data**, escolha uma data pré-definida para a busca. Se preferir definir o exato intervalo de datas para a busca, ative a opção **Personalizada** e determine as datas de **Início** e **Fim** para a busca.\n\n > ℹ️ Apenas registros dos últimos três meses podem ser pesquisados. Se precisar de dados mais antigos, abra um [chamado de suporte](https://help.vtex.com/pt/support).\n\n4. Se desejar, inclua um filtro por Ação. Para isso, no campo ao lado de `Ação deve ser`, digite o nome da ação e tecle `Enter`. Você pode inserir mais de um valor teclando `Enter` após cada seleção. Confira o nome de cada ação em [Eventos disponíveis no Audit](/pt/docs/tutorials/eventos-disponiveis-no-audit).\n5. Se necessário, você pode adicionar filtros mais específicos para realizar a busca por eventos com mais precisão. Para isso, clique no botão `Adicionar Filtro`.\n6. Selecione o parâmetro de filtragem (_Autor_ ou _Detalhe do evento_) e informe a qual valor o parâmetro deve ser comparado. Você pode inserir mais de um valor teclando `Enter` após cada seleção.\n\n Ao adicionar filtros com o mesmo parâmetro (exemplo: um filtro definindo que a ação deve ser `Change Promotion Configuration` ou `Change Coupon Configuration`), os resultados incluem eventos que se igualam a qualquer um dos valores inseridos. Ao adicionar filtros com parâmetros distintos (exemplo: `Ação = Change Coupon Configuration `e `Autor = email@email.com`), os critérios são somados. É possível repetir os passos 4 e 5 para adicionar mais filtros.\n\n Por exemplo, a busca correspondente à figura abaixo encontra resultados cujas ações são _Change Promotion Configuration_ ou _Change Coupon Configuration_ e cujo autor é `email@email.com`.\n\n \n\n7. Clique no botão `Aplicar` para obter os eventos que foram encontrados.\n\n Confira [Resultados](#resultados) para entender como os eventos são apresentados.\n\n> ⚠️ Os resultados da busca correspondem exatamente ao conteúdo escrito no tópico do filtro. Para evitar resultados inesperados, certifique-se de que você não digitou espaços desnecessários nos termos da busca.\n\nSe desejar, você pode compartilhar uma busca com outro usuário. Para isso, clique em `Compartilhar busca`, no canto superior direito da página. O link para a busca no Audit será copiado para a sua área de transferência.\n\n### Resultados\n\nA seção **Resultados** lista cada evento encontrado na busca e exibe as informações de cada evento, apresentadas na tabela a seguir.\n\n| Coluna | Descrição |\n|---|---|\n| __Copiar__ | Botão para copiar as informações do evento exibidas na tabela para a área de transferência. |\n| __Hora do evento__ | Data e horário em que o evento ocorreu, no fuso horário do navegador ou do sistema operacional. |\n| __Ação__ | Ação realizada na aplicação selecionada para a busca. Confira as ações possíveis na [lista de eventos disponíveis no Audit](/pt/docs/tutorials/eventos-disponiveis-no-audit). |\n| __Detalhe do evento__ | Informações complementares sobre o evento. Confira os detalhes exibidos para cada evento na [lista de eventos disponíveis no Audit](/pt/docs/tutorials/eventos-disponiveis-no-audit). |\n| __Autor__ | Email, ID ou token do usuário que realizou o evento. |\n| __Mais detalhes__ | Botão que abre um modal com mais informações sobre o evento, quando aplicável. Os detalhes exibidos podem incluir: - **Nome da entidade:** ID da entidade modificada.
- **Entidade antes da ação:** dados da entidade antes do evento, em formato [JSON](http://www.json.org/).
- **Entidade após a ação:** dados da entidade após o evento, em formato [JSON](http://www.json.org/).
A depender do evento, nem todas as informações citadas acima são exibidas. Por exemplo, um evento de exclusão de uma informação mostra apenas a entidade antes da ação. Por outro lado, um evento de criação de uma informação apresenta apenas a entidade após a ação.
Alguns eventos não apresentam nenhuma informação complementar. Nesses casos, o modal aparece vazio. |\n\n### Exportar resultados\n\nAlém de visualizar a lista de eventos e suas as informações, é possível exportar esses resultados para compartilhar com terceiros.\n\nAo fazer uma consulta, após aplicar os filtros, o botão `Exportar para CSV` será habilitado.\n\nClique em `Exportar para CSV` para enviar o arquivo com os eventos. O email será enviado para o endereço que está atualmente em uso no Admin VTEX.\n\n> ℹ️ O arquivo exportado pode demorar em torno de 20 minutos para ser enviado por email.\n\nVeja o exemplo de arquivo que será exportado:\n\n```csv\napp,source.application,source.author,source.entityName,source.eventTime,source.workflow,table,time\ncheckout,checkout,john.doe@example.com,Order,2025-10-28T21:01:01.165Z,order-processing,orders,2025-10-28T21:01:01.166Z\ninventory,inventory,jane.smith@example.com,Product,2025-10-28T21:01:01.166Z,inventory-management,products,2025-10-28T21:01:01.166Z\ncatalog,catalog,admin@example.com,Category,2025-10-28T21:01:01.166Z,catalog-update,categories,2025-10-28T21:01:01.166Z\npricing,pricing,pricing-bot@example.com,Price,2025-10-28T21:01:01.167Z,,,2025-10-28T21:01:01.167Z\n```\n\n> ⚠️ Os eventos das seguintes aplicações não podem ser exportados: OMS, Catálogo (API), Catálogo (Admin), Assinaturas, Portal CMS e Portal.\n\n> ℹ️ Apenas uma exportação de eventos é realizada por vez. Você deve aguardar o recebimento do email com o arquivo CSV para realizar uma nova exportação de eventos.\n\n### Exemplos de buscas\n\nA seguir, listamos alguns cenários de busca comuns para ilustrar como os filtros devem ser compostos dependendo do que se deseja buscar.\n\n#### Ativação de produto\n\nPara buscar se um produto foi ativado no Catálogo em determinada data:\n\n1. Selecione a data desejada.\n2. No menu **Aplicação**, selecione _Catálogo (Admin)_.\n3. Adicione um filtro cuja **Ação** deve ser `Product Activation`.\n4. Adicione um filtro cujo **Detalhe do evento **deve ser `product id \"X\" activated`, onde `X` precisa ser substituído pelo ID do produto buscado.\n\n#### Alteração de preço\n\nPara buscar se o preço de um SKU foi alterado em determinada data:\n\n1. Selecione a data desejada.\n2. No menu **Aplicação**, selecione _Preços_.\n3. Adicione um filtro cuja **Ação** deve ser `Put Price`.\n4. Adicione um filtro cujo **Detalhe do evento **deve ser o ID do SKU do item procurado.\n\n> ℹ️ Para identificar se a alteração de preço foi realizada por meio da importação de uma planilha de preços fixos, verifique a coluna **Autor** no resultado da busca. Se o autor for `vtex-service::pricing-wrk::Stable`, isso indica que o preço foi atualizado por uma planilha importada. Caso o autor seja um endereço de email de usuário, a alteração foi feita manualmente. \n\n#### Exclusão de estoque\n\nPara buscar se um estoque foi deletado em determinada data:\n\n1. Selecione a data desejada.\n2. No menu **Aplicação**, selecione _Estoque & Entrega_.\n3. Adicione um filtro cuja **Ação** deve ser `Warehouse Delete`.\n4. Adicione um filtro cujo **Detalhe do evento **deve ser o ID do item procurado.\n\n#### Exclusão de transportadora\n\nPara buscar se uma transportadora foi deletada em determinada data:\n\n5. Selecione a data desejada.\n6. No menu **Aplicação**, selecione _Estoque & Entrega_.\n7. Adicione um filtro cuja **Ação** deve ser `Carrier Delete`.\n8. Adicione um filtro cujo **Detalhe do evento** deve ser o ID da transportadora buscada.\n\n## Verificar últimas buscas realizadas no Audit\n\nToda busca realizada no Audit é salva na aba **Últimas buscas**. Para refazer uma busca nessa aba, clique no botão ![](\"https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/segurança/recursos-de-segurança-da-plataforma/audit_3.png\")
correspondente à busca que você deseja refazer.\n\nConfira a seguir as informações disponíveis nesta aba:\n\n| Coluna | Descrição |\n|---|---|\n| Buscado em | Data e horário em que a busca foi realizada no Audit. |\n| Aplicação | Aplicação da VTEX em que os eventos foram buscados. |\n| Termos buscados | Filtros utilizados na busca. |\n| Período buscado | Data de início e fim do período selecionado para a busca. |\n| Refazer busca | Botão que permite repetir a busca. |\n\n> ⚠️ Apenas 50 buscas ficam gravadas na aba **Últimas buscas**. Se quiser salvar uma busca além desse limite, adicione-a aos favoritos do seu browser."}