- Configurer un bucket S3 pour les livraisons échouées
- Configurer un rôle IAM pour Data Firehose
- Créer un stream Firehose
- Créer un CloudWatch metric stream
- La clé Push API au niveau de l’application de votre app. Pour la trouver, ouvrez la page des paramètres des clés d’API, ou rendez-vous dans les paramètres de votre organisation et sélectionnez Dev zone > API keys.
- La région AWS depuis laquelle vous souhaitez diffuser les métriques.
- Les permissions AWS pour créer des streams Firehose, des CloudWatch metric streams, des buckets S3 et des rôles IAM.
Configurer un bucket S3 pour les livraisons échouées
Amazon Data Firehose nécessite un bucket S3 pour stocker les enregistrements dont la livraison a échoué. Créez un bucket S3 via la console AWS ou la CLI avant de continuer.Configurer un rôle IAM pour Data Firehose
Créez un rôle IAM qui permet à Data Firehose d’écrire dans le bucket S3. Utilisez la politique de confiance suivante :JSON
Consultez Adding IAM identity
permissions
pour les instructions sur la création de politiques inline pour les rôles IAM.
JSON
<FIREHOSE_S3_BUCKET> par le nom du bucket S3 que vous avez créé à l’étape précédente.
Créer un stream Firehose
- Ouvrez la console Amazon Data Firehose et sélectionnez Create Firehose stream.
- Sélectionnez Direct PUT comme source.
- Sélectionnez HTTP Endpoint comme destination.
- Sous “Transform records”, laissez la transformation des données désactivée. Les données doivent être livrées telles quelles.
- Saisissez l’URL suivante comme HTTP endpoint URL :
Shell
- Saisissez la clé Push API au niveau de l’application de votre app comme Access key. Il ne s’agit pas d’une clé d’accès AWS. C’est la clé qu’AppSignal utilise pour identifier votre app.
- Sous “Content encoding”, sélectionnez GZIP.
- Sous “Buffer hints”, définissez la taille du buffer à 1 MB et l’intervalle du buffer à 60 seconds pour la latence la plus faible. Des valeurs plus élevées réduisent les coûts mais augmentent le délai de livraison.
- Sous “Backup settings”, définissez la sauvegarde des enregistrements source sur Failed data only et sélectionnez le bucket S3 que vous avez créé aux étapes précédentes.
- Sous “Advanced settings > Service access”, sélectionnez Choose existing IAM role et choisissez le rôle IAM que vous avez créé aux étapes précédentes.
- Sélectionnez Create Firehose stream.
Créer un CloudWatch metric stream
- Dans la console CloudWatch, allez dans Metrics > Streams.
- Sélectionnez Create metric stream.
- Sélectionnez Custom setup with Firehose. Sous Select your Amazon Data Firehose stream, choisissez le stream Firehose que vous avez créé à l’étape précédente.
- Choisissez les métriques à diffuser :
- All metrics diffuse tout depuis tous les services AWS. C’est l’option la plus simple, mais qui peut augmenter les coûts.
- Selected namespaces vous permet d’inclure ou d’exclure des namespaces spécifiques, comme
AWS/EC2,AWS/LambdaouAWS/RDS. Consultez la page Magic dashboards pour les services pris en charge par AppSignal.
- Sélectionnez OpenTelemetry 1.0 comme format de sortie.
- Pour Service access, laissez la console AWS créer ou mettre à jour le rôle IAM pour vous, ou choisissez un rôle existant disposant des autorisations d’écriture dans le stream Firehose.
- Sélectionnez Create metric stream.
Vérifier la configuration
Après avoir terminé la configuration, patientez 5 à 10 minutes pour que les métriques commencent à apparaître dans AppSignal. Pour vérifier que les données circulent :- Vérifiez l’onglet Monitoring de votre stream Firehose dans la console AWS. Cherchez des valeurs non nulles pour les métriques Incoming records et HTTP endpoint - Success.
- Vérifiez que l’état du metric stream affiche Running dans la console CloudWatch sous Metrics > Streams.
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
pour plus de détails sur les fréquences de rapport des métriques.
Métriques CloudWatch dans AppSignal
Après la configuration, AppSignal reçoit les métriques de tout service AWS qui émet des métriques via CloudWatch. AppSignal crée automatiquement des Magic Dashboards pour les services AWS pris en charge lorsqu’il détecte leurs métriques. Ces tableaux de bord apparaissent dans Dashboards avec des graphiques préconstruits pour les métriques les plus importantes de chaque service. Vous pouvez également créer vos propres vues à l’aide de tableaux de bord personnalisés. Dans le champ Metric, tapezaws_ pour parcourir les métriques CloudWatch reçues par AppSignal. AppSignal normalise les noms des métriques CloudWatch en minuscules avec des underscores. Par exemple, AWS/Firehose DeliveryToS3.Success devient aws_firehose_delivery_to_s3_success.
Quelques minutes peuvent s’écouler après la configuration avant que les premières métriques n’apparaissent. Si la liste est vide, patientez quelques minutes et actualisez.
Si vous avez besoin d’aide, contactez-nous.