Painel de administração do site

Neste artigo

• Informações de licença e pesquisa
• Console de gerenciamento
• Explorar
• Log de auditoria
• Relatórios
• Índices
• Repositórios
• Todos os usuários
• Administradores do site
• Usuários inativos
• Usuários suspensos

Para acessar o painel, clique em no canto superior direito de qualquer página.

Informações de licença e pesquisa

Consulte esta seção do painel de administração do site para verificar sua licença atual do GitHub Enterprise, 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 intervalos diários, semanais e mensais para repositórios e desenvolvedores. Veja qual foi a última vez que os dados ficaram em cache e organize em fila os trabalhos de cálculo de tendências na seção Explorar.

Log de auditoria

O GitHub Enterprise mantém um log de execução das ações auditadas, e essas informações ficam disponíveis para consulta.

Por padrão, o log de auditoria mostra uma lista de todas as ações auditadas em ordem cronológica inversa. Você pode filtrar essa lista inserindo pares chave-valor na caixa de texto Query (Consulta) e clicando em Search (Pesquisar), conforme a explicação em "Pesquisar no log de auditoria".

Para obter mais informações gerais sobre logs de auditoria, consulte "Gerar logs de auditoria". Para ver a lista completa de ações auditadas, consulte "Ações auditadas".

Relatórios

Para obter informações sobre usuários, organizações e repositórios da sua instância do GitHub Enterprise Server, você normalmente faria fetch de dados JSON na 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 Reports (Relatórios) como alternativa, facilitando o download de relatórios CSV com a maioria das informações necessárias 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 no último mês;
• todos os usuários inativos por um mês (ou mais);
• 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. Por exemplo, veja uma forma de baixar o relatório "todos os usuários" com cURL:

curl -L -u username:password/token http(s)://hostname/stafftools/reports/all_users.csv

Para acessar os outros relatórios de forma programática, substitua all_users por active_users, dormant_users, suspended_users, all_organizations ou all_repositories.

Relatórios de usuário

Relatórios da organização

Relatórios do repositório

Índices

Os recursos de pesquisa de códigos do GitHub têm tecnologia ElasticSearch. Esta seção do painel de administração do site mostra o status atual do cluster do ElasticSearch e oferece várias ferramentas para controlar o comportamento de pesquisa e geração de índices. Essas ferramentas se dividem em três categorias:

Pesquisa de código

Esta ação permite habilitar ou desabilitar as operações de pesquisa e índice no código-fonte.

Reparo de índice de pesquisa de códigos

Esta categoria controla a forma como ocorre o reparo do índice de pesquisa de códigos. Você pode:

• habilitar ou desabilitar trabalhos de reparo de índice;
• iniciar um novo trabalho de reparo de índice;
• redefinir o estado de todo o reparo de índice.

O GitHub Enterprise usa trabalhos de reparo para reconciliar o estado do índice de pesquisa com dados armazenados em bancos de dados (problemas, pull requests, repositórios e usuários) e dados armazenados em repositórios do Git (código-fonte). Isso acontece quando:

• um novo índice de pesquisa é criado;
• dados ausentes precisam ser aterrados; ou
• dados antigos de pesquisa precisam ser atualizados.

Em outras palavras, os trabalhos de reparo são iniciados conforme necessário e executados em segundo plano. Esses trabalhos não são programados pelos administradores do site.

Além disso, trabalhos de reparo usam uma "compensação de reparo" para 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.

Uma barra de progresso mostra o status atual de um trabalho de reparo em todos os trabalhadores relacionados em segundo plano. Trata-se da diferença percentual da compensação do reparo com o ID de registro mais alto no banco de dados. Não se preocupe com o valor mostrado na barra de progresso após a conclusão de um trabalho de reparo; ele mostra a diferença entre a compensação do reparo e o ID de registro mais alto no banco de dados, e diminuirá à medida que mais repositórios forem adicionados à sua instância do GitHub Enterprise Server, mesmo que esses repositórios estejam indexados no momento.

Você pode iniciar um novo trabalho de reparo do índice de pesquisa de código a qualquer momento. Ele usará uma única CPU, pois reconcilia o índice de pesquisa com os dados do banco de dados e do repositório Git. Para minimizar os efeitos no desempenho de E/S e reduzir as chances de tempo limite das operações, tente fazer um trabalho de reparo fora dos horários de pico. Monitore as médias de carga do sistema e o uso da CPU usando um utilitário como top. Se você notar que não houve alterações significativas, isso indica que provavelmente será seguro fazer um trabalho de reparo de índice nos horários de pico.

Reparo de índice de problemas

Esta categoria controla a forma como o índice Problemas é reparado. Você pode:

• habilitar ou desabilitar trabalhos de reparo de índice;
• iniciar um novo trabalho de reparo de índice;
• redefinir o estado de todo o reparo de índice.

Repositórios

Este espaço lista os repositórios da sua instância do GitHub Enterprise Server. Você pode clicar no nome de um repositório e acessar suas funções de administração.

• Bloquear pushes forçados em um repositório
• Configurar o Git Large File Storage;
• Arquivar e cancelar o arquivamento de repositórios

Todos os usuários

Aqui você verá todos os usuários da sua instância do GitHub Enterprise Server e poderá iniciar uma auditoria de chave SSH.

Administradores do site

Aqui você verá todos os administradores da sua instância do GitHub Enterprise Server e poderá iniciar uma auditoria de chave SSH.

Usuários inativos

Aqui você pode ver e suspender todos os usuários inativos da sua instância do GitHub Enterprise Server. Uma conta de usuário é considerada inativa quando:

• Seu tempo de existência supera o limite de inatividade configurado na 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.

The dormancy threshold is the length of time a user must be inactive to be considered dormant. The default dormancy threshold is 90 days, however you can customize the dormancy threshold for sua instância do GitHub Enterprise Server. Para obter mais informações, consulte "Gerenciar usuários inativos".

Usuários suspensos

Aqui você verá todos os usuários que foram suspensos da sua instância do GitHub Enterprise Server e poderá iniciar uma auditoria de chave SSH.