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

Interrogazione ProMQL

Quando si inseriscono le OpenTelemetry metriche CloudWatch tramite ilEndpoint delle metriche, il modello di dati gerarchico OTLP viene appiattito in etichette. PromQL-compatible Questa sezione descrive la struttura delle etichette, la sintassi PromQL per interrogare queste etichette e il supporto in PromQL. UTF-8

Quando si utilizza PromQL in CloudWatch, la convenzione dei @ prefissi distingue OTLP-scoped le etichette dalle etichette Prometheus standard. I campi all'interno di ciascun ambito utilizzano un doppio @ prefisso (ad esempio,@resource.@schema_url), mentre gli attributi utilizzano un prefisso a ambito singolo, ad esempio. @ @resource.service.name Gli attributi Datapoint supportano anche l'accesso nudo (senza prefisso) per la retrocompatibilità con le query PromQL standard, ad esempio, e sono equivalenti. {"http.server.active_requests"} {"@datapoint.@name"="http.server.active_requests"}

Un'espressione ProMQL è racchiusa tra parentesi graffe e specifica il nome della metrica e un set opzionale di abbinatori di etichette. L'esempio seguente seleziona tutte le serie temporali per la metrica: http.server.active_requests

{"http.server.active_requests"}

L'esempio seguente seleziona tutte le serie temporali per la metrica in http.server.active_requests cui l'attributo resource è uguale a: OpenTelemetry service.name myservice

{"http.server.active_requests", "@resource.service.name"="myservice"}

È possibile combinare più abbinatori di etichette in un'unica query. L'esempio seguente seleziona tutte le serie temporali per la http.server.active_requests metrica in cui l'attributo OpenTelemetry resource è service.name uguale in tutte le regioni degli Stati Uniti: myservice

{"http.server.active_requests",
 "@resource.service.name"="myservice",
 "@aws.region"=~"us-.*"}

L'esempio seguente mostra una query con intervallo. Calcola il valore medio di tutti i punti dati all'interno di un intervallo di tempo specificato per ogni serie temporale:

avg_over_time(
  {"http.server.active_requests",
   "@resource.service.name"="myservice"}[5m]
)

La tabella seguente riassume le convenzioni di prefisso per ogni ambito OTLP:

Interrogazione venduta AWS metriche con PromQL

Per poter interrogare le AWS metriche vendute in PromQL, devi prima abilitare l'arricchimento Otel delle metriche vendute. Consulta AWS OpenTelemetry metriche vendute in formato.

Dopo aver abilitato l'arricchimento di Otel, le AWS metriche vendute diventano interrogabili tramite PromQL con etichette aggiuntive. Il nome della metrica è lo stesso del nome della CloudWatch metrica originale e le dimensioni originali sono disponibili come attributi datapoint. CloudWatch Sono disponibili le seguenti etichette (l'esempio seguente è per un'istanza EC2):

L'esempio seguente seleziona Invocations una funzione Lambda specifica:

{Invocations, FunctionName="my-api-handler"}

L'esempio seguente seleziona Errors Lambda per tutte le funzioni etichettate con un team specifico:

{Errors, "@instrumentation.@name"="cloudwatch.aws/lambda", "@aws.tag.Team"="backend"}

L'esempio seguente calcola la Invocations Lambda totale raggruppata per team:

sum by ("@aws.tag.Team")(
    {Invocations, "@instrumentation.@name"="cloudwatch.aws/lambda"}
)

L'esempio seguente seleziona tutte le serie temporali per la metrica EC2. CPUUtilization L'utilizzo di "@instrumentation.@name"="cloudwatch.aws/ec2" deve corrispondere esclusivamente all'utilizzo della CPU di EC2 e non di altri AWS servizi come Amazon Relational Database Service:

histogram_avg({CPUUtilization, "@instrumentation.@name"="cloudwatch.aws/ec2"})

Interrogazione da Grafana

