Cassandra monitoramento integração

Nossa integração Cassandra envia métricas de desempenho e dados de inventário do seu banco de dados Cassandra para a plataforma New Relic . Você pode visualizar um painel pré-construído de seus dados métricos do Cassandra, criar políticas de alertas e criar suas próprias consultas e gráficos personalizados.

Continue lendo para instalar a integração e ver quais dados coletamos.

Compatibilidade e requisitos

Nossa integração é compatível com Apache Cassandra versão 3.x ou superior.

Antes de instalar a integração, certifique-se de atender aos três requisitos a seguir:

Java Runtime Environment 7 ou superior.
Se o Cassandra não estiver em execução no Kubernetes ou no Amazon ECS, você deverá instalar o agente de infraestrutura em um host Linux que esteja executando o Cassandra. De outra forma:
- Se estiver executando no Kubernetes, consulte estes requisitos.
- Se estiver executando no ECS, consulte estes requisitos.

Começo rápido

Instrumente seu banco de dados Cassandra rapidamente e envie seus dados de telemetria com instalação guiada. Nossa instalação guiada usa nosso agente de infraestrutura e nossa CLI para configurar a integração do Cassandra, e descobre outros aplicativos e fontes log em execução em seu ambiente e então recomenda quais você deve usar.

A instalação guiada funciona com a maioria das configurações. Mas se não atender às suas necessidades, existem outras opções de instalação abaixo.

Pronto para começar? Clique no botão relevante, dependendo da região do data center que você usa. Quando terminar a instalação, retorne a esta documentação para revisar as opções de configuração.

Instalação guiada, região dos EUA

Instalação guiada, região da UE

Instalar e ativar

Se você não estiver usando a instalação guiada, siga as instruções para seu ambiente:

' '

Para instalar a integração do Cassandra no Linux:

Instale o agente de infraestrutura e substitua a variável INTEGRATION_FILE_NAME por nri-cassandra.
Mude o diretório para a pasta integration :
bash
```
$cd /etc/newrelic-infra/integrations.d
```

Copie o arquivo de configuração de amostra:

bash

$sudo cp cassandra-config.yml.sample cassandra-config.yml

Edite o arquivo cassandra-config.yml conforme descrito nas definições de configuração.
Para ativar a análise de log e encaminhamento automático de erros do Cassandra, copie (ou renomeie) o arquivo cassandra-log.yml.example para cassandra-log.yml. Não há necessidade de reiniciar o agente.
Example:
bash
```
$sudo cp /etc/newrelic-infra/logging.d/casssandra-log.yml.example /etc/newrelic-infra/logging.d/cassandra-log.yml
```

Este documento ajudou você na instalação?

Atualize sua integração

Essa integração não é atualizada automaticamente. Para obter melhores resultados, atualize regularmente o pacote de integração e o agente de infraestrutura.

Tarefas pós-instalação

Quando terminar a instalação, você poderá definir opções de configuração. Algumas configurações são necessárias para que a integração funcione, enquanto outras são opcionais.

Configurar a integração

Se você habilitou essa integração por meio de nossa integração ECS ou Kubernetes, consulte estes documentos:

Para a instalação padrão no host, essa integração vem com um arquivo de configuração YAML, apache-config.yml. Esta configuração é onde você pode colocar as credenciais de login necessárias e configurar como os dados são coletados. Quais opções você altera dependem de sua configuração e preferências. Ele vem com um arquivo de configuração de amostra apache-config.yml.sample que você pode copiar e editar.

Configurações específicas relacionadas ao Cassandra são definidas usando a seção env do arquivo de configuração. Essas configurações controlam a conexão com sua instância do Cassandra, bem como outras configurações de segurança e recurso. A lista de configurações válidas é descrita na próxima seção deste documento.

Opções de configuração do Cassandra

A integração Cassandra coleta informações métricas(M) e de inventário(I). Na tabela, use a coluna Applies To para as configurações disponíveis para cada coleção:

' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '

