Gestion des métriques de flotte - AWS IoT Core
Gestion des indicateurs de flotte (console)Gestion des indicateurs de flotte (CLI)Autoriser le balisage des ressources IoT

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Gestion des métriques de flotte

Cette rubrique explique comment utiliser la AWS IoT console et comment AWS CLI gérer les indicateurs de votre flotte.

Gestion des indicateurs de flotte (console)

Les sections suivantes montrent comment utiliser la AWS IoT console pour gérer les indicateurs de votre flotte. Assurez-vous d'avoir activé l'indexation de la flotte avec les sources de données et les configurations associées avant de créer des métriques de flotte.

Activez l'indexation de la flotte

Si vous avez déjà activé l'indexation de la flotte, ignorez cette section.

Si vous n'avez pas activé l'indexation de la flotte, suivez ces instructions.

  1. Ouvrez votre AWS IoT console à l'adresse https://console.aws.amazon.com/iot/.

  2. AWS IoT Dans le menu, choisissez Réglages.

  3. Pour afficher les paramètres détaillés, sur la page Paramètres, faites défiler la page vers le bas jusqu'à la section indexation de la flotte.

  4. Pour mettre à jour les paramètres d'indexation de votre flotte, à droite de la section Indexation de la flotte, sélectionnez Gérer l'indexation.

  5. Sur la page Gérer l'indexation de la flotte, mettez à jour les paramètres d'indexation de votre flotte en fonction de vos besoins.

    • Configuration

      Pour activer l'indexation des objets, activez l'indexation des objets, puis sélectionnez les sources de données à partir desquelles vous souhaitez indexer.

      Pour activer l'indexation des groupes d'objets, activez l'indexation des groupes d'objets.

    • Champs personnalisés pour l'agrégation - facultatif

      Les champs personnalisés sont une liste de paires de noms et de types de champs.

      Pour ajouter une paire de champs personnalisée, choisissez Ajouter un nouveau champ. Entrez un nom de champ personnalisé tel queattributes.temperature, puis sélectionnez un type de champ dans le menu Type de champ. Notez que le nom d'un champ personnalisé commence par attributes. et sera enregistré en tant qu'attribut pour exécuter des requêtes d'agrégation d'objets.

      Pour mettre à jour et enregistrer le paramètre, choisissez Mettre à jour.

Créer une métrique de flotte

  1. Ouvrez votre AWS IoT console à l'adresse https://console.aws.amazon.com/iot/.

  2. AWS IoT Dans le menu, choisissez Gérer, puis choisissez Fleet metrics.

  3. Sur la page Métriques de la flotte, choisissez Créer une métrique de flotte et suivre les étapes de création.

  4. À l'étape 1, configurez les métriques de la flotte

    • Dans la section Requête, entrez une chaîne de requête pour spécifier les objets ou les groupes d'objets pour lesquels vous souhaitez effectuer la recherche agrégée. La chaîne de requête est composée d'un attribut et d'une valeur. Dans Propriétés, choisissez l'attribut souhaité ou, s'il n'apparaît pas dans la liste, saisissez-le dans le champ. Saisissez la valeur après :. Un exemple de chaîne de requête peut être thingName:TempSensor*. Pour chaque chaîne de requête que vous saisissez, appuyez sur la touche Entrée de votre clavier. Si vous entrez plusieurs chaînes de requête, spécifiez leur relation en sélectionnant et, ou, et non, ou pas entre elles.

    • Dans Propriétés du rapport, sélectionnez le nom de l'index, le type d'agrégation et le champ d'agrégation dans leurs listes respectives. Sélectionnez ensuite les données que vous souhaitez agréger dans Sélectionner les données, où vous pouvez sélectionner plusieurs valeurs de données.

    • Choisissez Suivant.

  5. À l'étape 2, spécifiez les propriétés métriques de la flotte

    • Dans le champ Nom de la métrique de flotte, entrez le nom de la métrique de flotte que vous créez.

    • Dans le champ Description - facultatif, entrez une description de la métrique de flotte que vous créez. Ce champ est facultatif.

    • Dans les champs Heures et Minutes, entrez l'heure (fréquence) à laquelle vous souhaitez que la métrique du parc émette des données CloudWatch.

    • Choisissez Suivant.

  6. À l'étape 3 : Examen et création

    • Vérifiez les paramètres des étapes 1 et 2. Pour modifier les paramètres, choisissez Modifier.

    • Choisissez Créer une métrique de flotte.

Une fois la création réussie, la métrique de flotte est répertoriée sur la page Métrique de flotte.

