Mesures de passerelle de gestion

Vous pouvez surveiller l'état, la capacité et les performances de votre passerelle de gestion à l'aide de mesures, d'alarmes et de notifications.

Pour plus d'informations, reportez-vous à Présentation de Monitoring et à Présentation de Notifications.

Cette rubrique décrit les mesures émises par la passerelle de gestion dans l'espace de noms de mesure oci_managementgateway.

Présentation des mesures de passerelle de gestion

Les mesures pour la passerelle de gestion permettent aux administrateurs de visualiser la consommation de ressources de celle-ci en matière d'UC, de mémoire et de disque.

Prérequis

Stratégies IAM : pour surveiller des ressources, un utilisateur doit disposer du type d'accès requis dans une stratégie écrite par un administrateur. Cela s'applique que vous utilisiez la console ou l'API REST avec un kit SDK, l'interface de ligne de commande ou un autre outil. La stratégie doit autoriser l'accès aux services de surveillance, ainsi qu'aux ressources surveillées. Si vous essayez d'effectuer une action et qu'un message indique que vous n'y êtes pas autorisé, 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 plus d'informations sur les autorisations utilisateur en matière de surveillance, reportez-vous à la section Authentification et autorisation du service associé : Monitoring ou Notifications. Afin d'obtenir des informations sur les stratégies pour la passerelle de gestion, reportez-vous à Exécution des prérequis pour le déploiement d'une passerelle de gestion.
Les mesures répertoriées sur cette page sont automatiquement disponibles pour toute passerelle que vous installez. Vous n'avez pas besoin d'activer la surveillance sur la ressource pour obtenir ces mesures.

Mesures disponibles : oci_managementgateway

La passerelle de gestion émet des mesures vers l'espace de noms de mesure oci_managementgateway dans le service Monitoring.

Les mesures présentées dans les tableaux suivants sont automatiquement disponibles pour toute passerelle que vous installez. Vous n'avez pas besoin d'activer la surveillance pour obtenir ces mesures. Vous pouvez également utiliser le service Monitoring pour créer des requêtes personnalisées.

Dimensions

Les mesures de passerelle de gestion incluent les dimensions suivantes :

GATEWAYHOSTNAME : nom de l'hôte sur lequel la passerelle de gestion est installée.
RESOURCEID : OCID de la ressource de passerelle de gestion.

Mesures

Nom de la mesure	Nom d'affichage de la mesure	Unité	Fréquence	Description	Dimensions
`gatewayHealthStatus`	Etat de la passerelle	Non applicable	1 minute	Indique que la passerelle communique avec le service Monitoring. La valeur de l'état est un nombre constant (1) qui indique que la passerelle est en fonctionnement et qu'elle peut télécharger des mesures vers le service Monitoring. Si la valeur `gatewayHealthStatus` est absente, cela signifie que la passerelle ne peut pas télécharger de mesures vers le service Monitoring. A ce moment précis, la passerelle peut être démarrée ou arrêtée.	`gatewayHostName` `resourceId`
`diskUsageUsed`	Utilisation du disque de passerelle	Méga-octets	1 heure	Espace disque total utilisé sous "agent_inst".	`gatewayHostName` `resourceId`
`diskUsageFree`	Espace disque disponible de la passerelle	Méga-octets	1 heure	Espace disque disponible sur le volume sur lequel la passerelle est installée.	`gatewayHostName` `resourceId`
`diskUsageInstallSize`	Utilisation du disque pour l'installation	Méga-octets	1 heure	Espace disque total utilisé sous le répertoire de base de la passerelle.	`gatewayHostName` `resourceId`
`usageCpu`	Utilisation de l'UC de passerelle	Pour cent	1 minute	Utilisation de l'UC par la passerelle, exprimée en pourcentage.	`gatewayHostName` `resourceId`
`usageRss`	Utilisation de la mémoire de passerelle	Méga-octets	1 minute	Quantité de mémoire consommée par la JVM de la passerelle. Le nombre représente la taille du jeu résident (RSS) dans la mémoire principale.	`gatewayHostName` `resourceId`
`uploadSent`	Données envoyées	Octets	10 minute	Octets téléchargés par la passerelle vers OCI.	`gatewayHostName` `resourceId`
`queueUsageDepth`	Utilisation de la file d'attente de tampon de passerelle	Nombre	10 minute	Nombre d'entrées en attente dans la file d'attente de téléchargement mise en mémoire tampon.	`gatewayHostName` `resourceId` `queueName`
`uploadResponseTime`	Temps de réponse du chargement	millisecondes	10 minute	Temps moyen nécessaire à Gateway pour obtenir une réponse du service côté OCI pour les téléchargements mis en mémoire tampon, compté à partir du moment où la passerelle est connectée à OCI.	`gatewayHostName` `resourceId` `serviceName`
`agentResponseTime`	Temps de réponse de l'agent	millisecondes	10 minute	Temps moyen nécessaire à Gateway pour obtenir une réponse du service côté OCI pour les téléchargements mis en mémoire tampon, décompté lorsque l'agent est connecté à la passerelle.	`gatewayHostName` `resourceId` `agentId`
`uploadLatency`	Temps d'attente de téléchargement	millisecondes	10 minute	Temps moyen passé dans la passerelle elle-même, lors du traitement des téléchargements mis en mémoire tampon.	`gatewayHostName` `resourceId` `serviceName`
`associatedAgentCount`	Nombre d'agents associés	Nombre	10 minute	Nombre d'agents distincts faisant des téléchargements mis en mémoire tampon depuis le démarrage de l'instance.	`gatewayHostName` `resourceId` `agentType`
`incomingRequestCount`	Nombre de demandes entrantes	nombre	10 minute	Nombre de demandes de téléchargement mises en mémoire tampon émises par les agents depuis le démarrage de l'instance.	`gatewayHostName` `resourceId` `agentId`
`outgoingRequestCount`	Nombre de demandes sortantes	nombre	10 minute	Nombre de demandes de téléchargement mises en mémoire tampon réussies de la passerelle vers OCI depuis le démarrage de l'instance.	`gatewayHostName` `resourceId` `serviceName`

