8.9.1. Configuration de l'interface Netdata polling

8.9.1.1. Introduction

Cette procédure décrit la configuration de l'interface Netdata pour permettre à un serveur distant (par exemple NAGIOS) de venir lire les métriques sélectionnées via l'API netdata.

Authentification des utilisateurs :

Les utilisateurs authentifiés peuvent sonder l’API Netadata, disponible sur Gstats.
Pour une automatisation simple, il est possible de permettre à un utilisateur non authentifié de sonder l’API.
Dans ce cas, l'endpoint de l’API est redirigé sur http sur le port spécifié ci-dessous http://gcenter_fqdn:redirection_port

Liste des adresses IP autorisées

Une liste d’accès restreint les sous-réseaux clients pour lesquels cette redirection est disponible.
Suivant le couple IP/masque, il est donc possible d'autoriser un IP ou une plage d'adresses IP par ligne saisie.
Il est possible d'ajouter plusieurs lignes.

Liste des métriques accessibles

Pour un PC distant défini dans la liste des IP autorisées, il est possible de visualiser les métriques disponibles.
Pour cela, il faut saisir l'URL suivant dans un navigateur WEB http://IP-gcenter:8001/host/fqdn-gcenter/api/v1/allmetrics

Ci dessous, un extrait des métriques est affiché.

# chart: net_drops.vnet0 (name: net_drops.vnet0)
NETDATA_NET_DROPS_VNET0_INBOUND="0"      # drops/s
NETDATA_NET_DROPS_VNET0_OUTBOUND="-0"      # drops/s
NETDATA_NET_DROPS_VNET0_VISIBLETOTAL="0"      # drops/s

# chart: net_errors.vnet0 (name: net_errors.vnet0)
NETDATA_NET_ERRORS_VNET0_INBOUND="0"      # errors/s
NETDATA_NET_ERRORS_VNET0_OUTBOUND="-0"      # errors/s
NETDATA_NET_ERRORS_VNET0_VISIBLETOTAL="0"      # errors/s

# chart: net.vnet0 (name: net.vnet0)
NETDATA_NET_VNET0_RECEIVED="8"      # kilobits/s
NETDATA_NET_VNET0_SENT="1"      # kilobits/s
NETDATA_NET_VNET0_VISIBLETOTAL="9"      # kilobits/s

# chart: elasticsearch_gesmaster.cluster_stats_shards_total (name: elasticsearch_gesmaster.cluster_stats_shards_total)
NETDATA_ELASTICSEARCH_GESMASTER_CLUSTER_STATS_SHARDS_TOTAL_SHARDS="114"      # shards
NETDATA_ELASTICSEARCH_GESMASTER_CLUSTER_STATS_SHARDS_TOTAL_VISIBLETOTAL="114"      # shards

# chart: elasticsearch_gesmaster.cluster_stats_indices (name: elasticsearch_gesmaster.cluster_stats_indices)
NETDATA_ELASTICSEARCH_GESMASTER_CLUSTER_STATS_INDICES_INDICES="114"      # indices
NETDATA_ELASTICSEARCH_GESMASTER_CLUSTER_STATS_INDICES_VISIBLETOTAL="114"      # indices

Note

Pour plus d'informations, voir l'Interconnexion avec les systèmes externes.
L'interface graphique est décrite dans l'Ecran `Admin-GCenter-Configuration` de la legacy web UI.

8.9.1.2. Prérequis

  • Utilisateur : membre du groupe Administrator

8.9.1.3. Opérations préliminaires

8.9.1.4. Procédure d'accès à l'écran `Netdata polling` de la legacy web UI

  • Dans la barre de navigation, cliquer successivement sur :

    • le bouton `Admin`

    • le sous menu `Gcenter`

    • la commande `Configuration`
      La fenêtre `Configuration` est affichée.
    ../../_images/CONFIGUR-01.PNG

  • Cliquer sur le bouton (1) `Netdata polling`.

8.9.1.5. Procédure de configuration

L'écran suivant est affiché :

../../_images/CONFIGUR-02.PNG

  • Utiliser le sélecteur (2) `Allow unauthenticated users to poll netdata API`.

  • Sélectionner le port de redirection (3) : par défaut 8001

  • Sélectionner l'interface d'entrée du GCenter dans le champ (4) `Intput interface`.

  • Pour ajouter une adresse IP ou un sous réseau :

    • appuyer sur le bouton `Add subnet`

    • dans la fenêtre `ADD IP/MASK`, saisir l'adresse IP puis / puis le masque

    • appuyer sur le bouton `ADD`
      L'adresse saisie est affichée dans la zone (7) `Authorized subnets`
  • Appuyer sur le bouton (5) `Save`.
    Si tout est ok alors le message `The netdata polling configuration was successfully updated` est affiché.