À propos de collectd pour GitHub Enterprise Server
collectd
est un service qui s’exécute sur votre instance GitHub Enterprise Server pour collecter et fournir des mesures concernant les performances du système. Les mesures courantes collectées par collectd
incluent l’utilisation de l’UC, la mémoire et la consommation de disque, le trafic d’interface réseau et les erreurs, ainsi que la charge globale d’un système. Vous pouvez également transférer les données vers un autre serveur collectd
. Pour plus d’informations, consultez le wiki collectd.
Votre instance utilise des mesures de collectd
pour afficher des graphiques dans le tableau de bord de surveillance de Management Console. Pour plus d’informations, consultez « Accès au tableau de bord moniteur ».
Vous pouvez consulter la liste des mesures collectées par collectd
sur votre instance GitHub Enterprise Server. Pour plus d’informations, consultez « Mesures collectd pour GitHub Enterprise Server ».
Configurer un serveur collectd
externe
Si vous n’avez pas encore configuré de serveur collectd
externe, vous devez le faire avant d’activer le transfert collectd
sur votre instance GitHub Enterprise Server. Votre serveur collectd
doit exécuter collectd
version 5.x ou ultérieure.
- Connectez-vous à votre serveur
collectd
. - Créez ou modifiez le fichier de configuration
collectd
pour charger le plug-in réseau et remplir les directives de serveur et de port avec les valeurs appropriées. Sur la plupart des distributions, il se trouve dans/etc/collectd/collectd.conf
Un exemple de collectd.conf pour exécuter un serveur collectd
:
LoadPlugin network
...
...
<Plugin network>
Listen "0.0.0.0" "25826"
</Plugin>
Activation du transfert collectd sur GitHub Enterprise
Par défaut, le transfert collectd
est désactivé sur GitHub Enterprise. Suivez les étapes ci-dessous pour activer et configurer le transfert collectd
:
-
À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.
-
Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.
-
Dans la barre latérale « Administrateur de site », cliquez sur Management Console .
-
Sous les paramètres de transfert de journal, sélectionnez Activer le transfert collectd.
-
Dans le champ Adresse du serveur, tapez l’adresse du serveur
collectd
vers lequel vous souhaitez transférer les statistiques de l’appliance GitHub Enterprise. -
Dans le champ Port, tapez le port utilisé pour se connecter au serveur
collectd
. (La valeur par défaut est 25826) -
Dans le menu déroulant Configuration du chiffrement, sélectionnez le niveau de sécurité des communications avec le serveur
collectd
. (Aucun, paquets signés ou paquets chiffrés.) 1. Sous la barre latérale « Paramètres », cliquez sur Enregistrer les paramètres.Remarque : l’enregistrement des paramètres dans la Management Console redémarre les services système, ce qui peut entraîner un temps d’arrêt visible pour l’utilisateur.
-
Attendez la fin de l’exécution de la configuration.
Exportation des données collectd avec ghe-export-graphs
L’outil en ligne de commande ghe-export-graphs
exporte les données que collectd
stocke dans des bases de données RRD. Cette commande convertit les données au format XML et les exporte sous forme de tarball unique (.tgz
).
Son utilisation principale consiste à fournir à l’équipe de Support GitHub Enterprise des données sur le niveau de performance d’une machine virtuelle, sans avoir besoin de télécharger de bundle de support complet. Il ne doit pas être inclus dans vos exportations de sauvegarde normales et il n’existe aucun équivalent d’importation. Si vous nous contactez via Support GitHub Enterprise, il se peut que ces données vous soient demandées pour faciliter la résolution des problèmes.
Utilisation
ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname]:~/graphs.tar.gz .
Dépannage
Le serveur collectd central ne reçoit pas de données
GitHub Enterprise est fourni avec collectd
version 5.x. collectd
5.x n’est pas rétrocompatible avec les versions 4.x. Votre serveur collectd
central doit au minimum être de version 5.x pour accepter les données envoyées à partir de votre instance GitHub Enterprise Server.
Pour obtenir de l’aide par rapport à d’autres questions ou problèmes, visitez Support GitHub Enterprise.