Remarque

L'intervalle d'alarme doit être supérieur à la fréquence à laquelle les mesures sont émises. Veillez à définir des intervalles d'alarme supérieurs à la fréquence d'émission des mesures.

Utilisation de la console

Utilisez la console afin d'afficher des graphiques pour les mesures émises par la passerelle de gestion.

Affichage des mesures par défaut pour une passerelle de gestion

Pour afficher les mesures par défaut d'une seule passerelle de gestion, vous pouvez utiliser Mesures de service.

Ouvrez le menu de navigation. Sous Observation & gestion, accédez à Surveillance et cliquez sur Mesures de service.
Pour Espace de noms de mesure, sélectionnez oci_managementgateway.
Pour Dimensions, indiquez resourceId et sélectionnez l'OCID de la passerelle de gestion pour laquelle afficher les mesures de service.

Construction de requêtes de mesure pour une passerelle de gestion

Vous pouvez construire des requêtes de mesure de passerelle de gestion pour surveiller l'état ou la consommation des ressources.

Par exemple, vous pouvez construire une requête à l'aide de l'espace de noms oci_managementgateway, de la mesure gatewayHealthStatus et de la dimension gatewayHostName pour vérifier que la passerelle communique avec le service Monitoring.

Ouvrez le menu de navigation. Sous Observation & gestion, accédez à Surveillance et cliquez sur Mesures de service.
Remplissez les champs pour créer une requête.
- Compartiment : compartiment dans lequel réside la passerelle de gestion.
- Espace de noms de mesure : sélectionnez oci_managementgateway.
- Nom de mesure : sélectionnez une mesure dans l'espace de noms de mesure sélectionné.
- Intervalle : sélectionnez une fenêtre d'agrégation.
- Statistique : sélectionnez une fonction d'agrégation.
- Dimensions de mesure : sélectionnez une dimension dans le champ Nom de la dimension et une valeur pour cette dimension dans le champ Valeur de dimension. Vous pouvez éventuellement ajouter une dimension supplémentaire.
Cliquez sur Mettre le graphique à jour.

Le graphique présente les résultats de la nouvelle requête.

Pour plus d'informations sur la construction de requêtes de mesure, reportez-vous à Construction de requêtes de mesure.

Création d'alarmes pour une passerelle de gestion

Vous pouvez créer une alarme à l'aide du service Monitoring pour être averti si une mesure de passerelle de gestion dépasse le seuil indiqué.

Par exemple, pour vérifier si une passerelle spécifique communique avec le service Monitoring, vous pouvez exécuter une requête à l'aide du nom de mesure gatewayHealthStatus. Pour surveiller automatiquement cette passerelle, vous pouvez créer une alarme afin d'avertir l'administrateur si la communication est interrompue pendant 10 minutes.

Vous pouvez visualiser les alarmes déclenchées sur la page Statut d'alarme :

Ouvrez le menu de navigation. Sous Observation & gestion, accédez à Surveillance et cliquez sur Statut d'alarme.

Afin d'obtenir des informations sur la création d'une alarme pour les mesures de passerelle de gestion, reportez-vous à Utilisation de la console pour créer une alarme.

Utilisation de l'API

Pour plus d'informations sur l'utilisation de l'API et la signature des demandes, reportez-vous à API REST et à Informations d'identification de sécurité. Pour plus d'informations sur les kits SDK, reportez-vous à Kits SDK et interface de ligne de commande.

Utilisez les API suivantes pour la surveillance :

API Monitoring pour les mesures et les alarmes
API Notifications pour les notifications (utilisées avec des alarmes)

Documentation Oracle Cloud Infrastructure