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à. # Connessione a un'origine dati predefinita con una procedura guidata Questo argomento fornisce istruzioni per l'utilizzo della procedura guidata per la connessione CloudWatch alle seguenti fonti di dati. + OpenSearch Servizio Amazon + Amazon Managed Service per Prometheus + Amazon RDS per MySQL + Amazon RDS per PostgreSQL + File CSV di Amazon S3 + Microsoft Azure Monitor + Prometheus Le sottosezioni di questo argomento includono note sulla gestione e sull'esecuzione di query con ciascuna di queste origini dati. **Per creare un connettore a un'origine dati** 1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Nel pannello di navigazione scegli **Impostazioni**. 1. Seleziona la scheda **Origini dati dei parametri**. 1. Seleziona **Create data source (Crea origine dati)**. 1. Seleziona l'origine che desideri, quindi scegli **Successivo**. 1. Inserisci un nome per l'origine dati. 1. Inserisci le altre informazioni richieste, a seconda dell'origine dati che hai scelto. Queste possono includere credenziali per accedere all'origine dati e alle informazioni di identificazione dell'origine dati, come il nome dell'area di lavoro Prometheus, del database o del bucket Amazon S3. Per AWS i servizi, la procedura guidata rileva le risorse e le inserisce nel menu a discesa di selezione. Per ulteriori note sull'origine dati che stai utilizzando, consulta le sezioni successive a questa procedura. 1. Per CloudWatch connetterti alla sorgente dati in un VPC, scegli **Usa un VPC e seleziona il VPC** da usare. Quindi seleziona la sottorete e il gruppo di sicurezza. 1. Scegli **Riconosco che CloudFormation creerà risorse** IAM. Questa risorsa è il ruolo di esecuzione della funzione Lambda. 1. Seleziona **Create data source (Crea origine dati)**. La nuova fonte che hai appena aggiunto non viene visualizzata finché lo CloudFormation stack non ha finito di crearla. Per verificare i progressi, puoi scegliere **Visualizza lo stato del mio CloudFormation stack**. In alternativa, puoi selezionare l'icona di aggiornamento per aggiornare questo elenco. Quando la nuova origine dati viene visualizzata nell'elenco, è pronta per essere utilizzata. Puoi scegliere **Query tra le CloudWatch metriche** per iniziare a eseguire query con essa. Per ulteriori informazioni, consulta [Creazione di un grafico dei parametri da un'altra origine dati](graph_a_metric.md#create-metric-graph-multidatasource). ## Amazon Managed Service per Prometheus **Aggiornamento della configurazione dell'origine dati** + Puoi aggiornare l'origine dati manualmente con le seguenti operazioni: + Per aggiornare l'ID dell'area di lavoro Amazon Managed Service per Prometheus, aggiorna la variabile di ambiente `AMAZON_PROMETHEUS_WORKSPACE_ID` per la funzione Lambda del connettore di origine dati. + Per aggiornare la configurazione VPC, consulta [Configurazione dell'accesso VPC (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html#vpc-configuring) per ulteriori informazioni. **Esecuzione di query sull'origine dati** + Quando esegui una query su Amazon Managed Service per Prometheus, dopo aver selezionato l'origine dati nella scheda **Query da più origini** e selezionato un connettore Amazon Managed Service per Prometheus, puoi utilizzare la **Guida alle query** per scoprire parametri ed etichette e fornire semplici query PromQL. Puoi anche utilizzare l'editor di query PromQL per creare una query PromQL. + Le interrogazioni multilinea non sono supportate dai connettori delle sorgenti dati. CloudWatch Ogni avanzamento riga viene sostituito da uno spazio quando la query viene eseguita o quando si crea un allarme o un widget del pannello di controllo con la query. In alcuni casi, ciò potrebbe rendere la query non valida. Ad esempio, se la query contiene un commento di una singola riga, non sarà valida. Se provi a creare una dashboard o un allarme con una query su più righe dalla riga di comando o Infrastructure as Code, l'API rifiuta l'azione generando un errore di analisi. ## OpenSearch Servizio Amazon **Creazione di un'origine dati** Se il OpenSearch dominio è abilitato per FGAC, è necessario mappare il ruolo di esecuzione della funzione Lambda del connettore a un utente in Service. OpenSearch Per ulteriori informazioni, consulta la sezione **Mappatura degli utenti ai ruoli** nella documentazione sulla [gestione delle autorizzazioni nella documentazione](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/fgac.html#fgac-access-control) del servizio. OpenSearch Se il tuo OpenSearch dominio è accessibile solo all'interno di un Virtual Private Cloud (VPC), devi includere manualmente una nuova variabile di ambiente nella funzione Lambda chiamata. `AMAZON_OPENSEARCH_ENDPOINT` Il valore di questa variabile deve essere il dominio principale dell' OpenSearch endpoint. È possibile ottenere questo dominio radice rimuovendo `https://` e `.es.amazonaws.com` dall'endpoint del dominio elencato nella console di OpenSearch servizio. Ad esempio, se l'endpoint del dominio è `https://sample-domain.us-east-1.es.amazonaws.com`, il dominio root sarà `sample-domain`. **Aggiornamento di un'origine dati** + Puoi aggiornare l'origine dati manualmente con le seguenti operazioni: + Per aggiornare il dominio OpenSearch Service, aggiorna la variabile di `AMAZON_OPENSEARCH_DOMAIN_NAME` ambiente per la funzione Lambda del connettore di origine dati. + Per aggiornare la configurazione VPC, consulta [Configurazione dell'accesso VPC (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html#vpc-configuring) per ulteriori informazioni. **Esecuzione di query sull'origine dati** + Quando esegui una query su OpenSearch Service, dopo aver selezionato l'origine dati nella scheda **Query da più fonti**, procedi come segue: + Seleziona l'indice per eseguire query. + Seleziona il nome del parametro (qualsiasi campo numerico nel documento) e le statistiche. + Seleziona l'asse del tempo (qualsiasi campo di data nel documento). + Seleziona i filtri da applicare (qualsiasi campo di stringa nel documento). + Scegli **Query a grafo**. ## Amazon RDS per PostgreSQL e Amazon RDS per MySQL **Creazione di un'origine dati** + Se l'origine dati è accessibile solo in un VPC, è necessario includere la configurazione VPC per il connettore, come descritto in [Connessione a un'origine dati predefinita con una procedura guidata](#CloudWatch_MultiDataSources-Connect). Se l'origine dati deve connettersi al VPC per le credenziali, l'endpoint deve essere configurato nel VPC. Per ulteriori informazioni, consulta [Utilizzo di un Gestione dei segreti AWS endpoint VPC.](https://docs.aws.amazon.com/secretsmanager/latest/userguide/vpc-endpoint-overview.html) Inoltre, devi creare un endpoint VPC per il servizio Amazon RDS. Per ulteriori informazioni, consulta [Amazon RDS API and interface VPC endpoints (AWS PrivateLink)](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/vpc-interface-endpoints.html). **Aggiornamento di un'origine dati** + Puoi aggiornare l'origine dati manualmente con le seguenti operazioni: + Per aggiornare l'istanza di database, aggiorna la variabile di ambiente `RDS_INSTANCE` per la funzione Lambda del connettore di origine dati. + Per aggiornare il nome utente e la password utilizzati per connettersi ad Amazon RDS, usa Gestione dei segreti AWS. Puoi trovare l'ARN del segreto usato per l'origine dati nella variabile di ambiente `RDS_SECRET` della funzione Lambda dell'origine dati. Per ulteriori informazioni sull'aggiornamento del segreto in Gestione dei segreti AWS, consulta [Modificare un segreto Gestione dei segreti AWS](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_update-secret.html). + Per aggiornare la configurazione VPC, consulta [Configurazione dell'accesso VPC (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html#vpc-configuring) per ulteriori informazioni. **Esecuzione di query sull'origine dati** + Quando esegui una query su Amazon RDS, dopo aver selezionato l'origine dati nella scheda **Query da più origini** e selezionato un connettore Amazon RDS, puoi utilizzare il rilevatore di database per visualizzare database, tabelle e colonne disponibili. Puoi inoltre utilizzare l'editor SQL per creare una query SQL. Puoi utilizzare le seguenti variabili nella query: + `$start.iso` – L'ora di inizio nel formato data ISO + `$end.iso` – L'ora di fine nel formato data ISO + `$period` – Il periodo selezionato in secondi Ad esempio, è possibile eseguire una query `SELECT value, timestamp FROM table WHERE timestamp BETWEEN $start.iso and $end.iso` + Le interrogazioni multilinea non sono supportate dai connettori delle sorgenti dati. CloudWatch Ogni avanzamento riga viene sostituito da uno spazio quando la query viene eseguita o quando si crea un allarme o un widget del pannello di controllo con la query. In alcuni casi, ciò potrebbe rendere la query non valida. Ad esempio, se la query contiene un commento di una singola riga, non sarà valida. Se provi a creare una dashboard o un allarme con una query su più righe dalla riga di comando o Infrastructure as Code, l'API rifiuta l'azione generando un errore di analisi. **Nota** Se nei risultati non viene trovato alcun campo relativo alla data, i valori di ogni campo numerico vengono sommati in valori singoli e tracciati nell'intervallo di tempo fornito. Se i timestamp non sono allineati con il periodo selezionato in CloudWatch, i dati vengono aggregati automaticamente utilizzando `SUM` e allineati con il periodo in. CloudWatch ## File CSV di Amazon S3 **Esecuzione di query sull'origine dati** + Quando esegui una query sui file CSV di Amazon S3, dopo aver selezionato l'origine dati nella scheda **Query da più origini** e selezionato un connettore Amazon S3, devi selezionare il bucket e la chiave Amazon S3. Il file CSV deve essere formattato come segue: + Il timestamp deve essere la prima colonna. + La tabella deve avere una riga di intestazione. Le intestazioni vengono utilizzate per denominare le metriche. Il titolo della colonna del timestamp verrà ignorato, verranno utilizzati solo i titoli delle colonne delle metriche. + I timestamp devono essere nel formato data ISO. + Le metriche devono essere campi numerici. ``` Timestamp, Metric-1, Metric-2, ... ``` Di seguito è riportato un esempio: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/CloudWatch_MultiDataSources-Connect.html) **Nota** Se non viene fornito alcun timestamp, i valori di ogni parametro vengono sommati in valori singoli e tracciati nell'intervallo di tempo fornito. Se i timestamp non sono allineati con il periodo selezionato in CloudWatch, i dati vengono aggregati automaticamente utilizzando e allineati con il periodo in. `SUM` CloudWatch ## Microsoft Azure Monitor **Creazione di un'origine dati** + È necessario fornire l'ID tenant, l'ID client e il segreto client per connettersi a Microsoft Azure Monitor. Le credenziali verranno archiviate in. Gestione dei segreti AWS Per maggiori informazioni, consulta [Creazione di un'applicazione Microsoft Entra e di un principale del servizio in grado di accedere alle risorse](https://learn.microsoft.com/en-us/entra/identity-platform/howto-create-service-principal-portal) nella documentazione di Microsoft. **Aggiornamento di un'origine dati** + Puoi aggiornare l'origine dati manualmente con le seguenti operazioni: + Per aggiornare l'ID tenant, l'ID client e il segreto client usati per connettersi ad Azure Monitor, puoi trovare l'ARN del segreto usato per l'origine dati come variabile di ambiente `AZURE_CLIENT_SECRET` della funzione Lambda dell'origine dati. Per ulteriori informazioni sull'aggiornamento del segreto in Gestione dei segreti AWS, consulta [Modificare un Gestione dei segreti AWS segreto](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_update-secret.html). **Esecuzione di query sull'origine dati** + Quando si esegue una query di Azure Monitor, dopo aver selezionato l'origine dati nella scheda **Query da più origini** e aver selezionato un connettore Azure Monitor, si specifica la sottoscrizione di Azure, il gruppo di risorse e la risorsa. È quindi possibile selezionare lo spazio dei nomi del parametro, il parametro e l'aggregazione dei parametri e filtrare per dimensioni. ## Prometheus **Creazione di un'origine dati** + È necessario fornire l'endpoint Prometheus e l'utente e la password necessari per interrogare Prometheus. Le credenziali verranno archiviate in Gestione dei segreti AWS. + Se l'origine dati è accessibile solo in un VPC, è necessario includere la configurazione VPC per il connettore, come descritto in [Connessione a un'origine dati predefinita con una procedura guidata](#CloudWatch_MultiDataSources-Connect). Se l'origine dati deve essere collegata per le credenziali, l'endpoint deve essere configurato nel VPC. Per ulteriori informazioni, consulta [Utilizzo di un Gestione dei segreti AWS endpoint VPC.](https://docs.aws.amazon.com/secretsmanager/latest/userguide/vpc-endpoint-overview.html) **Aggiornamento della configurazione dell'origine dati** + Puoi aggiornare l'origine dati manualmente con le seguenti operazioni: + Per aggiornare l'endpoint Prometheus, specifica il nuovo endpoint come variabile di ambiente `PROMETHEUS_API_ENDPOINT` nella funzione Lambda dell'origine dati. + Per aggiornare il nome utente e la password usati per connettersi a Prometheus, puoi trovare l'ARN del segreto usato per l'origine dati come variabile di ambiente `PROMETHEUS_API_SECRET` della funzione Lambda dell'origine dati. Per ulteriori informazioni sull'aggiornamento del segreto in Gestione dei segreti AWS, consulta [Modificare un Gestione dei segreti AWS](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_update-secret.html) segreto. + Per aggiornare la configurazione VPC, consulta [Configurazione dell'accesso VPC (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html#vpc-configuring) per ulteriori informazioni. **Esecuzione di query sull'origine dati** **Importante** I tipi di metriche di Prometheus sono CloudWatch diversi dalle metriche e molte metriche disponibili tramite Prometheus sono cumulative per definizione. Quando si esegue una query sulle metriche di Prometheus CloudWatch , non applica alcuna trasformazione aggiuntiva ai dati: se si specifica solo il nome o l'etichetta della metrica, il valore visualizzato sarà cumulativo. Per ulteriori informazioni, consulta [Tipi di parametri](https://prometheus.io/docs/concepts/metric_types/) nella documentazione di Prometheus. Per vedere i dati delle metriche di Prometheus come valori discreti, ad CloudWatch esempio metriche, devi modificare la query prima di eseguirla. Ad esempio, potresti dover aggiungere una chiamata alla funzione rate al nome del parametro Prometheus. Per la documentazione sulla funzione rate e altre funzioni di Prometheus, consulta [rate()](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate) nella documentazione di Prometheus. Le interrogazioni multilinea non sono supportate dai connettori delle sorgenti dati. CloudWatch Ogni avanzamento riga viene sostituito da uno spazio quando la query viene eseguita o quando si crea un allarme o un widget del pannello di controllo con la query. In alcuni casi, ciò potrebbe rendere la query non valida. Ad esempio, se la query contiene un commento di una singola riga, non sarà valida. Se provi a creare una dashboard o un allarme con una query su più righe dalla riga di comando o Infrastructure as Code, l'API rifiuta l'azione generando un errore di analisi. ## Notifica degli aggiornamenti disponibili Periodicamente, Amazon potrebbe inviarti una notifica per consigliarti di aggiornare i connettori con una versione disponibile più recente e ti fornirà istruzioni su come farlo.