Surveillance d'Amazon MSK
Le capteur Amazon MSK est automatiquement déployé et installé une fois que vous avez installé l'agent Instana.
Capteur (collecte de données)
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:GetMetricDatacloudwatch:GetMetricStatisticskafka:ListClusterskafka:ListNodeskafka:ListTagsForResourcekafka: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'
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>'
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).
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