Contexto	Descrição	Padrão	Aplica-se a
`HOSTNAME`	Nome do host ou IP onde o Cassandra está rodando.	`localhost`	MI
`PORT`	Porta na qual Cassandra está escutando.	`7199`	M
`USERNAME`	Nome de usuário para acessar JMX.	N/A	M
`PASSWORD`	Senha do usuário fornecido.	N/A	M
`CONFIG_PATH`	Caminho para o arquivo de configuração do Cassandra.	`/etc/cassandra/` `cassandra.yaml`	EU
`COLUMN_FAMILIES_LIMIT`	Limite no número de famílias de colunas Cassandra.	`20`	M
`TIMEOUT`	Tempo limite da solicitação em milissegundos.	`2000`	M
`KEY_STORE`	O caminho do arquivo do keystore que contém o certificado SSL do cliente JMX.	N/A	M
`KEY_STORE_PASSWORD`	A senha para o armazenamento de chaves JMX SSL.	N/A	M
`TRUST_STORE`	O caminho do arquivo do armazenamento confiável que contém o certificado SSL do cliente JMX.	N/A	M
`TRUST_STORE_PASSWORD`	A senha para o armazenamento confiável JMX SSL.	N/A	M
`REMOTE_MONITORING`	Habilite o monitoramento de multilocação.	`false`	MI
`METRICS`	Defina como `true` para ativar a coleta somente de métricas.	`false`
`INVENTORY`	Defina como `true` para ativar a coleta somente de inventário.	`false`

Os valores para estas configurações podem ser definidos de diversas maneiras:

Adicionando o valor diretamente no arquivo de configuração. Esta é a forma mais comum.
Substituindo os valores das variáveis de ambiente usando a notação {{}} . Isso requer o agente de infraestrutura v1.14.0+. Leia mais aqui ou veja o exemplo abaixo.
Usando gerenciamento de segredos. Use isto para proteger informações confidenciais, como senhas que seriam expostas em texto simples no arquivo de configuração. Para obter mais informações, consulte Gerenciamento de segredos.

Etiquetas

Você pode decorar ainda mais sua métrica usando etiquetas. Os rótulos permitem adicionar atributo (pares de valores principais) à sua métrica, que você pode usar para consultar, filtrar ou agrupar sua métrica.

Nosso arquivo de configuração de amostra padrão inclui exemplos de rótulos, mas, como não são obrigatórios, você pode remover, modificar ou adicionar novos de sua escolha.

labels:
  env: production
  role: load_balancer

Exemplo de configuração

Aqui estão alguns exemplos de configuração YAML:

Esta é a configuração básica usada para coletar métricas e inventário do seu localhost:

integrations:
  - name: nri-cassandra
    env:
      HOSTNAME: localhost
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
      CONFIG_PATH: /etc/cassandra/cassandra.yml
    interval: 30s
    labels:
      environment: production
    inventory_source: config/cassandra

Esta configuração coleta métricas a cada 30 segundos e inventário a cada 60 segundos:

integrations:
  - name: nri-cassandra
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
      REMOTE_MONITORING: true
    interval: 30s
    labels:
      environment: production

  - name: nri-cassandra
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
      CONFIG_PATH: /etc/cassandra/cassandra.yml
    interval: 60s
    labels:
      environment: production
    inventory_source: config/cassandra

Nesta configuração estamos usando a variável de ambiente CASSANDRA_HOST para preencher a configuração HOSTNAME da integração:

integrations:
  - name: nri-cassandra
    env:
      METRICS: "true"
      HOSTNAME: { { CASSANDRA_HOST } }
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
    interval: 15s
    labels:
      env: production
      role: load_balancer

Nesta configuração estamos monitorando vários servidores Cassandra a partir da mesma integração. Para a primeira instância (HOSTNAME: 1st_cassandra_host) estamos coletando métrica e inventário enquanto para a segunda instância (HOSTNAME: 2nd_cassandra_host) coletaremos apenas métrica.

integrations:
  - name: nri-cassandra
    env:
      METRICS: "true"
      HOSTNAME: 1st_cassandra_host
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
    interval: 30s
    labels:
      env: production
      role: load_balancer
  - name: nri-cassandra
    env:
      INVENTORY: "true"
      HOSTNAME: 1st_cassandra_host
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/cassandra

  - name: nri-cassandra
    env:
      METRICS: "true"
      HOSTNAME: 2nd_cassandra_host
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
    interval: 30s
    labels:
      env: production
      role: load_balancer

Encontre e use dados

Os dados desta integração podem ser encontrados em: one.newrelic.com > Infrastructure > Third-party services > Cassandra.

Os dados do Cassandra são anexados aos tipos de evento CassandraSample e CassandraColumnFamilySample . Você pode consultar esses dados para fins de resolução de problemas ou para criação de gráficos e dashboards.

Para saber mais sobre como encontrar e usar seus dados, consulte Compreender os dados de integração.

Para recriar o status do nodetool com NRQL, execute a seguinte consulta:

