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.

# Exemple : Comptage des occurrences d'un terme
<a name="CountOccurrencesExample"></a>

Les événements du journal comprennent fréquemment des messages importants que vous pouvez souhaiter comptabiliser. Il peut s'agir de messages sur l'échec ou la réussite des opérations. Par exemple, une erreur peut se produire et être enregistrée dans un fichier journal en cas d'échec d'une opération spécifique. Il est possible de surveiller ces entrées pour comprendre l'évolution de vos erreurs.

Dans l'exemple ci-dessous, un filtre de métrique est créé pour surveiller le terme Error. La politique a été créée et ajoutée au groupe de journaux **MyApp/message.log**. CloudWatch Logs publie un point de données vers la métrique CloudWatch personnalisée ErrorCount dans l'espace de noms **MyApp/message.log** avec une valeur de « 1 » pour chaque événement contenant une erreur. Si aucun événement ne contient le mot Error, la valeur 0 est publiée. Lorsque vous tracez ces données dans la CloudWatch console, veillez à utiliser la statistique de somme.

Après avoir créé un filtre de mesure, vous pouvez afficher la métrique dans la CloudWatch console. Lorsque vous sélectionnez la métrique à afficher, sélectionnez l'espace de noms de métrique correspondant au nom du groupe de journaux. Pour de plus amples informations, consultez [Affichage des métriques disponibles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html).

**Pour créer un filtre métrique à l'aide de la CloudWatch console**

1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dans le panneau de navigation, choisissez **Groupes de journaux**.

1. Choisissez le nom du groupe de journaux.

1. Choisissez **Actions**, **Créer un filtre de métriques**.

1. Pour **Modèle de filtre**, saisissez **Error**.
**Note**  
Toutes les entrées figurant dans **Filter Pattern** sont sensibles à la casse.

1. (Facultatif) Pour tester votre modèle de filtre, sous **Test Pattern** (Modèle de test), saisissez un ou plusieurs événements du journal à utiliser pour tester le modèle. Chaque événement de journal doit se trouver sur une seule ligne, car des sauts de ligne sont utilisés pour séparer les événements du journal dans la boîte **Messages d'événements du journal**.

1. Choisissez **Suivant**, puis, sur la page **Affecter une métrique**, pour **Nom du filtre**, tapez **MyAppErrorCount**.

1. Sous **Metric Details**, pour **Metric Namespace**, tapez **MyNameSpace**.

1. Dans **Metric Name (Nom de la métrique)**, saisissez **ErrorCount**.

1. Confirmez que la **Valeur de la métrique** est égale à 1. Cela indique que le décompte est augmenté d'1 pour chaque événement de journal contenant « Error ».

1. Pour **Valeur par défaut** tapez 0, puis choisissez **Suivant**. 

1. Choisissez **Créer un filtre de métriques**.

**Pour créer un filtre métrique à l'aide du AWS CLI**  
A partir d'une invite de commande, exécutez la commande suivante :

```
aws logs put-metric-filter \
  --log-group-name MyApp/message.log \
  --filter-name MyAppErrorCount \
  --filter-pattern 'Error' \
  --metric-transformations \
      metricName=ErrorCount,metricNamespace=MyNamespace,metricValue=1,defaultValue=0
```

Vous pouvez tester cette nouvelle stratégie en publiant les événements contenant le mot « Error » dans le message.

**Pour publier des événements à l'aide du AWS CLI**  
A partir d’une invite de commande, exécutez la commande suivante. Notez que les modèles sont sensible à la casse.

```
aws logs put-log-events \
  --log-group-name MyApp/access.log --log-stream-name TestStream1 \
  --log-events \
    timestamp=1394793518000,message="This message contains an Error" \
    timestamp=1394793528000,message="This message also contains an Error"
```