

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.

# Verwaltung der Abfragekosten in Amazon Managed Service für Prometheus
<a name="query-insights-control"></a>

Amazon Managed Service for Prometheus bietet die Möglichkeit, die Abfragekosten zu begrenzen, indem begrenzt wird, wie viele Query Samples Processed (QSP) von einer einzelnen Abfrage verwendet werden können. Sie können zwei Arten von Schwellenwerten für QSP konfigurieren: *Warnung* und *Fehler*, um die Abfragekosten effektiv verwalten und kontrollieren zu können.

Wenn Abfragen den *Warnschwellenwert* erreichen, wird in der API-Abfrageantwort eine Warnmeldung angezeigt. Bei Anfragen, die über Amazon Managed Grafana angezeigt werden, wird die Warnung in der Amazon Managed Grafana-Benutzeroberfläche angezeigt, sodass Benutzer teure Abfragen identifizieren können. Anfragen, die den *Fehlerschwellenwert* erreichen, werden nicht berechnet und mit einem Fehler zurückgewiesen.

Zusätzlich zur Abfragedrosselung bietet Amazon Managed Service for Prometheus die Möglichkeit, Abfrageleistungsdaten in Logs zu protokollieren. CloudWatch Mit dieser Funktion können Sie Anfragen detailliert analysieren und so Ihren Amazon Managed Service für Prometheus-Abfragen optimieren und die Kosten effektiver verwalten. Die Abfrageprotokollierung erfasst Informationen über Abfragen, die die angegebenen Schwellenwerte für die Verarbeitung von Query Samples (QSP) überschreiten. Diese Daten werden dann in CloudWatch Logs veröffentlicht, sodass Sie die Abfrageleistung untersuchen und analysieren können. Zu den protokollierten Abfragen gehören sowohl API-Abfragen als auch Regelabfragen. Standardmäßig ist die Abfrageprotokollierung deaktiviert, um die unnötige Nutzung von CloudWatch Protokollen zu minimieren. Sie können diese Funktion bei Bedarf für die Abfrageanalyse aktivieren. 

