Skip to main content

Como fazer pesquisas no log de auditoria para sua empresa

Você pode pesquisar uma extensa lista de ações auditadas em sua empresa.

Who can use this feature

Enterprise owners and site administrators can search the audit log.

Sobre a pesquisa no log de auditoria da empresa

Você pode pesquisar o log de auditoria da empresa diretamente na interface do usuário usando o menu suspenso Filtros ou digitando uma consulta de pesquisa.

Consulta de pesquisa

Para obter mais informações sobre como ver o log de auditoria da sua empresa, confira "Como acessar o log de auditoria para sua empresa".

Observação: os eventos Git não estão incluídos nos resultados da pesquisa.

Use também a API para recuperar eventos de log de auditoria. Para obter mais informações, confira "Como usar a API do log de auditoria para sua empresa".

Observe que não é possível pesquisar entradas usando texto. No entanto, é possível criar consultas de pesquisa usando diversos filtros. Muitos operadores usados na consultar do log, como -, > ou <, correspondem ao mesmo formato que a pesquisa no GitHub Enterprise Server. Para obter mais informações, confira "Como fazer pesquisas no GitHub".

Observação: O log de auditoria lista os eventos disparados por atividades que afetam sua empresa. Os logs de auditoria de GitHub Enterprise Server são retidos indefinidamente, a menos que um proprietário da empresa configure um período de retenção diferente. Para obter mais informações, confira "Configurar o log de auditoria da sua empresa".

Por padrão, são exibidos apenas os eventos dos últimos três meses. Para ver eventos mais antigos, você deve especificar um intervalo de datas com o parâmetro created. Para obter mais informações, confira "Noções básicas sobre a sintaxe de pesquisa".

Pesquisar filtros de consulta

FiltrarDescrição
Yesterday's activityTodas as ações criadas no último dia.
Enterprise account managementTodas as ações na categoria business.
Organization membershipTodas as ações de quando um novo usuário foi convidado a ingressar em uma organização.
Team managementTodas as ações relacionadas ao gerenciamento da equipe.
– Quando uma conta de usuário ou um repositório foi adicionado a uma equipe ou removido dela
– Quando um mantenedor da equipe foi promovido ou rebaixado
– Quando uma equipe foi excluída
Repository managementTodas as ações do gerenciamento do repositório.
– Quando um repositório foi criado ou excluído
– Quando a visibilidade do repositório foi alterada
– Quando uma equipe foi adicionada ou removida de um repositório
Hook activityTodas as ações de webhooks e ganchos de pré-recebimento.
Security managementTodas as ações referentes a chaves SSH, chaves de implantação, chaves de segurança, 2FA e autorização de credencial de logon único do SAML e alertas de vulnerabilidade para repositórios.

Sintaxe de consulta de pesquisa

Você pode redigir uma consulta de pesquisa de um ou mais pares key:value, separados por operadores lógicos AND/OR. Por exemplo, para ver todas as ações que afetaram o repositório octocat/Spoon-Knife desde o início de 2017:

repo:"octocat/Spoon-Knife" AND created:>=2017-01-01

Os pares key:valueque podem ser usados em uma consulta de pesquisa são:

ChaveValor
actor_idID da conta do usuário que iniciou a ação.
actorNome da conta do usuário que iniciou a ação.
oauth_app_idID do aplicativo OAuth associado à ação.
actionNome da ação auditada
user_idID do usuário afetado pela ação.
userNome do usuário afetado pela ação.
repo_idID do repositório afetado pela ação (se aplicável).
repoNome do repositório afetado pela ação (se aplicável).
actor_ipEndereço IP do qual a ação foi iniciada.
createdHora em que a ação ocorreu. Se estiver consultando o log de auditoria no painel de administração do site, use created_at
fromExibição da qual a ação foi iniciada.
noteInformações diversas sobre eventos específicos (em texto sem formatação ou formato JSON).
orgNome da organização afetada pela ação (se aplicável).
org_idID da organização afetada pela ação (se aplicável).
businessNome da empresa afetada pela ação (se aplicável)
business_idID da empresa afetada pela ação (se aplicável)

