Amazon Monitron n'est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour des fonctionnalités similaires à celles d'Amazon Monitron, consultez notre [article de blog](https://aws.amazon.com/blogs/machine-learning/maintain-access-and-consider-alternatives-for-amazon-monitron).
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.
# Accès à vos données Amazon Monitron
Il existe deux manières d'accéder à vos données Amazon Monitron brutes en dehors d'Amazon Monitron.
Vous souhaiterez peut-être accéder à vos données de manière continue, afin de pouvoir les utiliser ailleurs. Dans ce cas, vous pouvez configurer Amazon Monitron pour [ajouter automatiquement vos données à un flux Kinesis](/Monitron/latest/user-guide/monitron-kinesis-export.html). De là, vous pouvez le porter vers différentes destinations, notamment Amazon S3 et Lambda. Ce processus nécessite une configuration, et cette configuration nécessite une compréhension de Kinesis Data Streams. Cependant, une fois que vous avez organisé tous les éléments de manière satisfaisante, vous pouvez continuer à diffuser automatiquement vos données.
Ou vous souhaiterez peut-être accéder à vos données de temps en temps, simplement pour bien comprendre le type de données que vous stockez et analysez AWS. Dans ce cas, vous pouvez demander à l' AWS assistance de [copier manuellement vos données sur Amazon S3](data-download-monitron.md). Ce processus nécessite moins de configuration, mais il ne peut pas être automatisé. Il ne vous fournit que les données qu'Amazon Monitron a accumulées jusqu'à présent, en un seul bloc.
**Topics**
+ [Exportation de vos données Amazon Monitron vers Amazon S3](data-download-monitron.md)
+ [Exportation de données Amazon Monitron Kinesis v1](monitron-kinesis-export.md)
+ [Exportation de données Amazon Monitron Kinesis v2](monitron-kinesis-export-v2.md)
# Exportation de vos données Amazon Monitron vers Amazon S3
Vous souhaiterez peut-être parfois accéder aux données brutes qu'Amazon Monitron stocke pour vous, afin de savoir exactement quel type de données vous stockez en toute sécurité. AWS
Vous pouvez obtenir vos données brutes en déposant un ticket d'assistance auprès AWS d'Amazon Monitron et en autorisant Amazon Monitron à vous fournir vos données.
Pour obtenir des données opérationnelles en temps réel pour les ressources Amazon Monitron qui peuvent être consommées par programmation, envisagez d'exporter vos données à l'aide des flux Kinesis. Pour plus d'informations, consultez [Amazon Monitron Kinesis data export v2](https://docs.aws.amazon.com/Monitron/latest/user-guide/monitron-kinesis-export-v2.html).
**Topics**
+ [Conditions préalables](exporting-data-procedure.md)
+ [Exporter vos données avec CloudFormation (option recommandée)](onetime-download-cflink.md)
+ [Exporter vos données avec la console](onetime-download-console.md)
+ [Exporter vos données avec CloudShell](export-shell.md)
# Conditions préalables
Pour exporter correctement vos données Amazon Monitron, les conditions préalables suivantes doivent être remplies.
+ Vous ne devez pas avoir déjà effectué une autre exportation (de données Amazon Monitron) dans la même région.
+ Vous ne pouvez pas avoir effectué une autre exportation dans la même région au cours des dernières 24 heures.
# Exporter vos données avec CloudFormation (option recommandée)
**Topics**
+ [Étape 1 : Créez votre compartiment Amazon S3, votre rôle IAM et vos politiques IAM.](#gdpr-cloudfront-makestack)
+ [Étape 2 : Notez vos ressources](#gdpr-cloudfront-resources)
+ [Étape 3 : Création du dossier de support](#gdpr-cloudfront-case)
## Étape 1 : Créez votre compartiment Amazon S3, votre rôle IAM et vos politiques IAM.
1. Connectez-vous à votre AWS compte.
1. Ouvrez un nouvel onglet de navigateur avec l'URL suivante.
```
https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/create/review?templateURL=https://s3.us-east-1.amazonaws.com/monitron-cloudformation-templates-us-east-1/monitron_manual_download.yaml&stackName=monitronexport
```
1. Sur la CloudFormation page qui s'ouvre, dans le coin supérieur droit, sélectionnez la région dans laquelle vous utilisez Amazon Monitron.
1. Sélectionnez **Créer la pile**.
![\[CloudFormation quick create stack interface with template URL, stack name, and IAM role options.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-1.png)
1. Sur la page suivante, cliquez sur l'icône d'actualisation aussi souvent que vous le souhaitez jusqu'à ce que le statut de la pile (monitronexport) soit CREATE\$1COMPLETE.
![\[CloudFormation stack details page showing monitronexport stack in CREATE_IN_PROGRESS state.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-2.png)
## Étape 2 : Notez vos ressources
1. Choisissez l'onglet **Outputs**.
1. Notez la valeur de la clé`MonRoleArn`.
1. Notez la valeur de la clé`S3BucketArn`.
1. Notez l'identifiant de votre compte (dans le coin supérieur droit de la page).
1. Notez la région que vous avez choisie à l'étape 1. Il apparaît également désormais en haut de la page, à gauche de votre identifiant de compte.
![\[CloudFormation stack outputs page showing MonRoleArn and S3BucketArn with descriptions.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-3.png)
## Étape 3 : Création du dossier de support
1. Sur votre AWS console, cliquez sur l'icône en forme de point d'interrogation située dans le coin supérieur droit de n'importe quelle page, puis sélectionnez **Support Center**.
![\[AWS console interface showing IAM dashboard with Support Center dropdown menu highlighted.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/gdpr-support-question-mark.png)
1. Sur la page suivante, choisissez **Create case**.
![\[Support Center interface with Quick solutions, Active cases, and Create case button.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-4.png)
1. Sur la **page Comment pouvons-nous vous aider ?** page, procédez comme suit :
1. Choisissez **Support de compte et facturation**.
1. Sous **Service**, sélectionnez **Compte**.
1. Sous **Catégorie**, sélectionnez **Conformité et accréditations**.
1. Choisissez **Severity**, si cette option est disponible en fonction de votre abonnement au support.
1. Choisissez **Étape suivante : informations supplémentaires**.
![\[Support case form with Account and billing selected, and service details specified.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-5.png)
1. Dans **Informations supplémentaires**, procédez comme suit :
1. Dans le **champ Objet**, entrez**Amazon Monitron data export request**.
1. Dans le champ **Description**, entrez :
1. votre identifiant de compte
1. la région du bucket que vous avez créé
1. l'ARN du bucket que vous avez créé (par exemple : « arn:aws:s3 : ::bucketname »)
1. l'ARN du rôle que vous avez créé (par exemple : « arn:aws:iam : :273771705212:role/ «) role-for-monitron
![\[Form for Amazon Monitron data export request with fields for account and bucket details.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-6.png)
1. Cliquez sur **Étape suivante : résoudre maintenant ou nous contacter**.
1. Dans **Solve now ou contactez-nous**, procédez comme suit :
1. Dans **Résoudre maintenant**, sélectionnez **Suivant**.
![\[Support options interface with "Solve now" and "Contact us" buttons, and recommendations.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-7.png)
1. Dans **Contactez-nous**, choisissez votre **langue de contact préférée** et le mode de contact préféré.
1. Sélectionnez **Soumettre**. Un écran de confirmation avec votre numéro de dossier et les détails s'affichera.
![\[Contact options with language selection and choices for Web, Phone, or Chat communication.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-8.png)
Un spécialiste AWS du support client vous contactera dès que possible. En cas de problème avec les étapes répertoriées, le spécialiste peut vous demander plus d'informations. Si toutes les informations nécessaires ont été fournies, le spécialiste vous informera dès que vos données auront été copiées dans le compartiment Amazon S3 que vous avez créé ci-dessus.
# Exporter vos données avec la console
**Topics**
+ [Étape 1 : Configuration de votre compartiment Amazon S3](#gdpr-console-s3)
+ [Étape 2 : Autoriser Amazon Monitron à accéder à Amazon S3](#gdpr-console-set-policy)
+ [Étape 3 : Création du rôle](#gdpr-console-create-role)
+ [Étape 4 : Création de la politique de confiance](#gdpr-console-trust-policy)
+ [Étape 5 : Création du dossier de support](#gdpr-console-case)
## Étape 1 : Configuration de votre compartiment Amazon S3
1. Ouvrez la [console Amazon S3](https://console.aws.amazon.com/s3/).
1. Choisissez **Créer un compartiment**.
![\[Amazon S3 console interface showing Buckets section with Create bucket button highlighted.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/gdpr-create-bucket.png)
1. Donnez un nom à votre compartiment et sélectionnez une région appropriée. Ensuite, au bas de la page, choisissez **Create bucket**.
**Important**
À l'heure actuelle, Amazon Monitron n'est pris en charge que dans trois régions :
USA Est (Virginie du Nord) us-east-1
UE (Irlande) - eu-west-1
Asie-Pacifique (Sydney) ap-south-east -2
Par conséquent, votre compartiment Amazon S3 doit se trouver dans l'une de ces régions.
Il doit également s'agir de la même région que celle dans laquelle vous utilisez le service Amazon Monitron.
![\[Create bucket interface showing bucket name "monitron-export-example" and Région AWS "US East (N. Virginia)".\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/gdpr-create-bucket-2.png)
1. Passez en revue les autres options de la page et faites les choix appropriés en fonction de vos besoins et de vos politiques de sécurité.
**Important**
Il est de votre responsabilité de prendre les mesures appropriées pour sécuriser vos données. Nous vous recommandons vivement d'utiliser le chiffrement côté serveur et de bloquer l'accès public à votre bucket.
1. À l'aide de la zone de recherche, recherchez le bucket que vous venez de créer, puis sélectionnez-le.
![\[AWS S3 console showing a newly created bucket named "monitron-export-example" in the bucket list.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/gdpr-choose-s3-bucket.png)
1. Dans l'onglet **Propriétés**, notez le nom, l'ARN et la région du bucket.
![\[S3 bucket properties showing name, region, ARN, and creation date for monitron-export-example.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/gdpr-s3-properties-tab.png)
## Étape 2 : Autoriser Amazon Monitron à accéder à Amazon S3
1. Ouvrez la [console IAM](https://console.aws.amazon.com/iam/) et choisissez **Policies**.
![\[IAM Dashboard showing resource counts, recent updates, and tools for policy management.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-9.png)
1. Choisissez **Create Policy** (Créer une politique).
![\[IAM Policies page with options to search, filter, and create a new policy.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-10.png)
1. Sélectionnez l’onglet **JSON**.
![\[Policy editor interface showing JSON structure for specifying permissions in IAM.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-11.png)
1. Supprimez le texte JSON par défaut afin que le formulaire soit vide.
1. Collez la politique d'accès au bucket.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"s3:GetBucketAcl",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::bucketname"
]
},
{
"Action": [
"s3:PutObject",
"s3:GetBucketAcl"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::bucketname/*"
]
}
]
}
```
------
![\[IAM policy editor interface showing JSON code for S3 bucket permissions.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-12.png)
1. Sélectionnez **Suivant**.
1. Sur la page **Examiner et créer**, procédez comme suit :
1. Dans **Détails de la politique**, entrez un **nom de politique** et une **description** facultative.
1. Laissez les **autorisations définies dans cette section de politique** telles quelles.
1. Dans **Ajouter des balises *(facultatif)*, vous pouvez choisir d'ajouter des balises pour suivre vos ressources.** .
1. Choisissez **Create Policy** (Créer une politique).
![\[Policy creation interface showing policy details, permissions, and tags sections.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-13.png)
## Étape 3 : Création du rôle
1. Ouvrez la [console IAM](https://console.aws.amazon.com/iam/) et choisissez **Rôles**.
![\[IAM Dashboard showing resource counts, recent updates, and available tools.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-14.png)
1. Choisissez **Créer un rôle**.
![\[IAM roles interface showing 116 roles and a prominent "Create role" button.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-15.png)
1. Dans le champ **Sélectionner une entité de confiance**, dans **Type d'entité de confiance**, choisissez un **AWS compte**.
1. Dans **Un AWS compte**, sélectionnez **Ce compte**. Vous pouvez personnaliser des paramètres supplémentaires à l'aide **des options**.
1. Choisissez **Suivant**.
![\[Compte AWS selection interface with trusted entity types and account options.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-16.png)
1. Dans **Ajouter des autorisations**, pour **Politiques d'autorisations**, recherchez la politique que vous venez de créer dans le champ de recherche, puis sélectionnez votre politique.
![\[Add permissions interface showing search for "monitron-policy" with one matching result selected.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-17.png)
1. Sur la page **Nom, révision et création**, procédez comme suit :
1. Dans **Détails du rôle**, entrez un **nom de rôle** et une **description** facultative.
1. Vous pouvez choisir d'ignorer l'**étape 1 : sélectionner les entités de confiance** et **l'étape 2 : ajouter des autorisations**.
1. Pour **l'étape 3 : Ajouter des balises**, pour **Ajouter des balises — *facultatif***, ajoutez des balises facultatives pour suivre vos ressources.
1. Choisissez **Créer un rôle**.
![\[Form for creating a new role with fields for role name, description, trust policy, and permissions.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-18.png)
## Étape 4 : Création de la politique de confiance
1. Recherchez le rôle que vous venez de créer et choisissez-le.
![\[IAM Roles page showing search results for "monitron-role" with one matching role listed.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-19.png)
1. Sélectionnez l’onglet **Relations d’approbation**.
![\[IAM role details page showing Trust relationships tab and Edit trust policy button.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-20.png)
1. Choisissez **Modifier la relation d’approbation**.
![\[Trust relationships tab with Edit trust relationship button highlighted.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/gdpr-edit-trust-relationship.png)
1. Effacez le texte JSON par défaut pour que le formulaire soit vide.
1. Collez la politique qui autorise Amazon Monitron à assumer le rôle.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Effect": "Allow",
"Principal": {
"Service": ["monitron.amazonaws.com"]
},
"Action": "sts:AssumeRole"
}]
}
```
------
![\[Form for creating a new role with fields for role name, description, trust policy, and permissions.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-18.png)
1. Choisissez **Mettre à jour la politique d'approbation**.
## Étape 5 : Création du dossier de support
1. Sur votre AWS console, cliquez sur l'icône en forme de point d'interrogation située dans le coin supérieur droit de n'importe quelle page, puis sélectionnez **Support Center**.
![\[AWS console interface showing IAM dashboard with Support Center dropdown menu highlighted.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/gdpr-support-question-mark.png)
1. Sur la page suivante, choisissez **Create case**.
![\[Support Center interface with Quick solutions, Active cases, and Create case button.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-4.png)
1. Sur la **page Comment pouvons-nous vous aider ?** page, procédez comme suit :
1. Choisissez **Support de compte et facturation**.
1. Sous **Service**, sélectionnez **Compte**.
1. Sous **Catégorie**, sélectionnez **Conformité et accréditations**.
1. Choisissez **Severity**, si cette option est disponible en fonction de votre abonnement au support.
1. Choisissez **Étape suivante : informations supplémentaires**.
![\[Support case form with Account and billing selected, and service details specified.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-5.png)
1. Dans **Informations supplémentaires**, procédez comme suit :
1. Dans le **champ Objet**, entrez**Amazon Monitron data export request**.
1. Dans le champ **Description**, entrez :
1. votre identifiant de compte
1. la région du bucket que vous avez créé
1. l'ARN du bucket que vous avez créé (par exemple : « arn:aws:s3 : ::bucketname »)
1. l'ARN du rôle que vous avez créé (par exemple : « arn:aws:iam : :273771705212:role/ «) role-for-monitron
![\[Form for Amazon Monitron data export request with fields for account and bucket details.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-6.png)
1. Cliquez sur **Étape suivante : résoudre maintenant ou nous contacter**.
1. Dans **Solve now ou contactez-nous**, procédez comme suit :
1. Dans **Résoudre maintenant**, sélectionnez **Suivant**.
![\[Support options interface with "Solve now" and "Contact us" buttons, and recommendations.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-7.png)
1. Dans **Contactez-nous**, choisissez votre **langue de contact préférée** et le mode de contact préféré.
1. Sélectionnez **Soumettre**. Un écran de confirmation avec votre numéro de dossier et les détails s'affichera.
![\[Contact options with language selection and choices for Web, Phone, or Chat communication.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-8.png)
Un spécialiste AWS du support client vous contactera dès que possible. En cas de problème avec les étapes répertoriées, le spécialiste peut vous demander plus d'informations. Si toutes les informations nécessaires ont été fournies, le spécialiste vous informera dès que vos données auront été copiées dans le compartiment Amazon S3 que vous avez créé ci-dessus.
# Exporter vos données avec CloudShell
**Topics**
+ [Étape 1 : Création d'un compartiment Amazon S3 (avec AWS CloudShell)](#create-s3-with-shell)
+ [Étape 2 : accorder à Amazon Monitron l'accès à votre compartiment Amazon S3 (avec) AWS CloudShell](#create-policy-with-shell)
+ [Étape 3 : Création de votre ticket d'assistance](#create-support-ticket)
## Étape 1 : Création d'un compartiment Amazon S3 (avec AWS CloudShell)
1. Connectez-vous à la AWS console.
1. Ouvert AWS CloudShell
[AWS CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html)est un environnement de ligne de commande qui fonctionne dans votre navigateur. À l'intérieur AWS CloudShell, vous pouvez utiliser le AWS Command Line Interface pour lancer et configurer de nombreux AWS services.
1. Dans AWS CloudShell, entrez la commande suivante, où bucketname est le nom du bucket que vous créez :
```
$ aws s3api create-bucket --bucket bucketname --region us-east-1
```
Cette commande crée un compartiment Amazon S3 pour stocker vos données brutes. Vous pourrez accéder facilement à votre bucket depuis la console et télécharger vos données à votre convenance. Pour plus d'informations, consultez [Création, configuration et utilisation des compartiments Amazon S3](https://docs.aws.amazon.com//AmazonS3/latest/userguide/creating-buckets-s3.html).
**Important**
Il est de votre responsabilité de prendre les mesures appropriées pour sécuriser vos données. Nous vous recommandons vivement d'utiliser le chiffrement côté serveur et de bloquer l'accès public à votre bucket.
Dans la commande ci-dessus, le bucket est créé dans la région USA Est (Virginie du Nord). Vous pouvez éventuellement spécifier une région différente dans le corps de la demande. Pour plus d'informations, veuillez consulter [Régions, zones de disponibilité et Local Zones](https://docs.aws.amazon.com//AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html).
Vous devriez voir une sortie qui ressemble à ceci :
```
{ "Location": "/bucketname" }
```
1. Identifiez le [nom de ressource Amazon (ARN)](https://docs.aws.amazon.com//general/latest/gr/aws-arns-and-namespaces.html) du bucket que vous avez créé, qui sera :
```
arn:aws:s3:::bucketname
```
## Étape 2 : accorder à Amazon Monitron l'accès à votre compartiment Amazon S3 (avec) AWS CloudShell
1. Collez le code ci-dessous dans un éditeur de texte et enregistrez-le sous le nom : monitron-assumes-role .json. N'utilisez pas Microsoft Word, qui ajoutera des caractères supplémentaires. Utilisez un éditeur de texte simple tel que le Bloc-notes ou TextEdit.
Cette politique autorise Amazon Monitron à assumer le rôle qui lui permettra d'accéder à votre compartiment S3. Pour plus d'informations, consultez la section [Politiques et autorisations dans IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies.html).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Effect": "Allow",
"Principal": {
"Service": ["monitron.amazonaws.com"]
},
"Action": "sts:AssumeRole"
}]
}
```
------
1. Collez le texte ci-dessous dans un éditeur de texte et enregistrez-le sous le nom : monitron-role-accesses-s 3.json
Cette politique permettra à Amazon Monitron (en utilisant le rôle créé ci-dessus) d'accéder à votre compartiment Amazon S3.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"s3:GetBucketAcl",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::bucketname"
]
},
{
"Action": [
"s3:PutObject",
"s3:GetBucketAcl"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::bucketname/*"
]
}
]
}
```
------
1. Dans le fichier texte que vous venez de créer, remplacez chaque occurrence de *bucketname* par le nom de votre bucket.
Par exemple, si le nom de votre bucket est implacable, votre fichier ressemblera à ceci :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"s3:GetBucketAcl",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::relentless"
]
},
{
"Action": [
"s3:PutObject",
"s3:GetBucketAcl"
],
"Effect": "Allow",
"Resource": [
"arn:aws:s3:::relentless/*"
]
}
]
}
```
------
1. Téléchargez les deux fichiers json que vous venez de créer CloudShell dans le répertoire de base.
Pour charger un fichier, choisissez Actions dans le coin supérieur droit de la page de CloudShell console, puis choisissez Charger le fichier.
1. Entrez ce qui suit sur la ligne de commande dans CloudShell :
**aws iam create-role --role-name role-for-monitron --assume-role-policy-document "cat monitron-assumes-role.json"**
Cette commande crée le rôle et attache la monitron-assumes-role politique.
Vous devriez voir une sortie qui ressemble à ceci :
```
{
"Role": {
"Path": "/",
"RoleName": "role-for-monitron",
"RoleId": "AROAT7PQQWN6BMTMASVPP",
"Arn": "arn:aws:iam::273771705212:role/role-for-monitron",
"CreateDate": "2021-07-14T02:48:15+00:00",
"AssumeRolePolicyDocument": {
"Version": "2012-10-17",
"Statement": [{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": [
"monitron.amazonaws.com"
]
},
"Action": "sts:AssumeRole"
}]
}
}
}
```
Prenez note de la valeur ARN du rôle que vous venez de créer. Vous en aurez besoin ultérieurement.
Dans notre exemple, la valeur de l'ARN est : `arn:aws:iam::273771705212:role/role-for-monitron`
1. Entrez ce qui suit sur la ligne de commande dans CloudShell :
** aws iam create-policy --policy-name role-uses-bucket --policy-document "cat role-uses-bucket.json"**
Cette commande crée la politique monitron-role-accesses-s 3.
Vous devriez voir une sortie qui ressemble à ceci :
```
{
"Policy": {
"PolicyName": "role-uses-bucket",
"PolicyId": "ANPAT7PQQWN6I5KLORSDQ",
"Arn": "arn:aws:iam::273771705212:policy/role-uses-bucket",
"Path": "/",
"DefaultVersionId": "v1",
"AttachmentCount": 0,
"PermissionsBoundaryUsageCount": 0,
"IsAttachable": true,
"CreateDate": "2021-07-14T02:19:23+00:00",
"UpdateDate": "2021-07-14T02:19:23+00:00"
}
}
```
Prenez note de la valeur ARN de la politique que vous venez de créer. Vous en aurez besoin pour la prochaine étape.
Dans notre exemple, la valeur de l'ARN est :
```
arn:aws:iam::273771705212:policy/role-uses-bucket
```
1. Entrez ce qui suit sur la ligne de commande CloudShell, en remplaçant l'ARN par l'ARN de votre role-uses-bucket politique :
```
aws iam attach-role-policy --role-name role-for-monitron --policy-arn
arn:aws:iam::273771705212:policy/role-uses-bucket
```
Cette commande associe la politique monitron-role-accesses-s 3 au rôle que vous venez de créer.
Vous avez maintenant créé et provisionné un compartiment Amazon S3, un rôle qu'Amazon Monitron peut assumer, une politique qui permettra à Amazon Monitron d'assumer ce rôle et une autre politique qui autorisera le service utilisant ce rôle à utiliser votre compartiment Amazon S3.
Il est de votre responsabilité de prendre les mesures appropriées pour sécuriser vos données. Nous vous recommandons vivement d'utiliser le chiffrement côté serveur et de bloquer l'accès public à votre bucket. Pour plus d'informations, consultez la section [Blocage de l'accès public](https://docs.aws.amazon.com//AmazonS3/latest/userguide/access-control-block-public-access.html).
## Étape 3 : Création de votre ticket d'assistance
1. Sur votre AWS console, cliquez sur l'icône en forme de point d'interrogation située dans le coin supérieur droit de n'importe quelle page, puis sélectionnez **Support Center**.
![\[AWS console interface showing IAM dashboard with Support Center dropdown menu highlighted.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/gdpr-support-question-mark.png)
1. Sur la page suivante, choisissez **Create case**.
![\[Support Center interface with Quick solutions, Active cases, and Create case button.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-4.png)
1. Sur la **page Comment pouvons-nous vous aider ?** page, procédez comme suit :
1. Choisissez **Support de compte et facturation**.
1. Sous **Service**, sélectionnez **Compte**.
1. Sous **Catégorie**, sélectionnez **Conformité et accréditations**.
1. Choisissez **Severity**, si cette option est disponible en fonction de votre abonnement au support.
1. Choisissez **Étape suivante : informations supplémentaires**.
![\[Support case form with Account and billing selected, and service details specified.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-5.png)
1. Dans **Informations supplémentaires**, procédez comme suit :
1. Dans le **champ Objet**, entrez**Amazon Monitron data export request**.
1. Dans le champ **Description**, entrez :
1. votre identifiant de compte
1. la région du bucket que vous avez créé
1. l'ARN du bucket que vous avez créé (par exemple : « arn:aws:s3 : ::bucketname »)
1. l'ARN du rôle que vous avez créé (par exemple : « arn:aws:iam : :273771705212:role/ «) role-for-monitron
![\[Form for Amazon Monitron data export request with fields for account and bucket details.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-6.png)
1. Cliquez sur **Étape suivante : résoudre maintenant ou nous contacter**.
1. Dans **Solve now ou contactez-nous**, procédez comme suit :
1. Dans **Résoudre maintenant**, sélectionnez **Suivant**.
![\[Support options interface with "Solve now" and "Contact us" buttons, and recommendations.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-7.png)
1. Dans **Contactez-nous**, choisissez votre **langue de contact préférée** et le mode de contact préféré.
1. Sélectionnez **Soumettre**. Un écran de confirmation avec votre numéro de dossier et les détails s'affichera.
![\[Contact options with language selection and choices for Web, Phone, or Chat communication.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/s3-export-8.png)
Un spécialiste AWS du support client vous contactera dès que possible. En cas de problème avec les étapes répertoriées, le spécialiste peut vous demander plus d'informations. Si toutes les informations nécessaires ont été fournies, le spécialiste vous informera dès que vos données auront été copiées dans le compartiment Amazon S3 que vous avez créé ci-dessus.
# Exportation de données Amazon Monitron Kinesis v1
**Note**
Le schéma d'exportation de données Amazon Monitron Kinesis v1 est devenu obsolète. En savoir plus sur le [schéma d'exportation de données v2](monitron-kinesis-export-v2.md).
Vous pouvez exporter les données de mesure entrantes et les résultats d'inférence correspondants depuis Amazon Monitron et effectuer une analyse en temps réel. L'exportation de données diffuse des données en direct vers Kinesis.
**Topics**
+ [Exportation de vos données vers un flux Kinesis](#exporting-stream-procedure)
+ [Modification des paramètres d'exportation de données en temps réel](#edit-live-export)
+ [Arrêt d'une exportation de données en direct](#stop-kinesis-export)
+ [Affichage des erreurs d'exportation de données](#viewing-kinesis-export-errors)
+ [Utiliser le chiffrement côté serveur pour le flux Kinesis](#data-export-server-side-encryption)
+ [Surveillance avec Amazon CloudWatch Logs](data-export-cloudwatch-logs.md)
+ [Stockage des données exportées dans Amazon S3](kinesis-store-S3.md)
+ [Traitement des données avec Lambda](data-export-lambda.md)
+ [Comprendre le schéma d'exportation de données v1](data-export-schema.md)
## Exportation de vos données vers un flux Kinesis
1. Sur la page principale de votre projet, en bas de page, sur la droite, choisissez **Démarrer l'exportation des données en direct**.
1. Sous **Sélectionner le flux de données Amazon Kinesis, effectuez** l'une des opérations suivantes :
+ Entrez le nom d'un flux existant dans le champ de recherche. Passez ensuite à l'étape 5.
+ Choisissez **Créer un nouveau flux de données**.
1. Sur la page **Créer un flux de données**, sous **Configuration du flux de données**, entrez le nom de votre flux de données.
1. Sous Capacité du flux de données, choisissez votre mode de capacité :
+ Si les exigences de débit de votre flux de données sont imprévisibles et variables, choisissez **On-Demand.**
+ Si vous pouvez estimer de manière fiable les exigences de débit de votre flux de données, choisissez **Provisioned**. **Ensuite, sous Partitions provisionnées, entrez le nombre de partitions que vous souhaitez créer ou choisissez l'estimateur de partitions.**
1. Choisissez **Create data stream (Créer un flux de données)**.
## Modification des paramètres d'exportation de données en temps réel
Pour modifier vos paramètres d'exportation de données en temps réel :
1. Ouvrez la console Amazon Monitron.
1. Choisissez **Projets** dans le volet de navigation.
1. Si vous avez plusieurs projets, choisissez le projet pour lequel vous souhaitez modifier les paramètres d'exportation.
1. Sur la page principale de votre projet, sous **Exportation de données en direct**, dans le menu déroulant **Actions**, choisissez **Modifier les paramètres d'exportation de données en direct**.
## Arrêt d'une exportation de données en direct
1. Ouvrez la console Amazon Monitron.
1. Choisissez **Projets** dans le volet de navigation.
1. Si vous avez plusieurs projets, choisissez le projet pour lequel vous souhaitez modifier les paramètres d'exportation.
1. Sur la page principale de votre projet, sous **Exportation de données en direct**, dans le menu déroulant **Actions**, choisissez **Arrêter l'exportation de données en direct**.
1. Dans la fenêtre contextuelle, choisissez **Stop**.
## Affichage des erreurs d'exportation de données
Pour afficher les messages d'erreur dans l'interface CloudWatch Logs :
+ Sur la console Amazon Monitron, depuis la page principale de votre projet, sous **Exportation de données en direct**, choisissez un groupe de **CloudWatch journaux**.
## Utiliser le chiffrement côté serveur pour le flux Kinesis
Vous pouvez activer le chiffrement côté serveur pour votre flux Kinesis avant de configurer l'exportation des données Kinesis. Toutefois, si le chiffrement côté serveur est activé après la configuration de l'exportation des données Kinesis, Amazon Monitron ne sera pas en mesure de publier sur le flux. Cela est dû au fait qu'Amazon Monitron ne sera pas autorisé à appeler [kms : GenerateDataKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKey.html) afin de chiffrer les données envoyées à Kinesis.
Pour contourner ce problème, suivez les instructions ci-dessous[Modification des paramètres d'exportation de données en temps réel](#edit-live-export), mais sans modifier la configuration. Cela associera le chiffrement que vous avez configuré à votre configuration d'exportation.
# Surveillance avec Amazon CloudWatch Logs
Vous pouvez surveiller l'exportation des données en direct d'Amazon Monitron à l'aide d'Amazon CloudWatch Logs. Lorsqu'une mesure ne parvient pas à être exportée, Amazon Monitron envoie un événement de journal à vos CloudWatch journaux. Vous pouvez également configurer un filtre métrique dans le journal des erreurs pour générer des métriques et configurer des alarmes. Une alarme peut surveiller certains seuils et envoyer des notifications ou prendre des mesures lorsque ces seuils sont atteints. Pour plus d'informations, consultez [le guide de CloudWatch l'utilisateur](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html).
Amazon Monitron envoie les événements de journal au groupe de journaux/aws/monitron/data-export/ \$1HASH\$1ID\$1.
L'événement du journal a le format JSON suivant :
```
{
"assetDisplayName": "string",
"destination": "string",
"errorCode": "string",
"errorMessage": "string",
"eventId": "string",
"positionDisplayName": "string",
"projectDisplayName": "string",
"projectName": "string",
"sensorId": "string",
"siteDisplayName": "string",
"timestamp": "string"
}
```
assetDisplayName
+ Le nom de l'actif affiché dans l'application
+ Type : Chaîne
destination
+ L'ARN du flux de données Kinesis
+ Type : Chaîne
+ Modèle : arn:aws:kinesis : \$1\$1REGION\$1\$1 : \$1\$1AWS\$1ACCOUNT\$1ID\$1\$1 :stream/ \$1\$1STREAM\$1NAME\$1\$1
errorCode
+ Le code d'erreur
+ Type : Chaîne
+ Valeurs valides : `INTERNAL_SEVER_ERROR | KINESIS_RESOURCE_NOT_FOUND | KINESIS_PROVISIONED_THROUGHPUT_EXCEEDED | KMS_ACCESS_DENIED | KMS_NOT_FOUND | KMS_DISABLED | KMS_INVALID_STATE | KMS_THROTTLING`
errorMessage
+ Le message d'erreur détaillé
+ Type : Chaîne
eventId
+ L'identifiant d'événement unique correspondant à chaque exportation de mesure
+ Type : Chaîne
positionDisplayName
+ Le nom de la position du capteur affiché dans l'application
+ Type : Chaîne
ID du capteur
+ L'identifiant physique du capteur à partir duquel la mesure est envoyée
+ Type : Chaîne
siteDisplayName
+ Le nom du site affiché dans l'application
+ Type : Chaîne
timestamp
+ Horodatage de réception de la mesure par le service Amazon Monitron en UTC
+ Type : Chaîne
+ Motif : yyyy-mm-dd HH:MM:SS.SSS
# Stockage des données exportées dans Amazon S3
**Topics**
+ [Utilisation d'un CloudFormation modèle prédéfini](#kinesis-cloudfront-makestack)
+ [Configuration manuelle de Kinesis dans la console](#kinesis-configure-console)
## Utilisation d'un CloudFormation modèle prédéfini
Amazon Monitron fournit un AWS CloudFormation modèle prédéfini permettant de configurer rapidement le Firehose afin de transmettre les données d'un flux de données Kinesis vers le compartiment Amazon S3. Ce modèle permet le partitionnement dynamique et les objets Amazon S3 fournis utiliseront le format de clé suivant recommandé par Amazon Monitron : `/project={projectName}/site={siteName}/time={yyyy-mm-dd 00:00:00}/{filename}`
1. Connectez-vous à votre AWS compte.
1. Ouvrez un nouvel onglet de navigateur avec l'URL suivante :
```
https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/create/review?templateURL=https://s3.us-east-1.amazonaws.com/monitron-cloudformation-templates-us-east-1/monitron_kinesis_data_export.yaml&stackName=monitron-kinesis-live-data-export
```
1. Sur la CloudFormation page qui s'ouvre, dans le coin supérieur droit, sélectionnez la région dans laquelle vous utilisez Amazon Monitron.
1. Par défaut, le modèle créera un nouveau flux de données Kinesis et un nouveau bucket S3, ainsi que les autres ressources nécessaires pour fournir des données à Amazon S3. Vous pouvez modifier les paramètres pour utiliser les ressources existantes.
1. Cochez la case « *Je reconnais que cela AWS CloudFormation peut créer des ressources IAM* ».
1. Sélectionnez **Créer la pile**.
1. Sur la page suivante, cliquez sur l'icône d'actualisation aussi souvent que vous le souhaitez jusqu'à ce que le statut de la pile soit CREATE\$1COMPLETE.
## Configuration manuelle de Kinesis dans la console
1. Connectez-vous à la console de AWS gestion et ouvrez la console Kinesis à l'adresse /kinesis. https://console.aws.amazon.com
1. Choisissez **Delivery streams** dans le volet de navigation.
1. Sélectionnez **Create delivery Stream (Créer un flux de diffusion)**.
1. Dans Source, sélectionnez **Amazon Kinesis Data Streams**.
1. Pour Destination, sélectionnez **Amazon S3**.
1. Sous **Paramètres source, flux de données Kinesis, entrez l'ARN de votre flux** de données Kinesis.
1. Dans **Nom du flux de diffusion**, entrez le nom de votre flux de données Kinesis.
1. Dans **Paramètres de destination**, choisissez un compartiment Amazon S3 ou entrez un URI de compartiment.
1. (facultatif) Activez le partitionnement dynamique à l'aide de l'analyse syntaxique intégrée pour JSON. Cette option est appropriée si vous souhaitez partitionner les données de mesure du streaming en fonction des informations de source et de l'horodatage. Par exemple :
+ Choisissez **Activé** pour le **partitionnement dynamique**.
+ Choisissez **Activé** pour **Nouveau délimiteur de ligne**.
+ Choisissez **Activé** pour l'**analyse en ligne pour JSON**.
+ Sous **Clés de partitionnement dynamique**, ajoutez :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/kinesis-store-S3.html)
1. Choisissez **Appliquer les clés de partitionnement dynamiques** et vérifiez que le préfixe du compartiment Amazon S3 généré est bien. `!{partitionKeyFromQuery:project}/!{partitionKeyFromQuery:site}/!{partitionKeyFromQuery:time}/`
1. Dans Amazon S3, les objets utiliseront le format de clé suivant : `/project={projectName}/site={siteName}/time={yyyy-mm-dd 00:00:00}/{filename}`
1. Sélectionnez **Create delivery Stream (Créer un flux de diffusion)**.
1. (facultatif) Utilisez un chemin plus détaillé.
Si vous avez choisi une partition dynamique, utilisez le format de clé Amazon S3 précédent si vous prévoyez d'utiliser AWS Glue Athena pour interroger les données. Vous pouvez également choisir un format de clé plus fin, mais la requête Amazon Athena ne sera pas efficace. Voici un exemple de configuration d'un chemin clé Amazon S3 plus fin.
Sous **Clés de partitionnement dynamique**, ajoutez :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/kinesis-store-S3.html)
Dans Amazon S3, les objets utiliseront le format de clé suivant : ` /project={projectName}/site={siteName}/asset={assetName}/position={positionName}/sensor={sensorId}/date={yyyy-mm-dd}/time={HH:MM:SS}/{filename}`
# Traitement des données avec Lambda
**Topics**
+ [Étape 1 : créer le [rôle IAM](https://docs.aws.amazon.com//lambda/latest/dg/lambda-intro-execution-role.html) qui autorise votre fonction à accéder aux ressources AWS](#create-iam-role)
+ [Étape 2 : Création de la fonction Lambda](#create-lambda-function)
+ [Étape 3 : Configuration de la fonction Lambda](#configure-lambda-function)
+ [Étape 4 : activer le déclencheur Kinesis dans la console AWS Lambda](#enable-lambda-trigger)
## Étape 1 : créer le [rôle IAM](https://docs.aws.amazon.com//lambda/latest/dg/lambda-intro-execution-role.html) qui autorise votre fonction à accéder aux ressources AWS
1. Ouvrez la page [Roles (Rôles)](https://console.aws.amazon.com/iam/home?#/roles) dans la console IAM.
1. Sélectionnez **Créer un rôle**.
1. Créez un rôle avec les propriétés suivantes :
+ Entité de confiance : Lambda
+ Autorisations : AWSLambda KinesisExecutionRole (et AWSKey ManagementServicePowerUser si le flux Kinesis est crypté)
+ Nom du rôle : lambda-kinesis-role
![\[IAM role creation interface showing name, review, and create steps with role details and permissions.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/lambda-create-role.png)
## Étape 2 : Création de la fonction Lambda
1. Ouvrez la **page Fonctions** de la console Lambda.
1. Sélectionnez **Créer une fonction**.
1. Choisissez **Utiliser un plan**.
1. Dans la barre de recherche **Blueprints**, recherchez et choisissez **kinesis-process-record (nodejs**) ou. **kinesis-process-record-python**
1. Choisissez **Configurer**.
![\[Create function interface with options to author from scratch, use a blueprint, or select container image.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/lambda-create-function.png)
## Étape 3 : Configuration de la fonction Lambda
1. Choisissez le **nom de la fonction**
1. Choisissez le rôle créé lors de la première étape comme **rôle d'exécution**.
1. Configurez le déclencheur Kinesis.
1. Choisissez votre flux Kinesis.
1. Cliquez sur **Créer une fonction**.
![\[Lambda function configuration form with basic information and Kinesis trigger settings.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/lambda-kinesis-trigger.png)
## Étape 4 : activer le déclencheur Kinesis dans la console AWS Lambda
1. Dans l'onglet **Configuration**, sélectionnez **Déclencheurs**.
1. **Cochez la case à côté du nom du flux Kinesis et choisissez Enable.**
![\[Lambda function configuration page with Triggers tab and Kinesis stream trigger highlighted.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/kinesis-process-record-lambda.png)
Le plan utilisé dans cet exemple ne consomme que les données du journal du flux sélectionné. Vous pouvez modifier ultérieurement le code de fonction Lambda pour effectuer une tâche plus complexe.
# Comprendre le schéma d'exportation de données v1
**Note**
Le schéma d'exportation de données Amazon Monitron Kinesis v1 est devenu obsolète. En savoir plus sur le [schéma d'exportation de données v2](monitron-kinesis-export-v2.md).
Chaque donnée de mesure et le résultat d'inférence correspondant sont exportés sous la forme d'un enregistrement de flux de données Kinesis au format JSON.
**Topics**
+ [format de schéma v1](#data-export-schema-format)
+ [paramètres du schéma v1](#data-export-schema-parameters)
## format de schéma v1
```
{
"timestamp": "string",
"eventId": "string",
"version": "string",
"projectDisplayName": "string",
"siteDisplayName": "string",
"assetDisplayName": "string",
"sensorPositionDisplayName": "string",
"sensor": {
"physicalId": "string",
"rssi": number
},
"gateway": {
"physicalId": "string"
},
"measurement": {
"features": {
"acceleration": {
"band0To6000Hz": {
"xAxis": {
"rms": number
},
"yAxis": {
"rms": number
},
"zAxis": {
"rms": number
}
},
"band10To1000Hz": {
"resultantVector": {
"absMax": number,
"absMin": number,
"crestFactor": number,
"rms": number
},
"xAxis": {
"rms": number
},
"yAxis": {
"rms": number
},
"zAxis": {
"rms": number
}
}
},
"temperature": number,
"velocity": {
"band10To1000Hz": {
"resultantVector": {
"absMax": number,
"absMin": number,
"crestFactor": number,
"rms": number
},
"xAxis": {
"rms": number
},
"yAxis": {
"rms": number
},
"zAxis": {
"rms": number
}
}
}
},
"sequenceNo": number
},
"models": {
"temperatureML": {
"persistentClassificationOutput": "string",
"pointwiseClassificationOutput": "string"
},
"vibrationISO": {
"isoClass": "string",
"mutedThreshold": "string",
"persistentClassificationOutput": "string",
"pointwiseClassificationOutput": "string"
},
"vibrationML": {
"persistentClassificationOutput": "string",
"pointwiseClassificationOutput": "string"
}
},
"assetState": {
"newState": "string",
"previousState": "string"
}
}
```
## paramètres du schéma v1
timestamp
+ L'horodatage lorsque la mesure est reçue par le service Monitron en UTC
+ Type : Chaîne
+ Motif : yyyy-mm-dd HH:MM:SS.SSS
eventId
+ L'identifiant unique de l'événement d'exportation de données attribué à chaque mesure. Peut être utilisé pour dédupliquer les enregistrements de flux Kinesis reçus.
+ Type : Chaîne
version
+ Version du schéma
+ Type : Chaîne
+ Valeur actuelle : 1,0
projectDisplayName
+ Le nom du projet affiché dans l'application et la console
+ Type : Chaîne
siteDisplayName
+ Le nom du site affiché dans l'application
+ Type : Chaîne
assetDisplayName
+ Le nom de l'actif affiché dans l'application
+ Type : Chaîne
sensorPositionDisplayNom
+ Le nom de la position du capteur affiché dans l'application
+ Type : Chaîne
Capteur.PhysicalID
+ L'identifiant physique du capteur à partir duquel la mesure est envoyée
+ Type : Chaîne
capteur.rssi
+ Le capteur Bluetooth a reçu la valeur de l'indicateur d'intensité du signal
+ Type : Number
+ Unité : dBm
Gateway.PhysicalID
+ L'identifiant physique de la passerelle utilisée pour transmettre les données au service Amazon Monitron
+ Type : Chaîne
Mesure. Caractéristiques. Accélération. Bande de 0 à 6000 Hz. Axis. RMS
+ La valeur quadratique moyenne de l'accélération observée dans la bande de fréquences comprise entre 0 et 6 000 Hz sur l'axe x.
+ Type : Number
+ Unité : m/s^2
Mesure. Caractéristiques. Accélération. Bande de 0 à 6000 Hz.Yaxis.RMS
+ La valeur quadratique moyenne de l'accélération observée dans la bande de fréquences comprise entre 0 et 6 000 Hz sur l'axe y.
+ Type : Number
+ Unité : m/s^2
Mesure. Caractéristiques. Accélération. Bande de 0 à 6000 Hz. axe Z. RMS
+ La valeur quadratique moyenne de l'accélération observée dans la bande de fréquences comprise entre 0 et 6 000 Hz sur l'axe y.
+ Type : Number
+ Unité : m/s^2
Mesure. Caractéristiques. Accélération. Bande de 10 à 1000 Hz. Vecteur résultant. ABSmax
+ Accélération maximale absolue observée dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
+ Unité : m/s^2
Mesure. Caractéristiques. Accélération. Bande de 10 à 1000 Hz. Vecteur résultant. ABSmin
+ Accélération minimale absolue observée dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
+ Unité : m/s^2
Mesure. Caractéristiques. Accélération. Bande de 10 à 1000 Hz. Vecteur résultant. CrestFactor
+ Le facteur de crête d'accélération observé dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
Mesure. Caractéristiques. Accélération. Bande de 10 à 1000 Hz. Vecteur résultant. RMS
+ La moyenne quadratique de l'accélération observée dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
+ m/s^2
Mesure. Caractéristiques. Accélération. Bande de 10 à 1000 Hz. Axis. RMS
+ La racine carrée moyenne de l'accélération observée dans la bande de fréquences de 10 à 1 000 Hz sur l'axe x
+ Type : Number
+ m/s^2
Mesure. Caractéristiques. Accélération. Bande 10 à 1000 Hz. axe Y. RMS
+ La racine carrée moyenne de l'accélération observée dans la bande de fréquences 10—1 000 Hz sur l'axe y.
+ Type : Number
+ m/s^2
Mesure. Caractéristiques. Accélération. Bande 10 à 1000 Hz. axe Z. RMS
+ La racine carrée moyenne de l'accélération observée dans la bande de fréquences de 10 à 1 000 Hz sur l'axe z
+ Type : Number
+ m/s^2
mesure.caractéristiques.température
+ La température observée
+ Type : Number
+ °C/degrés C
Mesure. Caractéristiques. Vitesse. Bande 10 à 1000 Hz. Vecteur résultant. ABSmax
+ Vitesse maximale absolue observée dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
+ mm/s
Mesure. Caractéristiques. Vitesse. Bande 10 à 1000 Hz. Vecteur résultant. ABSmin
+ Vitesse minimale absolue observée dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
+ mm/s
Mesure. Caractéristiques. Vitesse. Bande 10 à 1000 Hz. Vecteur résultant. CrestFactor
+ Le facteur de crête de vitesse observé dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
Mesure. Caractéristiques. Vitesse. Bande 10 à 1000 Hz. Vecteur résultant. RMS
+ La racine carrée moyenne de la vitesse observée dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
+ mm/s
Mesure. Caractéristiques. Vitesse. Bande 10 à 1000 Hz. Axis. RMS
+ La racine carrée moyenne de la vitesse observée dans la bande de fréquences de 10 à 1 000 Hz sur l'axe x
+ Type : Number
+ mm/s
Mesure. Caractéristiques. Vitesse. Bande 10 à 1000 Hz. axe Y. RMS
+ La racine carrée moyenne de la vitesse observée dans la bande de fréquences 10—1 000 Hz sur l'axe y.
+ Type : Number
+ mm/s
Mesure. Caractéristiques. Vitesse. Bande 10 à 1000 Hz. axe Z. RMS
+ La racine carrée moyenne de la vitesse observée dans la bande de fréquences de 10 à 1 000 Hz sur l'axe z
+ Type : Number
+ mm/s
Mesure. Séquence Non
+ Le numéro de séquence de mesure
+ Type : Number
Modèles. TemperatureML. persistentClassificationOutput
+ La sortie de classification persistante du modèle de température basé sur l'apprentissage automatique
+ Type : Number
+ Valeurs valides : `UNKNOWN | HEALTHY | WARNING | ALARM`
Modèles. TemperatureML. pointwiseClassificationOutput
+ La sortie de classification par points du modèle de température basé sur l'apprentissage automatique
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM`
Modèles : vibration, ISO, classe ISO
+ La classe ISO 20816 (une norme pour la mesure et l'évaluation des vibrations des machines) utilisée par le modèle de vibration basé sur l'ISO
+ Type : Chaîne
+ Valeurs valides : `CLASS1 | CLASS2 | CLASS3 | CLASS4 | FAN_BV2`
Modèles. Vibration ISO. MutedThreshold
+ Le seuil pour désactiver la notification à partir du modèle de vibration basé sur l'ISO
+ Type : Chaîne
+ Valeurs valides : `WARNING | ALARM`
Modèles.vibrationISO. persistentClassificationOutput
+ La sortie de classification persistante du modèle de vibration basé sur la norme ISO
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | HEALTHY | WARNING | ALARM`
Modèles.vibrationISO. pointwiseClassificationOutput
+ La sortie de classification par points du modèle de vibration basé sur l'ISO
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | HEALTHY | WARNING | ALARM | MUTED_WARNING | MUTED_ALARM`
Modèles.vibrationML. persistentClassificationOutput
+ La sortie de classification persistante du modèle de vibration basé sur l'apprentissage automatique
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | HEALTHY | WARNING | ALARM`
Modèles.vibrationML. pointwiseClassificationOutput
+ Le résultat de classification par points issu du modèle de vibration basé sur l'apprentissage automatique
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM`
AssetState.NewState
+ L'état de la machine après le traitement de la mesure
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM`
AssetState.PreviousState
+ État de la machine avant le traitement de la mesure
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM`
# Exportation de données Amazon Monitron Kinesis v2
Vous pouvez exporter les données de mesure entrantes et les résultats d'inférence correspondants depuis Amazon Monitron et effectuer une analyse en temps réel. L'exportation de données diffuse des données en direct vers Kinesis.
**Topics**
+ [Exportation de vos données vers un flux Kinesis](#exporting-stream-procedure-v2)
+ [Modification des paramètres d'exportation de données en temps réel](#edit-live-export-v2)
+ [Arrêt d'une exportation de données en direct](#stop-kinesis-export-v2)
+ [Affichage des erreurs d'exportation de données](#viewing-kinesis-export-errors-v2)
+ [Utiliser le chiffrement côté serveur pour le flux Kinesis](#data-export-server-side-encryption-v2)
+ [Surveillance avec Amazon CloudWatch Logs](data-export-cloudwatch-logs-v2.md)
+ [Stockage des données exportées dans Amazon S3](kinesis-store-S3-v2.md)
+ [Traitement des données avec Lambda](data-export-lambda-v2.md)
+ [Comprendre le schéma d'exportation de données v2](data-export-schema-v2.md)
+ [Migration de Kinesis v1 vers v2](migration-from-v1-to-v2.md)
## Exportation de vos données vers un flux Kinesis
1. Sur la page principale de votre projet, en bas de page, sur la droite, choisissez **Démarrer l'exportation des données en direct**.
1. Sous **Sélectionner le flux de données Kinesis, effectuez** l'une des opérations suivantes :
+ Entrez le nom d'un flux existant dans le champ de recherche. Passez ensuite à l'étape 5.
+ Choisissez **Créer un nouveau flux de données**.
1. Sur la page **Créer un flux de données**, sous **Configuration du flux de données**, entrez le nom de votre flux de données.
1. Sous Capacité du flux de données, choisissez votre mode de capacité :
+ Si les exigences de débit de votre flux de données sont imprévisibles et variables, choisissez **On-Demand.**
+ Si vous pouvez estimer de manière fiable les exigences de débit de votre flux de données, choisissez **Provisioned**. **Ensuite, sous Partitions provisionnées, entrez le nombre de partitions que vous souhaitez créer ou choisissez l'estimateur de partitions.**
1. Choisissez **Create data stream (Créer un flux de données)**.
## Modification des paramètres d'exportation de données en temps réel
Pour modifier vos paramètres d'exportation de données en temps réel :
1. Ouvrez la console Amazon Monitron.
1. Choisissez **Projets** dans le volet de navigation.
1. Si vous avez plusieurs projets, choisissez le projet pour lequel vous souhaitez modifier les paramètres d'exportation.
1. Sur la page principale de votre projet, sous **Exportation de données en direct**, dans le menu déroulant **Actions**, choisissez **Modifier les paramètres d'exportation de données en direct**.
## Arrêt d'une exportation de données en direct
1. Ouvrez la console Amazon Monitron.
1. Choisissez **Projets** dans le volet de navigation.
1. Si vous avez plusieurs projets, choisissez le projet pour lequel vous souhaitez modifier les paramètres d'exportation.
1. Sur la page principale de votre projet, sous **Exportation de données en direct**, dans le menu déroulant **Actions**, choisissez **Arrêter l'exportation de données en direct**.
1. Dans la fenêtre contextuelle, choisissez **Stop**.
## Affichage des erreurs d'exportation de données
Pour afficher les messages d'erreur dans l'interface CloudWatch Logs :
+ Sur la console Amazon Monitron, depuis la page principale de votre projet, sous **Exportation de données en direct**, choisissez un groupe de **CloudWatch journaux**.
## Utiliser le chiffrement côté serveur pour le flux Kinesis
Vous pouvez activer le chiffrement côté serveur pour votre flux Kinesis avant de configurer l'exportation des données Kinesis. Toutefois, si le chiffrement côté serveur est activé après la configuration de l'exportation des données Kinesis, Amazon Monitron ne sera pas en mesure de publier sur le flux. Cela est dû au fait qu'Amazon Monitron ne sera pas autorisé à appeler [kms : GenerateDataKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKey.html) afin de chiffrer les données envoyées à Kinesis.
Pour contourner ce problème, suivez les instructions ci-dessous[Modification des paramètres d'exportation de données en temps réel](#edit-live-export-v2), mais sans modifier la configuration. Cela associera le chiffrement que vous avez configuré à votre configuration d'exportation.
# Surveillance avec Amazon CloudWatch Logs
Vous pouvez surveiller l'exportation des données en direct d'Amazon Monitron à l'aide d'Amazon CloudWatch Logs. Lorsqu'une mesure ne parvient pas à être exportée, Amazon Monitron envoie un événement de journal à vos CloudWatch journaux. Vous pouvez également configurer un filtre métrique dans le journal des erreurs pour générer des métriques et configurer des alarmes. Une alarme peut surveiller certains seuils et envoyer des notifications ou prendre des mesures lorsque ces seuils sont atteints. Pour plus d'informations, consultez [le guide de CloudWatch l'utilisateur](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html).
Amazon Monitron envoie les événements de journal au groupe de journaux/aws/monitron/data-export/ \$1HASH\$1ID\$1.
L'événement du journal a le format JSON suivant :
```
{
"assetName": "string",
"destination": "string",
"errorCode": "string",
"errorMessage": "string",
"eventId": "string",
"eventType": "string",
"positionName": "string",
"projectName": "string",
"projectId": "string",
"sensorId": "string",
"gatewayId": "string",
"siteName": "string",
"timestamp": "string"
}
```
Nom de l'actif
+ Le nom de la ressource affiché dans l'application
+ Type : Chaîne
destination
+ L'ARN du flux de données Kinesis
+ Type : Chaîne
+ Modèle : arn:aws:kinesis : \$1\$1REGION\$1\$1 : \$1\$1AWS\$1ACCOUNT\$1ID\$1\$1 :stream/ \$1\$1STREAM\$1NAME\$1\$1
errorCode
+ Le code d'erreur
+ Type : Chaîne
+ Valeurs valides : `INTERNAL_SEVER_ERROR | KINESIS_RESOURCE_NOT_FOUND | KINESIS_PROVISIONED_THROUGHPUT_EXCEEDED | KMS_ACCESS_DENIED | KMS_NOT_FOUND | KMS_DISABLED | KMS_INVALID_STATE | KMS_THROTTLING`
errorMessage
+ Le message d'erreur détaillé
+ Type : Chaîne
eventId
+ L'identifiant d'événement unique correspondant à chaque exportation de mesure
+ Type : Chaîne
eventType
+ Type d'événement en cours
+ Type : Chaîne
+ Valeurs valides : `measurement` ` | gatewayConnected` ` | gatewayDisconnected` ` | sensorConnected` ` | sensorDisconnected` ` | assetStateTransition`
Nom du poste
+ Le nom de la position du capteur affiché dans l'application
+ Type : Chaîne
projectName
+ Le nom du projet affiché dans l'application et la console
+ Type : Chaîne
ID du projet
+ L'identifiant de projet unique correspondant au projet Amazon Monitron
+ Type : Chaîne
ID du capteur
+ L'identifiant physique du capteur à partir duquel la mesure est envoyée
+ Type : Chaîne
ID de passerelle
+ L'identifiant physique de la passerelle utilisée pour transmettre les données au service Amazon Monitron
+ Type : Chaîne
siteName
+ Le nom du site affiché dans l'application
+ Type : Chaîne
timestamp
+ Horodatage de réception de la mesure par le service Amazon Monitron en UTC
+ Type : Chaîne
+ Motif : yyyy-mm-dd HH:MM:SS.SSS
# Stockage des données exportées dans Amazon S3
Si vous souhaitez stocker vos données exportées dans Amazon S3, suivez la procédure suivante.
**Topics**
+ [Configuration manuelle de Kinesis dans la console](#kinesis-configure-console-v2)
## Configuration manuelle de Kinesis dans la console
1. Connectez-vous à la console de AWS gestion et ouvrez la console Kinesis à l'adresse /kinesis. https://console.aws.amazon.com
1. Choisissez **Delivery streams** dans le volet de navigation.
1. Sélectionnez **Create delivery Stream (Créer un flux de diffusion)**.
1. Dans Source, sélectionnez **Amazon Kinesis Data Streams**.
1. Pour Destination, sélectionnez **Amazon S3**.
1. Sous **Paramètres source, flux de données Kinesis, entrez l'ARN de votre flux** de données Kinesis.
1. Dans **Nom du flux de diffusion**, entrez le nom de votre flux de données Kinesis.
1. Dans **Paramètres de destination**, choisissez un compartiment Amazon S3 ou entrez un URI de compartiment.
1. (facultatif) Activez le partitionnement dynamique à l'aide de l'analyse syntaxique intégrée pour JSON. Cette option est appropriée si vous souhaitez partitionner les données de mesure du streaming en fonction des informations de source et de l'horodatage. Par exemple :
+ Choisissez **Activé** pour le **partitionnement dynamique**.
+ Choisissez **Activé** pour **Nouveau délimiteur de ligne**.
+ Choisissez **Activé** pour l'**analyse en ligne pour JSON**.
+ Sous **Clés de partitionnement dynamique**, ajoutez :
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/kinesis-store-S3-v2.html)
1. Choisissez **Appliquer les clés de partitionnement dynamiques** et vérifiez que le préfixe du compartiment Amazon S3 généré est bien. `!{partitionKeyFromQuery:project}/!{partitionKeyFromQuery:site}/!{partitionKeyFromQuery:time}/`
1. Dans Amazon S3, les objets utiliseront le format de clé suivant : `/project={projectName}/site={siteName}/time={yyyy-mm-dd 00:00:00}/{filename}`
1. Sélectionnez **Create delivery Stream (Créer un flux de diffusion)**.
# Traitement des données avec Lambda
**Topics**
+ [Étape 1 : créer le [rôle IAM](https://docs.aws.amazon.com//lambda/latest/dg/lambda-intro-execution-role.html) qui autorise votre fonction à accéder aux ressources AWS](#data-export-lambda-v2-1)
+ [Étape 2 : Création de la fonction Lambda](#create-lambda-function-v2)
+ [Étape 3 : Configuration de la fonction Lambda](#configure-lambda-function-v2)
+ [Étape 4 : activer le déclencheur Kinesis dans la console AWS Lambda](#configure-kinesis-trigger-v2)
## Étape 1 : créer le [rôle IAM](https://docs.aws.amazon.com//lambda/latest/dg/lambda-intro-execution-role.html) qui autorise votre fonction à accéder aux ressources AWS
1. Ouvrez la page [Roles (Rôles)](https://console.aws.amazon.com/iam/home?#/roles) dans la console IAM.
1. Choisissez **Créer un rôle**.
1. Sur la page **Select trusted entity** (Sélectionner une entité de confiance), procédez comme suit :
+ Dans **Type d'entité fiable**, sélectionnez **AWS service**.
+ Dans **Cas d'utilisation**, pour **Service ou cas d'utilisation**, choisissez **Lambda**.
+ Choisissez **Suivant**.
![\[IAM role creation interface showing trusted entity selection with Service AWS option chosen.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/lambda-role-1.png)
1. Sur la page **Ajouter des autorisations**, procédez comme suit :
+ Dans **Politiques d'autorisations**, choisissez AWSLambda KinesisExecutionRole (et AWSKey ManagementServicePowerUser si le flux Kinesis est crypté).
+ Laissez les configurations dans **Définir les limites des autorisations** telles quelles.
+ Choisissez **Suivant**.
![\[Add permissions interface showing AWSLambdaKinesisExecutionRole policy selected for a new role.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/lambda-role-2.png)
1. Dans la page **Nom, révision et création**, procédez comme suit :
+ Dans **Détails du rôle**, dans **Nom du rôle**, entrez le nom de votre rôle. Par exemple *lambda-kinesis-role*. Vous pouvez également choisir d'ajouter une **description** facultative.
+ Conservez les paramètres pour **Étape 1 : Sélectionnez les entités de confiance** et **Étape 2 : Ajouter les autorisations** telles quelles. Vous pouvez choisir d'ajouter des balises à **l'étape 3 : Ajouter des balises** pour suivre vos ressources.
![\[IAM role creation interface showing name, review, and create steps with role details and permissions.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/lambda-create-role.png)
1. Sélectionnez **Créer le rôle**.
## Étape 2 : Création de la fonction Lambda
1. Ouvrez la **page Fonctions** de la console Lambda.
1. Sélectionnez **Créer une fonction**.
1. Choisissez **Utiliser un plan**.
1. Dans la barre de recherche **Blueprints**, recherchez et choisissez **kinesis-process-record (nodejs**) ou. **kinesis-process-record-python**
1. Choisissez **Configurer**.
![\[Create function interface with options to author from scratch, use a blueprint, or select container image.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/lambda-create-function.png)
## Étape 3 : Configuration de la fonction Lambda
1. Choisissez le **nom de la fonction**
1. Choisissez le rôle créé lors de la première étape comme **rôle d'exécution**.
1. Configurez le déclencheur Kinesis.
1. Choisissez votre flux Kinesis.
1. Cliquez sur **Créer une fonction**.
![\[Lambda function configuration form with basic information and Kinesis trigger settings.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/lambda-kinesis-trigger.png)
## Étape 4 : activer le déclencheur Kinesis dans la console AWS Lambda
1. Dans l'onglet **Configuration**, sélectionnez **Déclencheurs**.
1. **Cochez la case à côté du nom du flux Kinesis et choisissez Enable.**
![\[Lambda function configuration page with Triggers tab and Kinesis stream trigger highlighted.\]](http://docs.aws.amazon.com/fr_fr/Monitron/latest/user-guide/images/kinesis-process-record-lambda.png)
Le plan utilisé dans cet exemple ne consomme que les données du journal du flux sélectionné. Vous pouvez modifier ultérieurement le code de fonction Lambda pour effectuer une tâche plus complexe.
# Comprendre le schéma d'exportation de données v2
Chaque donnée de mesure, le résultat d'inférence correspondant et les connect/disconnect, and sensor connect/disconnect événements de passerelle sont exportés sous la forme d'un enregistrement de flux de données Kinesis au format JSON.
**Topics**
+ [format de schéma v2](#data-export-schema-format-v2)
+ [paramètres du schéma v2](#data-export-schema-parameters-v2)
## format de schéma v2
```
{
"timestamp": "string",
"eventId": "string",
"version": "2.0",
"accountId": "string",
"projectName": "string",
"projectId": "string",
"eventType": "measurement|gatewayConnected|gatewayDisconnected|sensorConnected|sensorDisconnected|assetStateTransition",
// measurement
"eventPayload": {
"siteName": "string",
"assetName": "string",
"positionName": "string",
"companyName": "string",
"geoLocation": {
"latitude": number,
"longitude": number
},
"address": "string",
"serialNumber": "string",
"make": "string",
"model": "string",
"assetPositionURL": "string",
"sensor": {
"physicalId": "string",
"rssi": number
},
"gateway": {
"physicalId": "string"
},
"sequenceNo": number,
"features": {
"acceleration": {
"band0To6000Hz": {
"xAxis": {
"rms": number
},
"yAxis": {
"rms": number
},
"zAxis": {
"rms": number
}
},
"band10To1000Hz": {
"totalVibration": {
"absMax": number,
"absMin": number,
"crestFactor": number,
"rms": number
},
"xAxis": {
"rms": number
},
"yAxis": {
"rms": number
},
"zAxis": {
"rms": number
}
}
},
"velocity": {
"band10To1000Hz": {
"totalVibration": {
"absMax": number,
"absMin": number,
"crestFactor": number,
"rms": number
},
"xAxis": {
"rms": number
},
"yAxis": {
"rms": number
},
"zAxis": {
"rms": number
}
}
},
"temperature": number
}
"models": {
"temperatureML": {
"previousPersistentClassificationOutput": "string",
"persistentClassificationOutput": "string",
"pointwiseClassificationOutput": "string"
},
"vibrationISO": {
"isoClass": "string",
"mutedThreshold": "string",
"previousPersistentClassificationOutput": "string",
"persistentClassificationOutput": "string",
"pointwiseClassificationOutput": "string"
},
"vibrationML": {
"previousPersistentClassificationOutput": "string",
"persistentClassificationOutput": "string",
"pointwiseClassificationOutput": "string"
}
},
"assetPositionId": "string"
}
// sensorConnected
"eventPayload": {
"siteName": "string",
"assetName": "string",
"positionName": "string",
"companyName": "string",
"geoLocation": {
"latitude": number,
"longitude": number
},
"address": "string",
"serialNumber": "string",
"make": "string",
"model": "string",
"assetPositionURL": "string",
"sensor": {
"physicalId": "string"
},
"assetPositionId": "string"
}
// sensorDisconnected
"eventPayload": {
"siteName": "string",
"assetName": "string",
"positionName": "string",
"companyName": "string",
"geoLocation": {
"latitude": number,
"longitude": number
},
"address": "string",
"serialNumber": "string",
"make": "string",
"model": "string",
"assetPositionURL": "string",
"sensor": {
"physicalId": "string"
},
"assetPositionId": "string"
}
// gatewayConnected
"eventPayload": {
"siteName": "string",
"gatewayName": "string",
"gatewayListURL": "string",
"companyName": "string",
"geoLocation": {
"latitude": number,
"longitude": number
},
"address": "string",
"gateway": {
"physicalId": "string"
}
}
// gatewayDisconnected
"eventPayload": {
"siteName": "string",
"gatewayName": "string",
"gatewayListURL": "string",
"companyName": "string",
"geoLocation": {
"latitude": number,
"longitude": number
},
"address": "string",
"gateway": {
"physicalId": "string"
}
}
// assetStateTransition
"eventPayload": {
"siteName": "string",
"assetName": "string",
"positionName": "string",
"companyName": "string",
"geoLocation": {
"latitude": number,
"longitude": number
},
"address": "string",
"serialNumber": "string",
"make": "string",
"model": "string",
"assetPositionURL": "string",
"sensor": {
"physicalId": "string"
},
"assetTransitionType": "measurement|userInput",
"assetState": {
"newState": "string",
"previousState": "string"
},
"closureCode": {
"failureMode": "string",
"failureCause": "string",
"actionTaken": "string",
"resolvedModels": list<"string">
},
"assetPositionId": "string"
}
}
```
## paramètres du schéma v2
Le schéma d'exportation de données Amazon Monitron Kinesis v2 inclut les paramètres de schéma suivants. Certains paramètres sont des mises à jour depuis la v1 et d'autres sont uniques à la v2. Par exemple, `siteName` était un paramètre de premier niveau dans la version 1. En v2, il s'agit d'un paramètre de second niveau qui se trouve sous l'`eventPayload`entité.
timestamp
+ Horodatage de réception de la mesure par le service Amazon Monitron en UTC
+ Type : Chaîne
+ Motif : yyyy-mm-dd HH:MM:SS.SSS
eventId
+ L'identifiant unique de l'événement d'exportation de données attribué à chaque mesure. Peut être utilisé pour dédupliquer les enregistrements de flux Kinesis reçus.
+ Type : Chaîne
version
+ Version du schéma
+ Type : Chaîne
+ Valeur : 1,0 ou 2,0
accountId
+ L'identifiant de AWS compte à 12 chiffres pour votre projet Monitron
+ Type : Chaîne
projectName
Le nom du projet affiché dans l'application et la console.
Type : Chaîne
projectId
L'identifiant unique de votre Amazon Monitron projet.
Type : Chaîne
eventType
+ Le flux de l'événement en cours. Chaque type d'événement aura un `eventPayload` format dédié.
+ Type : Chaîne
+ Valeurs possibles :`measurement`,`gatewayConnected`,`gatewayDisconnected`,`sensorConnected`,`sensorDisconnected`,`assetStateTransition`.
**`eventType: measurement`**
EventPayload.Features.Acceleration.Band 0 à 6 000 Hz.xaxis.rms
+ La valeur quadratique moyenne de l'accélération observée dans la bande de fréquences comprise entre 0 et 6 000 Hz sur l'axe x.
+ Type : Number
+ Unité : m/s^2
EventPayload.Features.Acceleration.Band 0 à 6 000 Hz. yaxis.rms
+ La valeur quadratique moyenne de l'accélération observée dans la bande de fréquences comprise entre 0 et 6 000 Hz sur l'axe y.
+ Type : Number
+ Unité : m/s^2
EventPayload.Features.Acceleration.Band 0 à 6000 Hz.zaxis.rms
+ La racine carrée moyenne de l'accélération observée dans la bande de fréquences de 0 à 6 000 Hz sur l'axe z.
+ Type : Number
+ Unité : m/s^2
EventPayload.Features.Acceleration.Band 10 à 1000 Hz.ResultantVector.absMax
+ Accélération maximale absolue observée dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
+ Unité : m/s^2
EventPayload.Features.Acceleration.Band 10 à 1000 Hz. ResultantVector.absmin
+ Accélération minimale absolue observée dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
+ Unité : m/s^2
EventPayload.Features.Acceleration.Band 10 à 1000 Hz. ResultantVector.CrestFactor
+ Le facteur de crête d'accélération observé dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
EventPayload.Features.Acceleration.Band 10 à 1000 Hz. ResultantVector.rms
+ La moyenne quadratique de l'accélération observée dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
+ m/s^2
EventPayload.Features.Acceleration.Band 10 à 1000 Hz.xaxis.rms
+ La racine carrée moyenne de l'accélération observée dans la bande de fréquences de 10 à 1 000 Hz sur l'axe x
+ Type : Number
+ m/s^2
EventPayload.Features.Acceleration.Band 10 à 1000 Hz.yaxis.rms
+ La racine carrée moyenne de l'accélération observée dans la bande de fréquences 10—1 000 Hz sur l'axe y.
+ Type : Number
+ m/s^2
EventPayload.Features.Acceleration.Band 10 à 1000 Hz.zaxis.rms
+ La racine carrée moyenne de l'accélération observée dans la bande de fréquences de 10 à 1 000 Hz sur l'axe z
+ Type : Number
+ m/s^2
EventPayload.Features.Temperature
+ La température observée
+ Type : Number
+ °C/degrés C
EventPayload.Features.Velocity.Band 10 à 1000 Hz. Vecteur résultant.absmax
+ Vitesse maximale absolue observée dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
+ mm/s
EventPayload.Features.Velocity.Band 10 à 1000 Hz. Vecteur résultant.absmin
+ Vitesse minimale absolue observée dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
+ mm/s
EventPayload.Features.Velocity.Band 10 à 1000 Hz.ResultantVector.CrestFactor
+ Le facteur de crête de vitesse observé dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
EventPayload.Features.Velocity.Band 10 à 1000 Hz. ResultantVector.rms
+ La racine carrée moyenne de la vitesse observée dans la bande de fréquences de 10 à 1 000 Hz
+ Type : Number
+ mm/s
EventPayload.Features.Velocity.Band 10 à 1000 hz.xaxis.rms
+ La racine carrée moyenne de la vitesse observée dans la bande de fréquences de 10 à 1 000 Hz sur l'axe x
+ Type : Number
+ mm/s
EventPayload.Features.Velocity.Band 10 à 1000 Hz.yaxis.rms
+ La racine carrée moyenne de la vitesse observée dans la bande de fréquences 10—1 000 Hz sur l'axe y.
+ Type : Number
+ mm/s
EventPayload.Features.Velocity.Band 10 à 1000 Hz.zaxis.rms
+ La racine carrée moyenne de la vitesse observée dans la bande de fréquences de 10 à 1 000 Hz sur l'axe z
+ Type : Number
+ mm/s
EventPayload.Sequence Non
+ Le numéro de séquence de mesure
+ Type : Number
Charge utile de l'événement. assetPositionId
+ Identifiant de la position du capteur pour laquelle la mesure est envoyée.
+ Type : Chaîne
EventPayload.CompanyName
+ Le nom de la société utilisant l'actif.
+ Type : Chaîne
EventPayload.Géolocalisation.Latitude
+ Latitude de l'emplacement physique du site.
+ Type : Number
EventPayload.Geolocation.Longitude
+ Longitude de l'emplacement physique du site.
+ Type : Number
EventPayload.Address
+ L'adresse du site.
+ Type : Chaîne
Charge utile de l'événement. Numéro de série
+ Le numéro de série de l'actif.
+ Type : Chaîne
Événement Payload.make
+ La marque de l'actif.
+ Type : Chaîne
EventPayload.model
+ Le modèle de l'actif.
+ Type : Chaîne
`eventType: sensorConnected`
siteName
+ Le nom du site affiché dans l'application
+ Type : Chaîne
Nom de l'actif
+ Le nom de la ressource affiché dans l'application
+ Type : Chaîne
Nom du poste
+ Le nom de la position du capteur affiché dans l'application
+ Type : Chaîne
URL de la position de l'actif
+ L'URL du capteur affichée dans l'application
+ Type : Chaîne
Identifiant physique
+ L'identifiant physique du capteur à partir duquel la mesure est envoyée
+ Type : Chaîne
Charge utile de l'événement. assetPositionId
+ Identifiant de la position du capteur dont l'état a changé.
+ Type : Chaîne
EventPayload.CompanyName
+ Le nom de la société utilisant l'actif.
+ Type : Chaîne
EventPayload.Géolocalisation.Latitude
+ Latitude de l'emplacement physique du site.
+ Type : Number
EventPayload.Geolocation.Longitude
+ Longitude de l'emplacement physique du site.
+ Type : Number
EventPayload.Address
+ L'adresse du site.
+ Type : Chaîne
Charge utile de l'événement. Numéro de série
+ Le numéro de série de l'actif.
+ Type : Chaîne
Événement Payload.make
+ La marque de l'actif.
+ Type : Chaîne
EventPayload.model
+ Le modèle de l'actif.
+ Type : Chaîne
`eventType: sensorDisconnected`
siteName
+ Le nom du site affiché dans l'application
+ Type : Chaîne
Nom de l'actif
+ Le nom de la ressource affiché dans l'application
+ Type : Chaîne
Nom du poste
+ Le nom de la position du capteur affiché dans l'application
+ Type : Chaîne
URL de la position de l'actif
+ L'URL du capteur affichée dans l'application
+ Type : Chaîne
Identifiant physique
+ L'identifiant physique du capteur à partir duquel la mesure est envoyée
+ Type : Chaîne
Charge utile de l'événement. assetPositionId
+ Identifiant de la position du capteur dont l'état a changé.
+ Type : Chaîne
EventPayload.CompanyName
+ Le nom de la société utilisant l'actif.
+ Type : Chaîne
EventPayload.Géolocalisation.Latitude
+ Latitude de l'emplacement physique du site.
+ Type : Number
EventPayload.Geolocation.Longitude
+ Longitude de l'emplacement physique du site.
+ Type : Number
EventPayload.Address
+ L'adresse du site.
+ Type : Chaîne
Charge utile de l'événement. Numéro de série
+ Le numéro de série de l'actif.
+ Type : Chaîne
Événement Payload.make
+ La marque de l'actif.
+ Type : Chaîne
EventPayload.model
+ Le modèle de l'actif.
+ Type : Chaîne
`eventType: gatewayConnected`
EventPayload.Nom du site
+ Le nom du site affiché dans l'application
+ Type : Chaîne
EventPayload.GatewayName
+ Le nom de la passerelle tel qu'il est affiché dans l'application
+ Type : Chaîne
EventPayload.GatewayListURL
+ URL de passerelle affichée dans l'application
+ Type : Chaîne
EventPayload.Gateway.PhysicalID
+ L'identifiant physique de la passerelle qui vient d'être connectée pour transmettre les données au service Amazon Monitron
+ Type : Chaîne
EventPayload.CompanyName
+ Le nom de la société utilisant l'actif.
+ Type : Chaîne
EventPayload.Géolocalisation.Latitude
+ Latitude de l'emplacement physique du site.
+ Type : Number
EventPayload.Geolocation.Longitude
+ Longitude de l'emplacement physique du site.
+ Type : Number
EventPayload.Address
+ L'adresse du site.
+ Type : Chaîne
`eventType: gatewayDisconnected`
siteName
+ Le nom du site affiché dans l'application
+ Type : Chaîne
Nom de la passerelle
+ Le nom de la passerelle tel qu'il est affiché dans l'application
+ Type : Chaîne
URL de la liste de passerelle
+ URL de passerelle affichée dans l'application
+ Type : Chaîne
Identifiant physique
+ L'identifiant physique de la passerelle qui vient d'être connectée pour transmettre les données au service Amazon Monitron
+ Type : Chaîne
EventPayload.CompanyName
+ Le nom de la société utilisant l'actif.
+ Type : Chaîne
EventPayload.Géolocalisation.Latitude
+ Latitude de l'emplacement physique du site.
+ Type : Number
EventPayload.Geolocation.Longitude
+ Longitude de l'emplacement physique du site.
+ Type : Number
EventPayload.Address
+ L'adresse du site.
+ Type : Chaîne
`eventType: assetStateTransition`
EventPayload.Nom du site
+ Le nom du site affiché dans l'application
+ Type : Chaîne
EventPayload.assetName
+ Le nom de la ressource affiché dans l'application
+ Type : Chaîne
EventPayload.PositionName
+ Le nom de la position du capteur affiché dans l'application
+ Type : Chaîne
URL de l'événement Payload.AssetPositionURL
+ L'URL du capteur affichée dans l'application
+ Type : Chaîne
EventPayload.Sensor.PhysicalID
+ L'identifiant physique du capteur à partir duquel la mesure est envoyée
+ Type : Chaîne
Charge utile de l'événement. assetTransitionType
+ La raison de la transition vers l'état des actifs
+ Type : Chaîne
+ Valeurs possibles : `measurement` ou `userInput`
EventPayload.AssetState.NewState
+ Le nouvel état de l'actif
+ Type : Chaîne
EventPayload.AssetState.PreviousState
+ L'état précédent de l'actif
+ Type : Chaîne
EventPayload.ClosureCode.FailureMode
+ Le mode de défaillance sélectionné par l'utilisateur lors de la confirmation de cet échec
+ Type : Chaîne
+ Valeurs possibles : `NO_ISSUE` `BLOCKAGE` \$1 `CAVITATION` \$1 `CORROSION` \$1 `DEPOSIT` \$1 `IMBALANCE` \$1 `LUBRICATION` \$1 `MISALIGNMENT` `OTHER` \$1 `RESONANCE` \$1 `ROTATING_LOOSENESS` \$1 `STRUCTURAL_LOOSENESS` \$1 `TRANSMITTED_FAULT` \$1 `UNDETERMINED`
EventPayload.ClosureCode.Cause de l'échec
+ La cause de l'échec, telle que sélectionnée par l'utilisateur dans la liste déroulante de l'application lorsqu'il reconnaît l'échec.
+ Type : Chaîne
+ Valeurs possibles : `ADMINISTRATION` \$1 `DESIGN` `FABRICATION` \$1 `MAINTENANCE` \$1 `OPERATION` \$1 `OTHER` \$1 `QUALITY` \$1 `UNDETERMINED` \$1 `WEAR`
EventPayload.ClosureCode.ActionTaken
+ Action prise lors de la fermeture de cette anomalie, telle que sélectionnée par l'utilisateur dans le menu déroulant de l'application.
+ Type : Chaîne
+ Valeurs possibles : `ADJUST` \$1 `CLEAN` \$1 `LUBRICATE` \$1 `MODIFY` \$1 `NO_ACTION` \$1 `OTHER` \$1 `OVERHAUL` \$1 `REPLACE`
EventPayload.ClosureCode.ResolvedModels
+ L'ensemble de modèles qui a mis en évidence le problème.
+ Type : liste de chaînes
+ Valeurs possibles : `vibrationISO` \$1 `vibrationML` \$1 `temperatureML`
Charge utile de l'événement. assetPositionId
+ Identifiant de la position de l'actif dont l'état a changé.
+ Type : Chaîne
Modèles. TemperatureML. persistentClassificationOutput
+ La sortie de classification persistante du modèle de température basé sur l'apprentissage automatique
+ Type : Number
+ Valeurs valides : `UNKNOWN | HEALTHY | WARNING | ALARM`
Modèles. TemperatureML. pointwiseClassificationOutput
+ La sortie de classification par points du modèle de température basé sur l'apprentissage automatique
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM`
Modèles : vibration, ISO, classe ISO
+ La classe ISO 20816 (une norme pour la mesure et l'évaluation des vibrations des machines) utilisée par le modèle de vibration basé sur l'ISO
+ Type : Chaîne
+ Valeurs valides : `CLASS1 | CLASS2 | CLASS3 | CLASS4`
Modèles. Vibration ISO. MutedThreshold
+ Le seuil pour désactiver la notification à partir du modèle de vibration basé sur l'ISO
+ Type : Chaîne
+ Valeurs valides : `WARNING | ALARM`
Modèles.vibrationISO. persistentClassificationOutput
+ La sortie de classification persistante du modèle de vibration basé sur la norme ISO
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | HEALTHY | WARNING | ALARM`
Modèles.vibrationISO. pointwiseClassificationOutput
+ La sortie de classification par points du modèle de vibration basé sur l'ISO
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | HEALTHY | WARNING | ALARM | MUTED_WARNING | MUTED_ALARM`
Modèles.vibrationML. persistentClassificationOutput
+ La sortie de classification persistante du modèle de vibration basé sur l'apprentissage automatique
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | HEALTHY | WARNING | ALARM`
Modèles.vibrationML. pointwiseClassificationOutput
+ Le résultat de classification par points issu du modèle de vibration basé sur l'apprentissage automatique
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM`
AssetState.NewState
+ L'état de la machine après le traitement de la mesure
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM`
AssetState.PreviousState
+ État de la machine avant le traitement de la mesure
+ Type : Chaîne
+ Valeurs valides : `UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM`
EventPayload.CompanyName
+ Le nom de la société utilisant l'actif.
+ Type : Chaîne
EventPayload.Géolocalisation.Latitude
+ Latitude de l'emplacement physique du site.
+ Type : Number
EventPayload.Geolocation.Longitude
+ Longitude de l'emplacement physique du site.
+ Type : Number
EventPayload.Address
+ L'adresse du site.
+ Type : Chaîne
Charge utile de l'événement. Numéro de série
+ Le numéro de série de l'actif.
+ Type : Chaîne
Événement Payload.make
+ La marque de l'actif.
+ Type : Chaîne
EventPayload.model
+ Le modèle de l'actif.
+ Type : Chaîne
# Migration de Kinesis v1 vers v2
Si vous utilisez actuellement le schéma de données v1, vous êtes peut-être déjà en train d'envoyer des données à Amazon S3 ou de poursuivre le traitement de la charge utile du flux de données avec Lambda.
**Topics**
+ [Mise à jour du schéma de données vers la version v2](#updating-to-v2)
+ [Mettre à jour le traitement des données avec Lambda](#updating-with-lam)
## Mise à jour du schéma de données vers la version v2
Si vous avez déjà configuré un flux de données avec le schéma v1, vous pouvez mettre à jour votre processus d'exportation de données en procédant comme suit :
1. Ouvrez votre console Amazon Monitron.
1. Accédez à votre projet.
1. Arrêtez l'[exportation de données en direct en cours](monitron-kinesis-export-v2.md#stop-kinesis-export-v2).
1. Lancez l'exportation des données en direct pour créer un nouveau flux de données.
1. Sélectionnez le flux de données nouvellement créé.
1. Choisissez **Démarrer l'exportation des données en direct**. À ce stade, le nouveau schéma enverra votre charge utile via le flux de données.
1. (Facultatif) Accédez à la console Kinesis et supprimez votre ancien flux de données.
1. Configurez une nouvelle méthode de livraison pour votre flux de données nouvellement créé avec le schéma v2.
Votre nouveau flux fournit désormais des charges utiles conformes au schéma v2 à votre nouveau compartiment. Nous vous recommandons d'utiliser deux compartiments distincts pour obtenir un format cohérent au cas où vous souhaiteriez traiter toutes les données contenues dans ces compartiments. Par exemple, en utilisant d'autres services tels qu'Athena et. AWS Glue
**Note**
Si vous livriez vos données à Amazon S3, découvrez comment [stocker les données exportées dans Amazon S3](kinesis-store-S3-v2.md#kinesis-store-S3-title-v2) pour plus de détails sur la manière de transmettre vos données à Amazon S3 avec le schéma v2.
**Note**
Si vous utilisiez une fonction Lambda pour traiter vos charges utiles, découvrez comment [traiter les données avec](https://docs.aws.amazon.com/Monitron/latest/user-guide/data-export-lambda.html) Lambda. Vous pouvez également consulter la section sur la [mise à jour avec Lambda](#updating-with-lam) pour plus d'informations.
## Mettre à jour le traitement des données avec Lambda
Pour mettre à jour le traitement des données avec Lambda, vous devez tenir compte du fait que le flux de données v2 est désormais basé sur des événements. Votre code Lambda v1 initial était peut-être similaire au suivant :
```
import base64
def main_handler(event):
# Kinesis "data" blob is base64 encoded so decode here:
for record in event['Records']:
payload = base64.b64decode(record["kinesis"]["data"])
measurement = payload["measurement"]
projectDisplayName = payload["projectDisplayName"]
# Process the content of the measurement
# ...
```
Le schéma de données v1 étant sur le point d'être obsolète, le code Lambda précédent ne fonctionnera pas avec tous les nouveaux flux de données.
L'exemple de code Python suivant traitera les événements du flux Kinesis avec le schéma de données v2. Ce code utilise le nouveau `eventType` paramètre pour orienter le traitement vers le gestionnaire approprié :
```
import base64
handlers = {
"measurement": measurementEventHandler,
"gatewayConnected": gatewayConnectedEventHandler,
"gatewayDisconnected": gatewayDisconnectedEventHandler,
"sensorConnected": sensorConnectedEventHandler,
"sensorDisconnected": sensorDisconnectedEventHandler,
}
def main_handler(event):
# Kinesis "data" blob is base64 encoded so decode here:
for record in event['Records']:
payload = base64.b64decode(record["kinesis"]["data"])
eventType = payload["eventType"]
if eventType not in handler.keys():
log.info("No event handler found for the event type: {event['eventType']}")
return
# Invoke the appropriate handler based on the event type.
eventPayload = payload["eventPayload"]
eventHandler = handlers[eventType]
eventHandler(eventPayload)
def measurementEventHandler(measurementEventPayload):
# Handle measurement event
projectName = measurementEventPayload["projectName"]
# ...
def gatewayConnectedEventHandler(gatewayConnectedEventPayload):
# Handle gateway connected event
# Other event handler functions
```