Puoi interrogare i dati CloudWatch PromQL da Grafana aggiungendo il plug-in di origine dati Amazon Managed Service for Prometheus e indirizzandolo all'endpoint di monitoraggio. CloudWatch La firma SigV4 è integrata nel plug-in ed è sempre abilitata, quindi non è necessario attivare alcun interruttore. Il plugin è pubblicato su grafana. com/grafana/plugins/grafana-amazonprometheus-datasource/; installalo dal catalogo dei plugin Grafana prima di aggiungere la fonte dati. Il plugin AMP v3.0.0 richiede Grafana. >=11.6.11 <12 || >=12.0.10 <12.1 || >=12.1.7 <12.2 || >=12.2.5

Prerequisiti IAM: il responsabile IAM le cui credenziali utilizzate da Grafana devono avere sia cloudwatch:GetMetricData (richieste per le query istantanee e a intervalli) che cloudwatch:ListMetrics (necessarie per l'individuazione di serie ed etichette). Per informazioni dettagliate, vedi Autorizzazioni IAM per PromQL.

Per configurare Grafana, completa i seguenti passaggi.

Interrogazione da Amazon Managed Grafana

Puoi interrogare i dati CloudWatch PromQL da un'area di lavoro Amazon Managed Grafana aggiungendo una fonte di dati Amazon Managed Service for Prometheus che punti all'endpoint di monitoraggio. CloudWatch Questo plug-in di origine dati firma automaticamente le richieste con SigV4 utilizzando il ruolo IAM del workspace; SigV4 è sempre abilitato, senza alcun interruttore da configurare. Il plug-in è disponibile in Amazon Managed Grafana versione 12 e successive. Per ulteriori informazioni, consulta Connect a una fonte di dati Amazon Managed Service for Prometheus nella Amazon Managed Grafana User Guide.

Prerequisiti IAM: il ruolo IAM dell'area di lavoro Amazon Managed Grafana deve avere cloudwatch:GetMetricData sia (richiesto per le query istantanee e a intervalli) sia (necessario per l'individuazione di serie cloudwatch:ListMetrics ed etichette). Per informazioni dettagliate, vedi Autorizzazioni IAM per PromQL.

Per configurare l'origine dati, completa i seguenti passaggi.

Interrogazione con strumenti MCP

Il server CloudWatch MCP fornisce strumenti Model Context Protocol (MCP) che consentono agli assistenti di intelligenza artificiale e agli strumenti di sviluppo di interrogare i dati CloudWatch ProMQL per conto dell'utente. Gli strumenti MCP gestiscono automaticamente l'autenticazione e la formattazione delle richieste, quindi puoi concentrarti sulla scrittura di query ProMQL anziché sulla gestione delle richieste HTTP e della firma SigV4.

I seguenti strumenti PromQL sono disponibili nel server MCP: CloudWatch

Per tutti i dettagli sui parametri, la configurazione e le istruzioni di configurazione, consulta Tools for CloudWatch ProMQL nella documentazione del server CloudWatch MCP.

Interrogazione con l'API HTTP

Puoi anche interrogare i dati CloudWatch PromQL a livello di codice chiamando direttamente gli Prometheus-compatible endpoint HTTP. Le richieste devono essere firmate con AWS Signature Version 4 utilizzando monitoring come nome del servizio.

L'endpoint PromQL segue lo schema. https://monitoring.AWS Region.amazonaws.com/api/v1/operation Ad esempio, per la regione Stati Uniti orientali (Virginia settentrionale) (us-east-1), l'endpoint per una query istantanea è. https://monitoring.us-east-1.amazonaws.com/api/v1/query

Per il riferimento completo all'API, incluse le operazioni supportate, i parametri di richiesta e i formati di risposta, consulta. Prometheus-compatible API Per l'elenco delle AWS regioni in cui è disponibile l'interrogazione PromQL, vedere. Supportata AWS Regioni Per le azioni IAM necessarie per ogni operazione, consulta. Autorizzazioni IAM per PromQL