AWS CloudFront de surveillance

Modifier en ligne

Le capteur « AWS CloudFront » est automatiquement déployé et installé une fois que vous avez installé l'agent « Instana ». Ce capteur surveille les distributions d' AWS CloudFront s et les fonctions qui y sont associées.

Pour connaître les autres services pris en charge par l' AWS, consultez la rubrique « AWS ».

Prérequis

Modifier en ligne

Pour activer la surveillance d' AWS CloudFront, déployez l'agent dans la région us-east-1.
Pour surveiller les métriques Cache hit rate et Origin latency , activez des métriques de distribution CloudFront supplémentaires dans la console AWS . Pour savoir comment activer des indicateurs supplémentaires, consultez la documentation de AWS.

Afficher les détails et les indicateurs d'une distribution d' CloudFront

Modifier en ligne

Instana recueille des informations et des indicateurs relatifs à une distribution d' CloudFront.

CloudFront détails de la distribution

Modifier en ligne

Les données d' CloudFront s suivantes sont collectées par le capteur AWS CloudFront :


CloudFront -Détails de distribution	Description
ARN	Nom de ressource Amazon (ARN) de la distribution CloudFront .
Nom	Nom de domaine CloudFront de la distribution.
Région	Emplacement (région) de la distribution.
ID de distribution	Identificateur unique de la distribution.
Statut	Statut de déploiement de la distribution.
Heure de la dernière modification	Date et heure de la dernière modification de la distribution.

Métriques

Modifier en ligne

Instana recueille des données sur la distribution d' CloudFront s et les fonctions associées.

Distribution

Modifier en ligne


Nom	Description
Demandes	Le nombre total de requêtes de consultation reçues par CloudFront, pour toutes les méthodes HTTP et pour les requêtes adressées à la fois à HTTP et à HTTPS.
Bytes Uploaded	Le nombre total d'octets que les utilisateurs ont téléchargés vers votre serveur d'origine via CloudFront, à l'aide de requêtes POST et PUT.
Bytes Downloaded	Nombre total d'octets téléchargés par les afficheurs pour les demandes GET, HEAD et OPTIONS.
4xx Taux d'erreurs	Pourcentage de toutes les demandes de l'afficheur pour lesquelles le code de statut HTTP de la réponse est 4xx.
5xx Taux d'erreurs	Pourcentage de toutes les demandes de l'afficheur pour lesquelles le code de statut HTTP de la réponse est 5xx.
Taux d'erreurs total	Pourcentage de toutes les demandes de l'afficheur pour lesquelles le code de statut HTTP de la réponse est 4xx ou 5xx.
Taux de réussite en cache	Pourcentage de toutes les demandes pouvant être mises en cache pour lesquelles CloudFront a servi le contenu à partir de son cache. HTTP POST Les requêtes PUT et les erreurs ne sont pas mises en cache.
Temps d'attente d'origine	Temps total, en millisecondes, nécessaire à CloudFront pour envoyer une réponse au réseau pour une demande. Cette valeur de temps d'attente concerne uniquement les demandes traitées à partir de l'origine, c'est-à-dire non à partir du cache CloudFront .

Fonctions associées

Modifier en ligne


Nom	Description
Appels	Nombre de fois où la fonction a été démarrée (appelée) au cours d'une période donnée.
Utilisation du traitement	Durée (0-100, en pourcentage de la durée maximale autorisée) nécessaire à l'exécution de la fonction.
Régulations	Nombre de fois où la fonction a été régulée sur une période donnée.
Erreurs de validation	Nombre d'erreurs de validation générées par la fonction au cours d'une période donnée. Des erreurs de validation se produisent lorsque la fonction s'exécute correctement, mais renvoie des données non valides (un objet d'événement non valide).
Erreurs d'exécution	Nombre d'erreurs d'exécution qui se sont produites au cours d'une période donnée. Des erreurs d'exécution se produisent lorsque la fonction échoue.

Droits requis

Modifier en ligne

Les droits suivants sont nécessaires :

cloudfront:GetDistribution
cloudfront:ListDistributions
cloudfront:ListTagsForResource

Configuration du capteur « AWS CloudFront »

Modifier en ligne

