Configuration personnalisée de l'intégration avec Firehose

Modifier en ligne

Pour activer la collecte des métriques d' AWSCloudWatch, vous devez appliquer Custom setup with Firehose l 'intégration. Pour plus d'informations sur la configuration d'autres prérequis, consultez le guide Configurer un flux métrique.

Le processus d'intégration comprend :

Configuration de l'instance de flux métrique AWS qui fournit les données métriques nécessaires AWS CloudWatch.
Configuration de l'instance de flux de livraison Firehose d' AWS qui fournit les données métriques AWS CloudWatch à Instana API à l'aide de la configuration de point de terminaison personnalisée HTTP.

Le reste de cette section décrit comment mettre en œuvre le processus d'intégration à l'aide de la console de gestion d' AWS.

Configurez un flux de métriques d' AWS s à l'aide de la console de gestion d' AWS

Pour plus d'informations sur la configuration de l'instance de flux de métriques AWS à l'aide de la console de gestion AWS CloudWatch, consultez le guide de configuration de la console de gestion AWS CloudWatch.

Le reste de cette section se concentre uniquement sur les paramètres de configuration qui doivent être configurés spécifiquement pour obtenir une observabilité en temps quasi réel avec Instana.

Tableau 1. Paramètres de configuration
Nom du paramètre de configuration	Valeur requise pour le paramètre de configuration
Modifier le format de sortie - facultatif	OpenTelemetry 1.0
Ajouter des statistiques supplémentaires - facultatif	Choisissez uniquement les statistiques par défaut (minimum, maximum, SampleCount, et somme), car aucune statistique supplémentaire n'est actuellement prise en charge.
Mesures à diffuser	Choisissez `Select metrics` et sélectionnez uniquement les espaces de noms actuellement pris en charge par Instana.

Configurez un flux de livraison Firehose d' AWS à l'aide de la console de gestion d' AWS

Pour plus d'informations sur la configuration de l'instance de flux de livraison Firehose d' AWS à l'aide de la console de gestion Firehose d' AWS, consultez le guide de configuration de la console de gestion Firehose d' AWS.

Le reste de cette section se concentre uniquement sur les paramètres de configuration qui doivent être configurés spécifiquement pour obtenir une observabilité en temps quasi réel avec Instana.

Configurer la source et la destination

Pour configurer les paramètres de livraison des données du flux de livraison Firehose d' AWS, utilisez les paramètres suivants :

Tableau 2. Paramètres de configuration pour la source et la destination
Nom du paramètre de configuration	Valeur requise pour le paramètre de configuration
Source	PUT direct
Destination	HTTP point final

Configurer les paramètres de destination

Pour configurer le point de terminaison d' HTTP s de la destination du flux de livraison Firehose d' AWS, utilisez les paramètres suivants :

Tableau 3. Paramètres de configuration pour les paramètres de destination
Nom du paramètre de configuration	Valeur requise pour le paramètre de configuration
HTTP URL des terminaux	Pour les serveurs auto-hébergés : `https://otlp-http.{base_domain}/v1/metrics/cloudwatch`
HTTP URL des terminaux	Pour le SaaS : `https://otlp-http-{region}-saas.instana.io/v1/metrics/cloudwatch`

Remarque : pour plus d'informations sur la valeur « region » et l'acceptateur « HTTP OTLP », consultez la section « Endpoints » du backend « Instana » (otlp-acceptor).

Configurer les paramètres d'authentification

Utilisez les paramètres de configuration Use access key (Utiliser la clé d'accès) ou Use AWS Secrets Manager - new (Utiliser - nouveau) pour fournir une clé d'agent Instana valide afin que vos demandes de flux de livraison Firehose puissent s'authentifier auprès du point de terminaison Instana.

Si vous choisissez Utiliser la clé d'accès :

Tableau 4. Paramètres de configuration pour `Use access key`
Nom du paramètre de configuration	Valeur requise pour le paramètre de configuration
Touche d'accès - facultative	Une clé d'agent valide d' Instana

Si vous choisissez Utiliser AWS Secrets Manager - nouveau lors de la création d'un nouveau secret :

Tableau 5. Paramètres de configuration pour `Use AWS Secrets Manager - new`
Nom du paramètre de configuration	Valeur requise pour le paramètre de configuration
Type de secret	Autre type
Paires clé-valeur	Clé secrète : `api_key` valeur secrète : une clé d'agent Instana valide

Configurer les paramètres d'encodage du contenu

Choisissez GZIP de compresser le corps de la requête avant de l'envoyer à la destination. L'utilisation GZIP du codage est nécessaire pour permettre à Instana de traiter vos données et de contrôler le coût global du transfert de données.

Configurer les paramètres de durée de réessai

Pour obtenir un traitement des données en temps quasi réel, la durée de réessai doit être courte. Une courte durée de nouvelle tentative garantit que les points de données retardés ne perturbent pas la continuité des données dans les graphiques chronologiques d' Instana.

Tableau 6. Paramètres de configuration pour la durée de réessai
Nom du paramètre de configuration	Valeur requise pour le paramètre de configuration
Durée de la nouvelle tentative	60 secondes

Remarque :

Instana ne traite pas les données d' CloudWatch s sauvegardées dans un compartiment d' AWS S3 s après l'expiration de Retry duration la période.
AWS Firehose ne garantit pas l'ordre de livraison après les nouvelles tentatives. Les données renvoyées et les nouvelles données peuvent arriver dans un ordre aléatoire.

Configurer les paramètres des conseils tampons

AWS Data Firehose met en mémoire tampon les métriques d' CloudWatch s en fonction de la taille des données configurée ( taille de la mémoire tampon ) et de l'intervalle de temps ( intervalle de la mémoire tampon ) avant de transmettre les données à la destination spécifiée. Pour obtenir un traitement des données d'observabilité en temps quasi réel dans l' Instana, définissez les valeurs des paramètres Taille du tampon et Intervalle du tampon sur des seuils bas afin que les données soient envoyées le plus rapidement possible à l' Instana API.

Tableau 7. Paramètres de configuration pour les conseils de mise en mémoire tampon
Nom du paramètre de configuration	Valeur requise pour le paramètre de configuration
Taille de la mémoire tampon	1 MiB
Intervalle tampon	60 secondes

Remarque :

Avec la configuration des indications de tampon donnée, la latence attendue est inférieure à 3 minutes si les espaces de noms d' CloudWatch s sélectionnés ont des mises à jour métriques actives.
Dans un flux métrique d' CloudWatch, les données sont envoyées toutes les minutes et peuvent arriver à leur destination finale dans un ordre aléatoire. Toutes les métriques configurées dans les espaces de noms spécifiés sont envoyées dans le flux de métriques, à l'exception des métriques dont l'horodatage remonte à plus de deux jours.