AWS IoT Core de surveillance

Modifier en ligne

Surveillez votre AWS IoT Core avec Instana pour une visibilité de bout en bout de votre environnement IoT. Pour surveiller AWS IoT Core, installez l'agent Instana dans votre environnement. L'agent déploie automatiquement le capteur « AWS IoT Core », qui recueille des données de surveillance de l' IoT. Vous pouvez consulter ces indicateurs dans l'interface utilisateur d' Instana.

Remarque : AWS IoT Core est un service cloud permettant de connecter des appareils au cloud d' AWS. Pour connaître les autres services pris en charge par l' AWS, consultez la rubrique « AWS ».

Autorisations IAM requis

Modifier en ligne

Le capteur « AWS IoT Core » nécessite les autorisations IAM suivantes d' AWS pour surveiller votre AWS IoT Core :

cloudwatch:GetMetricData
cloudwatch:GetMetricStatistics
iot:DescribeEndpoint
iot:ListThings

Configuration du capteur « AWS IoT Core »

Modifier en ligne

Une fois l'agent « Instana » installé, le capteur « AWS IoT Core » est activé par défaut. Les données de mesure d' AWS IoT Core s sont récupérées toutes les 60 secondes. Vous pouvez modifier ce paramètre dans le fichier <agent_install_dir>/etc/instana/configuration.yml :

com.instana.plugin.aws.iotcore:
  cloudwatch_period: 60

Activation de la configuration du proxy

Modifier en ligne

Pour permettre au capteur « AWS IoT Core » d'utiliser la configuration du proxy, ajoutez les paramètres de configuration d'agent suivants :

com.instana.plugin.aws.iotcore:
  proxy_host: 'example.com' # proxy host name or ip address
  proxy_port: 3128 # proxy port
  proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
  proxy_username: 'username' # OPTIONAL: proxy username
  proxy_password: 'password' # OPTIONAL: proxy password

Désactivation du capteur « AWS IoT Core »

Modifier en ligne

Pour désactiver la surveillance des instances IoT Core, utilisez la configuration suivante:

com.instana.plugin.aws.iotcore:
  enabled: false

Configuration de la surveillance d' AWS IoT Core. sur plusieurs comptes AWS

Modifier en ligne

Pour configurer la surveillance de plusieurs comptes AWS avec un agent AWS dans la même région, vous pouvez utiliser deux approches. Pour plus d'informations, voir Surveillance de plusieurs comptes AWS.

AWS approche par profils nommés

Modifier en ligne

Pour définir manuellement les profils utilisés pour surveiller AWS IoT Core, utilisez la configuration suivante :

com.instana.plugin.aws.iotcore:
  profile_names:
    - 'profile2'
    - 'profile3'

Remarque : si vous définissez des profils au niveau du service, la configuration globale du profil d' AWS s est remplacée.

Approche AWS STS

Modifier en ligne

Pour remplacer les rôles IAM utilisés pour surveiller IoT Core, utilisez la configuration suivante:

com.instana.plugin.aws.iotcore:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_2_name>'

Remarque : si vous définissez des rôles IAM au niveau d'un service, la configuration globale du rôle IAM « AWS » est remplacée.

Filtrer en définissant des balises

Modifier en ligne

Etant donné que le courtier IoT Core ne peut pas être balisé, le filtrage par définition de balises n'est pas pris en charge.

Affichage des mesures

Modifier en ligne

Pour afficher les métriques, procédez comme suit:

Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
Cliquez sur une instance spécifique d' AWS IoT Core.

Vous pouvez consulter le tableau de bord d' AWS IoT Core, qui présente toutes les données collectées.

Données de configuration

Modifier en ligne

Le capteur « AWS IoT Core » recueille les données suivantes d' IoT :

Noeud final
Région

Métriques

Modifier en ligne

Le tableau suivant répertorie les indicateurs collectés par le capteur « AWS IoT Core » :


Nom	Description
Réussite de la connexion	Nombre de connexions réussies au courtier de messages.
Régulateur de connexions	Nombre de demandes de connexion qui sont régulées car le compte a dépassé le taux de demandes de connexion autorisé.
Régulateur d'ID client de connexion	Nombre de demandes de connexion qui sont régulées car le client a dépassé le taux de demandes de connexion autorisé pour un ID client spécifique.
Régulateur du nombre total de connexions	Nombre total de demandes de connexion qui sont régulées.
Règles exécutées	Nombre de règles AWS IoT exécutées.
Commande ping réussie	Nombre de messages ping reçus par le courtier de messages.
Erreur d'authentification de connexion	Nombre de demandes de connexion qui ne peuvent pas être autorisées par le courtier de messages.
Erreur de connexion du client	Nombre de demandes de connexion rejetées car le message MQTT ne répondait pas aux exigences définies dans les quotas AWS IoT .
Erreur de connexion au serveur	Nombre de demandes de connexion ayant échoué en raison d'une erreur interne.
Erreur de publication dans l'authentification	Nombre de demandes de publication que le courtier de messages ne peut pas autoriser.
Erreur de publication dans le client	Nombre de demandes de publication rejetées par le courtier de messages car le message ne répondait pas aux exigences définies dans les quotas AWS IoT .
Erreur de publication dans le serveur	Nombre de demandes de publication que le courtier de messages n'a pas pu traiter en raison d'une erreur interne.
Publication entrante réussie	Nombre de demandes de publication traitées avec succès par le courtier de messages.
Régulateur de publications entrantes	Nombre de demandes de publication qui sont régulées car le client a dépassé le débit de messages entrants autorisé.
Erreur d'autorisation de publication	Nombre de demandes de publication effectuées par le courtier de messages qui ne peuvent pas être autorisées par AWS IoT.
Erreur du client de publication / sortie	Nombre de demandes de publication effectuées par le courtier de messages qui sont rejetées car le message ne répondait pas aux exigences définies dans les quotas AWS IoT .
Publication sortante réussie	Nombre de demandes de publication effectuées avec succès par le courtier de messages.
Régulateur de publications sortantes	Nombre de demandes de publication régulées car le client a dépassé le débit de messages sortants autorisé.
Abonnement réussi	Nombre de demandes d'abonnement traitées avec succès par le courtier de messages.
Régulateur d'abonnements	Nombre de demandes d'abonnement qui sont régulées car le client a dépassé le taux de demandes d'abonnement autorisé.
Demandes Get Thing Shadow acceptées	Le nombre de requêtes « GetThingShadow » traitées avec succès.
Demande Update Thing Shadow acceptées	Le nombre de requêtes « UpdateThingShadow » traitées avec succès.
Demandes Delete Thing Shadow acceptées	Le nombre de requêtes « DeleteThingShadow » traitées avec succès.
Demandes List Thing Shadow acceptées	Le nombre de requêtes « ListThingShadow » traitées avec succès.