Présentation
Recueillez des métriques de Cassandra en temps réel pour :
- Visualiser et surveiller les états de Cassandra
- Être informé des failovers et des événements de Cassandra
Implémentation
Installation
Le check Cassandra est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur vos nœuds Cassandra. Nous vous conseillons d’utiliser le JDK d’Oracle pour cette intégration.
Remarque : ce check prévoit une limite de 350 métriques par instance. Le nombre de métriques renvoyées est indiqué dans la page d’information. Vous pouvez choisir des métriques pertinentes en modifiant la configuration ci-dessous. Pour découvrir comment modifier la liste des métriques à recueillir, consultez la section JMX afin d’obtenir des instructions détaillées. Si vous souhaitez surveiller plus de 350 métriques, contactez l’assistance Datadog.
Configuration
Collecte de métriques
La configuration par défaut de votre fichier cassandra.d/conf.yaml active la collecte de vos métriques Cassandra. Consultez le fichier d’exemple cassandra.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
Redémarrez l’Agent.
Collecte de logs
Disponible à partir des versions > 6.0 de l’Agent
Pour les environnements conteneurisés, suivez les instructions de la section Collecte de logs Kubernetes ou de la section Collecte de logs Docker.
La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml :
Ajoutez ce bloc de configuration à votre fichier cassandra.d/conf.yaml pour commencer à recueillir vos logs Cassandra :
logs:
- type: file
path: /var/log/cassandra/*.log
source: cassandra
service: myapplication
log_processing_rules:
- type: multi_line
name: log_start_with_date
# pattern to match: DEBUG [ScheduledTasks:1] 2019-12-30
pattern: '[A-Z]+ +\[[^\]]+\] +\d{4}-\d{2}-\d{2}'
Modifiez les valeurs des paramètres path et service et configurez-les pour votre environnement. Consultez le fichier d’exemple cassandra.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
Pour vous assurer que les stack traces sont bien agrégées en un seul log, vous pouvez ajouter une règle de traitement multiligne.
Redémarrez l’Agent.
Validation
Lancez la sous-commande « status » de l’Agent et cherchez cassandra dans la section Checks.
Données collectées
Métriques
Événements
Le check Cassandra n’inclut aucun événement.
Checks de service
cassandra.can_connect
Renvoie CRITICAL si l’Agent n’est pas capable de se connecter à l’instance Cassandra qu’il surveille et d’y recueillir des métriques. Si ce n’est pas le cas, renvoie OK.
Statuses: ok, critical
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
Pour aller plus loin
Présentation
Ce check permet de recueillir des métriques pour votre cluster Cassandra qui ne sont pas proposées par l’intégration jmx. Cette collecte repose sur l’utilitaire nodetool.
Implémentation
Installation
Le check Cassandra Nodetool est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur vos nœuds Cassandra.
Configuration
Suivez les instructions ci-dessous pour configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la section Environnement conteneurisé pour la configuration dans un environnement conteneurisé.
Host
Modifiez le fichier cassandra_nodetool.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent. Consultez le fichier d’exemple cassandra_nodetool.d/conf.yaml pour découvrir toutes les options de configuration disponibles :
init_config:
instances:
## @param keyspaces - list of string - required
## The list of keyspaces to monitor.
## An empty list results in no metrics being sent.
#
- keyspaces:
- "<KEYSPACE_1>"
- "<KEYSPACE_2>"
Redémarrez l’Agent.
Collecte de logs
Les logs Cassandra Nodetool sont recueillis par l’intégration Cassandra. Consultez les instructions à ce sujet.
Environnement conteneurisé
Pour les environnements conteneurisés, utilisez l’exportateur Prometheus officiel dans le pod, puis servez-vous de la fonction Autodiscovery dans l’Agent pour rechercher le pod et interroger l’endpoint.
Validation
Lancez la sous-commande status de l’Agent et cherchez cassandra_nodetool dans la section Checks.
Données collectées
Métriques
Événements
Le check Cassandra_nodetool n’inclut aucun événement.
Checks de service
cassandra.nodetool.node_up
L’Agent envoie ce check de service pour chaque nœud du cluster surveillé. Renvoie CRITICAL si le nœud est indisponible. Si ce n’est pas le cas, renvoie OK.
Statuses: ok, critical
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
Pour aller plus loin
