Surveillance de Google Cloud Pub/Sub

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 :

Configuration

Modifier en ligne

L'intégration Google Cloud d'Instana utilise des comptes de service pour créer une connexion API entre Google Cloud et Instana. Les instructions suivantes expliquent comment créer le compte de service et fournir les identifiants du compte de service d' Instana afin de commencer à effectuer des appels vers API en votre nom.

Accédez à la page des identifiants de Google Cloud pour le projet Google Cloud sur lequel vous souhaitez configurer l'intégration Instana.
Cliquez sur CREATE CREDENTIALS > Compte de service.
Sur la page Créer un compte de service , entrez un nom unique pour le compte de service et cliquez sur Créer et continuer.
Sélectionnez un rôle ou créez-en un personnalisé, qui contient au moins les droits suivants:
- monitoring.timeSeries.list
- pubsub.subscriptions.list
- pubsub.topics.list
- resourcemanager.projects.get
Pour créer un rôle personnalisé, procédez comme suit :
1. Dans le menu de navigation, cliquez sur Rôles > Créer un rôle.
2. Entrez le titre du rôle et cliquez sur ADD PERMISSIONS.
3. Ajoutez les droits de base mentionnés précédemment, qui sont requis pour le rôle, puis cliquez sur Créer.
Sélectionnez le compte que vous avez créé dans la liste des comptes de service.
Sélectionnez l'onglet KEYS et cliquez sur Ajouter une clé.
Sélectionnez « Créer une nouvelle clé », choisissez le type de clé « JSON », puis cliquez sur « CRÉER ».

Remarque : vous devez noter l'emplacement du fichier d'informations d'identification afin de pouvoir finaliser l'intégration.
Ajoutez une zone credentials_path au fichier configuration.yml avec le chemin d'accès au fichier de données d'identification. Par exemple, voir configuration.

Pour surveiller un ou plusieurs projets, les services suivants doivent être activés :

Configuration

Modifier en ligne

Vous pouvez configurer la fréquence d'interrogation des métriques d' Google Cloud Pub/Sub, exprimée en secondes, en ajoutant la configuration suivante au fichier de configuration de l'agent GCP :

com.instana.plugin.gcp.pubsub:
  enabled: true
  poll_rate: 60  # How often Google's monitoring API will be polled
  credentials_path: '/opt/instana/credentials/cred-gcp.json'  # Path to Service Account credentials
  include_tags:
    topic:
    subscription:
  exclude_tags:
    topic:
    subscription:

Filtrage

Modifier en ligne

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 le 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.

Pour inclure des sujets et des abonnements par balises dans la reconnaissance, utilisez la configuration suivante :

com.instana.plugin.gcp.pubsub:
  include_tags:
    topic: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
    subscription: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Pour exclure des sujets et des abonnements par balises de la reconnaissance, procédez comme suit :

com.instana.plugin.gcp.pubsub:
  exclude_tags:
    topic: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
    subscription: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Si la configuration de balises d'inclusion doit s'appliquer à la fois aux sujets et aux abonnements, utilisez la configuration suivante :

com.instana.plugin.gcp.pubsub:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Si la configuration de balises d'exclusion doit s'appliquer à la fois aux sujets et aux abonnements, utilisez la configuration suivante :

com.instana.plugin.gcp.pubsub:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Libellés

Modifier en ligne

L'agent « Instana » récupère automatiquement les étiquettes à partir des sujets et abonnements de « Google Cloud Pub/Sub ». Ces étiquettes s'affichent dans la section « Balises » de la barre latérale pour chaque sujet et chaque abonnement Pub/Sub. Vous pouvez utiliser ces étiquettes comme filtres pour trier les ressources sur la carte de l'infrastructure dans l'interface utilisateur d' Instana.

Google Cloud Pub/Sub - Collecte des métriques

Modifier en ligne

Données de configuration

Modifier en ligne

Nom de projet
ID de projet
Numéro du projet
Heure de création

Métriques de performance

Modifier en ligne


Métrique	Description	Réducteur/Aligneur
Nombre de messages	Nombre cumulé de messages envoyés par Cloud Pub/Sub aux clients de l'abonné.	SOMME REDUITE / DELTA ALIGNE
Taille des messages	Taille totale des messages sans accusé de réception dans un abonnement.	SOMME REDUITE / MODELE ALIGNEE
Age du message le plus ancien	Age (en secondes) du message le plus ancien sans accusé de réception dans un abonnement.	MOT_DE_LIMITE_MAX / MOT_DE_ALIGNEE

La granularité est de 60 secondes pour toutes les métriques.

Rubrique Google Cloud Pub/Sub - Collecte des métriques

Modifier en ligne

Données de configuration

Modifier en ligne

ID de projet
Nom de la rubrique

Métriques de performance

Modifier en ligne


