Amazon Monitron non è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per funzionalità simili a Amazon Monitron, consulta il nostro [post sul blog](https://aws.amazon.com/blogs/machine-learning/maintain-access-and-consider-alternatives-for-amazon-monitron).
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Accesso ai dati di Amazon Monitron
Esistono due modi per accedere ai dati grezzi di Amazon Monitron al di fuori di Amazon Monitron.
Potresti voler accedere ai tuoi dati su base continuativa, in modo da poterli utilizzare altrove. In tal caso, puoi configurare Amazon Monitron per [aggiungere automaticamente i tuoi dati a uno stream Kinesis](/Monitron/latest/user-guide/monitron-kinesis-export.html). Da lì, puoi trasferirlo verso varie destinazioni, tra cui Amazon S3 e Lambda. Questo processo richiede una configurazione e tale configurazione richiede una conoscenza di Kinesis Data Streams. Tuttavia, una volta che tutti gli elementi sono stati sistemati in modo soddisfacente, è possibile mantenere lo streaming dei dati automaticamente.
Oppure potresti voler accedere ai tuoi dati di tanto in tanto, solo per avere una chiara comprensione del tipo di dati su AWS cui stai archiviando e analizzando. In tal caso, puoi chiedere all' AWS assistenza di [copiare manualmente i tuoi dati su Amazon S3](data-download-monitron.md). Questo processo richiede meno configurazioni, ma non può essere automatizzato. Fornisce solo i dati che Amazon Monitron ha accumulato fino ad ora, in un unico blocco.
**Topics**
+ [Esportazione dei dati di Amazon Monitron su Amazon S3](data-download-monitron.md)
+ [Esportazione dati Amazon Monitron Kinesis v1](monitron-kinesis-export.md)
+ [Esportazione dati Amazon Monitron Kinesis v2](monitron-kinesis-export-v2.md)
# Esportazione dei dati di Amazon Monitron su Amazon S3
A volte potresti voler accedere ai dati grezzi che Amazon Monitron archivia per te, per rimanere informato esattamente sul tipo di dati con cui stai archiviando in modo sicuro. AWS
Puoi ottenere i tuoi dati grezzi compilando un ticket di AWS assistenza e autorizzando Amazon Monitron a consegnarti i dati.
Per ottenere dati operativi in tempo reale per le risorse Amazon Monitron che possono essere utilizzati a livello di programmazione, prendi in considerazione l'esportazione dei dati utilizzando i flussi Kinesis. Per ulteriori informazioni, consulta [Amazon Monitron Kinesis data export v2](https://docs.aws.amazon.com/Monitron/latest/user-guide/monitron-kinesis-export-v2.html).
**Topics**
+ [Prerequisiti](exporting-data-procedure.md)
+ [Esportazione dei dati con CloudFormation (opzione consigliata)](onetime-download-cflink.md)
+ [Esportazione dei dati con la console](onetime-download-console.md)
+ [Esportazione dei dati con CloudShell](export-shell.md)
# Prerequisiti
Per esportare correttamente i dati di Amazon Monitron, devono essere soddisfatti i seguenti prerequisiti.
+ Non devi avere già un'altra esportazione (di dati Amazon Monitron) in esecuzione nella stessa regione.
+ Non puoi aver eseguito un'altra esportazione nella stessa regione nelle ultime 24 ore.
# Esportazione dei dati con CloudFormation (opzione consigliata)
**Topics**
+ [Fase 1: crea il bucket Amazon S3, il ruolo IAM e le policy IAM.](#gdpr-cloudfront-makestack)
+ [Passaggio 2: annota le tue risorse](#gdpr-cloudfront-resources)
+ [Passaggio 3: Crea la richiesta di supporto](#gdpr-cloudfront-case)
## Fase 1: crea il bucket Amazon S3, il ruolo IAM e le policy IAM.
1. Accedi al tuo account. AWS
1. Apri una nuova scheda del browser con il seguente URL.
```
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. Nella CloudFormation pagina che si apre, nell'angolo in alto a destra, seleziona la regione in cui utilizzi Amazon Monitron.
1. Seleziona **Crea stack**.
![\[CloudFormation quick create stack interface with template URL, stack name, and IAM role options.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-1.png)
1. Nella pagina successiva, scegli l'icona di aggiornamento tutte le volte che vuoi fino a quando lo stato dello stack (monitronexport) è CREATE\$1COMPLETE.
![\[CloudFormation stack details page showing monitronexport stack in CREATE_IN_PROGRESS state.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-2.png)
## Passaggio 2: annota le tue risorse
1. Seleziona la scheda **Outputs (Output)**.
1. Nota il valore della chiave`MonRoleArn`.
1. Annotate il valore della chiave`S3BucketArn`.
1. Annota l'ID del tuo account (nell'angolo in alto a destra della pagina).
1. Annota la regione che hai scelto nel passaggio 1. Ora appare anche nella parte superiore della pagina, a sinistra dell'ID del tuo account.
![\[CloudFormation stack outputs page showing MonRoleArn and S3BucketArn with descriptions.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-3.png)
## Passaggio 3: Crea la richiesta di supporto
1. Dalla AWS console, scegli l'icona del punto interrogativo nell'angolo in alto a destra di qualsiasi pagina, quindi scegli **Support Center**.
![\[AWS console interface showing IAM dashboard with Supporto Center dropdown menu highlighted.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/gdpr-support-question-mark.png)
1. Nella pagina successiva, scegli **Crea caso**.
![\[Supporto Center interface with Quick solutions, Active cases, and Create case button.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-4.png)
1. Nella sezione **Come possiamo aiutarti?** pagina, procedi come segue:
1. Scegli **Account and billing support** (Supporto account e fatturazione).
1. In **Servizio**, scegli **Account**.
1. In **Categoria**, scegli **Conformità e accreditamenti.**
1. Scegli **Severità**, se tale opzione è disponibile in base al tuo abbonamento al supporto.
1. Scegli **Fase successiva: informazioni aggiuntive**.
![\[Supporto case form with Account and billing selected, and service details specified.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-5.png)
1. In **Informazioni aggiuntive**, procedi come segue:
1. In **Oggetto**, immettere**Amazon Monitron data export request**.
1. Nel campo **Descrizione**, inserisci:
1. l'ID del tuo account
1. la regione del bucket che hai creato
1. l'ARN del bucket che hai creato (ad esempio: «arn:aws:s3: :bucketname»)
1. l'ARN del ruolo che hai creato (ad esempio: «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/it_it/Monitron/latest/user-guide/images/s3-export-6.png)
1. Scegli **Passaggio successivo: risolvi ora o contattaci**.
1. **In Solve** now o contattaci, procedi come segue:
1. In **Risolvi ora**, seleziona **Avanti**.
![\[Supporto options interface with "Solve now" and "Contact us" buttons, and recommendations.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-7.png)
1. In **Contattaci**, scegli la **lingua di contatto** e il metodo di contatto preferiti.
1. Seleziona **Invia**. Verrà visualizzata una schermata di conferma con l'ID del caso e i dettagli.
![\[Contact options with language selection and choices for Web, Phone, or Chat communication.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-8.png)
Uno specialista dell'assistenza AWS clienti ti contatterà il prima possibile. In caso di problemi con i passaggi elencati, lo specialista potrebbe chiederti ulteriori informazioni. Se sono state fornite tutte le informazioni necessarie, lo specialista ti avviserà non appena i tuoi dati saranno stati copiati nel bucket Amazon S3 che hai creato sopra.
# Esportazione dei dati con la console
**Topics**
+ [Fase 1: Configurazione del bucket Amazon S3](#gdpr-console-s3)
+ [Fase 2: autorizza Amazon Monitron ad accedere ad Amazon S3](#gdpr-console-set-policy)
+ [Fase 3: Creare il ruolo](#gdpr-console-create-role)
+ [Fase 4: Creare la politica di fiducia](#gdpr-console-trust-policy)
+ [Fase 5: Creare la richiesta di supporto](#gdpr-console-case)
## Fase 1: Configurazione del bucket Amazon S3
1. Aprire la [console Amazon S3](https://console.aws.amazon.com/s3/).
1. Scegliere **Create bucket (Crea bucket)**.
![\[Amazon S3 console interface showing Buckets section with Create bucket button highlighted.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/gdpr-create-bucket.png)
1. Assegna un nome al bucket e seleziona una regione appropriata. Quindi, nella parte inferiore della pagina, scegli **Crea bucket**.
**Importante**
Al momento, Amazon Monitron è supportato solo in tre regioni:
Stati Uniti orientali (Virginia settentrionale) us-east-1
UE (Irlanda) eu-west-1
Asia Pacifico (Sydney) -2 ap-south-east
Pertanto, il bucket Amazon S3 deve trovarsi in una di queste regioni.
Inoltre, deve essere la stessa regione in cui utilizzi il servizio Amazon Monitron.
![\[Create bucket interface showing bucket name "monitron-export-example" and Regione AWS "US East (N. Virginia)".\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/gdpr-create-bucket-2.png)
1. Esamina le altre opzioni sulla pagina e fai le scelte appropriate, a seconda delle tue esigenze e politiche di sicurezza.
**Importante**
È tua responsabilità adottare le misure appropriate per proteggere i tuoi dati. Ti consigliamo vivamente di utilizzare la crittografia lato server e di bloccare l'accesso pubblico al tuo bucket.
1. Usando la casella di ricerca, trova il bucket che hai appena creato, quindi sceglilo.
![\[AWS S3 console showing a newly created bucket named "monitron-export-example" in the bucket list.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/gdpr-choose-s3-bucket.png)
1. Dalla scheda **Proprietà**, prendi nota del nome, dell'ARN e della regione del bucket.
![\[S3 bucket properties showing name, region, ARN, and creation date for monitron-export-example.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/gdpr-s3-properties-tab.png)
## Fase 2: autorizza Amazon Monitron ad accedere ad Amazon S3
1. **Apri la [console IAM](https://console.aws.amazon.com/iam/) e scegli Policies.**
![\[IAM Dashboard showing resource counts, recent updates, and tools for policy management.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-9.png)
1. Scegli **Crea policy**.
![\[IAM Policies page with options to search, filter, and create a new policy.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-10.png)
1. Seleziona la scheda **JSON**.
![\[Policy editor interface showing JSON structure for specifying permissions in IAM.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-11.png)
1. Elimina il testo JSON predefinito in modo che il modulo sia vuoto.
1. Incolla la policy di accesso al 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/it_it/Monitron/latest/user-guide/images/s3-export-12.png)
1. Seleziona **Avanti**.
1. Nella pagina **Rivedi e crea**, effettua le operazioni seguenti:
1. Nei **dettagli della politica**, inserisci un **nome della politica** e una **descrizione** facoltativa.
1. Lascia le **autorizzazioni definite in questa sezione della politica** così come sono.
1. In **Aggiungi tag, *facoltativo*, puoi scegliere di aggiungere tag per tenere traccia delle tue risorse**. .
1. Scegli **Crea policy**.
![\[Policy creation interface showing policy details, permissions, and tags sections.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-13.png)
## Fase 3: Creare il ruolo
1. Apri la [console IAM](https://console.aws.amazon.com/iam/) e scegli **Ruoli**.
![\[IAM Dashboard showing resource counts, recent updates, and available tools.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-14.png)
1. Scegli **Crea ruolo**.
![\[IAM roles interface showing 116 roles and a prominent "Create role" button.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-15.png)
1. In **Seleziona entità affidabile**, in **Tipo di entità affidabile**, scegli **AWS account**.
1. In **Un AWS account**, scegli **Questo account**. Puoi personalizzare impostazioni aggiuntive utilizzando **Opzioni**.
1. Scegli **Next (Successivo)**.
![\[Account AWS selection interface with trusted entity types and account options.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-16.png)
1. In **Aggiungi autorizzazioni**, per **Politiche di autorizzazione**, cerca la politica che hai appena creato nella casella di ricerca e seleziona la tua politica.
![\[Add permissions interface showing search for "monitron-policy" with one matching result selected.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-17.png)
1. Nella pagina **Nome, rivedi e crea,** procedi come segue:
1. In **Dettagli del ruolo**, inserisci un **nome del ruolo** e una **descrizione** facoltativa.
1. Puoi scegliere di ignorare il **passaggio 1: selezione delle entità attendibili** e il **passaggio 2: aggiunta delle autorizzazioni**.
1. Per il **Passaggio 3: Aggiungi tag**, per **Aggiungi tag: *facoltativo***, aggiungi tag opzionali per tenere traccia delle tue risorse.
1. Scegli **Crea ruolo**.
![\[Form for creating a new role with fields for role name, description, trust policy, and permissions.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-18.png)
## Fase 4: Creare la politica di fiducia
1. Cerca il ruolo che hai appena creato e scegli il ruolo.
![\[IAM Roles page showing search results for "monitron-role" with one matching role listed.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-19.png)
1. Seleziona la scheda **Relazioni di attendibilità**.
![\[IAM role details page showing Trust relationships tab and Edit trust policy button.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-20.png)
1. Seleziona **Modifica relazione di attendibilità**.
![\[Trust relationships tab with Edit trust relationship button highlighted.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/gdpr-edit-trust-relationship.png)
1. Cancella il testo JSON predefinito in modo che il modulo sia vuoto.
1. Incolla la policy che consente ad Amazon Monitron di assumere il ruolo.
------
#### [ 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/it_it/Monitron/latest/user-guide/images/s3-export-18.png)
1. Scegli **Update Trust Policy (Aggiorna policy di trust)**.
## Fase 5: Creare la richiesta di supporto
1. Dalla AWS console, scegli l'icona del punto interrogativo nell'angolo in alto a destra di qualsiasi pagina, quindi scegli **Support Center**.
![\[AWS console interface showing IAM dashboard with Supporto Center dropdown menu highlighted.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/gdpr-support-question-mark.png)
1. Nella pagina successiva, scegli **Crea caso**.
![\[Supporto Center interface with Quick solutions, Active cases, and Create case button.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-4.png)
1. Nella sezione **Come possiamo aiutarti?** pagina, procedi come segue:
1. Scegli **Account and billing support** (Supporto account e fatturazione).
1. In **Servizio**, scegli **Account**.
1. In **Categoria**, scegli **Conformità e accreditamenti.**
1. Scegli **Severità**, se tale opzione è disponibile in base al tuo abbonamento al supporto.
1. Scegli **Fase successiva: informazioni aggiuntive**.
![\[Supporto case form with Account and billing selected, and service details specified.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-5.png)
1. In **Informazioni aggiuntive**, procedi come segue:
1. In **Oggetto**, immettere**Amazon Monitron data export request**.
1. Nel campo **Descrizione**, inserisci:
1. l'ID del tuo account
1. la regione del bucket che hai creato
1. l'ARN del bucket che hai creato (ad esempio: «arn:aws:s3: :bucketname»)
1. l'ARN del ruolo che hai creato (ad esempio: «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/it_it/Monitron/latest/user-guide/images/s3-export-6.png)
1. Scegli **Passaggio successivo: risolvi ora o contattaci**.
1. **In Solve** now o contattaci, procedi come segue:
1. In **Risolvi ora**, seleziona **Avanti**.
![\[Supporto options interface with "Solve now" and "Contact us" buttons, and recommendations.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-7.png)
1. In **Contattaci**, scegli la **lingua di contatto** e il metodo di contatto preferiti.
1. Seleziona **Invia**. Verrà visualizzata una schermata di conferma con l'ID del caso e i dettagli.
![\[Contact options with language selection and choices for Web, Phone, or Chat communication.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-8.png)
Uno specialista dell'assistenza AWS clienti ti contatterà il prima possibile. In caso di problemi con i passaggi elencati, lo specialista potrebbe chiederti ulteriori informazioni. Se sono state fornite tutte le informazioni necessarie, lo specialista ti avviserà non appena i tuoi dati saranno stati copiati nel bucket Amazon S3 che hai creato sopra.
# Esportazione dei dati con CloudShell
**Topics**
+ [Fase 1: creazione di un bucket Amazon S3 (con) AWS CloudShell](#create-s3-with-shell)
+ [Fase 2: concedere ad Amazon Monitron l'accesso al tuo bucket Amazon S3 (con) AWS CloudShell](#create-policy-with-shell)
+ [Fase 3: Creazione del ticket di assistenza](#create-support-ticket)
## Fase 1: creazione di un bucket Amazon S3 (con) AWS CloudShell
1. Accedi alla console. AWS
1. Apri AWS CloudShell
[AWS CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/welcome.html)è un ambiente a riga di comando che funziona all'interno del browser. All'interno AWS CloudShell, è possibile utilizzare il AWS Command Line Interface per avviare e configurare molti AWS servizi.
1. In AWS CloudShell, inserisci il seguente comando, dove bucketname è il nome del bucket che stai creando:
```
$ aws s3api create-bucket --bucket bucketname --region us-east-1
```
Questo comando crea un bucket Amazon S3 per archiviare i dati grezzi. Potrai accedere facilmente al tuo bucket dalla console e scaricare i dati quando preferisci. Per ulteriori informazioni, consulta [Creazione, configurazione e utilizzo dei bucket Amazon S3](https://docs.aws.amazon.com//AmazonS3/latest/userguide/creating-buckets-s3.html).
**Importante**
È tua responsabilità adottare le misure appropriate per proteggere i tuoi dati. Ti consigliamo vivamente di utilizzare la crittografia lato server e di bloccare l'accesso pubblico al tuo bucket.
Nel comando precedente, il bucket viene creato nella regione Stati Uniti orientali (Virginia settentrionale). Facoltativamente, puoi specificare una regione diversa nel corpo della richiesta. Per ulteriori informazioni, consulta [Regioni, zone di disponibilità e Local Zones](https://docs.aws.amazon.com//AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html)
Dovresti vedere un output simile a questo:
```
{ "Location": "/bucketname" }
```
1. Identifica l'[Amazon Resource Name (ARN)](https://docs.aws.amazon.com//general/latest/gr/aws-arns-and-namespaces.html) del bucket che hai creato, che sarà:
```
arn:aws:s3:::bucketname
```
## Fase 2: concedere ad Amazon Monitron l'accesso al tuo bucket Amazon S3 (con) AWS CloudShell
1. Incolla il codice seguente in un editor di testo e salvalo come: .json. monitron-assumes-role Non utilizzare Microsoft Word, che aggiungerà caratteri aggiuntivi. Usa un semplice editor di testo come Notepad o. TextEdit
Questa policy autorizza Amazon Monitron ad assumere il ruolo che gli consentirà di accedere al tuo bucket S3. Per ulteriori informazioni, consulta [Politiche e autorizzazioni](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies.html) in IAM.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Effect": "Allow",
"Principal": {
"Service": ["monitron.amazonaws.com"]
},
"Action": "sts:AssumeRole"
}]
}
```
------
1. Incolla il testo seguente in un editor di testo e salvalo come: 3.json monitron-role-accesses-s
Questa policy consentirà ad Amazon Monitron (utilizzando il ruolo creato sopra) di accedere al tuo bucket 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. Nel file di testo appena creato, sostituisci ogni occorrenza di *bucketname* con il nome del tuo bucket.
Ad esempio, se il nome del tuo bucket è implacabile, il tuo file avrà questo aspetto:
------
#### [ 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. Carica entrambi i file json che hai appena creato CloudShell nella home directory.
Per caricare un file, scegli Azioni nell'angolo in alto a destra della pagina della CloudShell console, quindi scegli Carica file.
1. Inserisci quanto segue nella riga di comando in CloudShell:
**aws iam create-role --role-name role-for-monitron --assume-role-policy-document "cat monitron-assumes-role.json"**
Questo comando crea il ruolo e allega la monitron-assumes-role policy.
Dovresti vedere un output simile a questo:
```
{
"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"
}]
}
}
}
```
Prendi nota del valore ARN per il ruolo che hai appena creato. Sarà necessario in seguito.
Nel nostro esempio, il valore ARN è: `arn:aws:iam::273771705212:role/role-for-monitron`
1. Immettete quanto segue nella riga di comando in CloudShell:
** aws iam create-policy --policy-name role-uses-bucket --policy-document "cat role-uses-bucket.json"**
Questo comando crea la politica monitron-role-accesses-s 3.
Dovresti vedere un output simile a questo:
```
{
"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"
}
}
```
Prendi nota del valore ARN per la policy che hai appena creato. Ti servirà per il passaggio successivo.
Nel nostro esempio, il valore ARN è:
```
arn:aws:iam::273771705212:policy/role-uses-bucket
```
1. Inserisci quanto segue nella riga di comando di CloudShell, sostituendo l'ARN con l'ARN per la tua politica: role-uses-bucket
```
aws iam attach-role-policy --role-name role-for-monitron --policy-arn
arn:aws:iam::273771705212:policy/role-uses-bucket
```
Questo comando associa la politica monitron-role-accesses-s 3 al ruolo appena creato.
Ora hai creato e fornito un bucket Amazon S3, un ruolo che Amazon Monitron può assumere, una policy che consentirà ad Amazon Monitron di assumere quel ruolo e un'altra policy che consentirà al servizio che utilizza quel ruolo di utilizzare il tuo bucket Amazon S3.
Sei responsabile dell'adozione delle misure appropriate per proteggere i tuoi dati. Ti consigliamo vivamente di utilizzare la crittografia lato server e di bloccare l'accesso pubblico al tuo bucket. Per ulteriori informazioni, consulta [Bloccare](https://docs.aws.amazon.com//AmazonS3/latest/userguide/access-control-block-public-access.html) l'accesso pubblico.
## Fase 3: Creazione del ticket di assistenza
1. Dalla AWS console, scegli l'icona del punto interrogativo nell'angolo in alto a destra di qualsiasi pagina, quindi scegli **Support Center**.
![\[AWS console interface showing IAM dashboard with Supporto Center dropdown menu highlighted.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/gdpr-support-question-mark.png)
1. Nella pagina successiva, scegli **Crea caso**.
![\[Supporto Center interface with Quick solutions, Active cases, and Create case button.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-4.png)
1. Nella sezione **Come possiamo aiutarti?** pagina, procedi come segue:
1. Scegli **Account and billing support** (Supporto account e fatturazione).
1. In **Servizio**, scegli **Account**.
1. In **Categoria**, scegli **Conformità e accreditamenti.**
1. Scegli **Severità**, se tale opzione è disponibile in base al tuo abbonamento al supporto.
1. Scegli **Fase successiva: informazioni aggiuntive**.
![\[Supporto case form with Account and billing selected, and service details specified.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-5.png)
1. In **Informazioni aggiuntive**, procedi come segue:
1. In **Oggetto**, immettere**Amazon Monitron data export request**.
1. Nel campo **Descrizione**, inserisci:
1. l'ID del tuo account
1. la regione del bucket che hai creato
1. l'ARN del bucket che hai creato (ad esempio: «arn:aws:s3: :bucketname»)
1. l'ARN del ruolo che hai creato (ad esempio: «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/it_it/Monitron/latest/user-guide/images/s3-export-6.png)
1. Scegli **Passaggio successivo: risolvi ora o contattaci**.
1. **In Solve** now o contattaci, procedi come segue:
1. In **Risolvi ora**, seleziona **Avanti**.
![\[Supporto options interface with "Solve now" and "Contact us" buttons, and recommendations.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-7.png)
1. In **Contattaci**, scegli la **lingua di contatto** e il metodo di contatto preferiti.
1. Seleziona **Invia**. Verrà visualizzata una schermata di conferma con l'ID del caso e i dettagli.
![\[Contact options with language selection and choices for Web, Phone, or Chat communication.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/s3-export-8.png)
Uno specialista dell'assistenza AWS clienti ti contatterà il prima possibile. In caso di problemi con i passaggi elencati, lo specialista potrebbe chiederti ulteriori informazioni. Se sono state fornite tutte le informazioni necessarie, lo specialista ti avviserà non appena i tuoi dati saranno stati copiati nel bucket Amazon S3 che hai creato sopra.
# Esportazione dati Amazon Monitron Kinesis v1
**Nota**
Lo schema di esportazione dati Amazon Monitron Kinesis v1 è obsoleto. [Scopri di più sullo schema di esportazione dei dati v2.](monitron-kinesis-export-v2.md)
Puoi esportare i dati di misurazione in entrata e i risultati di inferenza corrispondenti da Amazon Monitron ed eseguire analisi in tempo reale. L'esportazione dei dati trasmette i dati in tempo reale a Kinesis.
**Topics**
+ [Esportazione dei dati in uno stream Kinesis](#exporting-stream-procedure)
+ [Modifica delle impostazioni di esportazione dei dati in tempo reale](#edit-live-export)
+ [Interruzione di un'esportazione di dati in tempo reale](#stop-kinesis-export)
+ [Visualizzazione degli errori di esportazione dei dati](#viewing-kinesis-export-errors)
+ [Utilizzo della crittografia lato server per il flusso Kinesis](#data-export-server-side-encryption)
+ [Monitoraggio con Amazon CloudWatch Logs](data-export-cloudwatch-logs.md)
+ [Archiviazione dei dati esportati in Amazon S3](kinesis-store-S3.md)
+ [Elaborazione dei dati con Lambda](data-export-lambda.md)
+ [Comprensione dello schema di esportazione dei dati v1](data-export-schema.md)
## Esportazione dei dati in uno stream Kinesis
1. Dalla pagina principale del progetto, nella parte inferiore della pagina, sulla destra, scegli **Avvia l'esportazione dei dati in tempo reale**.
1. In **Seleziona il flusso di dati di Amazon Kinesis**, esegui una delle seguenti operazioni:
+ Inserisci il nome di uno stream esistente nella casella di ricerca. Quindi vai al passaggio 5.
+ Scegli **Crea un nuovo flusso di dati**.
1. Nella pagina **Crea flusso di dati**, in **Configurazione del flusso di dati**, inserisci il nome del flusso di dati.
1. In Capacità del flusso di dati, scegli la modalità di capacità:
+ **Se i requisiti di throughput del flusso di dati sono imprevedibili e variabili, scegli On-demand.**
+ **Se riesci a stimare in modo affidabile i requisiti di throughput del tuo flusso di dati, scegli Provisioned.** **Quindi, in Provisioned shards, inserisci il numero di shard che desideri creare o scegli lo Shard estimator.**
1. Selezionare **Create data stream (Crea flusso di dati)**.
## Modifica delle impostazioni di esportazione dei dati in tempo reale
Per modificare le impostazioni di esportazione dei dati in tempo reale:
1. Apri la console Amazon Monitron.
1. Scegli **Progetti** dal pannello di navigazione.
1. Se hai più progetti, scegli il progetto per il quale desideri modificare le impostazioni di esportazione.
1. Dalla pagina principale del progetto, in **Esportazione dati in tempo reale**, dal menu a discesa **Azioni**, scegli **Modifica le impostazioni di esportazione dei dati in tempo reale**.
## Interruzione di un'esportazione di dati in tempo reale
1. Apri la console Amazon Monitron.
1. Scegli **Progetti** dal pannello di navigazione.
1. Se hai più progetti, scegli il progetto per il quale desideri modificare le impostazioni di esportazione.
1. Dalla pagina principale del progetto, in **Esportazione dati in tempo reale**, dal menu a discesa **Azioni**, scegli **Interrompi l'esportazione dei dati in tempo reale**.
1. **Nella finestra pop-up, scegli Stop.**
## Visualizzazione degli errori di esportazione dei dati
Per visualizzare i messaggi di errore nell'interfaccia CloudWatch Logs:
+ Sulla console Amazon Monitron, dalla pagina principale del progetto, in **Esportazione dati in tempo reale**, scegli gruppo di **CloudWatch log**.
## Utilizzo della crittografia lato server per il flusso Kinesis
Puoi abilitare la crittografia lato server per il tuo flusso Kinesis prima di configurare l'esportazione dei dati Kinesis. Tuttavia, se la crittografia lato server è abilitata dopo aver impostato l'esportazione dei dati Kinesis, Amazon Monitron non sarà in grado di pubblicare nello stream. Questo perché Amazon Monitron non sarà autorizzato a chiamare [kms:](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKey.html) in GenerateDataKey modo che possa crittografare i dati inviati a Kinesis.
Per ovviare a questo problema, segui le istruzioni riportate di seguito[Modifica delle impostazioni di esportazione dei dati in tempo reale](#edit-live-export), ma senza modificare la configurazione. Ciò assocerà la crittografia che hai impostato alla configurazione di esportazione.
# Monitoraggio con Amazon CloudWatch Logs
Puoi monitorare l'esportazione dei dati in tempo reale di Amazon Monitron utilizzando Amazon CloudWatch Logs. Quando l'esportazione di una misurazione non riesce, Amazon Monitron invia un evento di log ai tuoi CloudWatch log. Puoi anche impostare un filtro metrico sul log degli errori per generare metriche e configurare allarmi. Un allarme può rilevare determinate soglie e inviare notifiche o intraprendere azioni quando tali soglie vengono raggiunte. [Per ulteriori informazioni, consulta la Guida per l'utente. CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)
Amazon Monitron invia gli eventi di log al gruppo di log/aws/monitron/data-export/ \$1HASH\$1ID\$1.
L'evento di registro ha il seguente formato JSON:
```
{
"assetDisplayName": "string",
"destination": "string",
"errorCode": "string",
"errorMessage": "string",
"eventId": "string",
"positionDisplayName": "string",
"projectDisplayName": "string",
"projectName": "string",
"sensorId": "string",
"siteDisplayName": "string",
"timestamp": "string"
}
```
assetDisplayName
+ Il nome della risorsa visualizzato nell'app
+ Tipo: String
destinazione
+ L'ARN del flusso di dati Kinesis
+ Tipo: String
+ Modello: arn:aws:kinesis: \$1\$1REGION\$1\$1: \$1\$1AWS\$1ACCOUNT\$1ID\$1\$1 :stream/ \$1\$1STREAM\$1NAME\$1\$1
errorCode
+ Il codice di errore
+ Tipo: String
+ Valori validi: `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
+ Il messaggio di errore dettagliato
+ Tipo: String
eventId
+ L'ID evento univoco corrispondente a ciascuna esportazione di misurazione
+ Tipo: String
positionDisplayName
+ Il nome della posizione del sensore visualizzato nell'app
+ Tipo: String
SensorID
+ L'ID fisico del sensore da cui viene inviata la misurazione
+ Tipo: String
siteDisplayName
+ Il nome del sito visualizzato nell'app
+ Tipo: String
timestamp
+ Il timestamp in cui la misurazione viene ricevuta dal servizio Amazon Monitron in UTC
+ Tipo: String
+ Modello: yyyy-mm-dd HH:mm:ss.sss
# Archiviazione dei dati esportati in Amazon S3
**Topics**
+ [Utilizzo di un modello predefinito CloudFormation](#kinesis-cloudfront-makestack)
+ [Configurazione manuale di Kinesis nella console](#kinesis-configure-console)
## Utilizzo di un modello predefinito CloudFormation
Amazon Monitron fornisce un AWS CloudFormation modello predefinito che consente di configurare rapidamente Firehose per fornire dati da un flusso di dati Kinesis al bucket Amazon S3. Questo modello consente il partizionamento dinamico e gli oggetti Amazon S3 forniti utilizzeranno il seguente formato di chiave consigliato da Amazon Monitron: `/project={projectName}/site={siteName}/time={yyyy-mm-dd 00:00:00}/{filename}`
1. Accedi al tuo account. AWS
1. Apri una nuova scheda del browser con il seguente URL:
```
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. Nella CloudFormation pagina che si apre, nell'angolo in alto a destra, seleziona la regione in cui utilizzi Amazon Monitron.
1. Per impostazione predefinita, il modello creerà un nuovo flusso di dati Kinesis e un bucket S3 insieme ad altre risorse necessarie per fornire dati ad Amazon S3. Puoi modificare i parametri per utilizzare le risorse esistenti.
1. Seleziona la casella che dice *Riconosco che AWS CloudFormation potrebbe creare risorse IAM.*
1. Seleziona **Crea stack**.
1. Nella pagina successiva, scegli l'icona di aggiornamento tutte le volte che vuoi fino a quando lo stato dello stack è CREATE\$1COMPLETE.
## Configurazione manuale di Kinesis nella console
1. Accedi alla Console di AWS gestione e apri la console Kinesis all'indirizzo /kinesis. https://console.aws.amazon.com
1. Scegli **Delivery streams** nel pannello di navigazione.
1. Selezionare **Create delivery stream (Crea flusso di distribuzione)**.
1. Per Source, seleziona **Amazon Kinesis Data Streams**.
1. Per Destinazione, seleziona **Amazon S3**.
1. In **Impostazioni sorgente, Kinesis data stream, inserisci l'ARN del tuo flusso di dati** Kinesis.
1. In **Delivery stream name**, inserisci il nome del tuo flusso di dati Kinesis.
1. In **Impostazioni di destinazione**, scegli un bucket Amazon S3 o inserisci un URI del bucket.
1. (opzionale) Abilita il partizionamento dinamico utilizzando l'analisi in linea per JSON. Questa opzione è appropriata se si desidera partizionare i dati di misurazione in streaming in base alle informazioni di origine e al timestamp. Esempio:
+ **Scegliete **Attivato** per il partizionamento dinamico.**
+ Scegli **Abilitato** per il **nuovo delimitatore di riga**.
+ Scegli **Abilitato** per l'analisi **in linea** per JSON.
+ In Chiavi di **partizionamento dinamico**, aggiungi:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/kinesis-store-S3.html)
1. Scegli **Applica chiavi di partizionamento dinamico** e conferma che il prefisso del bucket Amazon S3 generato sia. `!{partitionKeyFromQuery:project}/!{partitionKeyFromQuery:site}/!{partitionKeyFromQuery:time}/`
1. In Amazon S3, gli oggetti utilizzeranno il seguente formato chiave:. `/project={projectName}/site={siteName}/time={yyyy-mm-dd 00:00:00}/{filename}`
1. Selezionare **Create delivery stream (Crea flusso di distribuzione)**.
1. (opzionale) Utilizza un percorso più granulare.
Se hai scelto una partizione dinamica, utilizza il formato di chiave Amazon S3 precedente se prevedi di utilizzare AWS Glue Athena per interrogare i dati. Puoi anche scegliere un formato di chiave più preciso, ma la query di Amazon Athena non sarà efficiente. Ecco un esempio di configurazione di un percorso chiave Amazon S3 più preciso.
In Chiavi di **partizionamento dinamico**, aggiungi:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/kinesis-store-S3.html)
In Amazon S3, gli oggetti utilizzeranno il seguente formato chiave: ` /project={projectName}/site={siteName}/asset={assetName}/position={positionName}/sensor={sensorId}/date={yyyy-mm-dd}/time={HH:MM:SS}/{filename}`
# Elaborazione dei dati con Lambda
**Topics**
+ [Fase 1: Crea il [ruolo IAM](https://docs.aws.amazon.com//lambda/latest/dg/lambda-intro-execution-role.html) che autorizza la funzione ad accedere alle risorse AWS](#create-iam-role)
+ [Fase 2: Creare la funzione Lambda](#create-lambda-function)
+ [Fase 3: Configurare la funzione Lambda](#configure-lambda-function)
+ [Fase 4: Attivazione del trigger Kinesis nella console AWS Lambda](#enable-lambda-trigger)
## Fase 1: Crea il [ruolo IAM](https://docs.aws.amazon.com//lambda/latest/dg/lambda-intro-execution-role.html) che autorizza la funzione ad accedere alle risorse AWS
1. Apri la pagina [Ruoli](https://console.aws.amazon.com/iam/home?#/roles) nella console IAM.
1. Scegliere **Crea ruolo**.
1. Creare un ruolo con le seguenti proprietà.
+ Entità affidabile: Lambda
+ Autorizzazioni: AWSLambda KinesisExecutionRole (e AWSKey ManagementServicePowerUser se lo stream Kinesis è crittografato)
+ Nome del ruolo: lambda-kinesis-role
![\[IAM role creation interface showing name, review, and create steps with role details and permissions.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/lambda-create-role.png)
## Fase 2: Creare la funzione Lambda
1. Apri la **pagina Funzioni** della console Lambda.
1. Scegli **Crea funzione**.
1. Scegli **Usa uno schema**.
1. Nella barra di ricerca **Blueprints**, cerca e scegli **kinesis-process-record (nodejs**) o. **kinesis-process-record-python**
1. Scegli **Configura**.
![\[Create function interface with options to author from scratch, use a blueprint, or select container image.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/lambda-create-function.png)
## Fase 3: Configurare la funzione Lambda
1. Scegli il nome **della funzione**
1. Scegli il ruolo creato nel primo passaggio come **ruolo di esecuzione**.
1. Configura il trigger Kinesis.
1. Scegli il tuo stream Kinesis.
1. Fai clic su **Crea funzione.**
![\[Lambda function configuration form with basic information and Kinesis trigger settings.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/lambda-kinesis-trigger.png)
## Fase 4: Attivazione del trigger Kinesis nella console AWS Lambda
1. Nella scheda **Configurazione**, scegli **Trigger**.
1. **Seleziona la casella accanto al nome dello stream Kinesis e scegli Abilita.**
![\[Lambda function configuration page with Triggers tab and Kinesis stream trigger highlighted.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/kinesis-process-record-lambda.png)
Il blueprint utilizzato in questo esempio utilizza solo i dati di registro del flusso selezionato. È possibile modificare ulteriormente il codice della funzione Lambda in un secondo momento per completare un'attività più complicata.
# Comprensione dello schema di esportazione dei dati v1
**Nota**
Lo schema di esportazione dati Amazon Monitron Kinesis v1 è obsoleto. [Scopri di più sullo schema di esportazione dei dati v2.](monitron-kinesis-export-v2.md)
Ogni dato di misurazione e il risultato di inferenza corrispondente vengono esportati come un unico record del flusso di dati Kinesis in formato JSON.
**Topics**
+ [formato dello schema v1](#data-export-schema-format)
+ [parametri dello schema v1](#data-export-schema-parameters)
## formato dello schema 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"
}
}
```
## parametri dello schema v1
timestamp
+ Il timestamp in cui la misurazione viene ricevuta dal servizio Monitron in UTC
+ Tipo: String
+ Modello: yyyy-mm-dd HH:mm:ss.sss
eventId
+ L'ID univoco dell'evento di esportazione dei dati assegnato per ogni misurazione. Può essere usato per deduplicare i record di flusso Kinesis ricevuti.
+ Tipo: String
version
+ Versione dello schema
+ Tipo: String
+ Valore attuale: 1.0
projectDisplayName
+ Il nome del progetto visualizzato nell'app e nella console
+ Tipo: String
siteDisplayName
+ Il nome del sito visualizzato nell'app
+ Tipo: String
assetDisplayName
+ Il nome della risorsa visualizzato nell'app
+ Tipo: String
sensorPositionDisplayNome
+ Il nome della posizione del sensore visualizzato nell'app
+ Tipo: String
Sensor.PhysicalID
+ L'ID fisico del sensore da cui viene inviata la misurazione
+ Tipo: String
sensore.rssi
+ Il sensore bluetooth ha ricevuto il valore dell'indicatore di intensità del segnale
+ Tipo: numero
+ Unità: dBm
Gateway.PhysicalID
+ L'ID fisico del gateway utilizzato per trasmettere dati al servizio Amazon Monitron
+ Tipo: String
Misurazione. Caratteristiche. Accelerazione. Banda da 0 a 6000 Hz.xaxis.RMS
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 0-6000 Hz sull'asse x
+ Tipo: numero
+ Unità: m/s^2
Misurazione. Caratteristiche. Accelerazione. Banda da 0 a 6000 Hz.Yaxis.RMS
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 0-6000 Hz sull'asse y
+ Tipo: numero
+ Unità: m/s^2
Misurazione. Caratteristiche. Accelerazione. Banda da 0 a 6000 Hz.Axis.RMS
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 0-6000 Hz sull'asse y
+ Tipo: numero
+ Unità: m/s^2
Misurazione. Caratteristiche. Accelerazione. Banda da 10 a 1000 Hz. Vettore risultante. ABSmax
+ L'accelerazione massima assoluta osservata nella banda di frequenza 10—1000 Hz
+ Tipo: numero
+ Unità: m/s^2
Misurazione. Caratteristiche. Accelerazione. Banda da 10 a 1000 Hz. Vettore risultante. ABS min
+ L'accelerazione minima assoluta osservata nella banda di frequenza 10—1000 Hz
+ Tipo: numero
+ Unità: m/s^2
Misurazione. Caratteristiche. Accelerazione. Banda da 10 a 1000 Hz. Vettore risultante. Fattore di cresta
+ Il fattore di cresta di accelerazione osservato nella banda di frequenza 10—1000 Hz
+ Tipo: numero
Misurazione. Caratteristiche. Accelerazione. Banda da 10 a 1000 Hz. ResultantVector.rms
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 10—1000 Hz
+ Tipo: numero
+ m/s^2
Misurazione. Caratteristiche. Accelerazione. Banda da 10 a 1000 Hz.asse x.RMS
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 10—1000 Hz sull'asse x
+ Tipo: numero
+ m/s^2
Misurazione. Caratteristiche. Accelerazione. Banda da 10 a 1000 Hz.Yaxis.RMS
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 10—1000 Hz sull'asse y
+ Tipo: numero
+ m/s^2
Misurazione. Caratteristiche. Accelerazione. Banda da 10 a 1000 Hz. Asse Z.RMS
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 10—1000 Hz sull'asse z
+ Tipo: numero
+ m/s^2
misurazione.caratteristiche.temperatura
+ La temperatura osservata
+ Tipo: numero
+ °C/degC
Misura. Caratteristiche. Velocità. Banda da 10 a 1000 Hz. Vettore risultante. ABSmax
+ La velocità massima assoluta osservata nella banda di frequenza 10—1000 Hz
+ Tipo: numero
+ mm/s
Misurazione. Caratteristiche. Velocità. Banda da 10 a 1000 Hz. Vettore risultante. ABS min
+ La velocità minima assoluta osservata nella banda di frequenza 10—1000 Hz
+ Tipo: numero
+ mm/s
Misurazione. Caratteristiche. Velocità. Banda da 10 a 1000 Hz. Vettore risultante. Fattore di cresta
+ Il fattore di cresta della velocità osservato nella banda di frequenza 10—1000 Hz
+ Tipo: numero
Misurazione. Caratteristiche. Velocità.Banda da 10 a 1000 Hz. ResultantVector.rms
+ La radice quadratica media della velocità osservata nella banda di frequenza 10—1000 Hz
+ Tipo: numero
+ mm/s
Misurazione. Caratteristiche. Velocità. Banda da 10 a 1000 Hz.asse X.RMS
+ La radice quadratica media della velocità osservata nella banda di frequenza 10—1000 Hz sull'asse x
+ Tipo: numero
+ mm/s
Misurazione. Caratteristiche. Velocità. Banda da 10 a 1000 Hz.Yaxis.RMS
+ La radice quadratica media della velocità osservata nella banda di frequenza 10—1000 Hz sull'asse y
+ Tipo: numero
+ mm/s
Misurazione. Caratteristiche. Velocità. Banda da 10 a 1000 Hz. Asse Z.RMS
+ La radice quadratica media della velocità osservata nella banda di frequenza 10—1000 Hz sull'asse z
+ Tipo: numero
+ mm/s
Misurazione. Sequenza No
+ Il numero della sequenza di misurazione
+ Tipo: numero
Modelli. TemperatureML. persistentClassificationOutput
+ L'output di classificazione persistente del modello di temperatura basato sull'apprendimento automatico
+ Tipo: numero
+ Valori validi: `UNKNOWN | HEALTHY | WARNING | ALARM`
Modelli.TemperatureML. pointwiseClassificationOutput
+ L'output di classificazione puntuale del modello di temperatura basato sull'apprendimento automatico
+ Tipo: String
+ Valori validi: `UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM`
Classe Models.VibrationISO.ISO
+ La classe ISO 20816 (uno standard per la misurazione e la valutazione delle vibrazioni delle macchine) utilizzata dal modello di vibrazione basato su ISO
+ Tipo: String
+ Valori validi: `CLASS1 | CLASS2 | CLASS3 | CLASS4 | FAN_BV2`
models.VibrationISO.MutedThreshold
+ La soglia per disattivare la notifica dal modello di vibrazione basato su ISO
+ Tipo: String
+ Valori validi: `WARNING | ALARM`
Modelli. VibrationISO. persistentClassificationOutput
+ L'output di classificazione persistente del modello di vibrazione basato su ISO
+ Tipo: String
+ Valori validi: `UNKNOWN | HEALTHY | WARNING | ALARM`
Modelli.VibrationISO. pointwiseClassificationOutput
+ L'output della classificazione puntuale del modello di vibrazione basato su ISO
+ Tipo: String
+ Valori validi: `UNKNOWN | HEALTHY | WARNING | ALARM | MUTED_WARNING | MUTED_ALARM`
Modelli.VibrationML. persistentClassificationOutput
+ L'output di classificazione persistente del modello di vibrazione basato sull'apprendimento automatico
+ Tipo: String
+ Valori validi: `UNKNOWN | HEALTHY | WARNING | ALARM`
Modelli.VibrationML. pointwiseClassificationOutput
+ L'output della classificazione puntuale del modello di vibrazione basato sull'apprendimento automatico
+ Tipo: String
+ Valori validi: `UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM`
assetState.NewState
+ Lo stato della macchina dopo l'elaborazione della misurazione
+ Tipo: String
+ Valori validi: `UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM`
assetState.PreviousState
+ Lo stato della macchina prima dell'elaborazione della misurazione
+ Tipo: String
+ Valori validi: `UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM`
# Esportazione dati Amazon Monitron Kinesis v2
Puoi esportare i dati di misurazione in entrata e i risultati di inferenza corrispondenti da Amazon Monitron ed eseguire analisi in tempo reale. L'esportazione dei dati trasmette i dati in tempo reale a Kinesis.
**Topics**
+ [Esportazione dei dati in uno stream Kinesis](#exporting-stream-procedure-v2)
+ [Modifica delle impostazioni di esportazione dei dati in tempo reale](#edit-live-export-v2)
+ [Interruzione di un'esportazione di dati in tempo reale](#stop-kinesis-export-v2)
+ [Visualizzazione degli errori di esportazione dei dati](#viewing-kinesis-export-errors-v2)
+ [Utilizzo della crittografia lato server per il flusso Kinesis](#data-export-server-side-encryption-v2)
+ [Monitoraggio con Amazon CloudWatch Logs](data-export-cloudwatch-logs-v2.md)
+ [Archiviazione dei dati esportati in Amazon S3](kinesis-store-S3-v2.md)
+ [Elaborazione dei dati con Lambda](data-export-lambda-v2.md)
+ [Comprensione dello schema di esportazione dei dati v2](data-export-schema-v2.md)
+ [Migrazione da Kinesis v1 a v2](migration-from-v1-to-v2.md)
## Esportazione dei dati in uno stream Kinesis
1. Dalla pagina principale del progetto, nella parte inferiore della pagina, sulla destra, scegli **Avvia l'esportazione dei dati in tempo reale**.
1. In **Seleziona flusso di dati Kinesis**, esegui una delle seguenti operazioni:
+ Inserisci il nome di uno stream esistente nella casella di ricerca. Quindi vai al passaggio 5.
+ Scegli **Crea un nuovo flusso di dati**.
1. Nella pagina **Crea flusso di dati**, in **Configurazione del flusso di dati**, inserisci il nome del flusso di dati.
1. In Capacità del flusso di dati, scegli la modalità di capacità:
+ **Se i requisiti di throughput del flusso di dati sono imprevedibili e variabili, scegli On-demand.**
+ **Se riesci a stimare in modo affidabile i requisiti di throughput del tuo flusso di dati, scegli Provisioned.** **Quindi, in Provisioned shards, inserisci il numero di shard che desideri creare o scegli lo Shard estimator.**
1. Selezionare **Create data stream (Crea flusso di dati)**.
## Modifica delle impostazioni di esportazione dei dati in tempo reale
Per modificare le impostazioni di esportazione dei dati in tempo reale:
1. Apri la console Amazon Monitron.
1. Scegli **Progetti** dal pannello di navigazione.
1. Se hai più progetti, scegli il progetto per il quale desideri modificare le impostazioni di esportazione.
1. Dalla pagina principale del progetto, in **Esportazione dati in tempo reale**, dal menu a discesa **Azioni**, scegli **Modifica le impostazioni di esportazione dei dati in tempo reale**.
## Interruzione di un'esportazione di dati in tempo reale
1. Apri la console Amazon Monitron.
1. Scegli **Progetti** dal pannello di navigazione.
1. Se hai più progetti, scegli il progetto per il quale desideri modificare le impostazioni di esportazione.
1. Dalla pagina principale del progetto, in **Esportazione dati in tempo reale**, dal menu a discesa **Azioni**, scegli **Interrompi l'esportazione dei dati in tempo reale**.
1. **Nella finestra pop-up, scegli Stop.**
## Visualizzazione degli errori di esportazione dei dati
Per visualizzare i messaggi di errore nell'interfaccia CloudWatch Logs:
+ Sulla console Amazon Monitron, dalla pagina principale del progetto, in **Esportazione dati in tempo reale**, scegli gruppo di **CloudWatch log**.
## Utilizzo della crittografia lato server per il flusso Kinesis
Puoi abilitare la crittografia lato server per il tuo flusso Kinesis prima di configurare l'esportazione dei dati Kinesis. Tuttavia, se la crittografia lato server è abilitata dopo aver impostato l'esportazione dei dati Kinesis, Amazon Monitron non sarà in grado di pubblicare nello stream. Questo perché Amazon Monitron non sarà autorizzato a chiamare [kms:](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKey.html) in GenerateDataKey modo che possa crittografare i dati inviati a Kinesis.
Per ovviare a questo problema, segui le istruzioni riportate di seguito[Modifica delle impostazioni di esportazione dei dati in tempo reale](#edit-live-export-v2), ma senza modificare la configurazione. Ciò assocerà la crittografia che hai impostato alla configurazione di esportazione.
# Monitoraggio con Amazon CloudWatch Logs
Puoi monitorare l'esportazione dei dati in tempo reale di Amazon Monitron utilizzando Amazon CloudWatch Logs. Quando l'esportazione di una misurazione non riesce, Amazon Monitron invia un evento di log ai tuoi CloudWatch log. Puoi anche impostare un filtro metrico sul log degli errori per generare metriche e configurare allarmi. Un allarme può rilevare determinate soglie e inviare notifiche o intraprendere azioni quando tali soglie vengono raggiunte. [Per ulteriori informazioni, consulta la Guida per l'utente. CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)
Amazon Monitron invia gli eventi di log al gruppo di log/aws/monitron/data-export/ \$1HASH\$1ID\$1.
L'evento di registro ha il seguente formato JSON:
```
{
"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"
}
```
AssetName
+ Il nome della risorsa visualizzato nell'app
+ Tipo: String
destinazione
+ L'ARN del flusso di dati Kinesis
+ Tipo: String
+ Modello: arn:aws:kinesis: \$1\$1REGION\$1\$1: \$1\$1AWS\$1ACCOUNT\$1ID\$1\$1 :stream/ \$1\$1STREAM\$1NAME\$1\$1
errorCode
+ Il codice di errore
+ Tipo: String
+ Valori validi: `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
+ Il messaggio di errore dettagliato
+ Tipo: String
eventId
+ L'ID evento univoco corrispondente a ciascuna esportazione di misurazione
+ Tipo: String
eventType
+ Il tipo di evento corrente
+ Tipo: String
+ Valori validi: `measurement` ` | gatewayConnected` ` | gatewayDisconnected` ` | sensorConnected` ` | sensorDisconnected` ` | assetStateTransition`
nome della posizione
+ Il nome della posizione del sensore visualizzato nell'app
+ Tipo: String
projectName
+ Il nome del progetto visualizzato nell'app e nella console
+ Tipo: String
ID del progetto
+ L'ID di progetto univoco corrispondente al progetto Amazon Monitron
+ Tipo: String
SensorID
+ L'ID fisico del sensore da cui viene inviata la misurazione
+ Tipo: String
GatewayID
+ L'ID fisico del gateway utilizzato per trasmettere dati al servizio Amazon Monitron
+ Tipo: String
siteName
+ Il nome del sito visualizzato nell'app
+ Tipo: String
timestamp
+ Il timestamp in cui la misurazione viene ricevuta dal servizio Amazon Monitron in UTC
+ Tipo: String
+ Modello: yyyy-mm-dd HH:mm:ss.sss
# Archiviazione dei dati esportati in Amazon S3
Se desideri archiviare i dati esportati in Amazon S3, utilizza la seguente procedura.
**Topics**
+ [Configurazione manuale di Kinesis nella console](#kinesis-configure-console-v2)
## Configurazione manuale di Kinesis nella console
1. Accedi alla Console di AWS gestione e apri la console Kinesis all'indirizzo /kinesis. https://console.aws.amazon.com
1. Scegli **Delivery streams** nel pannello di navigazione.
1. Selezionare **Create delivery stream (Crea flusso di distribuzione)**.
1. Per Source, seleziona **Amazon Kinesis Data Streams**.
1. Per Destinazione, seleziona **Amazon S3**.
1. In **Impostazioni sorgente, Kinesis data stream, inserisci l'ARN del tuo flusso di dati** Kinesis.
1. In **Delivery stream name**, inserisci il nome del tuo flusso di dati Kinesis.
1. In **Impostazioni di destinazione**, scegli un bucket Amazon S3 o inserisci un URI del bucket.
1. (opzionale) Abilita il partizionamento dinamico utilizzando l'analisi in linea per JSON. Questa opzione è appropriata se si desidera partizionare i dati di misurazione in streaming in base alle informazioni di origine e al timestamp. Esempio:
+ **Scegliete **Attivato** per il partizionamento dinamico.**
+ Scegli **Abilitato** per il **nuovo delimitatore di riga**.
+ Scegli **Abilitato** per l'analisi **in linea** per JSON.
+ In Chiavi di **partizionamento dinamico**, aggiungi:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/kinesis-store-S3-v2.html)
1. Scegli **Applica chiavi di partizionamento dinamico** e conferma che il prefisso del bucket Amazon S3 generato sia. `!{partitionKeyFromQuery:project}/!{partitionKeyFromQuery:site}/!{partitionKeyFromQuery:time}/`
1. In Amazon S3, gli oggetti utilizzeranno il seguente formato chiave:. `/project={projectName}/site={siteName}/time={yyyy-mm-dd 00:00:00}/{filename}`
1. Selezionare **Create delivery stream (Crea flusso di distribuzione)**.
# Elaborazione dei dati con Lambda
**Topics**
+ [Fase 1: Crea il [ruolo IAM](https://docs.aws.amazon.com//lambda/latest/dg/lambda-intro-execution-role.html) che autorizza la funzione ad accedere alle risorse AWS](#data-export-lambda-v2-1)
+ [Fase 2: Creare la funzione Lambda](#create-lambda-function-v2)
+ [Fase 3: Configurare la funzione Lambda](#configure-lambda-function-v2)
+ [Fase 4: Attivazione del trigger Kinesis nella console AWS Lambda](#configure-kinesis-trigger-v2)
## Fase 1: Crea il [ruolo IAM](https://docs.aws.amazon.com//lambda/latest/dg/lambda-intro-execution-role.html) che autorizza la funzione ad accedere alle risorse AWS
1. Apri la pagina [Ruoli](https://console.aws.amazon.com/iam/home?#/roles) nella console IAM.
1. Scegli **Crea ruolo**.
1. Nella pagina **Seleziona un’entità attendibile**, esegui le operazioni seguenti:
+ Nel **tipo di entità affidabile**, scegli **AWS service**.
+ In **Use case**, per **Service o use case** scegli **Lambda**.
+ Scegli **Next (Successivo)**.
![\[IAM role creation interface showing trusted entity selection with Servizio AWS option chosen.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/lambda-role-1.png)
1. Nella pagina **Aggiungi autorizzazioni**, procedi come segue:
+ In **Criteri di autorizzazione**, scegli AWSLambda KinesisExecutionRole (e AWSKey ManagementServicePowerUser se lo stream Kinesis è crittografato).
+ Lascia le configurazioni in **Imposta i limiti delle autorizzazioni** così come sono.
+ Scegli **Next (Successivo)**.
![\[Add permissions interface showing AWSLambdaKinesisExecutionRole policy selected for a new role.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/lambda-role-2.png)
1. Nella pagina **Nome, rivedi e crea,** procedi come segue:
+ In **Dettagli del ruolo**, in **Nome del ruolo**, inserisci un nome per il tuo ruolo. Ad esempio, *lambda-kinesis-role*. Puoi anche scegliere di aggiungere una **descrizione** opzionale.
+ Lascia le impostazioni per **Passaggio 1: Seleziona entità attendibili** e **Passaggio 2: Aggiungi le autorizzazioni** così come sono. Puoi scegliere di aggiungere tag nel **Passaggio 3: Aggiungi tag** per tenere traccia delle tue risorse.
![\[IAM role creation interface showing name, review, and create steps with role details and permissions.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/lambda-create-role.png)
1. Seleziona **Create role** (Crea ruolo).
## Fase 2: Creare la funzione Lambda
1. Apri la **pagina Funzioni** della console Lambda.
1. Scegli **Crea funzione**.
1. Scegli **Usa uno schema**.
1. Nella barra di ricerca **Blueprints**, cerca e scegli **kinesis-process-record (nodejs**) o. **kinesis-process-record-python**
1. Scegli **Configura**.
![\[Create function interface with options to author from scratch, use a blueprint, or select container image.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/lambda-create-function.png)
## Fase 3: Configurare la funzione Lambda
1. Scegli il nome **della funzione**
1. Scegli il ruolo creato nel primo passaggio come **ruolo di esecuzione**.
1. Configura il trigger Kinesis.
1. Scegli il tuo stream Kinesis.
1. Fai clic su **Crea funzione.**
![\[Lambda function configuration form with basic information and Kinesis trigger settings.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/lambda-kinesis-trigger.png)
## Fase 4: Attivazione del trigger Kinesis nella console AWS Lambda
1. Nella scheda **Configurazione**, scegli **Trigger**.
1. **Seleziona la casella accanto al nome dello stream Kinesis e scegli Abilita.**
![\[Lambda function configuration page with Triggers tab and Kinesis stream trigger highlighted.\]](http://docs.aws.amazon.com/it_it/Monitron/latest/user-guide/images/kinesis-process-record-lambda.png)
Il blueprint utilizzato in questo esempio utilizza solo i dati di registro del flusso selezionato. È possibile modificare ulteriormente il codice della funzione Lambda in un secondo momento per completare un'attività più complicata.
# Comprensione dello schema di esportazione dei dati v2
Ogni dato di misurazione, il risultato di inferenza corrispondente, connect/disconnect, and sensor connect/disconnect gli eventi gateway vengono esportati come un unico record del flusso di dati Kinesis in formato JSON.
**Topics**
+ [formato dello schema v2](#data-export-schema-format-v2)
+ [parametri dello schema v2](#data-export-schema-parameters-v2)
## formato dello schema 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"
}
}
```
## parametri dello schema v2
Lo schema di esportazione dei dati Amazon Monitron Kinesis v2 include i seguenti parametri dello schema. Alcuni parametri sono aggiornamenti dalla v1 e altri sono esclusivi della v2. Ad esempio, `siteName` era un parametro di primo livello nella v1. Nella v2, è un parametro di secondo livello che può essere trovato sotto l'entità. `eventPayload`
timestamp
+ Il timestamp in cui la misurazione viene ricevuta dal servizio Amazon Monitron in UTC
+ Tipo: String
+ Modello: yyyy-mm-dd HH:mm:ss.sss
eventId
+ L'ID univoco dell'evento di esportazione dei dati assegnato per ogni misurazione. Può essere usato per deduplicare i record di flusso Kinesis ricevuti.
+ Tipo: String
version
+ Versione dello schema
+ Tipo: String
+ Valore: 1,0 o 2,0
accountId
+ L'ID AWS account a 12 cifre per il tuo progetto Monitron
+ Tipo: String
projectName
Il nome del progetto visualizzato nell'app e nella console.
Tipo: String
projectId
L'ID univoco del tuo Amazon Monitron progetto.
Tipo: String
eventType
+ Il flusso di eventi corrente. Ogni tipo di evento avrà un `eventPayload` formato dedicato.
+ Tipo: String
+ Valori possibili:`measurement`,`gatewayConnected`,`gatewayDisconnected`,`sensorConnected`,`sensorDisconnected`,`assetStateTransition`.
**`eventType: measurement`**
EventPayload.Features.Acceleration.Band da 0 a 6000 Hz.xaxis.rms
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 0-6000 Hz sull'asse x
+ Tipo: numero
+ Unità: m/s^2
EventPayload.Features.Acceleration.Band da 0 a 6000 Hz.yaxis.rms
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 0-6000 Hz sull'asse y
+ Tipo: numero
+ Unità: m/s^2
EventPayload.Features.Acceleration.Band da 0 a 6000 Hz.zaxis.rms
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 0-6000 Hz sull'asse z
+ Tipo: numero
+ Unità: m/s^2
Eventpayload.Caratteristiche.Acceleration.Band da 10 a 1000 Hz. Vettore risultant.ABSmax
+ L'accelerazione massima assoluta osservata nella banda di frequenza 10—1000 Hz
+ Tipo: numero
+ Unità: m/s^2
EventPayload.Features.Acceleration.Band da 10 a 1000 Hz. Vettore risultant.absmin
+ L'accelerazione minima assoluta osservata nella banda di frequenza 10—1000 Hz
+ Tipo: numero
+ Unità: m/s^2
EventPayload.Features.Acceleration.Band da 10 a 1000 Hz. ResultantVector.CrestFactor
+ Il fattore di cresta di accelerazione osservato nella banda di frequenza 10—1000 Hz
+ Tipo: numero
EventPayload.Features.Acceleration.Band da 10 a 1000 Hz. ResultantVector.rms
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 10—1000 Hz
+ Tipo: numero
+ m/s^2
EventPayload.Features.Acceleration.Band10 a 1000 Hz.xaxis.rms
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 10—1000 Hz sull'asse x
+ Tipo: numero
+ m/s^2
EventPayload.Features.Acceleration.Band da 10 a 1000 Hz.yaxis.RMS
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 10—1000 Hz sull'asse y
+ Tipo: numero
+ m/s^2
EventPayload.Features.Acceleration.Band da 10 a 1000 Hz.zaxis.rms
+ La radice quadratica media dell'accelerazione osservata nella banda di frequenza 10—1000 Hz sull'asse z
+ Tipo: numero
+ m/s^2
Eventpayload.Caratteristiche.Temperatura
+ La temperatura osservata
+ Tipo: numero
+ °C/degC
Eventpayload.Caratteristiche.Velocity.Band da 10 a 1000 Hz. Vettore risultante. ABSmax
+ La velocità massima assoluta osservata nella banda di frequenza 10—1000 Hz
+ Tipo: numero
+ mm/s
EventPayload.Features.Velocity.Band da 10 a 1000 Hz. Vettore risultant.absmin
+ La velocità minima assoluta osservata nella banda di frequenza 10—1000 Hz
+ Tipo: numero
+ mm/s
EventPayload.Features.Velocity.Band da 10 a 1000 Hz. Vettore risultante. Fattore di cresta
+ Il fattore di cresta della velocità osservato nella banda di frequenza 10—1000 Hz
+ Tipo: numero
EventPayload.Features.Velocity.Band da 10 a 1000 Hz. ResultantVector.rms
+ La radice quadratica media della velocità osservata nella banda di frequenza 10—1000 Hz
+ Tipo: numero
+ mm/s
EventPayload.Features.Velocity.Band da 10 a 1000 Hz.xaxis.rms
+ La radice quadratica media della velocità osservata nella banda di frequenza 10—1000 Hz sull'asse x
+ Tipo: numero
+ mm/s
EventPayload.Features.Velocity.Band da 10 a 1000 Hz.Yaxis.RMS
+ La radice quadratica media della velocità osservata nella banda di frequenza 10—1000 Hz sull'asse y
+ Tipo: numero
+ mm/s
EventPayload.Features.Velocity.Band da 10 a 1000 Hz.zaxis.rms
+ La radice quadratica media della velocità osservata nella banda di frequenza 10—1000 Hz sull'asse z
+ Tipo: numero
+ mm/s
EventPayload.Sequence No
+ Il numero della sequenza di misurazione
+ Tipo: numero
EventPayload. assetPositionId
+ L'identificatore della posizione del sensore per cui viene inviata la misurazione.
+ Tipo: String
EventPayload.Nome dell'azienda
+ Il nome dell'azienda che utilizza la risorsa.
+ Tipo: String
Eventpayload.geolocation.latitude
+ La latitudine della posizione fisica del sito.
+ Tipo: numero
Eventpayload.geolocation.longitude
+ La longitudine della posizione fisica del sito.
+ Tipo: numero
EventPayload.Indirizzo
+ L'indirizzo del sito.
+ Tipo: String
Eventpayload.serialNumber
+ Il numero di serie della risorsa.
+ Tipo: String
Eventpayload.make
+ La marca dell'asset.
+ Tipo: String
EventPayload.model
+ Il modello dell'asset.
+ Tipo: String
`eventType: sensorConnected`
siteName
+ Il nome del sito visualizzato nell'app
+ Tipo: String
AssetName
+ Il nome della risorsa visualizzato nell'app
+ Tipo: String
Nome della posizione
+ Il nome della posizione del sensore visualizzato nell'app
+ Tipo: String
AssetPositionURL
+ L'URL del sensore visualizzato nell'app
+ Tipo: String
ID fisico
+ L'ID fisico del sensore da cui viene inviata la misurazione
+ Tipo: String
EventPayload. assetPositionId
+ L'identificatore della posizione del sensore il cui stato è cambiato.
+ Tipo: String
EventPayload.Nome della società
+ Il nome dell'azienda che utilizza la risorsa.
+ Tipo: String
Eventpayload.geolocation.latitude
+ La latitudine della posizione fisica del sito.
+ Tipo: numero
Eventpayload.geolocation.longitude
+ La longitudine della posizione fisica del sito.
+ Tipo: numero
EventPayload.Indirizzo
+ L'indirizzo del sito.
+ Tipo: String
Eventpayload.serialNumber
+ Il numero di serie della risorsa.
+ Tipo: String
Eventpayload.make
+ La marca dell'asset.
+ Tipo: String
EventPayload.model
+ Il modello dell'asset.
+ Tipo: String
`eventType: sensorDisconnected`
siteName
+ Il nome del sito visualizzato nell'app
+ Tipo: String
AssetName
+ Il nome della risorsa visualizzato nell'app
+ Tipo: String
Nome della posizione
+ Il nome della posizione del sensore visualizzato nell'app
+ Tipo: String
AssetPositionURL
+ L'URL del sensore visualizzato nell'app
+ Tipo: String
ID fisico
+ L'ID fisico del sensore da cui viene inviata la misurazione
+ Tipo: String
EventPayload. assetPositionId
+ L'identificatore della posizione del sensore il cui stato è cambiato.
+ Tipo: String
EventPayload.Nome della società
+ Il nome dell'azienda che utilizza la risorsa.
+ Tipo: String
Eventpayload.geolocation.latitude
+ La latitudine della posizione fisica del sito.
+ Tipo: numero
Eventpayload.geolocation.longitude
+ La longitudine della posizione fisica del sito.
+ Tipo: numero
EventPayload.Indirizzo
+ L'indirizzo del sito.
+ Tipo: String
Eventpayload.serialNumber
+ Il numero di serie della risorsa.
+ Tipo: String
Eventpayload.make
+ La marca dell'asset.
+ Tipo: String
EventPayload.model
+ Il modello dell'asset.
+ Tipo: String
`eventType: gatewayConnected`
eventpayload.sitename
+ Il nome del sito visualizzato nell'app
+ Tipo: String
eventpayload.gatewayName
+ Il nome del gateway visualizzato nell'app
+ Tipo: String
EventPayload.GatewayListUrl
+ L'URL del gateway visualizzato nell'app
+ Tipo: String
eventpayload.gateway.PhysicalID
+ L'ID fisico del gateway appena connesso per trasmettere dati al servizio Amazon Monitron
+ Tipo: String
Eventpayload.nome della società
+ Il nome dell'azienda che utilizza la risorsa.
+ Tipo: String
Eventpayload.geolocation.latitude
+ La latitudine della posizione fisica del sito.
+ Tipo: numero
Eventpayload.geolocation.longitude
+ La longitudine della posizione fisica del sito.
+ Tipo: numero
EventPayload.Indirizzo
+ L'indirizzo del sito.
+ Tipo: String
`eventType: gatewayDisconnected`
siteName
+ Il nome del sito visualizzato nell'app
+ Tipo: String
Nome del gateway
+ Il nome del gateway visualizzato nell'app
+ Tipo: String
GatewayListURL
+ L'URL del gateway visualizzato nell'app
+ Tipo: String
ID fisico
+ L'ID fisico del gateway appena connesso per trasmettere dati al servizio Amazon Monitron
+ Tipo: String
Eventpayload.nome della società
+ Il nome dell'azienda che utilizza la risorsa.
+ Tipo: String
Eventpayload.geolocation.latitude
+ La latitudine della posizione fisica del sito.
+ Tipo: numero
Eventpayload.geolocation.longitude
+ La longitudine della posizione fisica del sito.
+ Tipo: numero
EventPayload.Indirizzo
+ L'indirizzo del sito.
+ Tipo: String
`eventType: assetStateTransition`
eventpayload.sitename
+ Il nome del sito visualizzato nell'app
+ Tipo: String
Eventpayload.assetName
+ Il nome della risorsa visualizzato nell'app
+ Tipo: String
eventpayload.positionName
+ Il nome della posizione del sensore visualizzato nell'app
+ Tipo: String
eventpayload.assetPositionUrl
+ L'URL del sensore visualizzato nell'app
+ Tipo: String
eventpayload.sensor.PhysicalID
+ L'ID fisico del sensore da cui viene inviata la misurazione
+ Tipo: String
EventPayload. assetTransitionType
+ Il motivo alla base della transizione dello stato patrimoniale
+ Tipo: String
+ Valori possibili: `measurement` o `userInput`
EventPayload.assetState.newState
+ Il nuovo stato dell'asset
+ Tipo: String
eventpayload.assetState.PreviousState
+ Lo stato precedente dell'asset
+ Tipo: String
Eventpayload.closureCode.FailureMode
+ La modalità di errore selezionata dall'utente al momento della conferma dell'errore
+ Tipo: String
+ Valori possibili: `NO_ISSUE` \$1 `BLOCKAGE` \$1 `CAVITATION` \$1 `CORROSION` \$1 \$1 `DEPOSIT` \$1 `IMBALANCE` \$1 `LUBRICATION` \$1 `MISALIGNMENT` \$1 `OTHER` \$1 `RESONANCE` \$1 `ROTATING_LOOSENESS` \$1 `STRUCTURAL_LOOSENESS` \$1 `TRANSMITTED_FAULT` `UNDETERMINED`
Eventpayload.closureCode.FailureCause
+ La causa dell'errore selezionata dall'utente nel menu a discesa dell'app al momento della conferma di un errore.
+ Tipo: String
+ Valori possibili: `ADMINISTRATION` \$1 \$1 `DESIGN` \$1 `FABRICATION` \$1 `MAINTENANCE` \$1 \$1 `OPERATION` \$1 `OTHER` \$1 `QUALITY` `UNDETERMINED` `WEAR`
eventpayload.closurecode.actionTaken
+ L'azione intrapresa alla chiusura di questa anomalia, selezionata dall'utente nel menu a discesa dell'app.
+ Tipo: String
+ Valori possibili: `ADJUST` \$1 \$1 `CLEAN` \$1 `LUBRICATE` \$1 \$1 `MODIFY` \$1 `NO_ACTION` \$1 `OTHER` `OVERHAUL` `REPLACE`
Eventpayload.closurecode.resolvedModels
+ L'insieme di modelli che ha sollevato il problema.
+ Tipo: elenco di stringhe
+ Valori possibili: `vibrationISO` \$1 `vibrationML` \$1 `temperatureML`
EventPayload. assetPositionId
+ L'identificatore della posizione patrimoniale il cui stato è cambiato.
+ Tipo: String
Modelli.TemperatureML. persistentClassificationOutput
+ L'output di classificazione persistente del modello di temperatura basato sull'apprendimento automatico
+ Tipo: numero
+ Valori validi: `UNKNOWN | HEALTHY | WARNING | ALARM`
Modelli.TemperatureML. pointwiseClassificationOutput
+ L'output di classificazione puntuale del modello di temperatura basato sull'apprendimento automatico
+ Tipo: String
+ Valori validi: `UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM`
Classe Models.VibrationISO.ISO
+ La classe ISO 20816 (uno standard per la misurazione e la valutazione delle vibrazioni delle macchine) utilizzata dal modello di vibrazione basato su ISO
+ Tipo: String
+ Valori validi: `CLASS1 | CLASS2 | CLASS3 | CLASS4`
models.VibrationISO.MutedThreshold
+ La soglia per disattivare la notifica dal modello di vibrazione basato su ISO
+ Tipo: String
+ Valori validi: `WARNING | ALARM`
Modelli. VibrationISO. persistentClassificationOutput
+ L'output di classificazione persistente del modello di vibrazione basato su ISO
+ Tipo: String
+ Valori validi: `UNKNOWN | HEALTHY | WARNING | ALARM`
Modelli.VibrationISO. pointwiseClassificationOutput
+ L'output della classificazione puntuale del modello di vibrazione basato su ISO
+ Tipo: String
+ Valori validi: `UNKNOWN | HEALTHY | WARNING | ALARM | MUTED_WARNING | MUTED_ALARM`
Modelli.VibrationML. persistentClassificationOutput
+ L'output di classificazione persistente del modello di vibrazione basato sull'apprendimento automatico
+ Tipo: String
+ Valori validi: `UNKNOWN | HEALTHY | WARNING | ALARM`
Modelli.VibrationML. pointwiseClassificationOutput
+ L'output della classificazione puntuale del modello di vibrazione basato sull'apprendimento automatico
+ Tipo: String
+ Valori validi: `UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM`
assetState.NewState
+ Lo stato della macchina dopo l'elaborazione della misurazione
+ Tipo: String
+ Valori validi: `UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM`
assetState.PreviousState
+ Lo stato della macchina prima dell'elaborazione della misurazione
+ Tipo: String
+ Valori validi: `UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM`
Eventpayload.Nome della società
+ Il nome dell'azienda che utilizza la risorsa.
+ Tipo: String
Eventpayload.geolocation.latitude
+ La latitudine della posizione fisica del sito.
+ Tipo: numero
Eventpayload.geolocation.longitude
+ La longitudine della posizione fisica del sito.
+ Tipo: numero
EventPayload.Indirizzo
+ L'indirizzo del sito.
+ Tipo: String
Eventpayload.serialNumber
+ Il numero di serie della risorsa.
+ Tipo: String
Eventpayload.make
+ La marca dell'asset.
+ Tipo: String
EventPayload.model
+ Il modello dell'asset.
+ Tipo: String
# Migrazione da Kinesis v1 a v2
Se attualmente utilizzi lo schema di dati v1, potresti già inviare dati ad Amazon S3 o elaborare ulteriormente il payload del flusso di dati con Lambda.
**Topics**
+ [Aggiornamento dello schema dei dati alla v2](#updating-to-v2)
+ [Aggiornamento dell'elaborazione dei dati con Lambda](#updating-with-lam)
## Aggiornamento dello schema dei dati alla v2
Se hai già configurato un flusso di dati con lo schema v1, puoi aggiornare il processo di esportazione dei dati effettuando le seguenti operazioni:
1. Apri la tua console Amazon Monitron.
1. Vai al tuo progetto.
1. Interrompi l'[attuale esportazione dei dati in tempo reale](monitron-kinesis-export-v2.md#stop-kinesis-export-v2).
1. Avvia l'esportazione dei dati in tempo reale per creare un nuovo flusso di dati.
1. Seleziona il flusso di dati appena creato.
1. Scegli **avvia l'esportazione dei dati in tempo reale**. A questo punto, il nuovo schema invierà il payload attraverso il flusso di dati.
1. (Facoltativo) Vai alla console Kinesis ed elimina il vecchio flusso di dati.
1. Configura un nuovo metodo di consegna per il flusso di dati appena creato con lo schema v2.
Il tuo nuovo stream ora fornisce payload conformi allo schema v2 al tuo nuovo bucket. Ti consigliamo di utilizzare due bucket distinti per avere un formato coerente nel caso in cui desideri elaborare tutti i dati in questi bucket. Ad esempio, utilizzando altri servizi come Athena e. AWS Glue
**Nota**
Se stavi distribuendo i tuoi dati ad Amazon S3, scopri come [archiviare i dati esportati in Amazon S3](kinesis-store-S3-v2.md#kinesis-store-S3-title-v2) per informazioni dettagliate su come distribuire i dati ad Amazon S3 con lo schema v2.
**Nota**
Se stavi usando una funzione Lambda per elaborare i tuoi payload, scopri come [elaborare i dati con](https://docs.aws.amazon.com/Monitron/latest/user-guide/data-export-lambda.html) Lambda. Puoi anche fare riferimento alla sezione [Aggiornamento con Lambda](#updating-with-lam) per ulteriori informazioni.
## Aggiornamento dell'elaborazione dei dati con Lambda
L'aggiornamento dell'elaborazione dei dati con Lambda richiede di considerare che il flusso di dati v2 è ora basato su eventi. Il codice Lambda v1 iniziale potrebbe essere stato simile al seguente:
```
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
# ...
```
Poiché lo schema di dati v1 si trova su un percorso obsoleto, il codice Lambda precedente non funzionerà con tutti i nuovi flussi di dati.
Il seguente codice di esempio in Python elaborerà gli eventi dal flusso Kinesis con lo schema di dati v2. Questo codice utilizza il nuovo `eventType` parametro per orientare l'elaborazione verso il gestore appropriato:
```
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
```