Surveillance d'Amazon MSK

Le capteur Amazon MSK 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 notre documentation sur l' AWS.

MSK Broker - Collecte de métriques

Configuration suivie

Détails de l'instance MSK Description
ID ID de l'instance MSK spécifique.
ARN Nom de ressource Amazon (ARN) non qualifié affecté à l'instance.
Type Type d'instance MSK.
Type d'instance Type de niveau d'instance.
Ajouté au cluster Heure à laquelle le broker a été ajouté au cluster.

Métriques de performance

Métrique de performance Description
Partitions Nombre de partitions.
Nombre de partitions sous-répliquées Nombre de partitions qui sont sous-répliquées.

Métriques

Métriques du courtier Description Niveau de surveillance
Nombre de leaders Nombre total de leaders de partitions par broker, sans compter les répliques. DEFAULT
Octets entrants Nombre d'octets par seconde reçus des clients. Cette métrique est disponible par broker et aussi par sujet. DEFAULT
Octets sortants Nombre d'octets par seconde envoyés aux clients. Cette métrique est disponible par broker et aussi par sujet. DEFAULT
Messages entrants Nombre de messages entrants par seconde pour le broker. DEFAULT
Octets de requête Nombre moyen d'octets de requête pour le broker. DEFAULT
CPUIdle Pourcentage de temps d'inactivité de l'unité centrale. DEFAULT
CPUUser Pourcentage de l'unité centrale dans l'espace utilisateur. DEFAULT
CPUSystem Pourcentage de l'unité centrale dans l'espace du noyau. DEFAULT
Mémoire disponible Taille en octets de la mémoire qui est libre et disponible pour le broker. DEFAULT
Mémoire utilisée Taille en octets de la mémoire utilisée pour le broker. DEFAULT
Mémoire en cache Taille en octets de la mémoire cache du broker. DEFAULT
Mémoire tampon Taille en octets de la mémoire tampon du broker. DEFAULT
Mémoire d'échange disponible Taille en octets de la mémoire d'échange disponible pour le broker. DEFAULT
Mémoire d'échange utilisée Taille en octets de la mémoire d'échange qui est utilisée pour le broker. DEFAULT
Paquets réseau reçus Nombre de paquets reçus par le broker. DEFAULT
Réceptions réseau abandonnées Nombre de paquets reçus abandonnés. DEFAULT
Erreurs de réception réseau Nombre d'erreurs de réception du réseau pour le broker. DEFAULT
Transmissions réseau effectuées Nombre de paquets transmis par le broker. DEFAULT
Réceptions réseau abandonnées Nombre de paquets transmis abandonnés. DEFAULT
Erreurs de réception réseau Nombre d'erreurs de transmission du réseau pour le broker. DEFAULT
Temps de production Temps moyen de production en millisecondes. PER_BROKER
Temps de limitation de production Temps moyen de limitation de la production en millisecondes. PER_BROKER
Temps de limitation d'extraction Temps moyen de limitation d'extraction en millisecondes. PER_BROKER
Temps de limitation des requêtes Temps moyen de limitation des requêtes en millisecondes. PER_BROKER
Débit de production limité en octets Nombre d'octets limités par seconde. PER_BROKER
Débit d'extraction limité en octets Nombre d'octets limités par seconde. PER_BROKER
Temps d'extraction consommateurs Temps moyen total, en millisecondes, que les consommateurs consacrent à extraire des données du broker. PER_BROKER
Temps d'extraction suiveurs Temps moyen total, en millisecondes, que les suiveurs consacrent à extraire des données du broker. PER_BROKER
Temps d'inactivité du réseau Pourcentage moyen du temps pendant lequel les processeurs du réseau sont inactifs. PER_BROKER
Temps d'inactivité des requêtes Pourcentage moyen du temps pendant lequel les unités d'exécution du gestionnaire de requêtes sont inactives. PER_BROKER

Cluster MSK - Collecte des métriques

Configuration suivie

Détails du cluster MSK Description
Nom Nom du cluster MSK.
ARN Nom de ressource Amazon (ARN) non qualifié affecté à l'instance.
Surveillance améliorée Niveau de surveillance.
Version Kafka Version des instances Kafka.

Métriques de performance

Métrique de performance Description
Contrôleurs actifs Nombre de contrôleurs actifs.
Rubriques Nombre de sujets.

Métriques

Métriques du courtier Description Niveau de surveillance
Nombre de partitions Nombre total de partitions. DEFAULT
Partitions hors ligne Nombre total de partitions hors ligne. DEFAULT
Disque utilisé Utilisation de l"espace disque. DEFAULT

Droits requis

  • cloudwatch:GetMetricData
  • cloudwatch:GetMetricStatistics
  • kafka:ListClusters
  • kafka:ListNodes
  • kafka:ListTagsForResource
  • kafka:DescribeCluster

Limitations connues

Le détecteur Amazon MSK prend en charge la surveillance uniquement pour le type de cluster MSK mis à disposition. Le type de cluster sans serveur n'est pas pris en charge.

Configuration

Les métriques pour Amazon MSK sont extraites toutes les 5 minutes, ce qui peut être modifié via la configuration de l'agent (<agent_install_dir>/etc/instana/configuration.yaml):

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

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

com.instana.plugin.aws.msk:
  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.msk:
  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 à utiliser pour surveiller MSK, utilisez la configuration suivante :

com.instana.plugin.aws.msk:
  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 à utiliser pour surveiller MSK, utilisez la configuration suivante :

com.instana.plugin.aws.msk:
  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 de AWS.

Filtrage

Plusieurs balises séparées par des virgules peuvent être définies. Les balises doivent être fournies sous forme de paire clé-valeur séparées par un signe deux-points (:). Pour faciliter la configuration, il est possible de définir les balises que vous souhaitez inclure ou exclure dans 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 ont la possibilité de spécifier la fréquence à laquelle les capteurs interrogeront les ressources balisées AWS à l'aide de la propriété de configuration tagged-services-poll-rate (300 secondes par défaut).

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

Pour définir la fréquence d'interrogation des 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.msk:
  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.msk:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Les services AWS sans étiquette seront surveillés par défaut mais peuvent être exclus en définissant la zone include_untagged sur false :

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