Métriques disponibles par plan de service

Les métriques de surveillance prises en charge sont les suivantes :

• Connexions actives à votre équilibreur de charge à un moment donné.
• Débit de connexion ou analyse des périodes au cours desquelles plus ou moins de connexions sont établies avec votre équilibreur de charge.

Ces métriques permettent de suivre le trafic et les tendances d'utilisation de votre équilibreur de charge de réseau et peuvent fournir des informations sur les heures de pointe du trafic, les déclins d'utilisation et les tendances d'utilisation globales.

Chaque métrique est composée des types de métadonnées suivants :

• Nom de la métrique - Nom de la métrique collectée.
• Type de métrique - Le type de métrique détermine si la valeur de la métrique correspond à une métrique de compteur ou de jauge. Chacune de ces métriques est de type gauge, qui représente une valeur numérique unique pouvant fluctuer arbitrairement dans le temps.
• Type de valeur - Unité de mesure d'une métrique spécifique. Par exemple, octets ou totaux. Le type de valeur none signifie que la valeur de métrique représente des occurrences individuelles de ce type de métrique.
• Segment - Mode de division et d'affichage des métriques de surveillance.

Segmentation des métriques

Vous pouvez fractionner les données présentées par IBM Cloud Monitoring dans diverses visualisations du tableau de bord, pour afficher des métriques différentes en fonction de vos préférences. Par exemple, si vous possédez plusieurs équilibreurs de charge ou plusieurs comptes avec des équilibreurs de charge différents dans chacun, vous pouvez vous intéresser à un port d'écoute particulier.

Par exemple, vous pouvez segmenter les active connections par IBM Load Balancer for VPC listener port pour afficher le nombre d'utilisateurs actifs connectés à l'équilibreur de charge par l'intermédiaire de chaque type d'écouteur. Pour illustrer cela, supposons que votre équilibreur de charge de réseau dispose du protocole d'écoute TCP sur le port 8080. Le tableau de bord contient alors différentes lignes affichant 10 utilisateurs connectés via HTTP sur le port 80 dans une couleur et six utilisateurs connectés via TCP sur le port 8080 dans une autre couleur.

Activation de la surveillance des métriques

Pour recevoir les métriques de surveillance, vous devez configurer IBM Cloud Monitoring avec une instance de surveillance.

Pour ce faire, procédez comme suit :

1. Accédez au portail de surveillance des métriques, puis cliquez sur Créer une instance de surveillance.

2. Sélectionnez une région pour votre instance de surveillance.

   Si vous ne disposez pas d'un équilibreur de charge existant, voir Création d'un équilibreur de charge de réseau pour mettre à disposition un équilibreur de charge.

   La région doit correspondre à l'emplacement de votre équilibreur de charge existant.

3. Sélectionnez votre plan tarifaire.

   Les détails du plan tarifaire sont expliqués dans la fenêtre de sélection. Sélectionnez le plan qui répond le mieux à vos besoins.

4. Spécifiez un nom de service unique pour votre instance.

5. Sélectionnez éventuellement un groupe de ressources. C'est un moyen d'organiser les ressources du compte en regroupements personnalisables. Toute ressource du compte qui est gérée à l'aide du contrôle d'accès IBM Cloud® Identity and Access Management (IAM) appartient à un groupe de ressources au sein de votre compte.

   Si aucun groupe de ressources n'est préconfiguré ou que vous n'avez aucune raison de partager cette ressource de manière sélective, utilisez la sélection par défaut.

   Si votre compte possède plusieurs groupes de ressources, vous pouvez choisir celui qui a accès à cette instance de surveillance. Cela vous permet de rendre des métriques disponibles pour certains groupes de ressources et non pour d'autres.

6. Cochez la case Activer les métriques de plateforme. Vous devez la cocher pour recevoir les métriques de votre équilibreur de charge.

7. Cliquez sur Créer. Vous retournez à la page d'accueil des métriques de surveillance.

En quelques minutes, votre nouvelle instance de surveillance est affichée avec plusieurs configurations. Vous devrez peut-être actualiser votre navigateur pour la voir.

Utilisation du tableau de bord IBM Cloud Monitoring

