Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Configuration de collectd

GitHub Enterprise peut collecter des données avec collectd et les envoyer à un serveur collectd externe. Parmi d’autres métriques, nous collectons un ensemble standard de données telles que l’utilisation du processeur, la consommation de la mémoire et du disque, le trafic et les erreurs d’interface réseau ainsi que la charge globale de la machine virtuelle.

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 your GitHub Enterprise Server instance. 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 dans le coin supérieur droit de n’importe quelle page.

    Capture d’écran de l’icône représentant une fusée qui donne accès aux paramètres d’administration du site

  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.

    Capture d’écran du lien « Administrateur du site » 1. Dans la barre latérale gauche, cliquez sur Management Console . Onglet Management Console dans la barre latérale gauche

  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 gauche, cliquez sur Enregistrer les paramètres.

    Capture d’écran du bouton Enregistrer les paramètres de la Management Console

    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.

    Configuration de votre instance

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 GitHub Enterprise Support 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 GitHub Enterprise Support, 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 your GitHub Enterprise Server instance.

Pour obtenir de l’aide par rapport à d’autres questions ou problèmes, contactez le GitHub Enterprise Support.