> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Métriques AWS CloudWatch

AppSignal peut recevoir et visualiser des métriques de votre infrastructure AWS via les CloudWatch Metric Streams. Une fois la connexion établie, AppSignal crée automatiquement des [Magic Dashboards](/metrics/aws-dashboards) pour les services AWS que vous utilisez, vous offrant des graphiques préconstruits pour les métriques les plus importantes.

## Comment ça fonctionne

AWS CloudWatch collecte les métriques des services s'exécutant dans votre compte AWS. Un CloudWatch Metric Stream exporte ces métriques via Amazon Data Firehose vers le point de terminaison HTTP d'AppSignal au format OpenTelemetry.

Le flux de données ressemble à ceci :

**Services AWS** → **CloudWatch** → **Metric Stream** → **Data Firehose** → **AppSignal**

Une fois les métriques reçues, AppSignal normalise les noms de métriques, applique les tags issus des dimensions CloudWatch, et les stocke sous forme de données de séries temporelles. Lorsque AppSignal détecte des métriques d'un service AWS pris en charge, il crée un Magic Dashboard avec des graphiques préconstruits pour ce service.

## Configurer les métriques CloudWatch

Il existe deux manières de connecter les métriques CloudWatch à AppSignal :

### Configuration via la console

Suivez les instructions pour créer un delivery stream Firehose, un bucket S3 de sauvegarde et un CloudWatch Metric Stream via la console AWS.

Consultez [Diffuser les métriques AWS CloudWatch via la console AWS](/metrics/cloudwatch).

### CloudFormation

Déployez un seul template CloudFormation qui crée toutes les ressources requises en une seule étape. C'est la manière la plus rapide de commencer et la plus facile à reproduire sur plusieurs comptes ou régions AWS.

Consultez [Diffuser les métriques AWS CloudWatch avec CloudFormation](/metrics/cloudwatch-cloudformation).

## Magic dashboards

AppSignal crée automatiquement des tableaux de bord lorsqu'il détecte des métriques CloudWatch d'un service AWS pris en charge. Chaque tableau de bord est conçu pour répondre aux questions opérationnelles courantes : y a-t-il un problème, pourquoi est-ce lent, et dois-je passer à l'échelle ?

Les tableaux de bord placent en premier les indicateurs de santé et d'erreurs, suivis de l'utilisation des ressources, puis du contexte opérationnel. Les descriptions des graphiques expliquent quelles valeurs indiquent un problème et que faire pour le résoudre, vous n'avez donc pas besoin d'être un expert de la surveillance AWS pour interpréter vos données.

AppSignal prend en charge les Magic Dashboards pour plus de 45 services AWS dans les domaines du calcul, des bases de données, du réseau, du stockage, de la messagerie, et plus encore.

Consultez [Magic dashboards AWS](/metrics/aws-dashboards) pour la liste complète des services pris en charge et leurs graphiques.

## Choisir quelles métriques diffuser

Les CloudWatch Metric Streams peuvent envoyer les métriques de tous les services AWS de votre compte ou d'un sous-ensemble filtré. Diffuser toutes les métriques est l'option la plus simple. Si vous n'avez besoin que de services spécifiques, filtrez par namespace pour limiter les données envoyées via Firehose.

Pour filtrer, ajoutez `IncludeFilters` à la ressource Metric Stream, en spécifiant les namespaces CloudWatch que vous voulez (comme `AWS/EC2`, `AWS/Lambda` ou `AWS/RDS`). Consultez la page [Magic dashboards AWS](/metrics/aws-dashboards) pour le namespace de chaque service pris en charge.

Pour des exemples de configuration de filtrage, consultez le [guide de configuration CloudFormation](/metrics/cloudwatch-cloudformation#filter-specific-aws-services).

## Dénomination des métriques

AppSignal normalise les noms des métriques CloudWatch en minuscules avec des underscores. Le format est le namespace normalisé suivi du nom de la métrique en `snake_case`.

Par exemple, `AWS/Lambda` `Duration` devient `aws_lambda_duration`, et `AWS/Firehose` `DeliveryToS3.Success` devient `aws_firehose_delivery_to_s3_success`.

Vous pouvez utiliser ces noms normalisés lors de la création de [tableaux de bord personnalisés](/metrics/dashboards) ou de la configuration de la [détection d'anomalies](/metrics/dashboards) dans AppSignal.

## Tags et dimensions

Les dimensions CloudWatch (telles que `FunctionName`, `DBInstanceIdentifier` ou `ServiceName`) deviennent des tags dans AppSignal. Utilisez ces tags pour filtrer les graphiques par ressources spécifiques.

Les Magic Dashboards utilisent des filtres de tags génériques pour afficher toutes les ressources d'un type donné sous forme de lignes distinctes sur le même graphique. Vous pouvez également utiliser ces tags dans les tableaux de bord personnalisés pour des vues plus ciblées.

## Configurations multi-régions et multi-comptes

Les CloudWatch Metric Streams fonctionnent au sein d'une seule région AWS. Si vous exécutez des charges de travail dans plusieurs régions, déployez un Metric Stream et un delivery stream Firehose distincts dans chaque région. Le [template CloudFormation](/metrics/cloudwatch-cloudformation) peut être déployé une fois par région pour cela.

Pour les configurations multi-comptes, créez un Metric Stream dans chaque compte. Utilisez la même clé Push API au niveau de l'application pour envoyer toutes les métriques vers une seule app AppSignal, ou utilisez des clés différentes pour séparer les métriques entre plusieurs apps.

## Dépannage

Si les métriques n'apparaissent pas dans AppSignal après la configuration :

1. Vérifiez l'onglet **Monitoring** de votre delivery stream Firehose dans la console AWS. Cherchez des valeurs non nulles pour les métriques **Incoming records** et **HTTP endpoint - Success**.
2. Vérifiez que l'état du Metric Stream affiche **Running** dans la console CloudWatch sous **Metrics > Streams**.
3. Vérifiez le bucket S3 de sauvegarde pour les enregistrements de livraison échoués.
4. Confirmez que le format de sortie est défini sur **OpenTelemetry 1.0**. Les autres formats ne sont pas pris en charge.

Certaines métriques AWS (telles que les métriques de stockage quotidiennes S3) sont rapportées avec des horodatages de plus de deux heures et n'apparaissent pas dans les Metric Streams. Consultez la [documentation AWS sur les CloudWatch Metric Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) pour plus de détails sur les fréquences de rapport des métriques.

Si vous avez besoin d'aide, [contactez-nous](mailto:support@appsignal.com).