SELECT cluster.datacenter, fullHostname, cluster.name, cluster.rack, entityName, hostStatus, (db.loadBytes /10e3) AS 'kb db.loadBytes' FROM CassandraSample

Dados métricos

As métricas do nó Cassandra são anexadas ao tipo de evento CassandraSample . A Cassandra integração coleta estes nós métricos:

Nome	Descrição
`db.allMemtablesOffHeapSizeBytes`	Quantidade total de bytes armazenados nas memtables (2i e memtables de liberação pendente incluídas) que residem no heap.
`db.allMemtablesOnHeapSizeBytes`	Quantidade total de bytes armazenados nas memtables (2i e memtables de liberação pendente incluídas) que residem fora do heap.
`db.commitLogCompletedTasksPerSecond`	O número de mensagens de commit do log gravadas por segundo.
`db.commitLogPendindTasks`	Número de mensagens de commit do log escritas, mas ainda não sincronizadas.
`db.commitLogTotalSizeBytes`	Tamanho atual, em bytes, usado por todos os segmentos de log de confirmação.
`db.droppedRequestTypeMessagesPerSecond`	Mensagens descartadas por segundo para esse tipo de solicitação. `RequestType` pode ser qualquer um dos seguintes: BatchRemove, BatchStore, CounterMutation, Hint, Mutation, PagedRange, RangeSlice, Read, ReadRepair, RequestResponse ou trace.
`db.keyCacheCapacityBytes`	Capacidade do cache de chaves em bytes.
`db.keyCacheHitRate`	Ocorrência chave de um minuto sem taxa de cache.
`db.keyCacheHitsPerSecond`	Número de ocorrências de chaves no cache por segundo.
`db.keyCacheRequestsPerSecond`	Número de solicitações ao cache de chaves por segundo.
`db.keyCacheSizeBytes`	Tamanho do cache ocupado em bytes.
`db.liveSSTableCount`	Número de SSTables no disco para este grupo de colunas.
`db.loadBytes`	Tamanho, em bytes, do tamanho dos dados em disco que esse nó gerencia.
`db.rowCacheCapacityBytes`	Capacidade do cache de linha em bytes.
`db.rowCacheHitRate`	Ocorrência de linha de um minuto sem taxa de cache.
`db.rowCacheHitsPerSecond`	Número de ocorrências de linhas no cache por segundo.
`db.rowCacheRequestsPerSecond`	Número de solicitações ao cache de linhas por segundo.
`db.rowCacheSizeBytes`	Tamanho total do cache de linhas ocupadas, em bytes.
`db.threadpool.<pool>ActiveTasks`	Número de tarefas sendo trabalhadas ativamente por este pool. `pool` pode ser um dos seguintes: `internalAntiEntropyStage` `internalCacheCleanupExecutor` `internalCompactionExecutor` `internalGossipStage` `internalHintsDispatcher` `internalInternalResponseStage` `internalMemtableFlushWriter` `internalMemtablePostFlush` `internalMemtableReclaimMemory` `internalMigrationStage` `internalMiscStage` `internalPendingRangeCalculator` `internalSampler` `internalSecondaryIndexManagement` `internalValidationExecutor` `nativeTransportRequest` `requestCounterMutationStage` `requestMutationStage` `requestReadRepairStage` `requestReadStage` `requestRequestResponse` `requestViewMutationStage`
`db.threadpool.<pool>PendingTasks`	Número de tarefas enfileiradas neste pool. `pool` pode ser qualquer um dos itens da lista fornecida na descrição de `db.threadpool.<pool>ActiveTasks`.
`db.threadpool.<pool>CompletedTasks`	Número de tarefas concluídas. `pool` pode ser qualquer um dos itens da lista fornecida na descrição de `db.threadpool.<pool>ActiveTasks`.
`db.threadpool.<pool>TotalBlockedTasks`	Número de tarefas que foram bloqueadas devido à saturação da fila. `pool` pode ser qualquer um dos itens da lista fornecida na descrição de `db.threadpool.<pool>ActiveTasks`.
`db.threadpool.<pool>CurrentlyBlockedTask`	Número de tarefas que estão atualmente bloqueadas devido à saturação da fila, mas que serão desbloqueadas na nova tentativa. `pool` pode ser qualquer um dos itens da lista fornecida na descrição de `db.threadpool.<pool>ActiveTasks`.
`db.totalHintsInProgress`	Número de dicas atualmente tentando ser enviadas.
`db.totalHintsPerSecond`	Número de mensagens de dica por segundo gravadas neste nó. Inclui uma entrada para cada host a ser sugerido por dica.
`query.CASReadRequestsPerSecond`	Transação de leitura latência em solicitações por segundo.
`query.CASWriteRequestsPerSecond`	Transação write latência em solicitações por segundo.
`query.rangeSliceRequestsPerSecond`	Número de solicitações de intervalo de intervalo por segundo.
`query.rangeSliceTimeoutsPerSecond`	Número de tempos limite encontrados por segundo ao processar solicitações de leitura de intervalo token .
`query.rangeSliceUnavailablesPerSecond`	Número de exceções indisponíveis encontradas por segundo ao processar solicitações de leitura de intervalo token .
`query.readLatency50thPercentileMilliseconds`	Leia a latência em milissegundos, percentil 50.
`query.readLatency75thPercentileMilliseconds`	Leia a latência em milissegundos, percentil 75.
`query.readLatency95thPercentileMilliseconds`	Leia a latência em milissegundos, percentil 95.
`query.readLatency98thPercentileMilliseconds`	Leia a latência em milissegundos, percentil 98.
`query.readLatency999thPercentileMilliseconds`	Leia a latência em milissegundos, percentil 999.
`query.readLatency99thPercentileMilliseconds`	Leia a latência em milissegundos, percentil 99.
`query.readRequestsPerSecond`	Número de solicitações de leitura por segundo.
`query.readTimeoutsPerSecond`	Número de tempos limite encontrados por segundo ao processar solicitações de leitura padrão.
`query.readUnavailablesPerSecond`	Número de exceções indisponíveis encontradas por segundo ao processar solicitações de leitura padrão.
`query.viewWriteRequestsPerSecond`	Número de solicitações de gravação de visualização por segundo.
`query.writeLatency50thPercentileMilliseconds`	Escreva a latência em milissegundos, percentil 50.
`query.writeLatency75thPercentileMilliseconds`	Escreva a latência em milissegundos, percentil 75.
`query.writeLatency95thPercentileMilliseconds`	Escreva a latência em milissegundos, percentil 95.
`query.writeLatency98thPercentileMilliseconds`	Escreva a latência em milissegundos, percentil 98.
`query.writeLatency999thPercentileMilliseconds`	Escreva a latência em milissegundos, percentil 999.
`query.writeLatency99thPercentileMilliseconds`	Escreva a latência em milissegundos, percentil 99.
`query.writeRequestsPerSecond`	Número de solicitações de gravação por segundo.
`query.writeTimeoutsPerSecond`	Número de tempos limite encontrados por segundo ao processar solicitações de gravação regulares.
`query.writeUnavailablesPerSecond`	Número de exceções indisponíveis encontradas por segundo ao processar solicitações de gravação regulares.

