Nuestra integración Cassandra envía rendimiento métrico y datos de inventario desde su base de datos Cassandra a la plataforma New Relic . Puede ver el panel prediseñado de sus datos métricos de Cassandra, crear políticas de alertas y crear sus propias consultas y gráficos personalizados.
Continúe leyendo para instalar la integración y ver qué datos recopilamos.
Compatibilidad y requisitos
Nuestra integración es compatible con Apache Cassandra versión 3.x o superior.
Antes de instalar la integración, asegúrese de cumplir con los tres requisitos siguientes:
Entorno de ejecución Java 7 o superior.
Si Cassandra no se ejecuta en Kubernetes o Amazon ECS, debe instalar el agente de infraestructura en un host Linux que ejecute Cassandra. De lo contrario:
- Si se ejecuta en Kubernetes, consulte estos requisitos.
- Si se ejecuta en ECS, consulte estos requisitos.
Inicio rápido
Instrumente su Cassandra base de datos rápidamente y envíe sus telemetry data con instalación guiada. Nuestra instalación guiada utiliza nuestro agente de infraestructura y nuestra CLI para configurar la integración de Cassandra, descubre otras aplicaciones y fuentes log que se ejecutan en su entorno y luego recomienda cuáles debería utilizar.
La instalación guiada funciona con la mayoría de las configuraciones. Pero si no se adapta a sus necesidades, existen otras opciones de instalación a continuación.
¿Listo para comenzar? Haga clic en el botón correspondiente, según la región del centro de datos que utilice. Cuando haya terminado con la instalación, regrese a esta documentación para revisar las opciones de configuración.
Instalar y activar
Si no está utilizando la instalación guiada, siga las instrucciones para su entorno:
' '
¿Te ha ayudado este documento con la instalación?
Actualiza tu integración
Esta integración no se actualiza automáticamente. Para obtener mejores resultados, actualice periódicamente el paquete de integración y el agente de infraestructura.
Tareas posteriores a la instalación
Cuando haya terminado con la instalación, puede establecer las opciones de configuración. Se requieren algunas configuraciones para que la integración funcione, mientras que otras son opcionales.
Configurar la integración
Si habilitó esta integración a través de nuestra integración ECS o Kubernetes, consulte esos documentos:
Para la instalación estándar en el host, esta integración viene con un archivo de configuración YAML, apache-config.yml
. Esta configuración es donde puede colocar las credenciales de inicio de sesión requeridas y configurar cómo se recopilan los datos. Las opciones que cambie dependen de su configuración y preferencias. Viene con un archivo de configuración de muestra apache-config.yml.sample
que puedes copiar y editar.
Las configuraciones específicas relacionadas con Cassandra se definen usando la sección env
del archivo de configuración. Estas configuraciones controlan la conexión a su instancia de Cassandra, así como otras configuraciones y características de seguridad. La lista de configuraciones válidas se describe en la siguiente sección de este documento.
Opciones de configuración de Casandra
La integración Cassandra recopila información métrica (M) e inventario (I). En la tabla, utilice la columna Applies To para las configuraciones disponibles para cada colección:
' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '
Configuración | Descripción | Por defecto | Se aplica a |
---|---|---|---|
| Nombre de host o IP donde se está ejecutando Cassandra. |
| M/I |
| Puerto en el que Cassandra está escuchando. |
| M |
| Nombre de usuario para acceder a JMX. | N/A | M |
| Contraseña para el usuario dado. | N/A | M |
| Ruta al archivo de configuración de Cassandra. |
| I |
| Límite en el número de familias de columnas de Cassandra. |
| M |
| Solicitar tiempo de espera en milisegundos. |
| M |
| La ruta del archivo del almacén de claves que contiene el certificado SSL del cliente JMX. | N/A | M |
| La contraseña para el almacén de claves SSL JMX. | N/A | M |
| La ruta del archivo del almacén de confianza que contiene el certificado SSL del cliente JMX. | N/A | M |
| La contraseña para el almacén de confianza JMX SSL. | N/A | M |
Habilite el monitoreo de múltiples inquilinos. |
| M/I | |
| Establezca en |
| |
| Configúrelo en |
|
Los valores para estas configuraciones se pueden definir de varias maneras:
- Agregando el valor directamente en el archivo de configuración. Esta es la forma más común.
- Reemplazar los valores de las variables de entorno usando la notación
{{}}
. Esto requiere el agente de infraestructura v1.14.0+. Lea más aquí o vea el ejemplo a continuación. - Utilizando la gestión de secretos. Utilícelo para proteger información confidencial, como contraseñas que quedarían expuestas en texto sin formato en el archivo de configuración. Para obtener más información, consulte Gestión de secretos.
Etiquetas
Puedes decorar aún más tu métrica usando etiquetas. Las etiquetas le permiten agregar atributos (pares de valores principales) a su métrica, que luego puede usar para consultar, filtrar o agrupar su métrica.
Nuestro archivo de configuración de muestra predeterminado incluye ejemplos de etiquetas pero, como no son obligatorias, puede eliminar, modificar o agregar nuevas de su elección.
labels: env: production role: load_balancer
Configuración de ejemplo
A continuación se muestran algunos ejemplos de configuración de YAML:
Buscar y utilizar datos
Los datos de esta integración se pueden encontrar en: one.newrelic.com > Infrastructure > Third-party services > Cassandra.
Los datos de Cassandra se adjuntan a los tipos de eventos CassandraSample
y CassandraColumnFamilySample
. Puede consultar estos datos para fines de resolución de problemas o para crear gráficos y paneles.
Para obtener más información sobre cómo encontrar y utilizar sus datos, consulte Comprender los datos de integración.
Para recrear el estado de nodetool con NRQL, ejecute la siguiente consulta:
SELECT cluster.datacenter, fullHostname, cluster.name, cluster.rack, entityName, hostStatus, (db.loadBytes /10e3) AS 'kb db.loadBytes' FROM CassandraSample
Datos métricos
Los nodos métricos de Cassandra están adjuntos al tipo de evento CassandraSample
. La integración Cassandra recoge estos nodos métricos:
Nombre | Descripción |
---|---|
| Cantidad total de bytes almacenados en las memtables (2i y memtables de vaciado pendientes incluidas) que residen en el montón. |
| Cantidad total de bytes almacenados en las memtables (2i y memtables de vaciado pendientes incluidas) que residen fuera del montón. |
| El número de mensajes de registro de confirmación escritos por segundo. |
| Número de mensajes de registro de confirmación escritos pero aún por sincronizar. |
| Tamaño actual, en bytes, utilizado por todos los segmentos log de confirmación. |
| Mensajes descartados por segundo para este tipo de solicitud. |
| Capacidad de caché de claves en bytes. |
| Tasa de caché de acierto de clave de un minuto. |
| Número de claves acierto de caché por segundo. |
| Número de solicitudes al caché de claves por segundo. |
| Tamaño de la caché ocupada en bytes. |
| Número de SSTables en el disco para esta familia de columnas. |
| Tamaño, en bytes, del tamaño de los datos en disco que administra este nodo. |
| Capacidad de caché de filas en bytes. |
| Fila de un minuto acierto de tarifa de caché. |
| Número de filas acierto de caché por segundo. |
| Número de solicitudes a la caché de filas por segundo. |
| Tamaño total de la caché de filas ocupadas, en bytes. |
| Número de tareas en las que este grupo está trabajando activamente.
|
| Número de tareas en cola en este grupo. |
| Número de tareas completadas. |
| Número de tareas que fueron bloqueadas debido a la saturación de la cola. |
| Número de tareas que actualmente están bloqueadas debido a la saturación de la cola pero que al reintentar se desbloquearán. |
| Número de sugerencias que actualmente se intentan enviar. |
| Número de mensajes de sugerencia por segundo escritos en este nodo. Incluye una entrada para cada host que recibirá sugerencias por sugerencia. |
| Transacción lee latencia en solicitudes por segundo. |
| La transacción escribe latencia en solicitudes por segundo. |
| Número de solicitudes de segmento de rango por segundo. |
| Número de tiempos de espera encontrados por segundo al procesar solicitudes de lectura de rango token . |
| Número de excepciones no disponibles encontradas por segundo al procesar solicitudes de lectura de rango token . |
| Lea la latencia en milisegundos, percentil 50. |
| Lea la latencia en milisegundos, percentil 75. |
| Lea la latencia en milisegundos, percentil 95. |
| Lea la latencia en milisegundos, percentil 98. |
| Lea la latencia en milisegundos, percentil 999. |
| Lea la latencia en milisegundos, percentil 99. |
| Número de solicitudes de lectura por segundo. |
| Número de tiempos de espera encontrados por segundo al procesar solicitudes de lectura estándar. |
| Número de excepciones no disponibles encontradas por segundo al procesar solicitudes de lectura estándar. |
| Número de solicitudes de escritura de vista por segundo. |
| Escribe latencia en milisegundos, percentil 50. |
| Escribe latencia en milisegundos, percentil 75. |
| Escribe latencia en milisegundos, percentil 95. |
| Escribe latencia en milisegundos, percentil 98. |
| Escribe latencia en milisegundos, percentil 999. |
| Escribe latencia en milisegundos, percentil 99. |
| Número de solicitudes de escritura por segundo. |
| Número de tiempos de espera encontrados por segundo al procesar solicitudes de escritura regulares. |
| Número de excepciones no disponibles encontradas por segundo al procesar solicitudes de escritura regulares. |
Familia de columnas Cassandra métricas y metadatos.
La integración Cassandra recupera la familia de columnas métricas. Los datos de la familia de columnas de Cassandra se adjuntan al tipo de evento CassandraColumnFamilySample
. Omite los espacios de claves del sistema (system
, system_auth
, system_distributed
, system_schema
, system_traces
y OpsCenter
). Para limitar el impacto en el rendimiento, la integración solo capturará métrica para un máximo de 20 familias de columnas.
Los siguientes metadatos indican el keyspace y la familia de columnas asociadas con la métrica de muestra:
Nombre | Descripción |
---|---|
| La familia de columnas Cassandra a la que se refieren estas métricas. |
| El keyspace de Cassandra que contiene esta familia de columnas. |
| El keyspace y la familia de columnas en un único atributo de metadatos en el siguiente formato: |
La lista de métricas a continuación se refiere al keyspace específico y a la familia de columnas especificadas en los metadatos anteriores:
Nombre | Descripción |
---|---|
| Número total de bytes almacenados en las tablas de memoria (incluidas las tablas de memoria 2i y de vaciado pendiente) que residen fuera del montón. |
| Número total de bytes almacenados en las memtables (2i y memtables de vaciado pendientes incluidas) que residen en el montón. |
| Espacio en disco en bytes utilizado por SSTables que pertenecen a esta familia de columnas (en bytes). |
| Número de SSTables en el disco para esta familia de columnas. |
| Estimación del número de compactaciones pendientes para esta familia de columnas. |
| Número de archivos de datos estables a los que se accede por lectura, percentil 50. |
| Número de archivos de datos estables a los que se accede por lectura, percentil 75. |
| Número de archivos de datos estables a los que se accede por lectura, percentil 95. |
| Número de archivos de datos estables a los que se accede por lectura, percentil 98. |
| Número de archivos de datos estables a los que se accede por lectura, percentil 999. |
| Número de archivos de datos estables a los que se accede por lectura, percentil 99. |
| Latencia de lectura local en milisegundos para esta familia de columnas, percentil 50. |
| Latencia de lectura local en milisegundos para esta familia de columnas, percentil 75. |
| Latencia de lectura local en milisegundos para esta familia de columnas, percentil 95. |
| Latencia de lectura local en milisegundos para esta familia de columnas, percentil 98. |
| Latencia de lectura local en milisegundos para esta familia de columnas, percentil 999. |
| Latencia de lectura local en milisegundos para esta familia de columnas, percentil 99. |
| Número de solicitudes de lectura por segundo para esta familia de columnas. |
| Latencia de escritura local en milisegundos para esta familia de columnas, percentil 50. |
| Latencia de escritura local en milisegundos para esta familia de columnas, percentil 75. |
| Latencia de escritura local en milisegundos para esta familia de columnas, percentil 95. |
| Latencia de escritura local en milisegundos para esta familia de columnas, percentil 98. |
| Latencia de escritura local en milisegundos para esta familia de columnas, percentil 999. |
| Latencia de escritura local en milisegundos para esta familia de columnas, percentil 99. |
| Número de solicitudes de escritura por segundo para esta familia de columnas. |
Inventario
La integración captura las opciones de configuración definidas en la configuración de Cassandra y las reporta como datos de inventario en la New Relic UI.
Metadatos del sistema
La integración de Cassandra también recoge estos atributos sobre el servicio y su configuración:
Nombre | Descripción |
---|---|
| La versión Casandra. |
| El nombre del clúster al que pertenece este nodo Cassandra. |
Comprueba el código fuente
Esta integración es software de código abierto. Eso significa que puedes explorar su código fuente y enviar mejoras, o crear tu propia bifurcación y compilarla.