Para ver as ações agrupadas por categoria, use também o qualificador de ação como um par key:value. Para obter mais informações, confira "Pesquisa com base na ação executada".

Para ver uma lista completa das ações no log de auditoria da sua empresa, confira "Ações de log de auditoria para sua empresa".

Pesquisar no log de auditoria

Pesquisar com base em operação

Use o qualificador operation para limitar as ações a tipos específicos de operações. Por exemplo:

  • operation:access localiza todos os eventos em que um recurso foi acessado.
  • operation:authentication localiza todos os eventos em que um evento de autenticação foi realizado.
  • operation:create localiza todos os eventos em que um recurso foi criado.
  • operation:modify localiza todos os eventos em que um recurso existente foi modificado.
  • operation:remove localiza todos os eventos em que um recurso existente foi removido.
  • operation:restore localiza todos os eventos em que um recurso existente foi restaurado.
  • operation:transfer localiza todos os eventos em que um recurso existente foi transferido.

Pesquisar com base no repositório

Use o qualificador repo para limitar as ações a um repositório específico. Por exemplo:

  • repo:my-org/our-repo localiza todos os eventos que ocorreram no repositório our-repo na organização my-org.
  • repo:my-org/our-repo repo:my-org/another-repo localiza todos os eventos que ocorreram nos repositórios our-repo e another-repo na organização my-org.
  • -repo:my-org/not-this-repo exclui todos os eventos que ocorreram no repositório not-this-repo na organização my-org.

Observe que você precisa incluir o nome da conta dentro do qualificador repo. A pesquisa de apenas repo:our-repo não funcionará.

Pesquisar com base no usuário

O qualificador actor pode definir o escopo de eventos com base no autor da ação. Por exemplo:

  • actor:octocat localiza todos os eventos realizados por octocat.
  • actor:octocat actor:hubot localiza todos os eventos realizados por octocat e hubot.
  • -actor:hubot exclui todos os eventos realizados por hubot.

Observe que só é possível usar um nome de usuário do GitHub Enterprise Server, e não o nome verdadeiro da pessoa.

Pesquisar com base na ação

Para pesquisar eventos específicos, use o qualificador action na consulta. Por exemplo:

  • action:team localiza todos os eventos agrupados na categoria da equipe.
  • -action:hook exclui todos os eventos na categoria do webhook.

Cada categoria tem um conjunto de ações associadas que você pode filtrar. Por exemplo:

  • action:team.create localiza todos os eventos em que uma equipe foi criada.
  • -action:hook.events_changed exclui todos os eventos em que os eventos em um webhook foram alterados.

As ações que podem ser encontradas no log de auditoria da sua empresa são agrupadas nas seguintes categorias:

