Configuration de collectd pour votre instance

Pour obtenir des informations sur les performances de GitHub Enterprise Server, vous pouvez passer en revue les données de collectd sur votre instance ou, optionnellement, envoyer les données à un serveur collectd externe.

Dans cet article

À 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.

  1. Connectez-vous à votre serveur collectd.
  2. 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 :

  1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.

  2. Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.

  3. Dans la barre latérale «  Administrateur de site », cliquez sur Management Console .

  4. Sous les paramètres de transfert de journal, sélectionnez Activer le transfert collectd.

  5. 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.

  6. Dans le champ Port, tapez le port utilisé pour se connecter au serveur collectd. (La valeur par défaut est 25826)

  7. 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.

  8. 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.