

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.

# Protokollierung
<a name="envoy-logs"></a>

**Wichtig**  
Hinweis zum Ende des Supports: Am 30. September 2026 AWS wird der Support für eingestellt. AWS App Mesh Nach dem 30. September 2026 können Sie nicht mehr auf die AWS App Mesh Konsole oder die Ressourcen zugreifen. AWS App Mesh Weitere Informationen finden Sie in diesem Blogbeitrag [Migration von AWS App Mesh zu Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect). 

Wenn Sie Ihre virtuellen Knoten und virtuellen Gateways erstellen, haben Sie die Möglichkeit, Envoy-Zugriffsprotokolle zu konfigurieren. In der Konsole befindet sich dies im Bereich **Protokollierung** der Workflows zum Erstellen oder Bearbeiten von virtuellen Knoten und virtuellen Gateways.

![](http://docs.aws.amazon.com/de_de/app-mesh/latest/userguide/images/logging.png)


Das vorherige Bild zeigt einen Protokollierungspfad `/dev/stdout` für Envoy-Zugriffsprotokolle.

Geben Sie für `format` **eines** von zwei möglichen Formaten `json` *oder* und `text` das Muster an. `json`nimmt Schlüsselpaare und wandelt sie in eine JSON-Struktur um, bevor sie an Envoy übergeben werden.

Der folgende Codeblock zeigt die JSON-Darstellung, die Sie in der verwenden können. AWS CLI

```
      "logging": { 
         "accessLog": { 
            "file": { 
               "path": "{{/dev/stdout}}",
                "format" : { 
                    // Exactly one of json or text should be specified
                    "json": [ // json will be implemented with key pairs
                        {
                            "key": "string",
                            "value": "string"
                        }
                    ]
                    "text": "string" //e.g. "%LOCAL_REPLY_BODY%:%RESPONSE_CODE%:path=%REQ(:path)%\n"
                }
            }
         }
      }
```

**Wichtig**  
Stellen Sie sicher, dass Ihr Eingabemuster für Envoy gültig ist. Andernfalls lehnt Envoy das Update ab und speichert die neuesten Änderungen in der. `error state`

Wenn Sie Envoy-Zugriffsprotokolle an senden`/dev/stdout`, werden sie mit den Envoy-Container-Protokollen vermischt. Sie können sie mit standardmäßigen Docker-Protokolltreibern wie CloudWatch Logs in einen Protokollspeicher- und -verarbeitungsdienst wie Logs exportieren. `awslogs` Weitere Informationen finden Sie unter [Verwenden des awslogs-Protokolltreibers](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html) im Amazon ECS-Entwicklerhandbuch. Um nur die Envoy-Zugriffsprotokolle zu exportieren (und die anderen Envoy-Container-Protokolle zu ignorieren), können Sie den Wert auf setzen. `ENVOY_LOG_LEVEL` `off` Sie können Anfragen ohne Abfragezeichenfolge protokollieren, indem Sie die Formatzeichenfolge angeben. `%REQ_WITHOUT_QUERY(X?Y):Z%` Beispiele finden Sie unter [`ReqWithoutQuery`Formatter.](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/formatter/req_without_query/v3/req_without_query.proto) Weitere Informationen finden Sie unter [Zugriffsprotokollierung](https://www.envoyproxy.io/docs/envoy/latest/configuration/observability/access_log/access_log.html) in der Envoy-Dokumentation.

**Aktivieren Sie die Zugriffsprotokolle auf Kubernetes**  
Wenn Sie den [App Mesh Controller für Kubernetes](https://docs.aws.amazon.com/app-mesh/latest/userguide/mesh-k8s-integration.html) verwenden, können Sie virtuelle Knoten mit Zugriffsprotokollierung konfigurieren, indem Sie die Protokollierungskonfiguration zur virtuellen Knotenspezifikation hinzufügen, wie im folgenden Beispiel gezeigt.

```
---
apiVersion: appmesh.k8s.aws/v1beta2
kind: VirtualNode
metadata:
  name: {{virtual-node-name}}
  namespace: {{namespace}}
spec:
  listeners:
    - portMapping:
        port: 9080
        protocol: http
  serviceDiscovery:
    dns:
      hostName: {{hostname}}
  logging:
    accessLog:
      file:
        path: "/dev/stdout"
```

Ihr Cluster muss über einen Log-Forwarder verfügen, um diese Protokolle zu sammeln, z. B. Fluentd. Weitere Informationen finden Sie unter [Fluentd einrichten, um Logs an Logs DaemonSet zu senden](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Container-Insights-setup-logs.html). CloudWatch 

Envoy schreibt auch verschiedene Debugging-Protokolle aus seinen Filtern in. `stdout` Diese Protokolle sind nützlich, um Einblicke sowohl in die Kommunikation von Envoy mit App Mesh als auch in den service-to-service Datenverkehr zu gewinnen. Ihre spezifische Protokollierungsebene kann mithilfe der `ENVOY_LOG_LEVEL` Umgebungsvariablen konfiguriert werden. Der folgende Text stammt beispielsweise aus einem Beispiel-Debug-Protokoll, das den Cluster zeigt, den Envoy für eine bestimmte HTTP-Anfrage abgeglichen hat.

```
[debug][router] [source/common/router/router.cc:434] [C4][S17419808847192030829] cluster 'cds_ingress_howto-http2-mesh_color_client_http_8080' match for URL '/ping'
```

## Firelens und Cloudwatch
<a name="firelens-cloudwatch-logging"></a>

[Firelens](https://aws.amazon.com/about-aws/whats-new/2019/11/aws-launches-firelens-log-router-for-amazon-ecs-and-aws-fargate/#:~:text=FireLens%20is%20a%20container%20log,for%20log%20analytics%20and%20storage.&text=This%20means%20you%20can%20use,your%20own%20Fluentd%20output%20plugin.) ist ein Container-Log-Router, mit dem Sie Protokolle für Amazon ECS und sammeln können. AWS Fargate[Ein Beispiel für die Verwendung von Firelens finden Sie in unserem Samples-Repository.AWS](https://github.com/aws-samples/amazon-ecs-firelens-examples)

Sie können es verwenden CloudWatch , um sowohl Protokollinformationen als auch Metriken zu sammeln. Weitere Informationen finden Sie CloudWatch in unserem Abschnitt [Metriken exportieren](https://docs.aws.amazon.com/app-mesh/latest/userguide/metrics.html#cloudwatch) der App Mesh Mesh-Dokumente.