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.
# Protokollzustellung
**Anmerkung**
Slow Log wird für Valkey 7.x und höher sowie für Redis OSS-Cluster und Replikationsgruppen ab der Engine-Version 6.0 unterstützt.
Engine Log wird für Valkey 7.x und höher sowie für Redis OSS-Cluster und Replikationsgruppen ab Engine-Version 6.2 unterstützt.
Mit der Protokollzustellung können Sie [SLOWLOG oder **Engine Log** an](https://valkey.io/commands/slowlog) eines von zwei Zielen streamen:
+ Amazon Data Firehose
+ CloudWatch Amazon-Protokolle
Sie aktivieren und konfigurieren die Protokollzustellung, wenn Sie einen Cluster erstellen oder ändern mit ElastiCache APIs. Jeder Protokolleintrag wird in einem von zwei Formaten an das angegebene Ziel übermittelt: *JSON* oder *TEXT*.
Eine feste Anzahl von Slow-Protokolleinträgen wird regelmäßig von der Engine abgerufen. Je nach dem für den Engine-Parameter `slowlog-max-len` angegebenen Wert werden zusätzliche langsame Protokolleinträge möglicherweise nicht an das Ziel übermittelt.
Sie können die Versandkonfigurationen ändern oder die Protokollzustellung jederzeit deaktivieren. Verwenden Sie dazu die AWS Konsole oder eine der Optionen zum Ändern APIs, entweder [modify-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html)oder [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html).
Sie müssen den `apply-immediately`-Parameter für alle Änderungen der Protokollzustellung setzen.
**Anmerkung**
Amazon CloudWatch Logs-Gebühren fallen an, wenn die Protokollzustellung aktiviert ist, auch wenn Protokolle direkt an Amazon Data Firehose geliefert werden. Weitere Informationen finden Sie im Abschnitt Verkaufte Logs in der [ CloudWatch Amazon-Preisübersicht](https://aws.amazon.com/cloudwatch/pricing/).
## Inhalt eines langsamen Protokolleintrags
Das Slow Log enthält die folgenden Informationen:
+ **CacheClusterId**— Die ID des Clusters
+ **CacheNodeId**— Die ID des Cache-Knotens
+ **Id** – Eine eindeutige progressive Kennung für jeden langsamen Protokoll-Eintrag
+ **Timestamp** – Der Unix-Zeitstempel, zu dem der protokollierte Befehl verarbeitet wurde
+ **Duration (Dauer)** – Die für die Ausführung benötigte Zeit in Mikrosekunden
+ **Command** – Der vom Client verwendete Befehl. Zum Beispiel, `set foo bar` wo `foo` ist der Schlüssel und wo `bar` ist der Wert. ElastiCache ersetzt den tatsächlichen Schlüsselnamen und -wert durch, `(2 more arguments)` um zu verhindern, dass vertrauliche Daten offengelegt werden.
+ **ClientAddress**— IP-Adresse und Port des Clients
+ **ClientName**— Clientname, falls er über den `CLIENT SETNAME` Befehl gesetzt wurde
## Inhalte eines Engine-Protokolleintrags
Das ElastiCache Engine-Protokoll enthält die folgenden Informationen:
+ **CacheClusterId**— Die ID des Clusters
+ **CacheNodeId**— Die ID des Cache-Knotens
+ **Protokollebene** — LogLevel kann eine der folgenden Optionen sein:`VERBOSE("-")`,`NOTICE("*")`,`WARNING("#")`.
+ **Zeit** – Die UTC-Uhrzeit der protokollierten Nachricht. Die Zeit ist in folgendem Format angegeben: `"DD MMM YYYY hh:mm:ss.ms UTC"`
+ **Rolle** – Rolle des Knotens, von dem das Protokoll ausgegeben wird. Dabei kann es sich um einen der folgenden Werte handeln: „M“ für Primär, „S“ für Replikat, „C“ für einen untergeordneten Writer-Prozess, an dem gearbeitet wird, RDB/AOF oder „X“ für Sentinel.
+ **Nachricht — Engine-Log-Meldung**.
## Berechtigungen zum Konfigurieren der Protokollierung
Sie müssen die folgenden IAM-Berechtigungen in Ihre user/role IAM-Richtlinie aufnehmen:
+ `logs:CreateLogDelivery`
+ `logs:UpdateLogDelivery`
+ `logs:DeleteLogDelivery`
+ `logs:GetLogDelivery`
+ `logs:ListLogDeliveries`
Weitere Informationen finden Sie unter [Übersicht über die Zugriffsverwaltung: Berechtigungen und Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_access-management.html).
## Spezifikationen des Protokolltyps und des Protokollformats
### Slow-Protokoll
Das langsame Protokoll unterstützt sowohl JSON als auch TEXT
Im Folgenden sehen Sie ein Beispiel für das JSON-Format:
```
{
"CacheClusterId": "logslowxxxxmsxj",
"CacheNodeId": "0001",
"Id": 296,
"Timestamp": 1605631822,
"Duration (us)": 0,
"Command": "GET ... (1 more arguments)",
"ClientAddress": "192.168.12.104:55452",
"ClientName": "logslowxxxxmsxj##"
}
```
Im Folgenden sehen Sie ein Beispiel für das TEXT-Format:
```
logslowxxxxmsxj,0001,1605631822,30,GET ... (1 more arguments),192.168.12.104:55452,logslowxxxxmsxj##
```
### Engine-Protokoll
Das Engine-Protokoll unterstützt sowohl JSON als auch TEXT
Im Folgenden sehen Sie ein Beispiel für das JSON-Format:
```
{
"CacheClusterId": "xxxxxxxxxzy-engine-log-test",
"CacheNodeId": "0001",
"LogLevel": "VERBOSE",
"Role": "M",
"Time": "12 Nov 2020 01:28:57.994 UTC",
"Message": "Replica is waiting for next BGSAVE before synchronizing with the primary. Check back later"
}
```
Im Folgenden sehen Sie ein Beispiel für das TEXT-Format:
```
xxxxxxxxxxxzy-engine-log-test/0001:M 29 Oct 2020 20:12:20.499 UTC * A slow-running Lua script detected that is still in execution after 1000 microseconds.
```
# ElastiCache Ziele protokollieren
In diesem Abschnitt werden die Protokollierungsziele beschrieben, die Sie für Ihre ElastiCache Protokolle auswählen können. Jeder Abschnitt enthält Anleitungen zum Konfigurieren der Protokollierung für den Zieltyp und Informationen zu jedem Verhalten, das für den jeweiligen Zieltyp spezifisch ist. Nachdem Sie Ihr Protokollierungsziel konfiguriert haben, können Sie dessen Spezifikationen für die ElastiCache Protokollierungskonfiguration angeben, um mit der Protokollierung zu beginnen.
**Topics**
+ [CloudWatch Amazon-Protokolle](#Destination_Specs_CloudWatch_Logs)
+ [Amazon Data Firehose](#Destination_Specs_Kinesis_Firehose_Stream)
## CloudWatch Amazon-Protokolle
+ Sie geben eine CloudWatch Logs-Protokollgruppe an, in die die Protokolle geliefert werden.
+ Protokolle von mehreren Valkey- oder Redis OSS-Clustern und Replikationsgruppen können an dieselbe Protokollgruppe übermittelt werden.
+ Für jeden Knoten innerhalb eines Clusters oder einer Replikationsgruppe wird ein neuer Protokollstream erstellt, und die Protokolle werden an die jeweiligen Protokollstreams übermittelt. Der Name des Protokolldatenstroms verwendet das folgende Format: `elasticache/${engine-name}/${cache-cluster-id}/${cache-node-id}/${log-type}`
**Berechtigungen zum Veröffentlichen von Protokollen in CloudWatch Logs**
Sie müssen über die folgenden Berechtigungseinstellungen verfügen, um das Senden von Protokollen an eine CloudWatch Logs-Protokollgruppe konfigurieren ElastiCache zu können:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"logs:CreateLogDelivery",
"logs:GetLogDelivery",
"logs:UpdateLogDelivery",
"logs:DeleteLogDelivery",
"logs:ListLogDeliveries"
],
"Resource": [
"*"
],
"Effect": "Allow",
"Sid": "ElastiCacheLogging"
},
{
"Sid": "ElastiCacheLoggingCWL",
"Action": [
"logs:PutResourcePolicy",
"logs:DescribeResourcePolicies",
"logs:DescribeLogGroups"
],
"Resource": [
"*"
],
"Effect": "Allow"
}
]
}
```
------
Weitere Informationen finden Sie unter An [Protokolle gesendete CloudWatch Protokolle](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-CWL).
## Amazon Data Firehose
+ Sie geben einen Firehose-Lieferstream an, in den die Protokolle geliefert werden.
+ Protokolle aus mehreren Valkey- oder Redis OSS-Clustern und Replikationsgruppen können an denselben Delivery Stream übermittelt werden.
+ Protokolle von jedem Knoten innerhalb eines Clusters oder einer Replikationsgruppe werden an denselben Lieferstream übermittelt. Sie können Protokollnachrichten von verschiedenen Cache-Knoten basierend auf `cache-cluster-id` und `cache-node-id` in jeder Protokollnachricht unterscheiden.
+ Die Lieferung von Baumstämmen an Firehose ist derzeit in der Region Asien-Pazifik (Osaka) nicht verfügbar.
**Berechtigungen zum Veröffentlichen von Protokollen auf Firehose**
Sie benötigen die folgenden Berechtigungen, um das Senden von Protokollen an einen Amazon Kinesis Data Firehose Firehose-Lieferstream zu konfigurieren ElastiCache .
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"logs:CreateLogDelivery",
"logs:GetLogDelivery",
"logs:UpdateLogDelivery",
"logs:DeleteLogDelivery",
"logs:ListLogDeliveries"
],
"Resource": [
"*"
],
"Effect": "Allow",
"Sid": "ElastiCacheLogging"
},
{
"Sid": "ElastiCacheLoggingFHSLR",
"Action": [
"iam:CreateServiceLinkedRole"
],
"Resource": "*",
"Effect": "Allow"
},
{
"Sid": "ElastiCacheLoggingFH",
"Action": [
"firehose:TagDeliveryStream"
],
"Resource": "arn:aws:iam::*:role/*",
"Effect": "Allow"
}
]
}
```
------
# Angeben der Protokollzustellung mithilfe der Konsole
Mit dem können AWS-Managementkonsole Sie einen Valkey- oder Redis OSS-Cluster (Clustermodus deaktiviert) erstellen, indem Sie den Schritten unter folgen, [Erstellen eines Valkey-Clusters (Cluster-Modus deaktiviert) (Konsole)](SubnetGroups.designing-cluster-pre.valkey.md#Clusters.Create.CON.valkey-gs) oder einen Valkey- oder Redis OSS-Cluster (Clustermodus aktiviert) mithilfe der Schritte unter erstellen. [Erstellen eines Valkey- oder Redis OSS-Clusters (Cluster-Modus aktiviert) (Konsole)](Clusters.Create.md#Clusters.Create.CON.RedisCluster) In beiden Fällen konfigurieren Sie die Protokollzustellung wie folgt;
1. **Wählen Sie unter **Erweiterte Einstellungen** die Option **Logs** aus und aktivieren Sie dann entweder **Slow Logs oder Engine Logs**.**
1. Unter **Protokollformat** wählen Sie entweder**Text** oder **JSON** aus.
1. Wählen Sie unter **Zieltyp** entweder **CloudWatch Logs** oder **Kinesis Firehose** aus.
1. Wählen Sie unter **Protokollziel** entweder **Neu erstellen** aus und geben Sie entweder Ihren Amazon S3 S3-Bucket-Namen, CloudWatchLogs Protokollgruppennamen oder Ihren Kinesis Data Firehose Firehose-Stream-Namen ein, oder wählen **Sie Bestehende auswählen** und dann entweder Ihren CloudWatch Logs-Gruppennamen oder Ihren Kinesis Data Firehose Firehose-Streamnamen aus.
**Beim Ändern eines Clusters:**
Sie können entweder die enable/disable Protokollzustellung protokollieren oder entweder den Zieltyp, das Format oder das Ziel ändern:
1. Melden Sie sich bei der Konsole an und öffnen Sie die ElastiCache Konsole unter [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/home).
1. Wählen Sie im Navigationsbereich **Valkey-Cluster** oder **Redis OSS-Cluster** aus.
1. Suchen Sie in der Liste der Cluster den Cluster aus, den Sie ändern möchten. Wählen Sie den **Clusternamen** und nicht das Kontrollkästchen daneben.
1. Wählen Sie auf der Seite **Clustername** die Registerkarte **Protokolle**.
1. Um Logs zu enable/disable verlangsamen, wählen Sie entweder **Slow Logs aktivieren oder Slow Logs** **deaktivieren**.
1. Wählen Sie für enable/disable Engine-Logs entweder **Engine-Logs aktivieren** oder **Engine-Logs deaktivieren**.
1. Um Ihre Konfiguration zu ändern, wählen Sie entweder **Modify slow logs** (Langsame Protokolle ändern) oder **Modify engine logs** (Engine-Protokolle ändern) aus:
+ Wählen Sie unter **Zieltyp** entweder **CloudWatch Logs** oder **Kinesis Firehose** aus.
+ Wählen Sie unter **Protokollziel** entweder **Neu erstellen** aus und geben Sie entweder Ihren CloudWatchLogs Protokollgruppennamen oder Ihren Kinesis Data Firehose Firehose-Stream-Namen ein. Oder wählen Sie **Select existing** und wählen Sie dann entweder Ihren CloudWatchLogs Log-Gruppennamen oder Ihren Kinesis Data Firehose Firehose-Stream-Namen.
# Angeben der Protokollzustellung mit dem AWS CLI
**Slow-Protokoll**
Erstellen Sie eine Replikationsgruppe mit langsamer Protokollzustellung an CloudWatch Logs.
Für Linux, macOS oder Unix:
```
aws elasticache create-replication-group \
--replication-group-id test-slow-log \
--replication-group-description test-slow-log \
--engine redis \
--cache-node-type cache.r5.large \
--num-cache-clusters 2 \
--log-delivery-configurations '{
"LogType":"slow-log",
"DestinationType":"cloudwatch-logs",
"DestinationDetails":{
"CloudWatchLogsDetails":{
"LogGroup":"my-log-group"
}
},
"LogFormat":"json"
}'
```
Für Windows:
```
aws elasticache create-replication-group ^
--replication-group-id test-slow-log ^
--replication-group-description test-slow-log ^
--engine redis ^
--cache-node-type cache.r5.large ^
--num-cache-clusters 2 ^
--log-delivery-configurations '{
"LogType":"slow-log",
"DestinationType":"cloudwatch-logs",
"DestinationDetails":{
"CloudWatchLogsDetails":{
"LogGroup":"my-log-group"
}
},
"LogFormat":"json"
}'
```
Ändern Sie eine Replikationsgruppe, um das Protokoll langsam in CloudWatch Logs zu speichern
Für Linux, macOS oder Unix:
```
aws elasticache modify-replication-group \
--replication-group-id test-slow-log \
--apply-immediately \
--log-delivery-configurations '
{
"LogType":"slow-log",
"DestinationType":"cloudwatch-logs",
"DestinationDetails":{
"CloudWatchLogsDetails":{
"LogGroup":"my-log-group"
}
},
"LogFormat":"json"
}'
```
Für Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id test-slow-log ^
--apply-immediately ^
--log-delivery-configurations '
{
"LogType":"slow-log",
"DestinationType":"cloudwatch-logs",
"DestinationDetails":{
"CloudWatchLogsDetails":{
"LogGroup":"my-log-group"
}
},
"LogFormat":"json"
}'
```
Ändern einer Replikationsgruppe, um die langsame Protokollzustellung zu deaktivieren
Für Linux, macOS oder Unix:
```
aws elasticache modify-replication-group \
--replication-group-id test-slow-log \
--apply-immediately \
--log-delivery-configurations '
{
"LogType":"slow-log",
"Enabled":false
}'
```
Für Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id test-slow-log ^
--apply-immediately ^
--log-delivery-configurations '
{
"LogType":"slow-log",
"Enabled":false
}'
```
**Engine-Protokoll**
Erstellen Sie eine Replikationsgruppe mit der Übermittlung von CloudWatch Engine-Protokollen an Logs.
Für Linux, macOS oder Unix:
```
aws elasticache create-replication-group \
--replication-group-id test-slow-log \
--replication-group-description test-slow-log \
--engine redis \
--cache-node-type cache.r5.large \
--num-cache-clusters 2 \
--log-delivery-configurations '{
"LogType":"engine-log",
"DestinationType":"cloudwatch-logs",
"DestinationDetails":{
"CloudWatchLogsDetails":{
"LogGroup":"my-log-group"
}
},
"LogFormat":"json"
}'
```
Für Windows:
```
aws elasticache create-replication-group ^
--replication-group-id test-slow-log ^
--replication-group-description test-slow-log ^
--engine redis ^
--cache-node-type cache.r5.large ^
--num-cache-clusters 2 ^
--log-delivery-configurations '{
"LogType":"engine-log",
"DestinationType":"cloudwatch-logs",
"DestinationDetails":{
"CloudWatchLogsDetails":{
"LogGroup":"my-log-group"
}
},
"LogFormat":"json"
}'
```
Ändern Sie eine Replikationsgruppe, um das Engine-Protokoll an Firehose zu übermitteln
Für Linux, macOS oder Unix:
```
aws elasticache modify-replication-group \
--replication-group-id test-slow-log \
--apply-immediately \
--log-delivery-configurations '
{
"LogType":"engine-log",
"DestinationType":"kinesis-firehose",
"DestinationDetails":{
"KinesisFirehoseDetails":{
"DeliveryStream":"test"
}
},
"LogFormat":"json"
}'
```
Für Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id test-slow-log ^
--apply-immediately ^
--log-delivery-configurations '
{
"LogType":"engine-log",
"DestinationType":"kinesis-firehose",
"DestinationDetails":{
"KinesisFirehoseDetails":{
"DeliveryStream":"test"
}
},
"LogFormat":"json"
}'
```
Ändern einer Replikationsgruppe zum Wechseln in das Engine-Format
Für Linux, macOS oder Unix:
```
aws elasticache modify-replication-group \
--replication-group-id test-slow-log \
--apply-immediately \
--log-delivery-configurations '
{
"LogType":"engine-log",
"LogFormat":"json"
}'
```
Für Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id test-slow-log ^
--apply-immediately ^
--log-delivery-configurations '
{
"LogType":"engine-log",
"LogFormat":"json"
}'
```
Ändern einer Replikationsgruppe zur Deaktivierung der Übermittlung von Engine-Protokollen
Für Linux, macOS oder Unix:
```
aws elasticache modify-replication-group \
--replication-group-id test-slow-log \
--apply-immediately \
--log-delivery-configurations '
{
"LogType":"engine-log",
"Enabled":false
}'
```
Für Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id test-slow-log ^
--apply-immediately ^
--log-delivery-configurations '
{
"LogType":"engine-log",
"Enabled":false
}'
```