Família de colunas Cassandra métrica e metadados

A integração Cassandra recupera métricas de famílias de colunas. Os dados do grupo de colunas Cassandra são anexados ao tipo de evento CassandraColumnFamilySample . Ele ignora os keyspaces do sistema (system, system_auth, system_distributed, system_schema, system_traces e OpsCenter). Para limitar o impacto no desempenho, a integração irá capturar apenas métricas para um máximo de 20 famílias de colunas.

Os metadados a seguir indicam o keyspace e a família de colunas associadas à métrica da amostra:

Nome	Descrição
`db.columnFamily`	A família de colunas Cassandra a que essas métricas se referem.
`db.keyspace`	O keyspace Cassandra que contém esse grupo de colunas.
`db.keyspaceAndColumnFamily`	O keyspace e o grupo de colunas em um único atributo de metadados no seguinte formato: `keyspace`.`columnFamily`.

A lista de métricas abaixo refere-se ao keyspace específico e à família de colunas especificadas nos metadados acima:

Nome	Descrição
`db.allMemtablesOffHeapSizeBytes`	Número total de bytes armazenados nas memtables (2i e memtables de liberação pendente incluídas) que residem fora do heap.
`db.allMemtablesOnHeapSizeBytes`	Número total de bytes armazenados nas memtables (2i e memtables de liberação pendente incluídas) que residem no heap.
`db.liveDiskSpaceUsedBytes`	Espaço em disco em bytes usado por SSTables pertencentes a esta família de colunas (em bytes).
`db.liveSSTableCount`	Número de SSTables no disco para este grupo de colunas.
`db.pendingCompactions`	Estimativa do número de compactações pendentes para esta família de colunas.
`db.SSTablesPerRead50thPercentileMilliseconds`	Número de arquivos de dados estáveis acessados por leitura, percentil 50.
`db.SSTablesPerRead75thPercentileMilliseconds`	Número de arquivos de dados estáveis acessados por leitura, 75º percentil.
`db.SSTablesPerRead95thPercentileMilliseconds`	Número de arquivos de dados estáveis acessados por leitura, percentil 95.
`db.SSTablesPerRead98thPercentileMilliseconds`	Número de arquivos de dados estáveis acessados por leitura, percentil 98.
`db.SSTablesPerRead999thPercentileMilliseconds`	Número de arquivos de dados estáveis acessados por leitura, percentil 999.
`db.SSTablesPerRead99thPercentileMilliseconds`	Número de arquivos de dados estáveis acessados por leitura, percentil 99.
`query.readLatency50thPercentileMilliseconds`	Latência de leitura local em milissegundos para este grupo de colunas, 50º percentil.
`query.readLatency75thPercentileMilliseconds`	Latência de leitura local em milissegundos para este grupo de colunas, 75º percentil.
`query.readLatency95thPercentileMilliseconds`	Latência de leitura local em milissegundos para este grupo de colunas, 95º percentil.
`query.readLatency98thPercentileMilliseconds`	Latência de leitura local em milissegundos para este grupo de colunas, 98º percentil.
`query.readLatency999thPercentileMilliseconds`	Latência de leitura local em milissegundos para este grupo de colunas, percentil 999.
`query.readLatency99thPercentileMilliseconds`	Latência de leitura local em milissegundos para este grupo de colunas, 99º percentil.
`query.readRequestsPerSecond`	Número de solicitações de leitura por segundo para este grupo de colunas.
`query.writeLatency50thPercentileMilliseconds`	Latência de gravação local em milissegundos para este grupo de colunas, 50º percentil.
`query.writeLatency75thPercentileMilliseconds`	Latência de gravação local em milissegundos para este grupo de colunas, 75º percentil.
`query.writeLatency95thPercentileMilliseconds`	Latência de gravação local em milissegundos para este grupo de colunas, 95º percentil.
`query.writeLatency98thPercentileMilliseconds`	Latência de gravação local em milissegundos para este grupo de colunas, 98º percentil.
`query.writeLatency999thPercentileMilliseconds`	Latência de gravação local em milissegundos para este grupo de colunas, percentil 999.
`query.writeLatency99thPercentileMilliseconds`	Latência de gravação local em milissegundos para este grupo de colunas, 99º percentil.
`query.writeRequestsPerSecond`	Número de solicitações de gravação por segundo para este grupo de colunas.

