Skip to main content

Esta versão do GitHub Enterprise será descontinuada em 2022-09-28. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Sobre os logs do sistema

O GitHub Enterprise Server mantém logs de erros e mensagens sobre eventos do sistema. Os logs são úteis para identificar ações e exceções no nível do usuário, do aplicativo e do sistema.

Logs do sistema

Por padrão, os logs do sistema para o GitHub Enterprise Server são girados automaticamente a cada 24 horas e mantidos por sete dias. Os logs do sistema incluem eventos no nível do sistema, logs de aplicativos e dados de eventos do Git. Como os arquivos de log costumam ser gravados e podem ser grandes, pode ser útil extrair e analisar entradas de log relevantes em um host separado para sua instância do GitHub Enterprise Server.

Encaminhe os logs do sistema para um sistema ou um servidor de terceiros para obter uma retenção mais longa. Para obter mais informações, confira "Encaminhamento de log".

Além de revisar os logs do sistema, você pode monitorar a atividade na sua empresa de outras maneiras, como ver os logs de auditoria, enviar os logs por push e gerenciar os webhooks globais. Para obter mais informações, confira "Como monitorar a atividade na sua empresa".

Tipos de logs

Veja abaixo uma lista dos principais logs usados pelo dispositivo do GitHub Enterprise Server e as respectivas funções:

CaminhoDescrição
/var/log/github/audit.logEventos de usuário, de repositório e do sistema auditados.
/var/log/github/unicorn.logTráfego da API e da interface da Web.
/var/log/github/exceptions.logErros no nível do aplicativo.
/var/log/haproxy.logTodo o tráfego IP que chega ao dispositivo.
/var/log/hookshot/resqued.logEntrega e falhas do webhook.
/var/log/github/auth.logSolicitações de autenticação, seja por meio de métodos internos, do LDAP, do CAS ou do SAML.
/var/log/github/gitauth.logTodas as solicitações de autenticação do Git.

As solicitações de atividade e autenticação do Git são processadas pelo serviço babeld.

Vários serviços do GitHub Enterprise Server, como o serviço babeld, são conteinerizados. Os logs conteinerizados são gravados no systemd journal e podem ser consultados a qualquer momento por meio do comando journalctl.

Eventos do sistema auditados

Todas as entradas do arquivo audit.log usam e podem ser filtradas com a palavra-chave github_audit.

Por exemplo, esta entrada mostra que um repositório foi criado.

Oct 26 01:42:08 github-ent github_audit: {:created_at=>1351215728326, :actor_ip=>"10.0.0.51", :data=>{}, :user=>"some-user", :repo=>"some-user/some-repository", :actor=>"some-user", :actor_id=>2, :user_id=>2, :action=>"repo.create", :repo_id=>1, :from=>"repositories#create"}

Este exemplo mostra que houve push dos commits para um repositório.

Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/main" }

Pacotes de suporte

O pacote de suporte inclui os logs do sistema e todas as informações de auditoria são registradas no arquivo audit.log no diretório github-logs. Para obter mais informações, confira "Como fornecer dados para o Suporte do GitHub".

Leitura adicional