Aller au contenu principal

Parity API

Vue d'ensemble​

Parity est un fork de la Blockchain Ethereum.

Le connecteur de supervision Parity API collecte des informations et métriques sur l'activité des noeuds d'un réseau Blockchain au travers d'une API.

Contenu du Pack​

Objets supervisés​

  • Noeud(s) d'une Blockchain Parity
    • Parity
    • Info
    • Eth
    • Net

Métriques collectées​

Metric nameDescriptionUnit
parity.pending.transactionsNumber of pending transactions
parity.mempol.usageMemory pool usageB
parity.mempol.sizeMemory pool sizeB
parity.peers.connectedNumber of connected peers
parity.peers.maxMaximum number of peers
parity.peers.usagePeers usage expressed in percent%

Prérequis​

Le Poller doit pouvoir communiquer avec le noeud Parity via le protocole HTTP et via le port configuré (par défaut: 8545).

Installation​

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

Configuration d'un Hôte​

  • Ajoutez un nouvel Hôte via le menu Configuration > Hosts
  • Complétez les champs "Nom","Alias" & "IP Address / DNS" correspondant à votre noeud Parity
  • Appliquez le Modèle d'Hôte Blockchain-Parity-Restapi-custom et configurer les macros associées
MandatoryNameDescription
PARITYAPIPORT(Default: '8545')
PARITYPROTO(Default: 'http')
PARITYAPIURLPATH(Default: '/')
TIMEOUT
PARITYEXTRAOPTIONSAny extra option you may want to add to every command_line (eg. a --verbose flag)

Comment tester mes configurations et le Plugin en ligne de commande ?​

Une fois le Plugin déployé, connectez vous à votre Collecteur en SSH et executez la commande suivante au travers de l'utilisateur centreon-engine:

/usr/lib/centreon/plugins//centreon_blockchain_parity_api.pl  \ 
--plugin=blockchain::parity::restapi::plugin \
--mode=net \
--hostname=10.0.0.1 \
--port=8545 \
--proto=http \
--timeout=10 \
--proto=http \
--api-path=/ \
--warning-peers='' \
--critical-peers='1:'

Le retour de la commande doit être similaire à:

OK: Parity network module: connected peers: 2

Cette commande déclenchera une alerte WARNING si le nombre de peers connecté est inférieur à 1 (--critical-peers=1:).

Tous les modes d'un Plugin donné peuvent être listés au moyen de la commande suivante:

/usr/lib/centreon/plugins//centreon_blockchain_parity_api.pl  \ 
--plugin=blockchain::parity::restapi::plugin \
--list-mode

Diagnostic des erreurs communes​

UNKNOWN: Can't connect to ...​

Cette erreur signifie que Centreon n'a pas réussi à se connecter à l'API du BCM Poller. 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'.

Vérifiez également que le port configuré est correct.

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.