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 l'esecuzione di query con ciascuna di queste fonti di dati.

Per creare un connettore a un'origine dati

1. Apri la CloudWatch console all'indirizzo. https://console.aws.amazon.com/cloudwatch/

2. Nel pannello di navigazione scegli Impostazioni.

3. Seleziona la scheda Origini dati dei parametri.

4. Seleziona Create data source (Crea origine dati).

5. Seleziona l'origine che desideri, quindi scegli Successivo.

6. Inserisci un nome per l'origine dati.

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

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

9. Scegli Riconosco che AWS CloudFormation creerà risorse IAM. Questa risorsa è il ruolo di esecuzione della funzione Lambda.

10. Seleziona Create data source (Crea origine dati).

    La nuova fonte che hai appena aggiunto non viene visualizzata finché lo AWS 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.

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) 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 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 <region>.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 principale sarebbe. 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) 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. 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 AWS Secrets Manager endpoint VPC.

  Inoltre, è necessario creare un endpoint VPC per il servizio Amazon RDS. Per ulteriori informazioni, consulta l'API Amazon RDS e gli endpoint AWS PrivateLink VPC di interfaccia ().

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 AWS Secrets Manager. 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 AWS Secrets Manager, consulta Modificare un segreto AWS Secrets Manager.

  • Per aggiornare la configurazione VPC, consulta Configurazione dell'accesso VPC (console) 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 query 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 nei seguenti modi:

  • 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 in formato data ISO.

  • Le metriche devono essere campi numerici.

  Timestamp, Metric-1, Metric-2, ...

  Di seguito è riportato un esempio:

  timestamp	CPU (%)	Memoria (%)	Archiviazione (%)
  2023-11-23T17:09:41+00:00	1	2	3
  2023-11-23T17:04:41+00:00	4	5	6
  2023-11-23T16:59:41+00:00	7	8	9
  2023-11-23T16:54:41+00:00	10	11	12

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 SUM e allineati con il periodo in. 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. AWS Secrets Manager Per maggiori informazioni, consulta Creazione di un'applicazione Microsoft Entra e di un principale del servizio in grado di accedere alle risorse 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 AWS Secrets Manager, consulta Modificare un AWS Secrets Manager segreto.

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 AWS Secrets Manager.

• 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. Se l'origine dati deve essere collegata per le credenziali, l'endpoint deve essere configurato nel VPC. Per ulteriori informazioni, consulta Utilizzo di un AWS Secrets Manager endpoint VPC.

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 AWS Secrets Manager, consulta Modificare un AWS Secrets Manager segreto.

  • Per aggiornare la configurazione VPC, consulta Configurazione dell'accesso VPC (console) 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 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() 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.