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à.

# CloudWatch metriche
<a name="cloudwatch-metrics-component"></a>

Il componente Amazon CloudWatch metrics (`aws.greengrass.Cloudwatch`) pubblica metriche personalizzate dai dispositivi principali di Greengrass su Amazon. CloudWatch Il componente consente ai componenti di pubblicare CloudWatch metriche, che puoi utilizzare per monitorare e analizzare l'ambiente del dispositivo principale Greengrass. Per ulteriori informazioni, consulta [ Using Amazon CloudWatch metrics ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) nella * Amazon CloudWatch User Guide. *

Per pubblicare una CloudWatch metrica con questo componente, pubblica un messaggio su un argomento a cui questo componente è abbonato. Per impostazione predefinita, questo componente si iscrive all'`cloudwatch/metric/put`[argomento locale. publish/subscribe ](ipc-publish-subscribe.md) È possibile specificare altri argomenti, inclusi gli argomenti AWS IoT Core MQTT, quando si distribuisce questo componente.

Questo componente raggruppa in batch le metriche che si trovano nello stesso namespace e le pubblica a intervalli regolari. CloudWatch 

**Nota**  
Questo componente fornisce funzionalità simili al connettore delle metriche in V1. CloudWatch AWS IoT Greengrass Per ulteriori informazioni, vedi [ CloudWatch Metrics Connector ](https://docs.aws.amazon.com/greengrass/latest/developerguide/cloudwatch-metrics-connector.html) nella *AWS IoT Greengrass V1 Developer Guide. *

**Topics**
+ [Versioni](#cloudwatch-metrics-component-versions)
+ [Tipo](#cloudwatch-metrics-component-type)
+ [Sistema operativo](#cloudwatch-metrics-component-os-support)
+ [Requisiti](#cloudwatch-metrics-component-requirements)
+ [Dipendenze](#cloudwatch-metrics-component-dependencies)
+ [Configurazione](#cloudwatch-metrics-component-configuration)
+ [Dati di input](#cloudwatch-metrics-component-input-data)
+ [Dati di output](#cloudwatch-metrics-component-output-data)
+ [Licenze](#cloudwatch-metrics-component-licenses)
+ [File di registro locale](#cloudwatch-metrics-component-log-file)
+ [Changelog](#cloudwatch-metrics-component-changelog)
+ [Consulta anche](#cloudwatch-metrics-component-see-also)

## Versioni
<a name="cloudwatch-metrics-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 4.0.x
+ 3.2.x
+ 3.1.x
+ 3.0.x
+ 2.1.x
+ 2.0.x

Per informazioni sulle modifiche apportate a ciascuna versione del componente, consultate il changelog. [Changelog](#cloudwatch-metrics-component-changelog)

## Tipo
<a name="cloudwatch-metrics-component-type"></a>

------
#### [ v4.x - v3.x ]

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a> componente è un componente generico ()`aws.greengrass.generic`. Il nucleo di [ Greengrass ](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente. 

------
#### [ v2.x ]

<a name="public-component-type-lambda"></a>Questo <a name="public-component-type-lambda-phrase"></a> componente è un componente Lambda (`aws.greengrass.lambda`). Il nucleo di [ Greengrass ](greengrass-nucleus-component.md) esegue la funzione Lambda di questo componente utilizzando il componente di avvio [ Lambda. ](lambda-launcher-component.md) 

------

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="cloudwatch-metrics-component-os-support"></a>

------
#### [ v4.x - v3.x ]

Questo componente può essere installato sui dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

------
#### [ v2.x ]

Questo componente può essere installato solo sui dispositivi principali di Linux.

------

## Requisiti
<a name="cloudwatch-metrics-component-requirements"></a>

Questo componente ha i seguenti requisiti:

------
#### [ v4.x - v3.x ]
+ <a name="public-component-python3-requirement"></a>[Python ](https://www.python.org/) versione 3.7 installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH.
+ Le seguenti librerie Python, incluse le eventuali dipendenze, devono essere installate e disponibili per l'utente che esegue il componente:
  + [SDK per dispositivi AWS IoT v2 per Python ](https://github.com/aws/aws-iot-device-sdk-python-v2)
  + [AWS SDK per Python (Boto3)](http://boto.readthedocs.org/en/latest/ref/)
**Nota**  
È possibile impostare la `UseInstaller` configurazione su per `true` installare automaticamente queste librerie nell'ambiente Python fornito.
+ Il ruolo del dispositivo [ Greengrass ](device-service-role.md) deve consentire l'`cloudwatch:PutMetricData`azione, come mostrato nel seguente esempio di policy IAM.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "cloudwatch:PutMetricData"
        ],
        "Effect": "Allow",
        "Resource": "*"
      }
    ]
  }
  ```

------

  Per ulteriori informazioni, consulta il riferimento CloudWatch alle autorizzazioni di [ Amazon ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) nella * Amazon CloudWatch User Guide. *

------
#### [ 2.x ]
+ <a name="core-device-lambda-function-requirements"></a>Il dispositivo principale deve soddisfare i requisiti per eseguire le funzioni Lambda. Se desideri che il dispositivo principale esegua funzioni Lambda containerizzate, il dispositivo deve soddisfare i requisiti per farlo. Per ulteriori informazioni, consulta [Requisiti della funzione Lambda](setting-up.md#greengrass-v2-lambda-requirements).
+ <a name="public-component-python3-requirement"></a>[La ](https://www.python.org/) versione 3.7 di Python è stata installata sul dispositivo principale e aggiunta alla variabile di ambiente PATH.
+ Il ruolo del dispositivo [ Greengrass ](device-service-role.md) deve consentire l'`cloudwatch:PutMetricData`azione, come mostrato nel seguente esempio di policy IAM.

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "cloudwatch:PutMetricData"
        ],
        "Effect": "Allow",
        "Resource": "*"
      }
    ]
  }
  ```

------

  Per ulteriori informazioni, consulta il riferimento CloudWatch alle autorizzazioni di [ Amazon ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) nella * Amazon CloudWatch User Guide. *
+ <a name="connector-component-legacy-subscription-router-dependency"></a>Per ricevere i dati di output da questo componente, è necessario unire il seguente aggiornamento di configurazione per il [ vecchio componente router in abbonamento ](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) quando si distribuisce questo componente. Questa configurazione specifica l'argomento in cui questo componente pubblica le risposte.

------
#### [ Legacy subscription router v2.1.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-cloudwatch": {
        "id": "aws-greengrass-cloudwatch",
        "source": "component:aws.greengrass.Cloudwatch",
        "subject": "cloudwatch/metric/put/status",
        "target": "cloud"
      }
    }
  }
  ```

------
#### [ Legacy subscription router v2.0.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-cloudwatch": {
        "id": "aws-greengrass-cloudwatch",
        "source": "arn:aws:lambda:{{region}}:aws:function:aws-greengrass-cloudwatch:{{version}}",
        "subject": "cloudwatch/metric/put/status",
        "target": "cloud"
      }
    }
  }
  ```<a name="connector-component-legacy-subscription-router-dependency-replace"></a>
  + Sostituisci {{region}} con quello Regione AWS che usi.
  + Sostituisci {{version}} con la versione della funzione Lambda eseguita da questo componente. Per trovare la versione della funzione Lambda, è necessario visualizzare la ricetta per la versione di questo componente che si desidera distribuire. Apri la pagina dei dettagli di questo componente nella [AWS IoT Greengrass console e cerca la ](https://console.aws.amazon.com/greengrass) coppia chiave-valore della funzione ** ** Lambda. Questa coppia chiave-valore contiene il nome e la versione della funzione Lambda.

**Importante**  <a name="connector-component-legacy-subscription-router-dependency-note"></a>
È necessario aggiornare la versione della funzione Lambda sul router di abbonamento precedente ogni volta che si distribuisce questo componente. Ciò garantisce l'utilizzo della versione della funzione Lambda corretta per la versione del componente da distribuire.

------

  <a name="connector-component-create-deployments"></a>Per ulteriori informazioni, consulta [Creare distribuzione](create-deployments.md).

------

### Endpoint e porte
<a name="cloudwatch-metrics-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita ai seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per il funzionamento di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
| `monitoring.{{region}}.amazonaws.com` | 443 | Sì | Metriche di caricamento. CloudWatch  | 

## Dipendenze
<a name="cloudwatch-metrics-component-dependencies"></a>

Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti del componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni [ rilasciate ](#cloudwatch-metrics-component-changelog) di questo componente e i vincoli semantici della versione che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna versione del componente nella console. [AWS IoT Greengrass](https://console.aws.amazon.com/greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle ** dipendenze**.

------
#### [ 4.0.0 - 3.0.0 ]

La tabella seguente elenca le dipendenze per le versioni da 4.0.0 a 3.0.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <3.0.0 | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | > = 0.0.0 | Rigidi | 

------
#### [ 2.1.4 - 2.1.9 ]

La tabella seguente elenca le dipendenze per le versioni da 2.1.4 a 2.1.9 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <3.0.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.4 - 2.1.8 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.4 e 2.1.8 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <3.0.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.2 - 2.1.3 ]

La tabella seguente elenca le dipendenze per le versioni 2.1.2 e 2.1.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.8.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.1.1 ]

La tabella seguente elenca le dipendenze per la versione 2.1.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.7.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.8 - 2.1.0 ]

La tabella seguente elenca le dipendenze per le versioni da 2.0.8 a 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.7 ]

La tabella seguente elenca le dipendenze per la versione 2.0.7 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.5.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.6 ]

La tabella seguente elenca le dipendenze per la versione 2.0.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.4.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.5 ]

La tabella seguente elenca le dipendenze per la versione 2.0.5 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.3.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.4 ]

La tabella seguente elenca le dipendenze per la versione 2.0.4 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.0 <2.2.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | ^2.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | ^2.0.0  | Rigidi | 

------
#### [ 2.0.3 ]

La tabella seguente elenca le dipendenze per la versione 2.0.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass ](greengrass-nucleus-component.md) | > =2.0.3 <2.1.0  | Rigidi | 
| [Launcher Lambda ](lambda-launcher-component.md) | > = 1.0.0  | Rigidi | 
| [Runtime Lambda](lambda-runtimes-component.md) | > = 1.0.0  | Flessibili | 
| [Servizio di scambio di token ](token-exchange-service-component.md) | > = 1.0.0  | Rigidi | 

------

Per ulteriori informazioni sulle dipendenze dei componenti, consultate il riferimento alla composizione dei [ componenti. ](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="cloudwatch-metrics-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

------
#### [ v4.x ]

 `PublishInterval`   
(Facoltativo) Il numero massimo di secondi di attesa prima che il componente pubblichi metriche in batch per un determinato namespace. Per configurare il componente in modo che pubblichi le metriche man mano che le riceve, vale a dire senza batch, specifica. `0`  
Il componente viene pubblicato su CloudWatch dopo aver ricevuto 20 metriche nello stesso namespace o dopo l'intervallo specificato.  
Il componente non specifica l'ordine di pubblicazione degli eventi.
Questo valore può essere un massimo di 900 secondi.  
Impostazione predefinita: 10 secondi

 `MaxMetricsToRetain`   
(Facoltativo) Il numero massimo di metriche in tutti i namespace da salvare in memoria prima che il componente le sostituisca con metriche più recenti.  
Questo limite si applica quando il dispositivo principale non dispone di una connessione a Internet, quindi il componente memorizza nel buffer le metriche per pubblicarle in un secondo momento. Quando il buffer è pieno, il componente sostituisce le metriche più vecchie con quelle più recenti. Le metriche in un determinato namespace sostituiscono solo le metriche nello stesso namespace.  
Se il processo host del componente viene interrotto, il componente non salva le metriche. Ciò può accadere durante una distribuzione o al riavvio del dispositivo principale, ad esempio.
Questo valore deve corrispondere ad almeno 2.000 metriche.  
Impostazione predefinita: 5.000 metriche

`InputTopic`  
(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica `true` per`PubSubToIoTCore`, è possibile utilizzare i caratteri jolly MQTT (\+ e \#) in questo argomento.  
Impostazione predefinita: `cloudwatch/metric/put`

`OutputTopic`  
(Facoltativo) L'argomento su cui il componente pubblica le risposte sullo stato.  
Impostazione predefinita: `cloudwatch/metric/put/status`

`PubSubToIoTCore`  
(Facoltativo) Valore di stringa che definisce se pubblicare e sottoscrivere argomenti AWS IoT Core MQTT. I valori supportati sono `true` e `false`.  
Impostazione predefinita: `false`

`LogLevel`  
(Facoltativo) Il livello di registrazione del componente. Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  
+ `DEBUG`
+ `INFO`
+ `WARNING`
+ `ERROR`
+ `CRITICAL`
Impostazione predefinita: `INFO`

 `UseInstaller`   
(Facoltativo) Valore booleano che definisce se utilizzare lo script di installazione per installare le dipendenze Python di questo componente nell'ambiente Python fornito.  
Imposta questo valore su per installare automaticamente le `true` dipendenze Python di questo componente. Se impostato su`false`, è necessario installare le seguenti librerie, incluse le eventuali dipendenze, e renderle disponibili per l'ambiente Python fornito all'utente che esegue il componente.  
+ [SDK per dispositivi AWS IoT v2 per Python ](https://github.com/aws/aws-iot-device-sdk-python-v2)
+ [AWS SDK per Python (Boto3)](http://boto.readthedocs.org/en/latest/ref/)
Impostazione predefinita: `false`

`PublishRegion`  
(Facoltativo) La metrica Regione AWS su cui pubblicare CloudWatch le metriche. Questo valore sostituisce la regione predefinita per il dispositivo principale. Questo parametro è obbligatorio solo per le metriche interregionali.

`accessControl`  
(Facoltativo) L'oggetto che contiene la politica di [ autorizzazione ](interprocess-communication.md#ipc-authorization-policies) che consente al componente di pubblicare e sottoscrivere gli argomenti specificati. Se si specificano valori personalizzati per `InputTopic` e`OutputTopic`, è necessario aggiornare i valori delle risorse in questo oggetto.   
Impostazione predefinita:   

```
{
  "aws.greengrass.ipc.pubsub": {
    "aws.greengrass.Cloudwatch:pubsub:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToTopic"
      ],
      "resources": [
        "{{cloudwatch/metric/put}}"
      ]
    },
    "aws.greengrass.Cloudwatch:pubsub:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToTopic"
      ],
      "resources": [
        "{{cloudwatch/metric/put/status}}"
      ]
    }
  },
  "aws.greengrass.ipc.mqttproxy": {
    "aws.greengrass.Cloudwatch:mqttproxy:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToIoTCore"
      ],
      "resources": [
        "{{cloudwatch/metric/put}}"
      ]
    },
    "aws.greengrass.Cloudwatch:mqttproxy:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToIoTCore"
      ],
      "resources": [
        "{{cloudwatch/metric/put/status}}"
      ]
    }
  }
}
```

**Example Esempio: aggiornamento dell'unione delle configurazioni**  

```
{
  "PublishInterval": 0,
  "PubSubToIoTCore": true
}
```

------
#### [ v3.x ]

 `PublishInterval`   
(Facoltativo) Il numero massimo di secondi di attesa prima che il componente pubblichi metriche in batch per un determinato namespace. Per configurare il componente in modo che pubblichi le metriche man mano che le riceve, vale a dire senza batch, specifica. `0`  
Il componente viene pubblicato su CloudWatch dopo aver ricevuto 20 metriche nello stesso namespace o dopo l'intervallo specificato.  
Il componente non specifica l'ordine di pubblicazione degli eventi.
Questo valore può essere un massimo di 900 secondi.  
Impostazione predefinita: 10 secondi

 `MaxMetricsToRetain`   
(Facoltativo) Il numero massimo di metriche in tutti i namespace da salvare in memoria prima che il componente le sostituisca con metriche più recenti.  
Questo limite si applica quando il dispositivo principale non dispone di una connessione a Internet, quindi il componente memorizza nel buffer le metriche per pubblicarle in un secondo momento. Quando il buffer è pieno, il componente sostituisce le metriche più vecchie con quelle più recenti. Le metriche in un determinato namespace sostituiscono solo le metriche nello stesso namespace.  
Se il processo host del componente viene interrotto, il componente non salva le metriche. Ciò può accadere durante una distribuzione o al riavvio del dispositivo principale, ad esempio.
Questo valore deve essere di almeno 2.000 metriche.  
Impostazione predefinita: 5.000 metriche

`InputTopic`  
(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica `true` per`PubSubToIoTCore`, è possibile utilizzare i caratteri jolly MQTT (\+ e \#) in questo argomento.  
Impostazione predefinita: `cloudwatch/metric/put`

`OutputTopic`  
(Facoltativo) L'argomento su cui il componente pubblica le risposte sullo stato.  
Impostazione predefinita: `cloudwatch/metric/put/status`

`PubSubToIoTCore`  
(Facoltativo) Valore di stringa che definisce se pubblicare e sottoscrivere argomenti AWS IoT Core MQTT. I valori supportati sono `true` e `false`.  
Impostazione predefinita: `false`

`LogLevel`  
(Facoltativo) Il livello di registrazione del componente. Scegliete tra i seguenti livelli di registro, elencati qui in ordine di livello:  
+ `DEBUG`
+ `INFO`
+ `WARNING`
+ `ERROR`
+ `CRITICAL`
Impostazione predefinita: `INFO`

`UseInstaller`  
(Facoltativo) Valore booleano che definisce se utilizzare lo script di installazione per installare le dipendenze Python di questo componente nell'ambiente Python fornito.  
Imposta questo valore su per utilizzare uno script personalizzato `false` o installare manualmente le dipendenze. Se impostato su`false`, è necessario installare le seguenti librerie, incluse le eventuali dipendenze, e renderle disponibili per l'ambiente Python fornito all'utente che esegue il componente.  
+ [SDK per dispositivi AWS IoT v2 per Python ](https://github.com/aws/aws-iot-device-sdk-python-v2)
+ [AWS SDK per Python (Boto3)](http://boto.readthedocs.org/en/latest/ref/)
Impostazione predefinita: `true`

`PublishRegion`  
(Facoltativo) La metrica Regione AWS su cui pubblicare CloudWatch le metriche. Questo valore sostituisce la regione predefinita per il dispositivo principale. Questo parametro è obbligatorio solo per le metriche interregionali.

`accessControl`  
(Facoltativo) L'oggetto che contiene la politica di [ autorizzazione ](interprocess-communication.md#ipc-authorization-policies) che consente al componente di pubblicare e sottoscrivere gli argomenti specificati. Se si specificano valori personalizzati per `InputTopic` e`OutputTopic`, è necessario aggiornare i valori delle risorse in questo oggetto.   
Impostazione predefinita:   

```
{
  "aws.greengrass.ipc.pubsub": {
    "aws.greengrass.Cloudwatch:pubsub:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToTopic"
      ],
      "resources": [
        "{{cloudwatch/metric/put}}"
      ]
    },
    "aws.greengrass.Cloudwatch:pubsub:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToTopic"
      ],
      "resources": [
        "{{cloudwatch/metric/put/status}}"
      ]
    }
  },
  "aws.greengrass.ipc.mqttproxy": {
    "aws.greengrass.Cloudwatch:mqttproxy:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToIoTCore"
      ],
      "resources": [
        "{{cloudwatch/metric/put}}"
      ]
    },
    "aws.greengrass.Cloudwatch:mqttproxy:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToIoTCore"
      ],
      "resources": [
        "{{cloudwatch/metric/put/status}}"
      ]
    }
  }
}
```

**Example Esempio: aggiornamento dell'unione delle configurazioni**  

```
{
  "PublishInterval": 0,
  "PubSubToIoTCore": true
}
```

------
#### [ v2.x ]

**Nota**  <a name="connector-component-lambda-parameters"></a>
La configurazione predefinita di questo componente include i parametri della funzione Lambda. Ti consigliamo di modificare solo i seguenti parametri per configurare questo componente sui tuoi dispositivi.

 `lambdaParams`   
Un oggetto che contiene i parametri per la funzione Lambda di questo componente. Questo oggetto contiene le seguenti informazioni:    
 `EnvironmentVariables`   
Un oggetto che contiene i parametri della funzione Lambda. Questo oggetto contiene le seguenti informazioni:    
 `PUBLISH_INTERVAL`   
(Facoltativo) Il numero massimo di secondi di attesa prima che il componente pubblichi metriche in batch per un determinato namespace. Per configurare il componente in modo che pubblichi le metriche man mano che le riceve, vale a dire senza batch, specifica. `0`  
Il componente viene pubblicato su CloudWatch dopo aver ricevuto 20 metriche nello stesso namespace o dopo l'intervallo specificato.  
Il componente non garantisce l'ordine di pubblicazione degli eventi.
Questo valore può essere al massimo 900 secondi.  
Impostazione predefinita: 10 secondi  
 `MAX_METRICS_TO_RETAIN`   
(Facoltativo) Il numero massimo di metriche in tutti i namespace da salvare in memoria prima che il componente le sostituisca con metriche più recenti.  
Questo limite si applica quando il dispositivo principale non dispone di una connessione a Internet, quindi il componente memorizza nel buffer le metriche per pubblicarle in un secondo momento. Quando il buffer è pieno, il componente sostituisce le metriche più vecchie con quelle più recenti. Le metriche in un determinato namespace sostituiscono solo le metriche nello stesso namespace.  
Se il processo host del componente viene interrotto, il componente non salva le metriche. Ciò può accadere durante una distribuzione o al riavvio del dispositivo principale, ad esempio.
Questo valore deve corrispondere ad almeno 2.000 metriche.  
Impostazione predefinita: 5.000 metriche  
 `PUBLISH_REGION`   
(Facoltativo) La metrica Regione AWS su cui pubblicare CloudWatch le metriche. Questo valore sostituisce la regione predefinita per il dispositivo principale. Questo parametro è obbligatorio solo per le metriche interregionali.

`containerMode`  <a name="connector-component-container-mode-parameter"></a>
(Facoltativo) La modalità di containerizzazione per questo componente. Seleziona una delle opzioni seguenti:  <a name="lambda-function-component-container-mode-parameter"></a>
+ `NoContainer`— Il componente non viene eseguito in un ambiente di runtime isolato.
+ `GreengrassContainer`— Il componente viene eseguito in un ambiente di runtime isolato all'interno del AWS IoT Greengrass contenitore.
Impostazione predefinita: `GreengrassContainer`

 `containerParams`   
<a name="connector-component-container-params-description"></a>(Facoltativo) Un oggetto che contiene i parametri del contenitore per questo componente. Il componente utilizza questi parametri se specificate `GreengrassContainer` per`containerMode`.  
Questo oggetto contiene le seguenti informazioni:    
 `memorySize`   
<a name="connector-component-container-params-memory-size-description"></a>(Facoltativo) La quantità di memoria (in kilobyte) da allocare al componente.  
Il valore predefinito è 64 MB (65.535 KB).

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
(Facoltativo) Un oggetto che contiene gli argomenti a cui il componente si iscrive per ricevere messaggi. È possibile specificare ogni argomento e se il componente sottoscrive argomenti MQTT provenienti da AWS IoT Core o argomenti locali. publish/subscribe   
Questo oggetto contiene le seguenti informazioni:    
`0`— Questo è un indice di matrice sotto forma di stringa.  
Un oggetto che contiene le seguenti informazioni:    
`type`  
(Facoltativo) Il tipo di publish/subscribe messaggistica utilizzato da questo componente per sottoscrivere i messaggi. Seleziona una delle opzioni seguenti:  
+ `PUB_SUB`— Sottoscrivi ai publish/subscribe messaggi locali. Se scegli questa opzione, l'argomento non può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi da un componente personalizzato quando si specifica questa opzione, vedere. [Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md)
+ `IOT_CORE`— Iscriviti ai messaggi AWS IoT Core MQTT. Se scegli questa opzione, l'argomento può contenere caratteri jolly MQTT. Per ulteriori informazioni su come inviare messaggi da componenti personalizzati quando si specifica questa opzione, vedere. [Publish/subscribe AWS IoT Core Messaggi MQTT](ipc-iot-core-mqtt.md)
Impostazione predefinita: `PUB_SUB`  
`topic`  
(Facoltativo) L'argomento a cui il componente si iscrive per ricevere messaggi. Se si specifica `IotCore` per`type`, è possibile utilizzare i caratteri jolly MQTT (`+`e`#`) in questo argomento.

**Example Esempio: aggiornamento dell'unione delle configurazioni (modalità contenitore)**  

```
{
  "containerMode": "GreengrassContainer"
}
```

**Example Esempio: aggiornamento dell'unione delle configurazioni (nessuna modalità contenitore)**  

```
{
  "containerMode": "NoContainer"
}
```

------

## Dati di input
<a name="cloudwatch-metrics-component-input-data"></a>

Questo componente accetta le metriche sull'argomento seguente e le pubblica su. CloudWatch <a name="connector-component-local-publish"></a>Per impostazione predefinita, questo componente si iscrive ai messaggi locali. publish/subscribe Per ulteriori informazioni su come pubblicare messaggi su questo componente dai componenti personalizzati, vedere[Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md).  

A partire dalla versione del componente v3.0.0, è possibile configurare facoltativamente questo componente per sottoscrivere un argomento MQTT impostando il parametro di configurazione su. `PubSubToIoTCore` `true` Per ulteriori informazioni sulla pubblicazione di messaggi su un argomento MQTT nei componenti personalizzati, vedere. [Publish/subscribe AWS IoT Core Messaggi MQTT](ipc-iot-core-mqtt.md)

 **Argomento predefinito: ** `cloudwatch/metric/put` 

<a name="connector-component-input-properties"></a>Il messaggio accetta le seguenti proprietà. I messaggi di input devono essere in formato JSON.

 `request`   
La metrica contenuta in questo messaggio.  
L'oggetto della richiesta contiene i dati dei parametri da pubblicare in CloudWatch. I valori delle metriche devono soddisfare le specifiche dell'[`PutMetricData`](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)operazione.  
Tipo: `object` che contiene le seguenti informazioni:    
 `namespace`   
Lo spazio dei nomi definito dall'utente per i dati delle metriche in questa richiesta. CloudWatch utilizza i namespace come contenitori per i punti dati metrici.  
Non è possibile specificare uno spazio dei nomi che inizi con la stringa riservata. `AWS/`
Tipo: `string`  
Pattern valido: `[^:].*`  
 `metricData`   
I dati del parametro.  
Tipo: `object` che contiene le seguenti informazioni:    
 `metricName`   
Nome del parametro.  
Tipo: `string`  
 `value`   
Il valore del parametro.  
CloudWatch rifiuta i valori troppo piccoli o troppo grandi. Il valore deve essere compreso tra `8.515920e-109` e `1.174271e+108` (Base 10) o `2e-360` e `2e360` (Base 2). CloudWatch non supporta valori speciali come `NaN``+Infinity`, e`-Infinity`.
Tipo: `double`  
 `dimensions`   
(Facoltativo) Le dimensioni della metrica. Le dimensioni forniscono ulteriori informazioni sul parametro e sui relativi dati. Un parametro è in grado di definire fino a 10 dimensioni.  
Questo componente include automaticamente una dimensione denominata`coreName`, in cui il valore è il nome del dispositivo principale.  
Tipo: `array` di oggetti che contengono ciascuno le seguenti informazioni:    
 `name`   
(Facoltativo) Il nome della dimensione.  
Tipo: `string`  
 `value`   
(Facoltativo) Il valore della dimensione.  
Tipo: `string`  
 `timestamp`   
(Facoltativo) L'ora in cui sono stati ricevuti i dati metrici, espressa in secondi in epoca Unix.  
Il valore predefinito è l'ora in cui il componente riceve il messaggio.  
Tipo: `double`  
Se utilizzi una versione compresa tra 2.0.3 e 2.0.7 di questo componente, ti consigliamo di recuperare il timestamp separatamente per ogni metrica quando invii più metriche da un'unica fonte. Non utilizzare una variabile per memorizzare il timestamp.  
 `unit`   
(Facoltativo) L'unità della metrica.  
Tipo: `string`  
Valori validi: `Seconds``Microseconds`,`Milliseconds`,`Bytes`,,`Kilobytes`,`Megabytes`,`Gigabytes`,`Terabytes`,`Bits`,,`Kilobits`,`Megabits`,`Gigabits`,`Terabits`,,`Percent`,`Count`,`Bytes/Second`,`Kilobytes/Second`,`Megabytes/Second`,,`Gigabytes/Second`,`Terabytes/Second`,`Bits/Second`,`Kilobits/Second`,`Megabits/Second`,,`Gigabits/Second`,`Terabits/Second`, `Count/Second` `None`  
L’impostazione predefinita è `None`.

**Nota**  
Tutte le quote che si applicano all' CloudWatch `PutMetricData`API si applicano alle metriche pubblicate con questo componente. Le seguenti quote sono particolarmente importanti:  
Limite di 40 KB sul payload dell'API
20 parametri per ciascuna richiesta API
150 transazioni al secondo (TPS) per l'API `PutMetricData`
Per ulteriori informazioni, consulta le quote [ CloudWatch di servizio ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html) nella Guida per l'*CloudWatch utente. *

**Example Input di esempio**  

```
{
  "request": {
    "namespace": "Greengrass",
    "metricData": {
      "metricName": "latency",
      "dimensions": [
        {
          "name": "hostname",
          "value": "test_hostname"
        }
      ],
      "timestamp": 1539027324,
      "value": 123.0,
      "unit": "Seconds"
    }
  }
}
```

## Dati di output
<a name="cloudwatch-metrics-component-output-data"></a>

 <a name="connector-component-output-data-pubsub"></a>Per impostazione predefinita, questo componente pubblica le risposte come dati di output sul seguente publish/subscribe argomento locale. Per ulteriori informazioni su come sottoscrivere i messaggi su questo argomento nei componenti personalizzati, vedere[Pubblicare/sottoscrivere messaggi locali](ipc-publish-subscribe.md).  

È possibile configurare facoltativamente questo componente per la pubblicazione su un argomento MQTT impostando il parametro di `PubSubToIoTCore` configurazione su. `true` Per ulteriori informazioni sulla sottoscrizione ai messaggi su un argomento MQTT nei componenti personalizzati, vedere. [Publish/subscribe AWS IoT Core Messaggi MQTT](ipc-iot-core-mqtt.md)

**Nota**  
Le versioni dei componenti 2.0.x pubblicano le risposte come dati di output su un argomento MQTT per impostazione predefinita. È necessario specificare l'argomento come argomento `subject` nella configurazione del componente router in abbonamento [ precedente. ](legacy-subscription-router-component.md)

 **Argomento predefinito: ** `cloudwatch/metric/put/status` 

**Example Output di esempio: Operazione riuscita**  
La risposta include lo spazio dei nomi dei dati della metrica e il `RequestId` campo della risposta. CloudWatch   

```
{
  "response": {
    "cloudwatch_rid": "70573243-d723-11e8-b095-75ff2EXAMPLE",
    "namespace": "Greengrass",
    "status": "success"
  }
}
```

**Example Esempio di output: Errore**  

```
{
  "response" : {
    "namespace": "Greengrass",
    "error": "InvalidInputException",
    "error_message": "cw metric is invalid",
    "status": "fail"
  }
}
```

**Nota**  <a name="connector-component-retryable-error"></a>
Se il componente rileva un errore che può essere ripetuto, ad esempio un errore di connessione, riprova la pubblicazione nel batch successivo.

## Licenze
<a name="cloudwatch-metrics-component-licenses"></a>

Questo componente include le seguenti terze parti: software/licensing<a name="boto-3-licenses"></a>
+ [AWS SDK per Python (Boto3)](https://pypi.org/project/boto3/)/Apache License 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache License 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License
+ [docutils](https://pypi.org/project/docutils/)/BSD License, GNU General Public License (GPL), Python Software Foundation License, Public Domain
+ [jmespath](https://pypi.org/project/jmespath/)/MIT License
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT License

<a name="component-core-software-license"></a>Questo componente è rilasciato in base al contratto [ di licenza software ](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) Greengrass Core.

## File di registro locale
<a name="cloudwatch-metrics-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
{{/greengrass/v2}}/logs/aws.greengrass.Cloudwatch.log
```

------
#### [ Windows ]

```
{{C:\greengrass\v2}}\logs\aws.greengrass.Cloudwatch.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `{{/greengrass/v2}}` o {{C:\\greengrass\\v2}} con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f {{/greengrass/v2}}/logs/aws.greengrass.Cloudwatch.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content {{C:\greengrass\v2}}\logs\aws.greengrass.Cloudwatch.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="cloudwatch-metrics-component-changelog"></a>

La tabella seguente descrive le modifiche in ciascuna versione del componente.

------
#### [ v4.x - v3.x ]


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
| 4.0.0 |  **Nuove funzionalità**<br />   La `UseInstaller` configurazione predefinita ora è. `false`     | 
| 3.2.0 |  **Nuove funzionalità**<br />   Aggiungi i supporti per le ricette per Greengrass nucleus lite     | 
| 3.1.0 |  **Correzioni di bug e miglioramenti**<br />   Aggiunge il supporto per le configurazioni del proxy di rete HTTPS. Per ulteriori informazioni, consulta [Connessione alla porta 443 o tramite un proxy di rete](configure-greengrass-core-v2.md#configure-alpn-network-proxy) e [Abilita il dispositivo principale in modo che consideri attendibile un proxy HTTPS](configure-greengrass-core-v2.md#https-proxy-certificate-trust).     | 
| 3.0.0 | <a name="changelog-cloudwatch-metrics-3.0.0-major-version-changes"></a>Questa versione del componente CloudWatch metrics prevede parametri di configurazione diversi rispetto alla versione 2.x. Se si utilizza una configurazione non predefinita per la versione 2.x e si desidera eseguire l'aggiornamento da v2.x a v3.x, è necessario aggiornare la configurazione del componente. Per ulteriori informazioni, consulta Configurazione del componente Metrics. [ CloudWatch ](#cloudwatch-metrics-component-configuration)<a name="changelog-cloudwatch-metrics-3.0.0"></a>**Nuove funzionalità**<br />   Aggiunge il supporto per i dispositivi principali che eseguono Windows.   Cambia il tipo di componente da componente Lambda a componente generico. Questo componente ora non dipende più dal componente precedente del router in abbonamento per creare gli abbonamenti.    Aggiunge un nuovo parametro di `InputTopic` configurazione per specificare l'argomento a cui il componente si iscrive per ricevere messaggi.   Aggiunge un nuovo parametro di `OutputTopic` configurazione per specificare l'argomento su cui il componente pubblica le risposte di stato.   Aggiunge un nuovo parametro di `PubSubToIoTCore` configurazione per specificare se pubblicare e sottoscrivere argomenti AWS IoT Core MQTT.   Aggiunge il nuovo parametro `UseInstaller` di configurazione che consente di disattivare facoltativamente lo script di installazione che installa le dipendenze dei componenti.   <br />**Correzioni di bug e miglioramenti**<br /> Aggiunge il supporto per i timestamp duplicati nei dati di input.  | 

------
#### [ v2.x ]


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
| 2.1.8 | Versione aggiornata per Greengrass nucleus versione 2.13.0. | 
| 2.1.3 | Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. | 
| 2.1.2 | Versione aggiornata per la versione 2.7.0 di Greengrass nucleus. | 
| 2.1.1 | Versione aggiornata per la versione 2.6.0 di Greengrass nucleus. | 
| 2.1.0 |  **Nuove funzionalità**<br />   Aggiunge il supporto per le configurazioni del proxy di rete HTTPS. Per ulteriori informazioni, consulta [Connessione alla porta 443 o tramite un proxy di rete](configure-greengrass-core-v2.md#configure-alpn-network-proxy) e [Abilita il dispositivo principale in modo che consideri attendibile un proxy HTTPS](configure-greengrass-core-v2.md#https-proxy-certificate-trust).     | 
| 2.0.8 |  **Correzioni di bug e miglioramenti**<br />   Aggiunge il supporto per i timestamp duplicati nei dati di input.   Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.     | 
| 2.0.7 | Versione aggiornata per la versione 2.4.0 di Greengrass nucleus. | 
| 2.0.6 | Versione aggiornata per la versione 2.3.0 di Greengrass nucleus. | 
| 2.0.5 | Versione aggiornata per la versione 2.2.0 di Greengrass nucleus. | 
| 2.0.4 | Versione aggiornata per la versione 2.1.0 di Greengrass nucleus. | 
| 2.0.3 | Versione iniziale. | 

------

## Consulta anche
<a name="cloudwatch-metrics-component-see-also"></a>
+ [Utilizzo delle CloudWatch metriche Amazon ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) nella Amazon User Guide * CloudWatch *
+ [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)nell'*Amazon CloudWatch API Reference *