Configuration de collectd

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>

Activer le 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. 1. Dans la barre latérale «  Administrateur de site », cliquez sur Management Console .

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

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

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

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

7. 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 contactez le Support GitHub Enterprise, il se peut que ces données vous soient demandées pour faciliter la résolution des problèmes.

Usage

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, contactez le Support GitHub Enterprise.