Intégration de CockroachDB

La base de données Cockroach est une base de données SQL distribuée construite sur un magasin de valeurs clés transactionnel et fortement cohérent.

La base de données sur les cafards présente les caractéristiques suivantes :

• Échelles horizontales
• Survit aux pannes de disque, de machine, de rack et même data center avec une interruption de latence minimale et aucune intervention manuelle
• Prend en charge les transactions ACID hautement cohérentes
• Fournit une API SQL familière pour structurer, manipuler et interroger les données

CockroachDB génère des métriques de séries chronologiques détaillées pour chaque nœud d'un cluster. Le moniteur CockroachDB avec Prometheus vous montre comment extraire ces métriques dans Prometheus.

Utilisez New Relic pour monitorer :

• Santé Cluster
• Santé des nœuds
• Capacité de stockage et de disque
• Performances des requêtes SQL
• Nombre élevé de descripteurs de fichiers ouverts
• Expiration des certificats

Activer l'intégration

Suivez ces étapes pour activer l'intégration.

1. Suivez la documentation CockroachDB pour Prometheus pour découvrir les points de terminaison métriques CockroachDB.

2. Configurer Prometheus monitoring. Les métriques Prometheus doivent être intégrées à New Relic, vous pouvez utiliser l'agent Prometheus ou l'intégration d'écriture à distance, voir comment envoyer des métriques Prometheus.

   Important

   L' agent Prometheus récupère uniquement les métriques par défaut à partir d'un ensemble d'intégration.

   Dans ce cas, vous devez identifier votre pod ou point de terminaison avec l'une de ces étiquettes app.kubernetes.io/name, app.newrelic.io/name, k8s-app contenant la chaîne cockroachdb.

3. Utilisez la requête suivante pour confirmer que les métriques sont ingérées comme prévu :

   SELECT * FROM Metric WHERE metricName = 'rocksdb_num_sstables'

   Copier

4. Installez le quickstart de CockroachDB pour accéder aux dashboardsalertes et aux alertes intégrées.

   Important

   Certains graphiques du dashboard incluent des requêtes avec des conditions qui nécessitent l'identification de votre pod ou point de terminaison avec l'une de ces étiquettes app.kubernetes.io/name, app.newrelic.io/name, k8s-app contenant la chaîne cockroachdb.

   Une fois importés, vous pouvez modifier ou cloner les ressources pour les adapter à vos besoins spécifiques.

   Intégration de l'écriture à distance

   Par défaut, la configuration par défaut de l'agent Prometheus inclut les règles correspondantes. Lorsque vous utilisez l'intégration Remote Write, il n'est pas possible de déduire correctement le type en raison de la dénomination des métriques CockroachDB. Dans ce cas, vous devez inclure ces règles pour remplacer le type de métrique:

   - source_labels: [__name__]
     separator: ;
     regex: timeseries_write_(.*)
     target_label: newrelic_metric_type
     replacement: counter
     action: replace
   - source_labels: [__name__]
     separator: ;
     regex: sql_byte(.*)
     target_label: newrelic_metric_type
     replacement: counter
     action: replace

   Copier

Rechercher et utiliser les données

Métriques

Les métriques Prometheus sont stockées sous forme de métriques dimensionnelles. Vous pouvez effectuer une requête à l'aide de NRQL ou utiliser l' explorateur de données pour parcourir les métriques, les facettes et filtrer les dimensions associées disponibles.

Les différents ensembles de métriques exposés par cette intégration sont définis dans la documentation CockroachDB.

Utilisez la requête NRQL suivante pour comprendre les métriques CockroachDB ingérées dans New Relic.

Dépannage

Suivez les conseils de dépannage de la documentation CockroachDB pour vous assurer que les métriques sont configurées comme prévu sur votre cluster.

Vous pouvez également consulter les directives de dépannage spécifiques pour l'intégration Prometheus .