Activation de la surveillance pour les instances Compute

Cette rubrique explique comment activer la surveillance pour les instances de calcul, plus précisément pour les mesures d'instance de calcul.

Les mesures d'instance de calcul fournissent des données sur le niveau d'activité et le débit de l'instance. Ces mesures sont requises pour utiliser des fonctionnalités telles que le redimensionnement automatique, les mesures, les alarmes et les notifications avec des instances de calcul. Une instance de calcul n'émet ces mesures que si le module d'extension Surveillance des instances Compute est activé et exécuté sur l'instance.

Le module d'extension Surveillance des instances Compute est géré par le logiciel d'agent Oracle Cloud.

Images prises en charge

Les mesures d'instance de calcul sont prises en charge sur les images de plate-forme en cours et sur les images personnalisées basées sur des images de plate-forme en cours.

Si vous utilisez une ancienne image de plate-forme, vous devez installer manuellement le logiciel d'agent Oracle Cloud pour pouvoir utiliser le module d'extension de surveillance des instances de calcul. Sélectionnez une image postérieure au 15 novembre 2018 (sauf Ubuntu, dont la date doit être postérieure au 28 février 2019).

Vous pouvez parvenir à activer des mesures d'instance de calcul sur d'autres images prenant en charge le logiciel d'agent Oracle Cloud, bien que le module d'extension de surveillance des instances de calcul n'ait pas été testé sur d'autres systèmes d'exploitation et que son fonctionnement ne soit pas garanti.

Stratégie IAM requise

Pour utiliser Oracle Cloud Infrastructure, un administrateur doit vous accorder un accès sécurisé dans une stratégie. Cet accès est requis que vous utilisiez la console ou l'API REST avec un kit SDK, l'interface de ligne de commande ou un autre outil. Si un message vous indique que vous ne disposez pas des droits d'accès ou des autorisations nécessaires, vérifiez auprès de l'administrateur le type d'accès qui vous a été accordé et le compartiment dans lequel vous devez travailler.

Pour les administrateurs : pour plus d'informations sur les stratégies IAM nécessaires à la création et à la mise à jour d'une instance de calcul, reportez-vous à Création d'une instance.

Avant de commencer

Passerelles de service ou adresses IP publiques : l'instance de calcul doit disposer d'une adresse IP publique ou d'une passerelle de service pour pouvoir envoyer des mesures d'instance de calcul au service Monitoring.

Si l'instance ne dispose pas d'une adresse IP publique, configurez une passerelle de service sur le réseau cloud virtuel. La passerelle de service permet à l'instance d'envoyer des mesures d'instance de calcul au service Monitoring sans que le trafic passe sur Internet. Voici des remarques spéciales permettant de configurer la passerelle de service afin qu'elle accède au service Monitoring :
- Lors de la création de la passerelle de service, activez le libellé de service Tous les services <region> dans Oracle Services Network. Il inclut le service Monitoring.
- Lors de la configuration du routage pour le sous-réseau qui contient l'instance, configurez une règle de routage dont le type de cible est défini sur Passerelle de service, et le service de destination sur Tous les services <region> dans Oracle Services Network.
Pour obtenir des instructions détaillées, reportez-vous à Accès aux services Oracle : passerelle de service.
Agent Oracle Cloud : le logiciel d'agent Oracle Cloud doit être installé sur l'instance. L'agent Oracle Cloud est installé par défaut sur des images de plate-forme en cours. Pour obtenir la procédure d'installation manuelle de l'agent Oracle Cloud sur des images plus anciennes, reportez-vous à Installation du logiciel d'agent Oracle Cloud.
Module d'extension Surveillance des instances de calcul : pour que l'instance émette des mesures d'instance de calcul, le module d'extension Surveillance des instances de calcul doit être activé sur l'instance et les modules d'extension doivent être en cours d'exécution. Pour plus d'informations sur l'activation et l'exécution des modules d'extension, reportez-vous à Agent Oracle Cloud.

Activation de la surveillance pour une nouvelle instance de calcul

Pour configurer une nouvelle instance de calcul afin qu'elle émette les mesures d'instance de calcul, procédez comme suit.

Création d'une instance pour laquelle la surveillance est activée à l'aide de la console

