QueryMetrics - Amazon Managed Service für Prometheus

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

QueryMetrics

Der QueryMetrics Vorgang wertet eine Sofortabfrage zu einem bestimmten Zeitpunkt oder über einen bestimmten Zeitraum aus.

Gültige HTTP-Verben:

GET, POST

Gültig URIs:

/workspaces/workspaceId/api/v1/queryDieser URI wertet eine Sofortabfrage zu einem einzigen Zeitpunkt aus.

/workspaces/workspaceId/api/v1/query_rangeDieser URI wertet eine Sofortabfrage über einen bestimmten Zeitraum aus.

URL-Abfrageparameter:

query=<string>Ein Abfrage-String mit einem Prometheus-Ausdruck. Wird sowohl in query als auch in query_range verwendet.

time=<rfc3339 | unix_timestamp> (Optional) Zeitstempel für die Auswertung, wenn Sie den query für eine Sofortabfrage zu einem einzigen Zeitpunkt verwenden.

timeout=<duration> (Optional) Timeout für die Evaluierung. Der Standardwert ist auf den Wert der -query.timeout Flag eingestellt und wird durch diesen begrenzt. Wird sowohl in query als auch in query_range verwendet.

start=<rfc3339 | unix_timestamp> Startzeitstempel, wenn Sie query_range einen bestimmten Zeitraum abfragen möchten.

end=<rfc3339 | unix_timestamp> Endzeitstempel, wenn Sie für query_range die Abfrage nach einem bestimmten Zeitraum verwenden.

step=<duration | float> Schrittweite der Auflösung im duration Format oder als float Anzahl von Sekunden abfragen. Verwenden Sie diese Option nur, wenn Sie query_range für Abfragen für einen bestimmten Zeitraum verwenden und dies für solche Abfragen erforderlich sind.

max_samples_processed_warning_threshold=<integer>(Optional) Legt den Warnschwellenwert für QSP (Query Samples Processed) fest. Wenn Abfragen diesen Schwellenwert erreichen, wird in der API-Antwort eine Warnmeldung zurückgegeben.

max_samples_processed_error_threshold=<integer>>(Optional) Legt den Fehlerschwellenwert für QSP (Query Samples Processed) fest. Abfragen, die diesen Schwellenwert überschreiten, werden mit einem Fehler zurückgewiesen und nicht in Rechnung gestellt. Wird verwendet, um übermäßige Abfragekosten zu vermeiden.

Duration (Dauer)

A duration in einer Prometheus-kompatiblen API ist eine Zahl, unmittelbar gefolgt von einer der folgenden Einheiten:

  • ms Millisekunden

  • s Sekunden

  • m Minuten

  • h Stunden

  • d Tage, vorausgesetzt, ein Tag hat immer 24 Stunden

  • w Wochen, vorausgesetzt, eine Woche hat immer 7 Tage

  • y Jahre, vorausgesetzt, ein Jahr hat immer 365 Tage

Beispielanforderung

POST /workspaces/ws-b226cc2a-a446-46a9-933a-ac50479a5568/api/v1/query?query=sum(node_cpu_seconds_total) HTTP/1.1
Content-Length: 0, 
Authorization: AUTHPARAMS
X-Amz-Date: 20201201T193725Z
User-Agent: Grafana/8.1.0

Beispielantwort

HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Length: 132
Connection: keep-alive
Date: Tue, 01 Dec 2020 19:37:25 GMT
Content-Type: application/json
Server: amazon
content-encoding: gzip

{
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [
            {
                "metric": {},
                "value": [
                    1634937046.322,
                    "252590622.81000024"
                ]
            }
        ]
    }
}