| Nome da categoria | Descrição |------------------|------------------- | artifact | Contém atividades relacionadas aos artefatos de execução de fluxo de trabalho do GitHub Actions. | audit_log_streaming | Contém atividades relacionadas aos logs de auditoria de streaming para organizações em uma conta corporativa. | business | Contém atividades relacionadas às configurações corporativas de uma empresa. | business | Contém atividades relacionadas às configurações corporativas de uma empresa. | business_secret_scanning_custom_pattern | Contém atividades relacionadas aos padrões personalizados para a verificação de segredos em uma empresa. | checks | Contém atividades relacionadas aos pacotes de verificação e às execuções. | commit_comment | Contém atividades relacionadas à atualização ou à exclusão de comentários de commit. | config_entry | Contém atividades relacionadas a definições de configuração. Esses eventos só ficam visíveis no log de auditoria do administrador do site. | | dependabot_alerts | Contém atividades de configuração no nível da organização para Dependabot alerts nos repositórios existentes. Para obter mais informações, confira "Sobre os Dependabot alerts". | dependabot_alerts_new_repos | Contém atividades de configuração no nível da organização para Dependabot alerts em novos repositórios criados na organização. | dependabot_repository_access | Contém atividades relacionadas aos repositórios privados de uma organização que o Dependabot tem permissão para acessar. | dependabot_security_updates | Contém atividades de configuração no nível da organização para Dependabot security updates nos repositórios existentes. Para obter mais informações, confira "Como configurar Dependabot security updates". | dependabot_security_updates_new_repos | Contém atividades de configuração de nível da organização nas Dependabot security updates para os repositórios criados na organização. | dependency_graph | Contém atividades de configuração no nível da organização dos grafos de dependências nos repositórios. Para obter mais informações, confira "Sobre o grafo de dependência". | dependency_graph_new_repos | Contém atividades de configuração no nível da organização para novos repositórios criados na organização. | dotcom_connection | Contém atividades relacionadas ao GitHub Connect. | enterprise | Contém atividades relacionadas às configurações da empresa. | gist | Contém atividades relacionadas ao Gists. | hook | Contém atividades relacionadas a webhooks. | integration | Contém atividades relacionadas às integrações de uma conta. | integration_installation | Contém atividades relacionadas às integrações instaladas em uma conta. | integration_installation_request | Contém atividades relacionadas às solicitações de membros da organização para proprietários aprovarem integrações para uso na organização. | issue | Contém atividades relacionadas à fixação, à transferência ou à exclusão de um problema em um repositório. | issue_comment | Contém atividades relacionadas à fixação, à transferência ou à exclusão de comentários em um problema. | issues | Contém atividades relacionadas à habilitação ou à desabilitação da criação de problemas para uma organização. | members_can_create_pages | Contém atividades relacionadas ao gerenciamento da publicação de sites do GitHub Pages para repositórios na organização. Para obter mais informações, confira "Como gerenciar a publicação de sites do GitHub Pages para sua organização". | members_can_create_private_pages | Contém atividades relacionadas ao gerenciamento da publicação de sites privados do GitHub Pages para repositórios na organização. | members_can_create_public_pages | Contém atividades relacionadas ao gerenciamento da publicação de sites públicos do GitHub Pages para repositórios na organização. | members_can_delete_repos | Contém atividades relacionadas à habilitação ou à desabilitação da criação de repositórios para uma organização. | oauth_access | Contém atividades relacionadas aos tokens de acesso OAuth. | oauth_application | Contém atividades relacionadas aos Aplicativos OAuth. | org | Contém atividades relacionadas à associação a uma organização. | org_credential_authorization | Contém atividades relacionadas à autorização de credenciais para uso com o logon único do SAML. | org_secret_scanning_custom_pattern | Contém atividades relacionadas aos padrões personalizados para a verificação de segredos em uma organização. Para obter mais informações, confira "Como definir padrões personalizados para a verificação de segredos". | org.secret_scanning_push_protection | Contém atividades relacionadas aos padrões personalizados de verificação de segredos em uma organização. Para obter mais informações, confira "Como proteger os pushes com a verificação de segredos". | organization_default_label | Contém atividades relacionadas aos rótulos padrão em uma organização. | organization_domain |Contém atividades relacionadas aos domínios da organização verificados. | organization_projects_change | Contém atividades relacionadas aos quadros de projetos de toda a organização em uma empresa. | pre_receive_environment | Contém atividades relacionadas aos ambientes de gancho de pré-recebimento. | pre_receive_hook | Contém atividades relacionadas aos ganchos de pré-recebimento. | private_instance_encryption | Contém atividades relacionadas à habilitação do modo privado para uma empresa. | private_repository_forking | Contém atividades relacionadas à permissão de forks de repositórios privados e internos para um repositório, uma organização ou uma empresa. | project | Contém atividades relacionadas aos quadros de projetos. | project_field | Contém atividades relacionadas à criação e à exclusão de campos em um quadro de projetos. | project_view | Contém atividades relacionadas à criação e à exclusão de exibições em um quadro de projetos. | protected_branch | Contém atividades relacionadas aos branches protegidos. | public_key | Contém atividades relacionadas às chaves SSH e às chaves de implantação. | pull_request | Contém atividades relacionadas às solicitação de pull. | pull_request_review | Contém atividades relacionadas às revisões de solicitação de pull. | pull_request_review_comment | Contém atividades relacionadas aos comentários de revisão de solicitação de pull. | repo | Contém atividades relacionadas aos repositórios pertencentes a uma organização. | repository_image | Contém atividades relacionadas a imagens para um repositório. | repository_invitation | Contém atividades relacionadas a convites para ingresso em um repositório. | repository_projects_change | Contém atividades relacionadas à habilitação de projetos em um repositório ou em todos os repositórios de uma organização. | repository_secret_scanning | Contém atividades de nível do repositório relacionadas à verificação de segredos. Para obter mais informações, confira "Sobre a verificação de segredos". | repository_secret_scanning_custom_pattern | Contém atividades relacionadas a padrões personalizados da verificação de segredos em um repositório. Para obter mais informações, confira "Como definir padrões personalizados para a verificação de segredos". | repository_secret_scanning_push_protection | Contém atividades relacionadas a padrões personalizados da verificação de segredos em um repositório. Para obter mais informações, confira "Como proteger os pushes com a verificação de segredos". | repository_vulnerability_alert | Contém atividades relacionadas a Dependabot alerts. | restrict_notification_delivery | Contém atividades relacionadas à restrição de notificações por email para domínios aprovados ou verificados em uma empresa. | role | Contém atividades relacionadas a funções de repositório personalizadas. | secret_scanning | Contém atividades de configuração de nível da organização para a verificação de segredos em repositórios existentes. Para obter mais informações, confira "Sobre a verificação de segredos". | secret_scanning_new_repos | Contém atividades de configuração de nível da organização para verificação de segredos para os repositórios criados na organização. | security_key | Contém atividades relacionadas ao registro e à remoção de chaves de segurança. | ssh_certificate_authority | Contém atividades relacionadas a uma autoridade de certificação SSH em uma organização ou uma empresa. | ssh_certificate_requirement | Contém atividades relacionadas ao requisito de que os membros usem certificados SSH para acessar recursos da organização. | staff | Contém atividades relacionadas a um administrador do site que executa uma ação. | team | Contém atividades relacionadas às equipes em uma organização. | team_discussions | Contém atividades relacionadas ao gerenciamento de discussões em equipe em uma organização. | two_factor_authentication | Contém atividades relacionadas à autenticação de dois fatores. | user | Contém atividades relacionadas aos usuários em uma empresa ou organização. | user_license | Contém atividades relacionadas a um usuário que ocupa uma estação licenciada e que é membro de uma empresa. | workflows | Contém atividades relacionadas a fluxos de trabalho do GitHub Actions.

