

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

**Important**  
Avis de fin de support : le 30 septembre 2026, AWS le support de. AWS App Mesh Après le 30 septembre 2026, vous ne pourrez plus accéder à la AWS App Mesh console ni aux AWS App Mesh ressources. Pour plus d'informations, consultez ce billet de blog [intitulé Migration from AWS App Mesh to Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect). 

Lorsque vous créez vos nœuds virtuels et vos passerelles virtuelles, vous avez la possibilité de configurer les journaux d'accès d'Envoy. Dans la console, cela se trouve dans la section **Logging** du nœud virtuel et la passerelle virtuelle permet de créer ou de modifier des flux de travail.

![\[Logging configuration interface showing HTTP access logs path field with example path.\]](http://docs.aws.amazon.com/fr_fr/app-mesh/latest/userguide/images/logging.png)


L'image précédente montre un chemin de journalisation de `/dev/stdout` pour les journaux d'accès à Envoy.

Pour`format`, spécifiez **l'un** des deux formats possibles, `json` *ou*`text`, et le modèle. `json`prend des paires de clés et les transforme en structure JSON avant de les transmettre à Envoy.

Le bloc de code suivant montre la représentation JSON que vous pouvez utiliser dans le 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"
                }
            }
         }
      }
```

**Important**  
Assurez-vous de vérifier que votre modèle de saisie est valide pour Envoy, sinon Envoy rejettera la mise à jour et stockera les dernières modifications dans le`error state`.

Lorsque vous envoyez les journaux d'accès à Envoy`/dev/stdout`, ils sont mélangés aux journaux des conteneurs Envoy. Vous pouvez les exporter vers un service de stockage et de traitement des CloudWatch journaux tel que Logs à l'aide de pilotes de journal Docker standard tels que`awslogs`. Pour plus d'informations, consultez la section [Utilisation du pilote de journal awslogs dans le manuel](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html) Amazon ECS Developer Guide. Pour exporter uniquement les journaux d'accès à Envoy (et ignorer les autres journaux du conteneur Envoy), vous pouvez `ENVOY_LOG_LEVEL` définir le sur`off`. Vous pouvez enregistrer une demande sans chaîne de requête en incluant la chaîne de format`%REQ_WITHOUT_QUERY(X?Y):Z%`. Pour des exemples, voir [`ReqWithoutQuery`Formatter.](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/formatter/req_without_query/v3/req_without_query.proto) Pour plus d'informations, consultez la section [Journalisation des accès](https://www.envoyproxy.io/docs/envoy/latest/configuration/observability/access_log/access_log.html) dans la documentation d'Envoy.

**Activer les journaux d'accès sur Kubernetes**  
Lorsque vous utilisez l'[App Mesh Controller pour Kubernetes](https://docs.aws.amazon.com/app-mesh/latest/userguide/mesh-k8s-integration.html), vous pouvez configurer des nœuds virtuels avec la journalisation des accès en ajoutant la configuration de journalisation à la spécification du nœud virtuel, comme indiqué dans l'exemple suivant.

```
---
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"
```

Votre cluster doit disposer d'un redirecteur de journaux pour collecter ces journaux, tel que Fluentd. Pour plus d'informations, voir [Configurer Fluentd comme un DaemonSet pour envoyer des journaux à CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Container-Insights-setup-logs.html).

Envoy écrit également divers journaux de débogage à partir de ses filtres vers`stdout`. Ces journaux sont utiles pour mieux comprendre à la fois les communications d'Envoy avec App Mesh et service-to-service le trafic. Votre niveau de journalisation spécifique peut être configuré à l'aide de la variable d'`ENVOY_LOG_LEVEL`environnement. Par exemple, le texte suivant provient d'un exemple de journal de débogage indiquant le cluster auquel Envoy a fait correspondre une requête HTTP particulière.

```
[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 et 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.) est un routeur de journaux de conteneurs que vous pouvez utiliser pour collecter des journaux pour Amazon ECS et. AWS Fargate Vous trouverez un exemple d'utilisation de Firelens dans notre référentiel d'[AWS exemples](https://github.com/aws-samples/amazon-ecs-firelens-examples).

Vous pouvez l'utiliser CloudWatch pour recueillir des informations de journalisation ainsi que des métriques. Vous trouverez plus d'informations à ce sujet CloudWatch dans notre section [Exportation de métriques](https://docs.aws.amazon.com/app-mesh/latest/userguide/metrics.html#cloudwatch) de la documentation App Mesh.