Aller au contenu principal

Hyperledger API

Vue d'ensemble​

Hyperledger est une plateforme open-source de développement de blockchain et supporté par la fondation Linux.

Le connecteur de supervision Hyperledger API se connecte à une API de type exporter afin de récupérer des métriques au sujet des channels.

Contenu du Pack​

Objets supervisés​

  • Sous-rĂ©seaux privĂ©s Hyperledger

Métriques collectées​

Metric nameDescription
channel.ledger.transaction.countNumber of processed transaction
channel.gossip.membership.total.peers.known.countTotal known peers
channel.gossip.state.height.countCurrent ledger height
channel.ledger.blockchain.height.countHeight of the chain in blocks

Installation​

  1. Installer le Plugin sur tous les Collecteurs Centreon supervisant des noeuds Hyperledger API:
yum install centreon-plugin-Blockchain-Hyperledger-Exporter
  1. Sur l'interface Web de Centreon, installer le connecteur de supervision Hyperledger API depuis la page Configuration > Gestionnaire de connecteurs de supervision.

Configuration d'un Hôte​

  • Ajoutez un nouvel HĂ´te depuis la page Configuration > HĂ´tes
  • ComplĂ©tez les champs "Nom","Alias" & "IP Address / DNS" correspondant Ă  votre noeud Hyperledger
  • Appliquez le Modèle d'HĂ´te Blockchain-Hyperledger-Exporter-custom
MandatoryNameDescription
xEXPORTERAPIPORTPort used by the Hyperledger Exporter (Default: '80')
xEXPORTERPROTOProtocol used by the Hyperledger Exporter (Default: 'http')
XEXPORTERAPIURLPATHURL to access the Hyperledger Exporter (Default: '/')
TIMEOUTTimeout (Default: '10')
EXTRAOPTIONSAny extra option you may want to add to every command_line (eg. a --verbose flag)

Diagnostic des erreurs communes​

UNKNOWN: Can't connect to ...​

Cette erreur signifie que Centreon n'a pas réussi à se connecter à l'API de l'Hyperledger. Vérifiez que la requête n'est pas bloquée par un outil externe (un pare-feu par exemple). Si vous utilisez un proxy, renseignez son URL dans la Macro EXTRAOPTIONS de l'Hôte ou directement dans la commande avec l'option --proxyurl='http://proxy.mycompany:8080'.

J'obtiens le message d'erreur suivant: ``UNKNOWN: 501 Protocol scheme 'connect' is not supported |```​

Dans certains cas, et plus spécifiquement lors de l'usage d'un proxy d'entreprise, le protocole de connexion n'est pas supporté par la libraire lwp utlisée par défaut par le Plugin Centreon.

Cette erreur peut être résolue en utilisant le backend HTTP curl. Pour ce faire, ajoutez l'option --http-backend='curl' dans la Macro EXTRAOPTIONS de l'Hôte ou directement à la commande.