Documentation Oracle Cloud Infrastructure

Configuration des agents de gestion pour collecter des mesures Prometheus

Le service Oracle Cloud Infrastructure Management Agents (agents de gestion) prend en charge la collecte des données de mesure de performances de série chronologique à partir de n'importe quelle ressource qui expose les données de mesure au format Prometheus. Pour en savoir plus sur Prometheus, reportez-vous à la documentation officielle de prise en main de Prometheus.

Prométhée et agents de gestion

Les étapes suivantes expliquent comment collecter des mesures Prometheus avec des agents de gestion :

  • Etape 1. Installer l'agent de gestion avec accès à l'adresse de mesures Prometheus.
  • Etape 2. Activer les mesures Prometheus
  • Etape 3 . Configurer une source de données Prometheus
  • Etape 4 . Créer un tableau de bord Prometheus

    Etape 1 : Installation de l'agent de gestion

    Tout d'abord, vous devez installer un agent de gestion pour inscrire des agents auprès d'Oracle Cloud Infrastructure (OCI).
    Selon votre environnement, vous pouvez choisir l'une des méthodes suivantes pour installer l'agent de gestion :
    • Installation d'un agent de gestion sur une instance OCI.

      Si vous disposez d'une instance de calcul OCI, vous devez suivre les instructions pour activer l'agent de gestion sur des instances de calcul OCI. Pour plus d'informations sur les prérequis et le processus d'installation, reportez-vous à Déploiement d'agents de gestion sur des instances de calcul.

    • Installez un agent de gestion dans une instance non OCI.

      Si vous disposez d'une machine virtuelle autonome, vous devez suivre les instructions pour installer un agent de gestion sur une machine virtuelle. Vous devez installer Management Agent sur la même machine virtuelle ou sur une machine virtuelle avec accès à l'adresse Prometheus. Pour plus d'informations sur les prérequis et le processus d'installation, reportez-vous à Installation des agents de gestion.

      Création d'un groupe dynamique et attachement d'une stratégie

      Créez ensuite un groupe dynamique d'agent de gestion avec la stratégie suivante.
      1. Créez un groupe dynamique pour les agents de gestion s'il n'existe pas déjà. Par exemple : Management-Agent-Dynamic-Group. Remplacez <AGENT_COMPARTMENT_OCID> par l'OCID de compartiment de l'agent de gestion. 
        ALL {resource.type='managementagent' resource.compartment.id='<AGENT_COMPARTMENT_OCID>'}
      2. Attachez la stratégie suivante pour autoriser l'agent à publier les mesures vers l'espace de noms OCI Monitoring. 
        allow dynamic-group Management-Agent-Dynamic-Group to use metrics in compartment <METRIC_COMPARTMENT_OCID> where target.metrics.namespace = '<OCI_MONITORING_NAMESPACE>'
      Remarque

      Si vous voulez voir les mesures immédiatement, vous devez redémarrer l'agent de gestion.
      Pour plus d'informations sur les groupes dynamiques, reportez-vous à Gestion des groupes dynamiques et à Gestion des stratégies.

      Etape 2 . Activer les mesures Prometheus

      Pour activer les mesures Prometheus pour le logiciel ou le matériel, consultez les instructions officielles de ce que vous souhaitez surveiller pour déterminer la méthode à utiliser.

      Par exemple, cet article de blog explique Comment configurer des conteneurs Docker dans Oracle Cloud pour utiliser les mesures Prometheus. Dans cet exemple, les instructions Docker sur le site officiel contiennent les dernières instructions sur la façon d'activer Prometheus sur un conteneur Docker.

      Etape 3 . configurer une source de données Prometheus

      Ensuite, dans Oracle Cloud, vous pouvez configurer l'agent de gestion pour collecter les mesures Prometheus en ajoutant et en configurant une source de données Prometheus dans la console Oracle Cloud.

      Cette vidéo montre comment configurer une source de données Prometheus. Dans cette vidéo, une source de données Prometheus est configurée pour un service Kafka. Le processus d'ajout, de modification et de configuration d'une source de données dans la console Oracle Cloud est le même pour toutes les sources de données qui affichent les mesures Prometheus sur une URL.

      Pour ajouter et configurer une source de données Prometheus :

      1. Dans la console Oracle Cloud, accédez au menu de navigation, sélectionnez Observation et gestion, accédez à Agents de gestion, puis sélectionnez Agents.
      2. Sélectionnez Agents et passerelles, sélectionnez le compartiment requis, puis sélectionnez l'agent.
      3. Sélectionnez Gérer les sources de données, puis Ajouter une source de données.
      4. Sélectionnez Prometheus dans la liste déroulante Type de source de données, ajoutez l'espace de noms de mesure et l'URL, puis sélectionnez le compartiment de mesure. Si nécessaire, vous pouvez ajouter des dimensions de mesure personnalisées ou définir des propriétés facultatives. Pour obtenir la liste des options, reportez-vous aux sections Propriétés de source de données requises et Propriétés de source de données facultatives.
        Remarque

        Les valeurs de espace de noms de mesure et de compartiment de mesure doivent être identiques aux valeurs de la stratégie.

      5. Cliquez sur Ajouter.

        Désormais, si elles sont configurées correctement, au bout de quelques minutes, les mesures seront affichées dans le service OCI Monitoring.

        Remarque

        Si les stratégies requises sont manquantes, vous recevez des messages d'erreur HTTP 404 NotAuthorized dans les journaux de l'agent de gestion. Pour plus de détails, reportez-vous à Création d'un groupe dynamique et attachement d'une stratégie.

      Pour afficher ou modifier une source de données Prometheus :

      Une fois que vous avez ajouté une source de données, vous pouvez accéder à Gérer les sources de données, puis sélectionner l'ellipse verticale en regard de la source de données à visualiser ou à modifier.

