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.
Affichage des mesures
Pour afficher les métriques, procédez comme suit:
- Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
- 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:GetMetricDatacloudwatch:GetMetricStatisticsappsync:ListGraphqlApisappsync:GetGraphqlApiappsync: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'
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>'
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.
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