Suivez les étapes de création d'une instance, jusqu'aux options avancées. Assurez-vous que l'instance possède une adresse IP publique ou une passerelle de service, comme décrit dans les prérequis.
Cliquez sur Afficher les options avancées.
Dans l'onglet Agent Oracle Cloud, sélectionnez Surveillance des instances de calcul.

Remarque

Si vous utilisez une ancienne image de plate-forme ou une image personnalisée qui n'est pas basée sur une image de plate-forme récente, vous devez installer manuellement le logiciel d'agent Oracle Cloud. Pour ce faire, vous pouvez fournir un script cloud-init. Pour plus d'informations, reportez-vous à Installation du logiciel d'agent Oracle Cloud. Comparez la date de l'image à celle indiquée dans Images prises en charge.
Cliquez sur Créer.

La nouvelle instance pour laquelle la surveillance est activée émet des mesures d'instance de calcul vers le service Monitoring.

Création d'une instance pour laquelle la surveillance est activée à l'aide de l'API

Utilisez l'opération LaunchInstance. Incluez les paramètres suivants :

{
  "agentConfig": {
    "isMonitoringDisabled": false,
    "areAllPluginsDisabled": false,
    "pluginsConfig": [
      {
        "name": "Compute Instance Monitoring",
        "desiredState": "ENABLED"
      }
    ]
  }
}

Assurez-vous que l'instance possède une adresse IP publique ou une passerelle de service, comme décrit dans les prérequis.

Remarque

Si vous utilisez une ancienne image de plate-forme ou une image personnalisée qui n'est pas basée sur une image de plate-forme récente, vous devez installer manuellement le logiciel d'agent Oracle Cloud. Pour ce faire, vous pouvez fournir un script cloud-init. Pour plus d'informations, reportez-vous à Installation du logiciel d'agent Oracle Cloud. Comparez la date de l'image à celle indiquée dans Images prises en charge.

Activation de la surveillance pour une instance de calcul existante

Pour configurer une instance de calcul existante afin qu'elle émette les mesures d'instance de calcul, procédez comme suit.

Procédure d'activation de la surveillance pour une instance de calcul existante à l'aide de la console

Installez le logiciel d'agent Oracle Cloud, s'il n'est pas déjà installé.
Activez le module d'extension de surveillance des instances de calcul.
Vérifiez que les modules d'extension sont en cours d'exécution sur l'instance.
Assurez-vous que l'instance possède une adresse IP publique ou une passerelle de service, comme décrit dans les prérequis.
Pour vérifier que la surveillance est activée, procédez comme suit :
1. Accédez à la page Mesures de l'instance :
  1. Ouvrez le menu de navigation et cliquez sur Compute. Sous Compute, cliquez sur Instances.
  2. Cliquez sur l'instance qui vous intéresse.
  3. Sous Ressources, cliquez sur Mesures.
  4. Dans la liste Espace de noms de mesure, sélectionnez oci_computeagent.
2. Si vous voyez des graphiques de mesures avec des données, cela signifie que le service Monitoring reçoit des mesures d'instance de calcul de cette instance. Pour plus d'informations sur ces mesures, reportez-vous à Mesures d'instance Compute.
  
  Si la surveillance n'est pas activée (et que l'instance utilise une image prise en charge), un bouton est disponible pour l'activer. Cliquez sur Activer la surveillance.

Procédure d'activation de la surveillance pour une instance de calcul existante à l'aide de l'API

Installez le logiciel d'agent Oracle Cloud, s'il n'est pas déjà installé.

Utilisez l'opération UpdateInstance. Incluez les paramètres suivants :

{
  "agentConfig": {
    "isMonitoringDisabled": false,
    "areAllPluginsDisabled": false,
    "pluginsConfig": [
      {
        "name": "Compute Instance Monitoring",
        "desiredState": "ENABLED"
      }
    ]
  }
}

Assurez-vous que l'instance possède une adresse IP publique ou une passerelle de service, comme décrit dans les prérequis.

Gestion du module d'extension Surveillance des instances Compute

Pour qu'une instance émette des mesures d'instance de calcul, le module d'extension Surveillance des instances Compute doit être activé sur l'instance et les modules d'extension doivent être en cours d'exécution.

