Tableau de bord d’administration de site

Pour accéder au tableau de bord, dans l’angle supérieur droit de n’importe quelle page, cliquez sur .

Rechercher

Consultez cette section du tableau de bord d’administration de site pour rechercher des utilisateurs et des dépôts et pour interroger le journal d’audit.

Management Console

Ici, vous pouvez lancer la Management Console pour gérer les paramètres de l’appliance virtuelle comme le domaine, l’authentification et SSL.

Explorer

Les données relatives à la page des tendances de GitHub sont calculées pour des périodes d’une journée, d’une semaine et d’un mois pour les dépôts et les développeurs. Vous pouvez voir à quel moment ces données ont été mises en cache pour la dernière fois et mettre en file d’attente de nouveaux travaux de calcul de tendances à partir de la section Explorer.

Journal d’audit

GitHub Enterprise Server tient à jour un journal des actions auditées que vous pouvez interroger.

Par défaut, le journal d’audit affiche une liste de toutes les actions auditées dans un ordre chronologique inversé. Vous pouvez filtrer cette liste en entrant des paires clé-valeur dans la zone de texte Requête, puis en cliquant sur Rechercher, comme expliqué dans « Recherche dans le journal d’audit de votre entreprise ».

Pour plus d’informations sur la journalisation d’audit en général, consultez « À propos du journal d’audit de votre entreprise ». Pour obtenir la liste complète des actions auditées, consultez « Événements du journal d’audit pour votre entreprise ».

Rapports

Si vous avez besoin d’obtenir des informations sur les utilisateurs, les organisations et les dépôts de votre instance GitHub Enterprise Server, vous pouvez être tenté d’extraire des données JSON via l’API GitHub. Malheureusement, vous n’êtes pas assuré d’en tirer toutes les données souhaitées et elle demande un certain bagage technique. Le tableau de bord d’administration de site propose une alternative avec sa section Rapports, d’où vous pouvez facilement télécharger des rapports CSV contenant la plupart des informations dont vous pouvez avoir besoin à propos des utilisateurs, des organisations et des dépôts.

Plus précisément, vous pouvez télécharger des rapports CSV qui listent

• tous les utilisateurs
• tous les utilisateurs actifs
• tous les utilisateurs dormants
• tous les utilisateurs qui ont été suspendus
• toutes les organisations
• tous les dépôts

Vous pouvez aussi accéder à ces rapports par programmation via l’authentification HTTP standard avec un compte d’administrateur de site. Vous devez utiliser un personal access token avec l’étendue site_admin. Pour plus d’informations, consultez « Managing your personal access tokens ».

Par exemple, voici comment télécharger le rapport « tous les utilisateurs » à l’aide d’une commande curl :

curl -L -u USERNAME:TOKEN http(s)://HOSTNAME/stafftools/reports/all_users.csv

Pour accéder aux autres rapports par programmation, remplacez all_users par active_users, dormant_users, suspended_users, all_organizations ou all_repositories.

Rapports utilisateur

Clé	Description
created_at	Date/heure de création du compte d’utilisateur (horodatage ISO 8601)
id	ID de compte de l’utilisateur ou de l’organisation
login	Nom de connexion du compte
email	Adresse e-mail principale du compte
role	Indique si le compte est de type administrateur ou utilisateur ordinaire
suspended?	Indique si le compte a été suspendu
last_logged_ip	Dernière adresse IP à s’être connectée au compte
repos	Nombre de dépôts dont le compte est propriétaire
ssh_keys	Nombre de clés SSH inscrites au niveau du compte
org_memberships	Nombre d’organisations auxquelles le compte appartient
dormant?	Indique si le compte est dormant
last_active	Date/heure auxquelles le compte a été actif pour la dernière fois (horodatage ISO 8601)
raw_login	Informations de connexion brutes (au format JSON)
2fa_enabled?	Indique si l’utilisateur a activé l’authentification à 2 facteurs

Rapports d’organisation

Clé	Description
id	ID d’organisation
created_at	Date/heure de création de l’organisation
login	Nom de connexion de l’organisation
email	Adresse e-mail principale de l’organisation
owners	Nombre de propriétaires de l’organisation
members	Nombre de membres de l’organisation
teams	Nombre d’équipes de l’organisation
repos	Nombre de dépôts de l’organisation
2fa_required?	Indique si l’organisation exige une authentification à 2 facteurs

Rapports de dépôt

Clé	Description
created_at	Date/heure de création du dépôt
owner_id	ID du propriétaire du dépôt
owner_type	Indique si le dépôt est la propriété d’un utilisateur ou d’une organisation
owner_name	Nom du propriétaire du dépôt
id	ID du dépôt
name	Nom du dépôt
visibility	Indique si le dépôt est public ou privé
readable_size	Taille du dépôt dans un format compréhensible
raw_size	Taille du dépôt sous forme de nombre
collaborators	Nombre de collaborateurs dans le dépôt
fork?	Indique si le dépôt est une duplication (fork)
deleted?	Indique si le dépôt a été supprimé

Indexation

Les fonctionnalités de recherche de GitHub sont basées sur la technologie Elasticsearch. Cette section du tableau de bord d’administration de site vous montre l’état actuel de votre cluster Elasticsearch et vous propose plusieurs outils permettant de contrôler le comportement de la recherche et de l’indexation.

