Charger des métriques sur Azure Monitor

  • Article

Régulièrement, vous pouvez exporter les métriques de surveillance, puis les charger dans Azure. L’exportation et le chargement des données crée et met à jour le contrôleur de données, l’instance gérée SQL et les ressources de serveur PostgreSQL dans Azure.

Avec les services de données Azure Arc, vous pouvez éventuellement charger vos métriques sur Azure Monitor afin de pouvoir agréger et analyser les métriques, déclencher des alertes, envoyer des notifications ou déclencher des actions automatisées.

L’envoi de vos données à Azure Monitor vous permet également de stocker des données de métrique et de journalisation hors site et à grande échelle, ce qui permet un stockage à long terme des données pour l’analytique avancée.

Si vous disposez de plusieurs sites avec Azure Arc Data Services, vous pouvez utiliser Azure Monitor comme emplacement central pour collecter tous les journaux et toutes les métriques de vos sites.

Charger les métriques pour le contrôleur de données Azure Arc en mode direct

En mode de connexion directe, le chargement des métriques peut uniquement être configuré en mode automatique. Ce chargement automatique de métriques peut être configuré pendant ou après le déploiement du contrôleur de données Azure Arc. L’identité managée de l’extension des services de données Arc est utilisée pour charger les métriques. L’identité managée doit se voir attribuer le rôle Publication des métriques de surveillance.

Remarque

Si le chargement automatique des métriques a été désactivé pendant le déploiement du contrôleur de données Azure Arc, vous devez d’abord récupérer l’identité managée de l’extension du contrôleur de données Arc et lui accorder le rôle Publication des métriques de surveillance avant d’activer le chargement automatique. Suivez les étapes ci-dessous pour récupérer l’identité managée et accorder les rôles requis.

Les exemples de cet article utilisent des crochets pointus < ... > pour identifier les valeurs que vous devez remplacer avant d’exécuter le script. Remplacez les crochets et les valeurs à l’intérieur des crochets.

(1) Récupérer l’identité managée de l’extension du contrôleur de données Azure Arc

$Env:MSI_OBJECT_ID = (az k8s-extension show --resource-group <resource group>  --cluster-name <connectedclustername> --cluster-type connectedClusters --name <name of extension> | convertFrom-json).identity.principalId
#Example
$Env:MSI_OBJECT_ID = (az k8s-extension show --resource-group myresourcegroup  --cluster-name myconnectedcluster --cluster-type connectedClusters --name ads-extension | convertFrom-json).identity.principalId

(2) Attribuer un rôle à l’identité managée

Exécutez la commande ci-dessous pour attribuer le rôle Publication des métriques de surveillance :

az role assignment create --assignee $Env:MSI_OBJECT_ID --role 'Monitoring Metrics Publisher' --scope "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP_NAME"

Le chargement automatique des métriques peut être activé comme suit :

az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-metrics true
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-metrics true

Pour désactiver le chargement automatique des métriques dans Azure Monitor, exécutez la commande suivante :

az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-metrics false
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-metrics false

Charger les métriques pour le contrôleur de données Azure Arc en mode indirect

En mode de connexion indirecte, le principal de service est utilisé pour charger les métriques.

Prérequis

Avant de continuer, assurez-vous que vous avez créé le principal du service requis et que vous l’avez affecté à un rôle approprié. Pour plus d’informations, consultez :

Définir des variables d’environnement et confirmer

Définissez l’URL de l’autorité du SPN dans une variable d’environnement :

$Env:SPN_AUTHORITY='https://login.microsoftonline.com'

Assurez-vous que toutes les variables d’environnement nécessaires sont définies si vous le souhaitez :

$Env:SPN_TENANT_ID
$Env:SPN_CLIENT_ID
$Env:SPN_CLIENT_SECRET
$Env:SPN_AUTHORITY

Charger des métriques sur Azure Monitor

Pour charger des métriques pour SQL Managed Instance avec Azure Arc et PostgreSQL avec Azure Arc, exécutez les commandes CLI suivantes :

  1. Exportez toutes les métriques vers le fichier spécifié :

Remarque

L’exportation des informations d’utilisation/facturation, des métriques et des journaux à l’aide de la commande az arcdata dc export nécessite de contourner la vérification SSL pour l’instant. Vous êtes invité à contourner la vérification SSL ou vous pouvez définir la variable d’environnement AZDATA_VERIFY_SSL=no pour éviter les invites. Il n’existe actuellement aucun moyen de configurer un certificat SSL pour l’API d’exportation du contrôleur de données.