Pour empêcher temporairement l'instance d'émettre des mesures d'instance de calcul, vous pouvez désactiver le module d'extension de surveillance des instances de calcul. Vous pouvez également arrêter tous les modules d'extension qui s'exécutent sur l'instance, y compris le module d'extension de surveillance des instances de calcul.

Attention

Les fonctionnalités qui dépendent du module d'extension, comme la surveillance et le redimensionnement automatique, ne fonctionnent pas si le module d'extension est désactivé ou arrêté.

Pour plus d'informations sur l'activation et l'exécution des modules d'extension, reportez-vous à Agent Oracle Cloud.

Dépannage : recherche des éventuelles mesures dans Monitoring

Pour déterminer si Monitoring reçoit les mesures d'instance de calcul, vous pouvez interroger les mesures d'instance ou visualiser les propriétés d'instance afin de vérifier que le module d'extension de surveillance des instances de calcul est activé et en cours d'exécution.

Utilisation de la console : pour savoir si Monitoring reçoit des mesures via l'interrogation des mesures d'instance

Ouvrez le menu de navigation et cliquez sur Compute. Sous Compute, cliquez sur Instances.
Cliquez sur l'instance qui vous intéresse.
Sous Ressources, cliquez sur Mesures.
Dans la liste Espace de noms de mesure, sélectionnez oci_computeagent.

Si vous voyez des graphiques de mesures avec des données, cela signifie que le service Monitoring reçoit des mesures de cette instance. Pour plus d'informations sur ces mesures, reportez-vous à Mesures d'instance Compute.

Si un message indiquant que la surveillance n'est pas activée ou que le logiciel d'agent Oracle Cloud doit être installé apparaît, effectuez ces tâches.

Utilisation de la console : déterminer si le module d'extension de surveillance des instances de calcul est activé et en cours d'exécution

Ouvrez le menu de navigation et cliquez sur Compute. Sous Compute, cliquez sur Instances.
Cliquez sur l'instance qui vous intéresse.
Cliquez sur l'onglet Agent Oracle Cloud.
Vérifiez que le module d'extension de surveillance des instances de calcul est activé et que tous les modules d'extension sont en cours d'exécution.

Utilisation de l'API : pour savoir si Monitoring reçoit des mesures via l'interrogation des mesures d'instance

Utilisez l'opération d'API SummarizeMetricsData. Si des mesures sont renvoyées, cela indique que le service Monitoring reçoit des mesures de l'instance.

Utilisation de l'API : déterminer si le module d'extension de surveillance des instances de calcul est activé et en cours d'exécution

Utilisez l'opération GetInstance (ou ListInstances pour plusieurs instances).

Dans la réponse, si l'objet agentConfig renvoie les valeurs suivantes, il indique que le module d'extension de surveillance des instances de calcul est activé et que tous les modules d'extension sont en cours d'exécution.

{
  "agentConfig": {
    "isMonitoringDisabled": false,
    "areAllPluginsDisabled": false,
    "pluginsConfig": [
      {
        "name": "Compute Instance Monitoring",
        "desiredState": "ENABLED"
      }
    ]
  }
}

Les mesures de votre instance ne sont pas visibles ?

Si aucun graphique de mesures n'apparaît, l'instance n'émet peut-être pas de mesures. Reportez-vous aux causes possibles et aux résolutions suivantes.


Cause possible	Vérification	Résolution
Le module d'extension de surveillance des instances de calcul est désactivé sur l'instance ou des modules d'extension sont arrêtés.	Vérifiez les propriétés de l'instance.	Activez le module d'extension de surveillance des instances de calcul et démarrez tous les modules d'extension.
L'instance ne peut pas accéder au service Monitoring car son VCN n'utilise pas Internet.	Vérifiez l'adresse IP de l'instance. Si elle n'est pas publique, une passerelle de service est nécessaire.	Configurez une passerelle de service.
L'instance n'utilise pas une image prise en charge.	Vérifiez les images prises en charge.	Créez une instance avec une image prise en charge.
Images plus anciennes et images personnalisées : aucun logiciel d'agent Oracle Cloud n'existe sur l'instance.	Connectez-vous à l'instance et recherchez le logiciel.	Installez le logiciel d'agent Oracle Cloud.
Le logiciel d'agent Oracle Cloud pose un autre problème.	(non applicable)	Suivez les étapes de dépannage de l'agent Oracle Cloud.

Documentation Oracle Cloud Infrastructure