Para acessar o painel, clique em no canto superior direito de qualquer página.
Pesquisar
Veja esta seção do painel de administração do site para pesquisar usuários e repositórios e consultar o log de auditoria.
Console de Gerenciamento
Neste espaço, é possível iniciar o Console de Gerenciamento para gerenciar configurações do appliance virtual, como domínio, autenticação e SSL.
Explorar
Os dados da página de tendências do GitHub são calculados em períodos diários, semanais e mensais para repositórios e desenvolvedores. Você pode ver quando esses dados foram armazenados em cache pela última vez e colocar na fila novos trabalhos de cálculo de tendências na seção Explorar.
Log de auditoria
O GitHub Enterprise Server mantém um log contínuo das ações auditadas que você pode consultar.
Por padrão, o log de auditoria mostra uma lista de todas as ações auditadas em ordem cronológica inversa. Filtre essa lista inserindo pares chave-valor na caixa de texto Consulta e clicando em Pesquisar, conforme explicado em "Como fazer pesquisas no log de auditoria para sua empresa".
Para obter mais informações sobre o log de auditoria em geral, confira "Sobre o log de auditoria da sua empresa". Para ver a lista completa de ações auditadas, confira "Auditar eventos de log para sua empresa".
Relatórios
Caso você precise obter informações sobre os usuários, as organizações e os repositórios do sua instância do GitHub Enterprise Server, normalmente, busque dados JSON por meio da API do GitHub. Infelizmente, a API pode não fornecer todos os dados necessários e ainda requer um pouco de conhecimento técnico. O painel de administração do site oferece uma seção Relatórios como alternativa, facilitando o download de relatórios CSV com a maioria das informações de que você provavelmente precisará para usuários, organizações e repositórios.
Especificamente, é possível baixar relatórios CSV que listem o seguinte:
- todos os usuários;
- todos os usuários ativos
- todos os usuários inativos
- todos os usuários suspensos;
- todas as organizações;
- todos os repositórios.
Você também pode acessar esses relatórios de forma programática pela autenticação HTTP padrão com uma conta de administrador do site. Você deve usar um personal access token com o escopo site_admin
. Para obter mais informações, confira "Managing your personal access tokens".
Por exemplo, veja abaixo uma forma de baixar o relatório "todos os usuários" com um comando curl
:
curl -L -u USERNAME:TOKEN http(s)://HOSTNAME/stafftools/reports/all_users.csv
Para acessar os outros relatórios por meio de programação, substitua all_users
por active_users
, dormant_users
, suspended_users
, all_organizations
ou all_repositories
.
Observação: a solicitação curl
inicial retornará uma resposta HTTP 202 se não houver relatórios armazenados em cache disponíveis. Um relatório será gerado em segundo plano. Você pode enviar uma segunda solicitação para baixar o relatório. Você pode usar uma senha ou um token OAuth com o escopo site_admin
no lugar de uma senha.
Relatórios de usuário
Chave | Descrição |
---|---|
created_at | Momento da criação da conta do usuário (carimbo de data/hora ISO 8601) |
id | ID da conta de usuário ou organização |
login | Nome de login da conta |
email | Endereço de e-mail principal da conta |
role | Conta de administrador ou usuário regular |
suspended? | Se a conta foi suspensa |
last_logged_ip | Endereço IP mais recente a fazer login na conta |
repos | Número de repositórios pertencentes à conta |
ssh_keys | Número de chaves SSH registradas na conta |
org_memberships | Número de organizações às quais a conta pertence |
dormant? | Se a conta está inativa |
last_active | Última vez em que a conta ficou ativa (carimbo de data/hora ISO 8601) |
raw_login | Informações brutas de login (formato JSON) |
2fa_enabled? | Se o usuário habilitou a autenticação de dois fatores |
Relatórios da organização
Chave | Descrição |
---|---|
id | ID da organização |
created_at | Momento de criação da organização |
login | Nome de login da organização |
email | Endereço de e-mail principal da organização |
owners | Número de proprietários da organização |
members | Número de integrantes da organização |
teams | Número de equipes da organização |
repos | Número de repositórios da organização |
2fa_required? | Se a organização exige autenticação de dois fatores |
Relatórios do repositório
Chave | Descrição |
---|---|
created_at | Momento de criação do repositório |
owner_id | ID do proprietário do repositório |
owner_type | Se o repositório pertence a um usuário ou organização |
owner_name | Nome do proprietário do repositório |
id | ID do repositório |
name | Nome do repositório |
visibility | Se o repositório é público ou privado |
readable_size | Tamanho do repositório em formato legível por humanos |
raw_size | Tamanho do repositório como número |
collaborators | Número de colaboradores do repositório |
fork? | Se o repositório é uma bifurcação |
deleted? | Se o repositório foi excluído |
Indexação
Os recursos de pesquisa do GitHub da plataforma Elasticsearch. Esta seção do painel de administração do site mostra o status atual do seu cluster do Elasticsearch e oferece várias ferramentas para controlar o comportamento de pesquisa e do índice.
Para obter mais informações sobre a pesquisa de código, confira "Pesquisa na documentação do GitHub". Para obter informações sobre o Elasticsearch, visite o site do Elasticsearch.
Observação: em uso normal, os administradores do site não precisam criar índices ou agendar trabalhos de reparo. Para solução de problemas ou outras finalidades de suporte, o Suporte do GitHub pode instruir você a executar um trabalho de reparo.
Gerenciamento de índice
GitHub Enterprise Server reconcilia o estado do índice de pesquisa com os dados na instância de maneira automática e regular.
- Problemas, solicitações de pull, repositórios e usuários no banco de dados
- Repositórios Git (código-fonte) no disco
Sua instância usa trabalhos de reparo para reconciliar os dados e agenda um trabalho de reparo em segundo plano quando ocorrem os eventos a seguir.
- Um índice de pesquisa é criado.
- Dados ausentes precisam ser provisionados.
- Dados antigos de pesquisa precisam ser atualizados.
Você pode criar um índice ou clicar em um índice existente na lista para gerenciá-lo. É possível executar as operações a seguir em um índice.
- Torne o índice pesquisável.
- Torne o índice gravável.
- Atualize o índice.
- Excluir o índice
- Redefina o estado de reparo do índice.
- Inicie um novo trabalho de reparo de índice.
- Habilite ou desabilite trabalhos de reparo de índice.
Uma barra de progresso mostra o status atual de um trabalho de reparo em todos os trabalhadores em segundo plano. A barra é a diferença percentual do deslocamento do reparo com o ID de registro mais alto no banco de dados. Você pode ignorar o valor mostrado na barra de progresso após a conclusão de um trabalho de reparo. A barra de progresso mostra a diferença entre o deslocamento de reparo e a ID de registro mais alta no banco de dados, e diminuirá à medida que mais repositórios forem adicionados ao sua instância do GitHub Enterprise Server, mesmo que esses repositórios estejam realmente indexados.
Para minimizar os efeitos no desempenho de E/S e reduzir as chances de exceder o tempo limite das operações, execute o trabalho de reparo fora dos horários de pico. À medida que o trabalho reconciliar o índice de pesquisa com os dados de banco de dados e repositório Git, uma CPU será usada. Monitore as médias de carga do sistema e o uso da CPU com um utilitário como top
. Se você não observar nenhum aumento significativo no consumo de recursos, também deverá ser seguro executar um trabalho de reparo de índice durante o horário de pico.
Os trabalhos de reparo usam um "deslocamento de reparo" a fim de alcançar a paralelização. Trata-se de uma compensação na tabela do banco de dados para o registro a ser reconciliado. Vários trabalhos em segundo plano podem sincronizar tarefas com base nessa compensação.
Pesquisa de código
Esta ação permite habilitar ou desabilitar as operações de pesquisa e índice no código-fonte.
Logins reservados
Certas palavras são reservadas para uso interno em sua instância do GitHub Enterprise Server, o que significa que essas palavras não podem ser usadas como nomes de usuário.
Por exemplo, as palavras a seguir são reservadas, entre outras:
admin
enterprise
login
staff
support
Para a lista completa ou palavras reservadas, acesse "Logins reservados" no painel de administração do site.
Advanced Security Committers
Dentro do painel de administração do site, você pode ver o número de commiters ativos que estão atualmente usando estações para o GitHub Advanced Security e pode calcular quantas estações novas ou adicionais seriam usadas se você habilitasse o GitHub Advanced Security para mais organizações e repositórios. Para obter mais informações, confira "Exibir informações do committer para GitHub Advanced Security".
Todos os usuários
Consulte esta seção do painel de administração do site para gerenciar organizações, pessoas, políticas e configurações.
Repositórios
Esta é uma lista dos repositórios do sua instância do GitHub Enterprise Server. Você pode clicar no nome de um repositório e acessar suas funções de administração.
- Como bloquear pushes forçados em um repositório
- Como configurar o Git Large File Storage
- Como arquivar repositórios e cancelar o arquivamento deles
todos os usuários
Aqui você pode ver todos os usuários do sua instância do GitHub Enterprise Server e iniciar uma auditoria de chave SSH.
Administradores do site
Aqui você pode ver todos os administradores do sua instância do GitHub Enterprise Server e iniciar uma auditoria de chave SSH.
Usuários inativos
Aqui você pode ver e suspender todos os usuários inativos do sua instância do GitHub Enterprise Server. Uma conta de usuário é considerada inativa quando:
- Existe há mais tempo do que o limite de inatividade definido para o sua instância do GitHub Enterprise Server.
- Não gerou qualquer atividade em seu período de existência;
- Não é uma conta de administrador do site.
O limite de inatividade é o tempo que um usuário deve ser inativo para ser considerado inativo. O limite padrão de inatividade é de 90 dias, mas você pode personalizar esse limite no sua instância do GitHub Enterprise Server. Para obter mais informações, confira "Gerenciar usuários inativos".
Usuários suspensos
Aqui você pode ver todos os usuários que foram suspensos do sua instância do GitHub Enterprise Server e iniciar uma auditoria de chave SSH.