Met à jour une métrique de flotte

  1. Sur la page Métrique de flotte, choisissez la métrique de flotte que vous souhaitez mettre à jour.

  2. Sur la page métrique de la flotte, choisissez Détails, puis Modifier. Cela ouvre les étapes de création où vous pouvez mettre à jour les indicateurs de votre flotte dans l'une des trois étapes.

  3. Une fois que vous avez terminé de mettre à jour la métrique de flotte, choisissez Mettre à jour la métrique de flotte.

Supprimer une métrique de flotte

  1. Sur la page Métrique de flotte, choisissez la métrique de flotte que vous souhaitez mettre à jour.

  2. Sur la page suivante qui affiche les détails de l'indicateur de votre flotte, choisissez Supprimer.

  3. Dans la boîte de dialogue, entrez le nom de la métrique de flotte pour confirmer la suppression.

  4. Sélectionnez Delete (Supprimer). Cette étape supprime définitivement la métrique de votre flotte.

Gestion des indicateurs de flotte (CLI)

Les sections suivantes montrent comment utiliser le AWS CLI pour gérer les indicateurs de votre flotte. Assurez-vous d'avoir activé l'indexation de la flotte avec les sources de données et les configurations associées avant de créer des métriques de flotte. Pour activer l'indexation de flotte pour vos objets ou groupes d'objets, suivez les instructions dans Gestion de l'indexation des objets ou Gestion de l'indexation des groupes d'objets.

Créer une métrique de flotte

Vous pouvez utiliser la commande create-fleet-metric CLI pour créer une métrique de flotte. 

aws iot create-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 60 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum

La sortie de cette commande contient le nom et l'Amazon Resource Name (ARN) de la métrique de votre flotte. Le résultat se présente comme suit :

{
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "metricName": "YourFleetMetricName"
}

Liste des métriques de flotte

Vous pouvez utiliser la commande list-fleet-metric CLI pour répertorier tous les indicateurs de flotte de votre compte. 

aws iot list-fleet-metrics

Le résultat de cette commande contient tous les indicateurs de votre flotte. Le résultat se présente comme suit :

{
    "fleetMetrics": [
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric1", 
            "metricName": "YourFleetMetric1"
        }, 
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric2", 
            "metricName": "YourFleetMetric2"
        }
    ]
}

Décrire une métrique de flotte

Vous pouvez utiliser la commande describe-fleet-metric CLI pour afficher des informations plus détaillées sur une métrique de flotte. 

aws iot describe-fleet-metric --metric-name "YourFleetMetricName"

La sortie de la commande contient les informations détaillées sur la métrique de flotte spécifiée. Le résultat se présente comme suit :

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625790642.355, 
    "queryString": "*", 
    "period": 60, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 1, 
    "aggregationType": {
        "values": [
            "sum"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625790642.355, 
    "metricName": "YourFleetMetricName"
}

Met à jour une métrique de flotte

Vous pouvez utiliser la commande update-fleet-metric CLI pour mettre à jour une métrique de flotte. 

aws iot update-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 120 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum,count --index-name AWS_Things

La update-fleet-metric commande ne produit aucune sortie. Vous pouvez utiliser la commande describe-fleet-metric CLI pour voir le résultat.

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625792300.881, 
    "queryString": "*", 
    "period": 120, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 2, 
    "aggregationType": {
        "values": [
            "sum", 
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625792300.881, 
    "metricName": "YourFleetMetricName"
}

Supprimez une métrique de flotte

Utilisez la commande delete-fleet-metric CLI pour supprimer une métrique de flotte. 

aws iot delete-fleet-metric --metric-name "YourFleetMetricName"

Cette commande ne produit aucune sortie si la suppression est réussie ou si vous spécifiez une métrique de flotte qui n'existe pas.

Pour plus d’informations, consultez Dépannage des métriques de flotte.

Autoriser le balisage des ressources IoT

Pour mieux contrôler les indicateurs de flotte que vous pouvez créer, modifier ou utiliser, vous pouvez associer des balises aux indicateurs de flotte.

Pour étiqueter les métriques de flotte que vous créez à l'aide de AWS Management Console ou AWS CLI, vous devez inclure l'iot:TagResourceaction dans votre politique IAM afin d'accorder des autorisations aux utilisateurs. Si votre politique IAM ne l'inclut pas iot:TagResource, toute action visant à créer une métrique de flotte avec une balise renverra une erreur AccessDeniedException.

Pour obtenir des informations générales sur le balisage de vos ressources, consultez Balisage de vos AWS IoT ressources.

Exemple de politique IAM

Reportez-vous à l'exemple de politique IAM suivant accordant des autorisations de balisage lorsque vous créez une métrique de flotte :

{
	"Version": "2012-10-17",
	"Statement": [
		{
			"Action": [
				"iot:TagResource"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		},
		{
			"Action": [
				"iot:CreateFleetMetric"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:index/*",
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		}
	]
}

Pour de plus amples informations, consultez Actions, ressources et clés de condition pour AWS IoT