Pour modifier la configuration du capteur « AWS CloudFront », modifiez les com.instana.plugin.aws.cloudfront propriétés de la configuration de l'agent dans le <agent_install_dir>/etc/instana/configuration.yml fichier.

Le capteur « AWS CloudFront » récupère les données de « CloudFront » toutes les 5 minutes. Pour modifier cette fréquence, utilisez la propriété cloudwatch_period :

com.instana.plugin.aws.cloudfront:
  cloudwatch_period: 60

Remarque : l'activation de la surveillance des fonctions entraîne des coûts supplémentaires en raison de l'augmentation du volume de données d' CloudWatch s collectées.

Pour activer la surveillance des fonctions CloudFront , définissez la propriété enable_function_monitoring: true :

com.instana.plugin.aws.cloudfront:
   enable_function_monitoring: true

Pour désactiver la surveillance des distributions CloudFront , définissez la propriété enabled: false :

com.instana.plugin.aws.cloudfront:
  enabled: false

Configuration du capteur « AWS CloudFront » pour l'utilisation d'un proxy

Modifier en ligne

Pour que le capteur « AWS CloudFront » utilise un proxy, ajoutez les propriétés suivantes à la configuration de l'agent dans le <agent_install_dir>/etc/instana/configuration.yml fichier :

com.instana.plugin.aws.cloudfront:
  proxy_host: 'example.com' # proxy host name or ip address
  proxy_port: 3128 # proxy port
  proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
  proxy_username: 'username' # OPTIONAL: proxy username
  proxy_password: 'password' # OPTIONAL: proxy password

Surveillance de plusieurs comptes AWS

Modifier en ligne

Pour configurer la surveillance de plusieurs comptes AWS avec un agent AWS dans la même région, voir la rubrique Surveillance de plusieurs comptes AWS .

Remplacer les profils d' AWS s utilisés pour surveiller CloudFront

Modifier en ligne

Pour définir manuellement les profils d' AWS s utilisés pour surveiller CloudFront,, utilisez la configuration suivante :

com.instana.plugin.aws.cloudfront:
  profile_names:
    - 'profile2'
    - 'profile3'

Remarque : si vous définissez des profils au niveau d'un service, la configuration globale des profils d' AWS s est remplacée.

Remplacer les rôles IAM utilisés pour surveiller CloudFront

Modifier en ligne

Pour définir les rôles IAM utilisés pour surveiller CloudFront,, utilisez la configuration suivante :

com.instana.plugin.aws.cloudfront:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_2_name>'

Remarque : si vous définissez des rôles IAM au niveau d'un service, la configuration globale des rôles IAM de AWS est remplacée.

Filtrage

Modifier en ligne

Vous pouvez définir des balises à utiliser pour inclure des services dans la reconnaissance ou pour exclure des services de la reconnaissance. Si vous n'avez pas besoin de filtrer les services, vous n'avez pas besoin de définir les balises.

Vous pouvez définir plusieurs balises, séparées par une virgule. Définissez chaque balise en tant que paire clé-valeur. Pour faciliter la configuration, vous pouvez définir les balises à inclure dans la reconnaissance ou à exclure de la reconnaissance. Si vous définissez la même balise dans les deux listes (include et exclude), la liste exclude a une priorité plus élevée. Il n'est pas obligatoire de définir toutes les valeurs pour activer le filtrage.

Remarque : les balises ne sont disponibles qu'avec l' agent « AWS ».

Vous pouvez spécifier la fréquence à laquelle les détecteurs interrogent les ressources référencées AWS à l'aide de la propriété de configuration tagged-services-poll-rate . Par défaut, la valeur est 300 secondes.

Pour définir la fréquence à laquelle les détecteurs interrogent les ressources balisées, utilisez la configuration suivante:

com.instana.plugin.aws:
  tagged-services-poll-rate: 60 #default 300

Pour inclure des services par balises dans la reconnaissance, utilisez la configuration suivante:

com.instana.plugin.aws.cloudfront:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

Pour exclure des services par balises de la reconnaissance, utilisez la configuration suivante:

com.instana.plugin.aws.cloudfront:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Les services AWS sans balises sont surveillés par défaut, mais vous pouvez les exclure en définissant la zone include_untagged sur false:

com.instana.plugin.aws.cloudfront:
  include_untagged: false # True value by default