Propriétés de source de données requises

Les propriétés suivantes sont requises lorsque vous créez une source de données Prometheus.

Nom Unités/Format Description
URL Chaîne (String) URL où l'exportateur Prometheus publie ses métriques. Prend en charge uniquement les demandes HTTP, par exemple :

http://localhost:9100/metrics
namespace Chaîne (String) Espace de noms de surveillance OCI dans lequel les mesures mises au rebut sont téléchargées.
compartmentId Chaîne (String) OCID du compartiment dans lequel les mesures mises au rebut sont téléchargées.

Propriétés de source de données facultatives

Les propriétés suivantes sont facultatives lorsque vous créez une source de données Prometheus. Pour collecter une plage de mesures Prometheus plus spécifique, vous pouvez ajouter l'une de ces propriétés facultatives lorsque vous créez la source de données.

Nom Unités/Format Description
allowMetrics Chaîne - liste de noms de mesure séparés par des virgules Ensemble complet de mesures mises au rebut souhaitées. Utilisez cette propriété pour limiter l'ensemble de mesures téléchargées si nécessaire.
connection-timeout Nombre en millisecondes Délai d'expiration pour la connexion à l'adresse de l'exportateur Prometheus.
metricDimensions Chaîne - liste de noms de propriété séparés par des virgules Noms des autres propriétés fournies par l'utilisateur, exprimés en valeurs fixes à utiliser en tant que dimensions pour chaque point de données téléchargé.
proxy-url Chaîne - URL URL du proxy réseau qui permet d'accéder au point de terminaison de l'exportateur Prometheus, propriété URL requise.
limite de données en lecture Nombre en kilo-octets Limite des données envoyées. Par exemple, si vous saisissez 400 Ko, la limite fixe de l'agent de gestion ne sera pas dépassée, soit 400 Ko d'espace disque.
read-timeout Nombre en millisecondes Délai d'expiration pour la lecture de la réponse à partir de l'adresse de l'exportateur Prometheus.
resourceGroup Chaîne. Il comprend uniquement des caractères alphanumériques, des points (.), des traits de soulignement (_), des tirets (-) et des signes dollar ($). Groupe de ressources du service de surveillance OCI.

S'il est spécifié, le groupe de ressources est affecté à chacune des mesures émises.
scheduleMins Intervalle de raclage en minutes Si cette valeur est spécifiée, la collecte de données ou le raclage a lieu à cet intervalle de temps spécifique.

La valeur minimale est 1 minute.

Si cette valeur n'est pas spécifiée, la valeur par défaut est de 5 minutes.

Remarque : la réduction de l'intervalle de collecte peut avoir un impact positif sur les performances de l'UC.

Exemple : scheduleMins=1

Créer un tableau de bord Prometheus

Une fois les étapes ci-dessus pour configurer l'agent de gestion afin d'exporter les mesures Prometheus terminées, vous pouvez utiliser le service OCI Management Dashboards pour créer un tableau de bord et visualiser les mesures Prometheus. Vous pouvez configurer un widget d'explorateur de données de mesure pour chaque mesure à visualiser. Pour plus d'informations, reportez-vous à Création d'un widget d'explorateur de données de mesure.