Surveillance du service OpenSearch d'Amazon

Le capteur du service Amazon OpenSearch est automatiquement déployé et installé une fois que vous avez installé l'agent Instana.

Remarque : pour en savoir plus sur les autres services pris en charge par l' AWS, consultez la documentation sur l' AWS.

Capteur (collecte de données)

Configuration suivie

Le capteur du service Amazon Web Services ( OpenSearch ) suit les détails d' OpenSearch s suivants :

  • ARN de domaine
  • Nom de domaine
  • Zone de regroupement (région)

Métriques

  • Statuts du cluster : Vert, Jaune, Rouge
  • Nombre de noeuds
  • Nombre de documents consultables et supprimés
  • Pourcentage maximal de ressources d'UC utilisées pour les noeuds de données du cluster
  • Stockage disponible pour le cluster
  • Espace utilisé pour le cluster
  • Indicateur de cluster pour l'acceptation ou le blocage des demandes d'écriture entrantes (cluster_index_writes_blocked)
  • Sollicitation de la mémoire JVM
  • Métriques d'échec d'image d'instantané automatique
  • Nombre de demandes avec des codes d'état HTTP
  • Temps d'attente de recherche, temps moyen nécessaire à un fragment pour effectuer une opération de recherche
  • Crédits d'UC restants disponibles pour les noeuds de données du cluster

Pour plus d'informations, consultez la section « Indicateurs et dimensions d'Amazon OpenSearch ».

Droits requis

  • cloudwatch:GetMetricData
  • cloudwatch:GetMetricStatistics
  • cloudwatch:GetMetricData
  • es:ListDomainNames
  • es:ListTags
  • es:DescribeElasticsearchDomain

Configuration

Les métriques d' OpenSearch sont extraites toutes les 5 minutes, ce qui peut être modifié via la configuration de l'agent dans le fichier <agent_install_dir>/etc/instana/configuration.yml :

com.instana.plugin.aws.es:
  cloudwatch_period: 300

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

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

Configuration de proxy

Pour configurer le capteur AWS spécifique, afin d'utiliser la configuration du proxy, ajoutez les paramètres de configuration d'agent suivants :

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

Reportez-vous à la documentation Surveillance de plusieurs comptes AWS pour configurer la surveillance de plusieurs comptes AWS avec un agent AWS dans la même région.

Approche des profils nommés AWS

Pour remplacer les profils utilisés pour surveiller OpenSearch,, utilisez la configuration suivante :

com.instana.plugin.aws.es:
  profile_names:
    - 'profile2'
    - 'profile3'
Remarque : la définition de profils au niveau du service remplace la configuration globale des profils d' AWS.

Approche AWS STS

Pour remplacer les rôles IAM utilisés pour surveiller OpenSearch,, utilisez la configuration suivante :

com.instana.plugin.aws.es:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_2_name>'
Remarque : la définition de rôles IAM au niveau du service remplace la configuration globale des rôles IAM sur AWS.

Filtrage

Plusieurs balises séparées par des virgules peuvent être définies. Les balises sont fournies sous la forme d'une paire clé-valeur séparée par: Pour faciliter la configuration, il est possible de définir les balises à inclure dans la reconnaissance ou à exclure de la reconnaissance. Si vous définissez une balise dans les deux listes (inclusion et exclusion), la liste d'exclusion a une priorité plus élevée. S'il n'est pas nécessaire de filtrer les services, la configuration ne doit pas être définie. Il n'est pas obligatoire de définir toutes les valeurs pour activer le filtrage.

Les utilisateurs peuvent spécifier la fréquence à laquelle les détecteurs interrogent les ressources étiquetées AWS qui utilisent la propriété de configuration tagged-services-poll-rate (valeur par défaut: 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.es:
  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.es:
  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 peuvent être exclus en définissant la zone include_untagged sur false:

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

Balises de l'agent Instana

Veuillez noter que les balises ne sont disponibles qu'avec l 'agent « AWS ». Vous trouverez ici plus de détails sur l'utilisation des balises.