Métrique	Description	Réducteur/Aligneur
Taille des messages	Taille totale des messages sans accusé de réception dans un abonnement.	MODELE REDUITE / DELTA DE L'ALIGNEMENT
Age du message le plus ancien avec accusé de réception	Age (en secondes) du message le plus ancien avec accusé de réception conservé dans un sujet, réparti par région de cloud.	SOMME REDUITE / MODELE ALIGNEE
Age du message le plus ancien sans accusé de réception	Age (en secondes) du message le plus ancien sans accusé réception dans un sujet, réparti par région de cloud.	SOMME REDUITE / MODELE ALIGNEE
Opération de publication	Nombre cumulé d'opérations de publication de message, regroupées par résultat.	SOMME REDUITE / DELTA ALIGNE
Demandes de publication	Nombre cumulé de demandes de publication, regroupées par résultat.	SOMME REDUITE / DELTA ALIGNE
Coût des opérations	Coût des opérations, en octets.	SOMME REDUITE / DELTA ALIGNE

La granularité est de 60 secondes pour toutes les métriques.

Abonnement Google Cloud Pub/Sub - Collecte des métriques

Modifier en ligne

Données de configuration

Modifier en ligne

ID de projet
Nom de l'abonnement
Nom de la rubrique

Métriques de performance

Modifier en ligne


Métrique	Description	Réducteur/Aligneur
Taille des messages	Taille totale des messages sans accusé de réception dans un abonnement.	NEAU_RÉDUCTION/MODELE D'ALIGNEMENT
Messages avec accusé de réception	Nombre cumulé de messages répondant positivement aux demandes d'accuser réception.	SOMME REDUITE / DELTA ALIGNE
Messages sans accusé de réception	Nombre de messages sans accusé de réception dans un abonnement.	NEAU_RÉDUCTION/MODELE D'ALIGNEMENT
Nombre de messages de lettres mortes	Nombre cumulé de messages publiés dans le sujet de lettres mortes.	SOMME REDUITE / DELTA ALIGNE
Messages envoyés	Nombre cumulé de messages envoyés par Cloud Pub/Sub aux clients de l'abonné.	SOMME REDUITE / DELTA ALIGNE
Messages en attente	Nombre de messages envoyés au noeud final push d'un abonnement, n'ayant pas encore reçu d'accusé de réception.	NEAU_RÉDUCTION/MODELE D'ALIGNEMENT
Age du message le plus ancien avec accusé de réception	Age (en secondes) du message avec accusé de réception le plus ancien, conservé dans un abonnement.	NEAU_RÉDUCTION/MODELE D'ALIGNEMENT
Age du message le plus ancien sans accusé de réception	Age (en secondes) du message le plus ancien sans accusé de réception dans un abonnement.	NEAU_RÉDUCTION/MODELE D'ALIGNEMENT
Opérations d'extraction de message	Nombre cumulé d'opérations d'extraction de message, regroupées par résultat.	SOMME REDUITE / DELTA ALIGNE
Opérations d'envoi d'accusé de réception de message	Nombre cumulé d'opérations d'envoi d'accusé réception de message, regroupées par résultat.	SOMME REDUITE / DELTA ALIGNE
Demandes d'extraction	Nombre cumulé de demandes d'extraction (pull), regroupées par résultat.	SOMME REDUITE / DELTA ALIGNE
Demandes Push	Nombre cumulé de tentatives de soumission par commande push, regroupées par résultat.	SOMME REDUITE / DELTA ALIGNE
Demandes Ack	Nombre cumulé de demandes d'accusé de réception, regroupées par résultat.	SOMME REDUITE / DELTA ALIGNE
Temps d'attente pour les demandes push	Répartition des temps d'attente pour les demandes push (en microsecondes), regroupées par résultat.	MODELE REDUITE / DELTA DE L'ALIGNEMENT
Nombre de mises à jour de configuration	Nombre cumulé de modifications de configuration pour chaque abonnement.	SOMME REDUITE / DELTA ALIGNE
Coût des opérations	Coût cumulé des opérations, en octets.	SOMME REDUITE / DELTA ALIGNE

La granularité est de 60 secondes pour toutes les métriques.

Signatures d'intégrité

Modifier en ligne

Pour chaque capteur, il existe une base de connaissances des signatures d'intégrité qui sont évaluées en permanence par rapport aux métriques entrantes et qui sont utilisées pour traiter les problèmes ou les incidents en fonction de l'impact sur l'utilisateur.

Les événements intégrés déclenchent des problèmes ou des incidents en cas de signatures d'intégrité défaillantes sur des entités, tandis que les événements personnalisés déclenchent des problèmes ou des incidents en fonction de seuils définis pour les métriques individuelles d'une entité donnée.

Pour plus d'informations sur les événements générés pour Google Cloud Pub/Sub, voir Référence des événements intégrés.