Pour afficher et utiliser vos métriques de surveillance, procédez comme suit :

1. Accédez au portail de surveillance des métriques.

2. Cliquez sur Open Dashboard en regard du nom de service de l'instance de surveillance à utiliser.

   La première fois que vous accédez à votre instance de surveillance, plusieurs fenêtres s'affichent dans le cadre de la configuration interne. Conservez les entrées par défaut de ces sélections et cliquez sur les différentes pages jusqu'à ce que vous atteigniez la page principale.

3. Sélectionnez Tableaux de bord dans la barre latérale de gauche pour ouvrir le tableau de bord des métriques de surveillance d'IBM Load Balancer. Cliquez ensuite sur Tableaux de bord par défaut > IBM > Métriques de surveillance d'IBM Load Balancer. Le tableau de bord par défaut n'est pas éditable.

4. Deux métriques principales dans le tableau de bord sont affichées : Connexions actives et Débit de connexion. Pour modifier les paramètres et segmenter vos métriques par ID équilibreur de charge ou port d'écoute, vous devez créer un tableau de bord personnalisé.

   Vous pouvez sélectionner la fenêtre de temps de votre choix pour l'affichage de vos métriques, à l'aide de la barre inférieure.

Création d'un tableau de bord des métriques personnalisé

Vous pouvez créer votre propre tableau de bord pour personnaliser vos mesures de surveillance, par exemple, pour afficher des informations sur des équilibreurs de charge particuliers ou n'afficher que le trafic en provenance d'écouteurs particuliers.

Pour personnaliser votre tableau de bord, procédez comme suit :

1. Accédez au portail de surveillance des métriques.

2. Cliquez sur Open Dashboard en regard du nom de service de l'instance de surveillance à utiliser. Le tableau de bord s'affiche.

3. Dans la barre latérale de gauche, sélectionnez Tableaux de bord. Cliquez ensuite sur le signe + vert dans le panneau.

4. Sélectionnez un tableau de bord vierge, puis sélectionnez le type de représentation visuelle de votre choix.

   IBM Cloud Monitoring offre huit visualisations différentes pour votre tableau de bord. Lisez la description de chaque visualisation, puis choisissez celle qui correspond le mieux à vos besoins.

   Ligne ("Afficher les tendances dans le temps") représente l'option de base et la plus simple. Il s'agit également de l'option la plus fréquemment sélectionnée. Les exemples de cette rubrique présentent une visualisation en ligne.

5. Configurez votre tableau de bord personnalisé.

   • Dans la zone Métriques, entrez ibm_is pour afficher les deux métriques d'équilibreur de charge : ibm_is_load_balancer_active_connections et ibm_is_load_balancer_connection_rate.

     Vous pouvez surveiller le trafic du port d'écoute en activant la métrique ibm_is_load_balancer_listener_port.

   • Vous pouvez choisir une portée à afficher dans votre tableau de bord en cliquant sur Override Dashboard Scope. Par exemple, vous pouvez afficher les métriques d'un équilibreur de charge particulier.

   • Vous pouvez également définir un segment pour comparer les métriques dans la portée que vous avez définie. Par exemple, vous pouvez consulter les connexions actives pour un équilibreur de charge particulier segmenté par port d'écoute.

6. Cliquez sur Sauvegarder pour que votre nouveau tableau de bord personnalisé soit accessible.

   Par défaut, le tableau de bord commence par le nom "tableau de bord vierge". Vous pouvez modifier le nom en sélectionnant Tableaux de bord dans la barre latérale, puis en cliquant sur l'icône Editer à côté du nom.

Pour retourner au tableau de bord par défaut à tout moment, sélectionnez Tableaux de bord > Tableaux de bord par défaut > IBM > Métriques de surveillance d'IBM Load Balancer.

Utilisation d'IBM Cloud Monitoring à l'aide des API

Vous pouvez également utiliser l'instance de surveillance avec les API de requête de métriques. Cela peut s'avérer utile si vous avez besoin de points de données bruts ou que vous souhaitez utiliser vos métriques à partir d'une interface de ligne de commande et non du tableau de bord.

Une fois que vous avez créé votre instance IBM Cloud Monitoring, vous devez collecter les deux informations ci-après.