Pesquisar com base na hora da ação

Use o qualificador created para filtrar eventos no log de auditoria com base na data em que eles ocorreram.

A formatação de data precisa seguir o padrão ISO8601, que é YYYY-MM-DD (ano-mês-dia). Adicione também informações de hora THH:MM:SS+00:00 opcionais após a data, para fazer a pesquisa por hora, minuto e segundo. Isso é T, seguido de HH:MM:SS (hora-minutos-segundos) e uma diferença UTC (+00:00).

Ao pesquisar uma data, você pode usar qualificadores de maior que, menor que e intervalo para filtrar os resultados ainda mais. Para obter mais informações, confira "Noções básicas sobre a sintaxe de pesquisa".

Por exemplo:

  • created:2014-07-08 localiza todos os eventos ocorridos em 8 de julho de 2014.
  • created:>=2014-07-08 localiza todos os eventos ocorridos em 8 de julho de 2014 ou após essa data.
  • created:<=2014-07-08 localiza todos os eventos ocorridos em 8 de julho de 2014 ou antes dessa data.
  • created:2014-07-01..2014-07-31 localiza todos os eventos ocorridos no mês de julho de 2014.

Pesquisar com base no local

Usando o qualificador country, você pode filtrar eventos no log de auditoria com base no país de origem. Use o código curto de duas letras ou o nome completo de um país. Os países com espaços no nome precisarão ser colocados entre aspas. Por exemplo:

  • country:de localiza todos os eventos ocorridos na Alemanha.
  • country:Mexico localiza todos os eventos ocorridos no México.
  • country:"United States" localiza todos os eventos ocorridos nos Estados Unidos.