Surveillance d'AWS Kinesis

Le capteur « AWS Kinesis » 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.

Informations complémentaires

Prise en charge du traçage côté client

Pour cette technologie, Instana prend en charge le traçage côté client pour les langages et environnements d'exécution suivants :

Capteur (collecte de données)

Configuration suivie

  • Détails de l'instance Kinesis Data Streams
    • Nom du flux
    • ARN du flux
    • Statut du flux
    • Type de chiffrement du flux
    • Durée de conservation de flux (heures)
    • Date et heure de création du flux
    • Zone de regroupement AWS

Droits requis

  • cloudwatch:GetMetricData
  • kinesis:ListStreams
  • kinesis:DescribeStream
  • kinesis:ListTagsForStream

Configuration

Les métriques pour Kinesis sont extraites toutes les 5 minutes, qui peuvent être modifiées via la configuration de l'agent dans <agent_install_dir>/etc/instana/configuration.yml:

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

Pour désactiver la surveillance des flux Kinesis, utilisez la configuration suivante:

com.instana.plugin.aws.kinesis:
  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.kinesis:
  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 pouvant être utilisés pour surveiller Kinesis, utilisez la configuration suivante:

com.instana.plugin.aws.kinesis:
  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 Kinesis, utilisez la configuration suivante:

com.instana.plugin.aws.kinesis:
  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 forme de paires clé-valeur séparées par : Pour faciliter la configuration, il est possible de définir les balises que vous souhaitez inclure ou exclure de la détection. 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 balisé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.kinesis:
  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.kinesis:
  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.kinesis:
  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.