Inventário

A integração captura opções de configuração definidas na configuração do Cassandra e as reporta como dados de inventário na interface do New Relic .

Metadados do sistema

A Cassandra integração também coleta estes atributos sobre o serviço e sua configuração:

Nome	Descrição
`software.version`	A versão Cassandra.
`cluster.name`	O nome do cluster ao qual este nó do Cassandra pertence.

Verifique o código-fonte

Esta integração é um software de código aberto. Isso significa que você pode navegar pelo código-fonte e enviar melhorias, ou criar seu próprio fork e construí-lo.

Esta tradução de máquina é fornecida para sua comodidade.

Compatibilidade e requisitos

Começo rápido

Instalar e ativar

SEC

Kubernetes

Linux

Este documento ajudou você na instalação?

Atualize sua integração

Tarefas pós-instalação

Configurar a integração

Opções de configuração do Cassandra

Etiquetas

Exemplo de configuração

Configuração básica

Configuração básica com diferentes intervalos métricos/inventário

Substituição de variáveis de ambiente

Monitoramento Multi-instância

Encontre e use dados

Dados métricos

Família de colunas Cassandra métrica e metadados

Inventário

Metadados do sistema

Verifique o código-fonte

Esta tradução de máquina é fornecida para sua comodidade.

Cassandra monitoramento integração

Compatibilidade e requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Começo rápido

Instalar e ativar

Kubernetes

Linux

Este documento ajudou você na instalação?

Atualize sua integração

Tarefas pós-instalação

Configurar a integração

Opções de configuração do Cassandra

Etiquetas

Exemplo de configuração

Configuração básica

Configuração básica com diferentes intervalos métricos/inventário

Substituição de variáveis de ambiente

Monitoramento Multi-instância

Encontre e use dados

Dados métricos

Família de colunas Cassandra métrica e metadados

Inventário

Metadados do sistema

Verifique o código-fonte

Compatibilidade e requisitos