**Topics**
+ [Konfiguration der Abfrageprotokollierung](#query-logging)
+ [Schwellenwerte für die Abfragedrosselung konfigurieren](#query-throttling-thresholds)
+ [Inhalt protokollieren](#log-content)
+ [Einschränkungen](#limitations)

## Konfiguration der Abfrageprotokollierung
<a name="query-logging"></a>

Sie können die Abfrageprotokollierung in der Amazon Managed Service for Prometheus-Konsole oder in der AWS CLI konfigurieren, indem Sie die `create-query-logging-configuration ` API-Anfrage aufrufen. Dieser API-Text enthält eine Liste von Zielen, aber im Moment unterstützen wir nur CloudWatch Logs als Ziel, und Ziele sollten genau ein Element mit CloudWatch Konfigurationen enthalten.

### Voraussetzungen
<a name="CW-vender-query-logs-prerequisites"></a>

Stellen Sie sicher, dass `logGroup` das bereits erstellt wurde. Die ID oder Rolle, die zur Konfiguration verwendet wurde, sollte über die folgenden Richtlinien oder gleichwertige Berechtigungen verfügen.

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

****  

```
{
"Version":"2012-10-17",		 	 	 
    "Statement": [
        {
"Effect": "Allow",
            "Action": [
                "logs:CreateLogDelivery",
                "logs:GetLogDelivery",
                "logs:UpdateLogDelivery",
                "logs:DeleteLogDelivery",
                "logs:ListLogDeliveries",
                "logs:PutResourcePolicy",
                "logs:DescribeResourcePolicies",
                "logs:DescribeLogGroups",
                "aps:CreateQueryLoggingConfiguration",
                "aps:UpdateQueryLoggingConfiguration",
                "aps:DescribeQueryLoggingConfiguration",
                "aps:DeleteQueryLoggingConfiguration"
            ],
            "Resource": "*"
        }
    ]
}
```

------

### CloudWatch Protokolle konfigurieren
<a name="configure-cloudwatch-logs"></a>

Sie können CloudWatch Logs konfigurieren, indem Sie sich mit dem AWS-Managementkonsole oder dem bei Amazon Managed Service for Prometheus anmelden. AWS CLI

**So konfigurieren Sie die Abfrageprotokollierung mit der Amazon Managed Service for Prometheus-Konsole**

1. Navigieren Sie in Ihrem Workspace-Detailbereich zur Registerkarte **Logs**.

1. **Wählen Sie unter **Query Insights** die Option Create aus.**

1. Wählen Sie das Drop-down-Menü **Protokollgruppe** aus und wählen Sie die Protokollgruppe aus, um Ihre Protokolle zu veröffentlichen.

   Sie können auch eine neue Protokollgruppe in der CloudWatch Konsole erstellen.

1. Geben Sie den **Schwellenwert (QSP)** ein.

1. Wählen Sie **Speichern**.

**Um die Abfrageprotokollierung mit dem AWS CLI Befehl zu konfigurieren** 

```
aws amp create-query-logging-configuration \
--workspace-id my_workspace_ID \
--destinations '[{"cloudWatchLogs":{"logGroupArn":"$my-log-group-arn"},"filters":{"qspThreshold":$qspThreshold}}]'
```

Informationen zum Aktualisieren, Löschen und Beschreiben von Vorgängen finden Sie in der [Amazon Managed Service for Prometheus API-Referenz](https://docs.aws.amazon.com/prometheus/latest/APIReference/Welcome.html).

## Schwellenwerte für die Abfragedrosselung konfigurieren
<a name="query-throttling-thresholds"></a>

[Um QSP-Schwellenwerte zu konfigurieren, müssen Sie die Abfrageparameter in der API angeben. QueryMetrics ](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-APIReference-QueryMetrics.html)
+ max\$1samples\$1processed\$1warning\$1threshold — Legt den Warnschwellenwert für verarbeitete Abfrageproben fest
+ max\$1samples\$1processed\$1error\$1threshold — Legt den Fehlerschwellenwert für verarbeitete Abfrageproben fest

Für Amazon Managed Grafana-Benutzer können Sie die Grafana-Datenquellenkonfiguration verwenden, um Beschränkungen auf alle Abfragen aus der Datenquelle anzuwenden:

1. Rufen Sie die Amazon Managed Service for Prometheus-Datenquellenkonfiguration in Amazon Managed Grafana auf.

1. Fügen Sie unter **Benutzerdefinierte Abfrageparameter die Schwellenwert-Header** hinzu.

1. Wählen Sie **Speichern**.

## Inhalt protokollieren
<a name="log-content"></a>

Bei Abfragen, die auf Regeln basieren, werden in den CloudWatch Protokollen die folgenden Informationen zur Abfrage angezeigt:

```
{
    workspaceId: "workspace_id",
    message: {
        query: "avg(rate(go_goroutines[1m])) > 1",
        name: "alert_rule",
        kind: "alerting",
        group: "test-alert",
        namespace: "test",
        samples: "59321",
    },
    component: "ruler"
}
```

Bei Abfragen, die aus API-Aufrufen stammen, werden in den CloudWatch Protokollen die folgenden Informationen zur Abfrage angezeigt:

```
{
    workspaceId: "ws-5e7658c2-7ccf-4c30-9de9-2ab26fa30639",
    message: {
        query: "sum by (instance) (go_memstats_alloc_bytes{job=\"node\"})",
        queryType: "range",
        start: "1683308700000",
        end: "1683913500000",
        step: "300000",
        samples: "11496",
        userAgent: "AWSPrometheusDPJavaClient/2.0.436.0 ",
        dashboardUid: "11234",
        panelId: "12"
    },
    component: "query-frontend"
}
```

## Einschränkungen
<a name="limitations"></a>

**Größenbeschränkungen für** Richtlinien — Ressourcenrichtlinien für CloudWatch Protokolle sind auf 5120 Zeichen begrenzt. Wenn CloudWatch Logs feststellt, dass sich die Richtlinie der Größenbeschränkung nähert, werden automatisch Protokollgruppen aktiviert, die mit `/aws/vendedlogs/` beginnen. Wenn Sie die Abfrageprotokollierung aktivieren, muss Amazon Managed Service for Prometheus Ihre CloudWatch Logs-Ressourcenrichtlinie mit der von Ihnen angegebenen Protokollgruppe aktualisieren. Um zu verhindern, dass die Größenbeschränkung für die CloudWatch Logs-Ressourcenrichtlinie erreicht wird, stellen Sie Ihren CloudWatch Logs-Protokollgruppennamen das Präfix voran. `/aws/vendedlogs/`