Les intégrations New Relic avec la Google Cloud Platform (GCP) en incluent une qui signale les données de Google Cloud Pub/Sub à New Relic. Ce document explique comment activer l’intégration GCP Pub/Sub et décrit les données qu’elle signale.
Caractéristiques
Dans le cadre de la solution d’analyse de flux Google Cloud, le service Cloud Pub/Sub ingère et distribue des flux d’événements pour un traitement des données et une analyse rapides. L’intégration New Relic Pub/Sub collecte les métriques de publication, de distribution, de backlog et de rétention sur les rubriques, les abonnements et les instantanés.
Activer l'intégration
Pour activer l’intégration, suivez les procédures standard pour connecter votre service GCP à New Relic:
- Se connecter avec la fédération d'identité de workload (Workload Identity Federation) (recommandé)
- Se connecter avec un compte de service ou un compte utilisateur
Fréquence des sondages
Les intégrations New Relic interrogent vos services GCP selon un intervalle d’interrogation qui varie selon l’intégration. La fréquence d'interrogation pour Google Cloud Pub/Sub est de 5 minutes. La résolution est de 1 point de données par minute.
Important
Cloud Pub/Sub prend en charge des intervalles d’interrogation de 1 minute pour les intégrations WIF en version préliminaire limitée. Pour demander l’accès, contactez le support New Relic.
Fédération d'identité de workload (Workload Identity Federation)
Rechercher et utiliser des données
Une fois que vous avez activé l’intégration, vos ressources Pub/Sub apparaissent sous forme d’entités dans l’explorateur d’entités de New Relic. Pour voir les dashboards et gérer les services, accédez à one.newrelic.com > All capabilities > Infrastructure > GCP.
Toutes les métriques Pub/Sub disponibles dans le monitoring cloud de GCP sont collectées en tant que métriques dimensionnelles dans le type d’événement Metric. Des métriques supplémentaires au-delà de ce tableau sont collectées automatiquement. Consultez la documentation de Google sur les métriques Pub/Sub pour obtenir la liste complète.
Entité
données métriques
Principales métriques — Topic
Nom métrique | Unité | Description |
|---|---|---|
| Compter | Nombre de requests de publication sur le topic, réparties par code de réponse. |
| Microsecondes | Distribution de la latence des requêtes de publication au niveau du topic. |
| Compter | Nombre de messages publiés dans la rubrique. |
| Octets | Distribution de la taille des messages publiés sur le sujet. |
| Octets | Coût en octets des opérations sur le sujet, utilisé pour la comptabilisation des quotas. |
| Compter | Nombre de messages conservés dans le sujet. |
| Compter | Nombre de messages non acquittés conservés par le topic, réparti par région. |
| Octets | Taille totale en octets des messages conservés dans le topic. |
| Secondes | Âge du message le plus ancien conservé dans la rubrique. |
| Secondes | Âge du plus ancien message non acquitté dans le topic, réparti par région. |
| Pour cent | Ratio d’utilisation du quota de publication pour le sujet. |
| Compter | Nombre de modifications de configuration appliquées au topic, ventilé par type d’opération et résultat. |
Pour la liste complète des métriques de sujet, consultez la documentation de Google sur les métriques Pub/Sub.
Principales métriques — abonnement
Nom métrique | Unité | Description |
|---|---|---|
| Compter | Nombre de messages en attente non acquittés dans l’abonnement. |
| Octets | Taille totale en octets des messages non acquittés dans l’abonnement. |
| Secondes | Âge du plus ancien message non acquitté dans l’abonnement. |
| Compter | Nombre de messages livrés au point de terminaison push de l'abonnement mais pas encore acquittés. |
| Compter | Nombre de messages acquittés sur l’abonnement. |
| Millisecondes | Distribution de la latence d’acquittement au niveau de l’abonnement. |
| Compter | Nombre de demandes de tirage émises pour l’abonnement, réparties par code de réponse. |
| Compter | Nombre de requests d’acquittement émises pour l’abonnement, réparties par code de réponse. |
| Compter | Nombre de tentatives de push de l’abonnement vers son point de terminaison, segmentées par code de réponse. |
| Microsecondes | Distribution de la latence des requêtes push de l'abonnement vers son point de terminaison, répartie par code de réponse. |
| Compter | Nombre de réponses StreamingPull renvoyées pour l’abonnement, réparties par code de réponse. |
| Compter | Nombre de délais d’acquittement qui ont expiré avant que l’abonné n’acquitte le message. |
| Compter | Nombre de messages livrés de l’abonnement à son sujet de lettres mortes. |
| Octets | Coût en octets des opérations sur l'abonnement, utilisé pour la comptabilisation des quotas. |
| Booléen | Score de santé indiquant si la latence de distribution de l’abonnement est dans sa cible. |
Pour la liste complète des métriques d’abonnement, consultez la documentation sur les métriques Pub/Sub de Google.
Métriques clés — instantané
Nom métrique | Unité | Description |
|---|---|---|
| Compter | Nombre de messages conservés dans le snapshot. |
| Octets | Taille totale en octets des messages conservés dans le snapshot. |
| Secondes | Âge du message le plus ancien dans l’instantané. |
| Compter | Nombre de messages contenus dans le snapshot, répartis par région. |
| Octets | Taille totale en octets des messages conservés dans l’instantané, répartie par région. |
| Secondes | Âge du message le plus ancien dans le snapshot, segmenté par région. |
| Compter | Nombre de modifications de configuration appliquées au snapshot, ventilé par type d’opération et résultat. |
Pour obtenir la liste complète des métriques d’instantané, consultez la documentation sur les métriques Pub/Sub de Google.
Compte de service ou compte utilisateur
Rechercher et utiliser des données
Après avoir activé l'intégration et attendu quelques minutes (en fonction de la fréquence d'interrogation), les données apparaîtront dans l'UI de New Relic. Pour rechercher et utiliser vos données, y compris les liens vers vos et vos paramètres d'alerte, accédez à one.newrelic.com > All capabilities > Infrastructure > GCP > (select an integration).
Les sujets Pub/Sub sont des entités nommées qui représentent des flux de messages, et les abonnements sont des entités nommées qui représentent des destinations de messages sur un sujet particulier.
Pour afficher les données métriques de votre intégration GCP Pub/Sub dans New Relic, créez une requête NRQL pour l'événement GcpPubSubTopicSample et GcpPubSubSubscriptionSample et leur attribut associé.
Exemple de sous-sujet GcpPub
requête GcpPubSubTopicSample événement dans New Relic pour afficher les données de l'attribut suivant :
Attribut | Description |
|---|---|
| Coût des opérations, mesuré en octets. Ceci est utilisé pour mesurer l'utilisation des quotas. |
| Nombre cumulé de modifications de configuration, regroupées par type d'opération et résultat. |
| Répartition des tailles des messages publiés (en octets). |
| Nombre de messages reconnus conservés dans une rubrique, répartis par région Cloud. |
| Nombre de messages non reconnus dans une rubrique, répartis par région Cloud. |
| Âge (en secondes) du message reconnu le plus ancien conservé dans une rubrique, réparti par région Cloud. |
| Âge (en secondes) du message non reconnu le plus ancien dans une rubrique, réparti par région Cloud. |
| Taille totale en octets des messages reconnus conservés dans une rubrique, répartis par région Cloud. |
| Nombre cumulé d'opérations de publication de messages. |
| Nombre cumulé de requests de publication. |
| Taille totale en octets des messages non reconnus dans une rubrique, répartie par région Cloud. |
Exemple d'abonnement GcpPubSub
requête GcpPubSubSubscriptionSample événement dans New Relic pour afficher les données de l'attribut suivant :
Attribut | Description |
|---|---|
| Taille totale en octets des messages non reconnus (alias messages en attente) dans un abonnement. |
| Coût cumulé des opérations, mesuré en octets. Ceci est utilisé pour mesurer l'utilisation des quotas. |
| Nombre cumulé de modifications de configuration pour chaque abonnement, regroupées par type d'opération et résultat. |
| Nombre cumulé d'opérations de message ModifyAckDeadline, regroupées par résultat. |
| Nombre cumulé de requests ModifyAckDeadline, regroupées par résultat. |
| Nombre de messages livrés au point de terminaison push d'un abonnement, mais pas encore reconnus. |
| Nombre de messages reconnus conservés dans un abonnement. |
| Nombre de messages reconnus conservés dans un abonnement, répartis par région Cloud. |
| Nombre de messages non reconnus dans un abonnement, répartis par région Cloud. |
| Nombre de messages non reconnus (aka messages en attente) dans un abonnement. |
| Âge (en secondes) du message reconnu le plus ancien conservé dans un abonnement. |
| Âge (en secondes) du message reconnu le plus ancien conservé dans un abonnement, réparti par région Cloud. |
| Âge (en secondes) du plus ancien message non reconnu (aka message d'arriéré) dans un abonnement. |
| Âge (en secondes) du message non reconnu le plus ancien dans un abonnement, réparti par région Cloud. |
| Nombre cumulé d'opérations de messages d'accusé de réception, regroupées par résultat. |
| Nombre cumulé de requests d'accusé de réception, regroupées par résultat. |
| Nombre cumulé d'opérations d'extraction de messages, regroupées par résultat. |
| Nombre cumulé de demandes de tirage, regroupées par résultat. |
| Nombre cumulé de tentatives de push, regroupées par résultat. Contrairement aux pulls, l'implémentation du serveur push ne regroupe pas les messages utilisateur, donc chaque demande ne contient qu'un seul message utilisateur. Le serveur push réessaye en cas d'erreur, de sorte qu'un message utilisateur donné peut apparaître plusieurs fois. |
| Répartition de la latence des requêtes push (en microsecondes), regroupée par résultat. |
| Taille totale en octets des messages reconnus conservés dans un abonnement. |
| Taille totale en octets des messages reconnus conservés dans un abonnement, répartie par région Cloud. |
| Nombre cumulé d'opérations de messages d'accusé de réception StreamingPull, regroupées par résultat. |
| Nombre cumulé de demandes de tirage en streaming avec des identifiants d'accusé de réception non vides, regroupées par résultat. |
| Nombre cumulé d'opérations d'extraction de messages en streaming, regroupées par résultat. |
| Nombre cumulé d'opérations StreamingPull ModifyAckDeadline, regroupées par résultat. |
| Nombre cumulé de demandes de tirage en streaming avec des champs ModifyAckDeadline non vides, regroupés par résultat. |
| Nombre cumulé de réponses d'extraction en continu, regroupées par résultat. |
| Taille totale en octets des messages non reconnus dans un abonnement, répartie par région Cloud. |