AWS AppSync de surveillance

Le capteur « AWS AppSync » est automatiquement déployé et installé une fois que vous avez installé l'agent « Instana ». Vous pouvez consulter les indicateurs liés à l' AWS AppSync ation dans l'interface utilisateur d' Instana.

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

Affichage des mesures

Pour afficher les métriques, procédez comme suit:

  1. Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
  2. Cliquez sur une instance spécifique d' AWS AppSync.

Vous pouvez consulter un tableau de bord d' AWS AppSync s contenant toutes les données collectées.

Données de configuration

Le capteur « AWS AppSync » recueille les données d' AppSync s suivantes :

  • ARN
  • Nom
  • Région
  • ID d'API
  • Type d'API
  • Type d'authentification
  • Visibilité
  • Sources de données

Métriques

Le capteur « AWS AppSync » recueille les indicateurs suivants :

Nom Description
Erreurs 4xx Nombre d'erreurs résultant de demandes non valides en raison d'une configuration client incorrecte au cours d'une période.
Erreurs 5xx Nombre d'erreurs rencontrées lors de l'exécution d'une requête GraphQL au cours d'une période.
Nombre total d'erreurs Nombre total d'erreurs (4xx + 5xx) sur une période.
Temps d'attente Le délai moyen entre le moment où AWS AppSync reçoit une requête d'un client et celui où il renvoie une réponse à ce client.
Demandes Nombre total de demandes (requêtes + mutations) que toutes les API de votre compte ont traitées, par région, sur une période donnée.
Jetons consommés Nombre total de jetons alloués aux demandes traitées dans une région particulière au cours d'une période.
Réussite de la connexion Nombre total de connexions WebSocket établies avec succès à l'adresse AWS AppSync au cours d'une période donnée.
Erreur de connexion du client Nombre de connexions WebSocket rejetées par AWS AppSync en raison d'erreurs côté client au cours d'une période donnée.
Erreur de connexion au serveur Nombre d'erreurs provenant de AWS AppSync survenues lors du traitement des connexions au cours d'une période donnée.
Abonnement réussi Le nombre d'abonnements enregistrés avec succès sur AWS AppSync via WebSocket au cours d'une période donnée.
Erreur d'abonnement au client Nombre d'abonnements rejetés par AWS AppSync en raison d'erreurs côté client au cours d'une période donnée.
Erreur d'abonnement au serveur Nombre d'erreurs provenant de AWS AppSync lors du traitement des abonnements au cours d'une période donnée.
Réussite de la publication des messages de données Nombre de messages d'événement d'abonnement publiés avec succès dans une période.
Erreur du client de message de publication de données Nombre de messages d'événement d'abonnement dont la publication a échoué en raison d'erreurs côté client au cours d'une période.
Erreur du serveur de messages de publication de données Le nombre d'erreurs provenant d' AWS AppSync s pendant la publication des messages d'événements d'abonnement au cours d'une période donnée.
Taille des messages de publication de données Taille des messages d'événement d'abonnement publiés en octets.
Connexions actives Le nombre de connexions simultanées via le protocole WebSocket établies par les clients vers AWS AppSync en une minute.
Abonnements actifs Nombre d'abonnements simultanés des clients en 1 minute.
Durée de connexion Durée moyenne pendant laquelle la connexion reste ouverte.

Droits requis

Le capteur « AWS AppSync » nécessite les autorisations suivantes :

  • cloudwatch:GetMetricData
  • cloudwatch:GetMetricStatistics
  • appsync:ListGraphqlApis
  • appsync:GetGraphqlApi
  • appsync:ListDataSources

Configuration

Les données de mesure d' AWS AppSync s sont récupérées toutes les 60 secondes. Vous pouvez modifier ce paramètre dans le fichier <agent_install_dir>/etc/instana/configuration.yml :

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

Pour désactiver la surveillance des instances AppSync , utilisez la configuration suivante:

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

Activation de la configuration du proxy

Pour permettre au capteur « AWS AppSync » d'utiliser la configuration du proxy, ajoutez les paramètres de configuration d'agent suivants :

com.instana.plugin.aws.appsync:
  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

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 .

AWS approche par profils nommés

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

com.instana.plugin.aws.appsync:
  profile_names:
    - 'profile2'
    - 'profile3'
Remarque : si vous définissez des profils au niveau du service, la configuration globale du profil d' AWS s est remplacée.

Approche AWS STS

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

com.instana.plugin.aws.appsync:
  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 du rôle IAM « AWS » est remplacée.

Filtrer en définissant des balises

Vous pouvez définir plusieurs balises, chacune séparée par une virgule. Les balises doivent être fournies sous la forme d'une 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 des balises dans les deux listes (include et exclude), la liste exclude a une priorité plus élevée. Si vous n'avez pas besoin de filtrer les services, vous n'avez pas besoin de définir les balises. Il n'est pas obligatoire de définir toutes les valeurs pour activer le filtrage.

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.

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

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.appsync:
  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.appsync:
  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.appsync:
  include_untagged: false # True value by default