az arcdata dc export --type metrics --path metrics.json --k8s-namespace arc

  1. Charger les métriques sur le Azure Monitor :

    az arcdata dc upload --path metrics.json

    Remarque

    Attendez au moins 30 minutes après la création des instances de données compatibles avec Azure Arc pour le premier chargement.

    Veillez à upload les mesures immédiatement après export, car Azure Monitor accepte uniquement les métriques des 30 dernières minutes. Plus d’informations

Si vous voyez des erreurs indiquant « Impossible d’obtenir les métriques » pendant l’exportation, vérifiez si la collecte de données est définie sur true en exécutant la commande suivante :

az arcdata dc config show  --k8s-namespace arc --use-k8s

regardez sous la « section relative à la sécurité »

 "security": {
      "allowDumps": true,
      "allowNodeMetricsCollection": true,
      "allowPodMetricsCollection": true,
    },

Vérifiez si les propriétés allowNodeMetricsCollection et allowPodMetricsCollection sont définies sur true.

Afficher les métriques dans le portail

Une fois vos métriques chargées, vous pouvez les afficher à partir du Portail Azure.

Remarque

Notez que le traitement des données chargées peut prendre quelques minutes avant que vous puissiez afficher les métriques dans le portail.

Pour consulter vos métriques, accédez au portail Azure. Puis recherchez le nom de votre instance de base de données sur la barre de recherche :

Vous pouvez voir l’utilisation du processeur sur la page de vue d’ensemble ou, si vous souhaitez des métriques plus détaillées, vous pouvez cliquer sur les métriques dans le panneau de navigation de gauche.

Choisissez sql server ou postgres comme espace de noms de métrique.

Sélectionnez la métrique que vous souhaitez voir (vous pouvez également en sélectionner plusieurs).

Modifiez la fréquence pour qu’elle dure 30 minutes.

Remarque

Vous ne pouvez charger les métriques que pour les 30 dernières minutes. Azure Monitor rejette les métriques datant de plus de 30 minutes.

Automatisation des chargements (facultatif)

Si vous souhaitez charger les métriques et les journaux sur une base planifiée, vous pouvez créer un script et l’exécuter sur la base d’un minuteur toutes les quelques minutes. Voici un exemple d’automatisation des chargements à l’aide d’un script de shell Linux.

Dans votre éditeur de texte ou de code, ajoutez ce qui suit au script dans le fichier, puis enregistrez-le en tant que fichier exécutable de script, tel que .sh (Linux/Mac), .cmd, .bat ou .ps1.

az arcdata dc export --type metrics --path metrics.json --force  --k8s-namespace arc
az arcdata dc upload --path metrics.json

Rendre le fichier de script exécutable

chmod +x myuploadscript.sh

Exécutez le script toutes les 20 minutes :

watch -n 1200 ./myuploadscript.sh

Vous pouvez également utiliser un planificateur de travaux comme cron ou le Planificateur de tâches Windows ou encore un orchestrateur comme Ansible, Puppet ou Chef.

Conseils généraux sur l’exportation et le chargement des métriques d’utilisation

Les opérations de création, de lecture, de mise à jour et de suppression (CRUD) sur les services de données compatibles Azure Arc sont journalisées à des fins de facturation et de surveillance. Il existe des services en arrière-plan qui surveillent ces opérations CRUD et calculent la consommation de manière appropriée. Le calcul réel de l’utilisation ou de la consommation se produit de manière planifiée et est effectué en arrière-plan.

Chargez l’utilisation seulement une fois par jour. Lorsque les informations d’utilisation sont exportées et chargées plusieurs fois au cours de la même période de 24 heures, seul l’inventaire des ressources est mis à jour dans le Portail Azure mais pas dans l’utilisation des ressources.

Pour le chargement des mesures, Azure Monitor accepte uniquement les 30 dernières minutes de données (En savoir plus). La recommandation pour le chargement des métriques est de charger les métriques immédiatement après la création du fichier d’exportation afin de pouvoir afficher l’ensemble du jeu de données dans le Portail Azure. Par exemple, supposons que vous avez exporté les métriques à 14 h et que vous avez exécuté la commande de chargement à 14 h 50. Étant donné qu’Azure Monitor n’accepte que les données des 30 dernières minutes, vous ne verrez aucune donnée dans le portail.

Contenu connexe

Charger les journaux sur Azure Monitor

Charger les données d’utilisation, les métriques et les journaux d’activité sur Azure Monitor

Charger des données de facturation dans Azure et les afficher dans le portail Azure

Afficher la ressource Azure Arc Data Controller dans Portail Azure