Pour plus d’informations sur la recherche de code, consultez « Documentation sur Rechercher sur GitHub ». Pour plus d’informations sur Elasticsearch, consultez le site web d’Elasticsearch.

Gestion des index

GitHub Enterprise Server rapproche l’état de l’index de recherche et les données de l’instance automatiquement et régulièrement.

• Problèmes, demandes de tirage, dépôts et utilisateurs dans la base de données
• Dépôts Git (code source) sur disque

Votre instance utilise des travaux de réparation pour rapprocher les données et planifier un travail de réparation en arrière-plan lorsque les événements suivants se produisent.

• Un index de recherche est créé.
• Des données manquantes doivent être provisionnées.
• D’anciennes données de recherche doivent être mises à jour.

Vous pouvez créer un index ou cliquer sur un index existant dans la liste afin de le gérer. Vous pouvez effectuer les opérations suivantes sur un index.

• Rendre l’index recherchable.
• Rendre l’index accessible en écriture.
• Mettre à jour l’index.
• Supprimer l’index.
• Réinitialiser l’état de réparation de l’index.
• Démarrer un nouveau travail de réparation d’index.
• Activer ou désactiver les travaux de réparation d’index.

Une barre de progression affiche l’état actuel d’un travail de réparation pour l’ensemble des Workers en arrière-plan. Cette barre correspond à la différence en pourcentage du décalage de réparation avec l’ID d’enregistrement le plus élevé dans la base de données. Vous pouvez ignorer la valeur affichée dans la barre de progression une fois que la tâche de réparation est terminée. La barre de progression montre la différence entre le décalage de réparation et l’ID d’enregistrement le plus élevé dans la base de données. Elle diminuera à mesure que d’autres dépôts seront ajoutés à votre instance GitHub Enterprise Server, même si ces dépôts sont réellement indexés.

Pour limiter les effets sur le niveau de performance en E/S et réduire les risques d’expiration des opérations, exécutez un travail de réparation pendant les heures creuses. Un seul processeur est utilisé pendant que le travail rapproche l’index de recherche et les données de la base de données et du dépôt Git. Monitorez les moyennes de charge et l’utilisation processeur de votre système avec un utilitaire comme top. Si vous ne remarquez aucune augmentation significative de la consommation des ressources, cela signifie que vous pouvez sans problème exécuter un travail de réparation d’index pendant les heures de pointe.

Les travaux de réparation utilisent un « décalage de réparation » pour la parallélisation. Il s’agit d’un décalage dans la table de base de données pour l’enregistrement faisant l’objet d’un rapprochement. Plusieurs travaux en arrière-plan peuvent synchroniser le travail en fonction de ce décalage.

Recherche de code

L’objectif est ici de vous permettre d’activer ou de désactiver les opérations de recherche et d’indexation dans le code source.

Connexions réservées

Certains mots sont réservés à une utilisation interne dans votre instance GitHub Enterprise Server, ce qui signifie que ces mots ne peuvent pas être utilisés comme noms d’utilisateurs.

Voici quelques exemples de mots réservés :

• admin
• enterprise
• login
• staff
• support

Pour obtenir la liste complète des mots réservés, accédez à « Connexions réservées » dans le tableau de bord d’administration de site.

Advanced Security Committers

Avec le tableau de bord d’administrateur de site, vous pouvez voir le nombre de committeurs actifs qui utilisent actuellement des sièges pour GitHub Advanced Security, et vous pouvez calculer le nombre de sièges nouveaux ou supplémentaires qui seraient utilisé(e)s si vous activiez GitHub Advanced Security pour d’autres organisations et dépôts. Pour plus d’informations, consultez « Affichage des informations de commiteur pour GitHub Advanced Security ».

Vue d’ensemble de l’entreprise

Consultez cette section du tableau de bord d’administration de site pour gérer les organisations, les personnes, les stratégies et les paramètres.

Référentiels

Il s’agit de la liste des dépôts sur votre instance GitHub Enterprise Server. Vous pouvez cliquer sur un nom de dépôt et accéder à des fonctions permettant d’administrer le dépôt.

• Blocage des envois (push) forcés vers un dépôt
• Configuration de Stockage Fichiers volumineux Git
• Archivage et désarchivage des dépôts

tous les utilisateurs

Ici, vous pouvez voir tous les utilisateurs de votre instance GitHub Enterprise Server et lancer un audit de clé SSH.

Administrateurs de site

Ici, vous pouvez voir tous les administrateurs de votre instance GitHub Enterprise Server et lancer un audit de clé SSH.

Utilisateurs dormants

Ici, vous pouvez voir et suspendre tous les utilisateurs inactifs sur votre instance GitHub Enterprise Server. Un compte d’utilisateur est considéré comme inactif (« dormant ») dans les cas suivants :

• Il a dépassé le seuil de dormance défini pour votre instance GitHub Enterprise Server.
• Il n’a généré aucune activité au cours de cette période.
• Il n’est pas administrateur de site.

Le seuil de repos est la durée pendant laquelle un utilisateur doit être inactif pour être considéré comme étant en sommeil. Le seuil de repos par défaut est de 90 jours, mais vous pouvez le personnaliser pour votre instance GitHub Enterprise Server. Pour plus d’informations, consultez « Gestion des utilisateurs dormants ».

Utilisateurs suspendus

Ici, vous pouvez voir tous les utilisateurs qui ont été suspendus sur votre instance GitHub Enterprise Server et lancer un audit de clé SSH.