• Le jeton d'API de surveillance
• Le point d'extrémité de votre instance IBM Cloud Monitoring

Pour collecter ces informations et commencer à utiliser votre instance de surveillance à l'aide de l'API de requête de métriques, procédez comme suit :

1. Accédez à la page d'accueil de la surveillance et cliquez sur Ouvrir le tableau de bord à côté de l'instance avec laquelle vous voulez travailler. Une fois que le tableau de bord IBM Cloud Monitoring est affiché, sélectionnez l'icône Profil du compte dans la barre latérale de gauche, puis sélectionnez Paramètres. Vos paramètres de compte s'affichent.

2. Votre jeton d'API de surveillance est une chaîne alphanumérique qui se trouve dans le champ du jeton d'API de surveillance. Cliquez sur le bouton Copier à droite de la clé pour le transférer dans votre presse-papiers.

   Ne partagez pas ce jeton d'API. Quiconque en a possession dispose d'un accès complet à vos métriques.

3. Pour obtenir le point d'extrémité de votre instance IBM Cloud Monitoring, accédez à votre tableau de bord principal dans votre navigateur. Sélectionnez ensuite l'URL du tableau de bord, qui se présente comme suit :

   https://us-south.monitoring.cloud.ibm.com/#/default-dashboard/ibm_is_load_balancer?last=3600
   

   La première partie de l'URL (dans le cas présent, us-south.monitoring.cloud.ibm.com) correspond à votre point d'extrémité. Notez-le.

4. Une fois que vous disposez du jeton d'API et du point d'extrémité, vous pouvez formater votre demande POST. La demande POST ci-après est un exemple, avec tous les paramètres que vous pouvez modifier. Ces paramètres sont les suivants :

   • Le jeton d'API de surveillance.

   • Le point d'extrémité de votre instance de surveillance.

   • La valeur d'ibm_resource (ID de l'équilibreur de charge dont vous souhaitez consulter les métriques).

     Si vous souhaitez afficher cette métrique pour tous vos équilibreurs de charge, n'entrez pas de valeur pour l'attribut scope. Par exemple, utilisez "scope" : "".

   • Type de métrique dont vous souhaitez afficher les résultats. Cet exemple utilise ibm_is_load_balancer_active_connections, mais ibm_is_load_balancer_connection_rate est également une option valide.

   • Les attributs from et to définissent les délais de l'analyse, en heure d'époque et en microsecondes.

   • Les attributs sampling et value définissent la granularité des données renvoyées dans la demande POST.

Comme un volume important de données est stocké dans IBM Cloud Monitoring, le choix du niveau de granularité spécifique est important. IBM Cloud Monitoring ne peut renvoyer que 600 points de données à la fois par demande. Les attributs sampling et value sont donc importants. Si vous laissez ces deux lignes en dehors de votre demande, une somme agrégée est renvoyée à la place au cours de cette période.

Si la plage spécifiée par from et to est importante (par exemple, quatre jours), mais que vous définissez des attributs sampling et value de 10 secondes, cela signifie que vous recevez quatre jours de données, divisés en blocs de 10 secondes. Cet échantillonnage n'est pas utile compte tenu de la grande quantité de données renvoyées. Il est recommandé de spécifier un bloc plus grand (par exemple, une heure au lieu de 10 secondes).

curl \
-H 'Authorization: Bearer <API_TOKEN>’ \
-H 'Content-Type: application/json' \
https://us-south.monitoring.cloud.ibm.com/api/data/batch  \
-d '{
 "requests": [
     {
         "format": {
             "type": "data"
         },
         "scope": "ibm_resource = \"cfc851b1-f30b-4a06-b354-5b64526c0a69\"",
         "metrics": {
             "k0": "timestamp",
             “v1”: "ibm_is_load_balancer_active_connections"
         },
         "time": {
             "from": 1584396900000000,
             "to": 1584402600000000,
              “sampling”: 600000000
         },
         "group": {
             "by": [
                 {
                     "metric": "k0",
                     “value” : 600000000
                 }
             ],
             "aggregations": {
                 “v1”: "sum"
             },
             "groupAggregations": {
                 “v1”: "sum"
             }
         }
     }
 ]
}'