Cassandra agent

Prerequisites

  • For prerequisite checks for agent installation, see Prerequisite checks for agent installation.
  • URL/IP of the SixthSense collector (your tenant URL which will be provided by Customer Support).
  • Access token from the SixthSense portal. For accessing the token, see Accessing your Access Token under Getting started with the Observability Portal.
  • For information about supported agent versions and framework, see Supported agents.
  • Database details (host name, port, database name, database user credentials).
  • Package token to download agent which will be provided by Customer Support.
  • Database User Permissions: Grant SELECT permission for all keyspaces to <db_user>.

Downloading the agent version 4.4.5 (latest)

For Windows and Linux based servers, use the following link.

curl --header "PRIVATE-TOKEN:<TOKEN>" --output meter-agent.zip "https://artifacts-observability.sixthsense.rakuten.com/api/v4/projects/32/packages/generic/Meter-Agent/v4.4.5/meter-agent.zip"
note

Agent depends on the OS and architecture.

Configuring the agent for Linux

  1. Extract CassandraDB_Linux.zip file.
  2. Edit the configuration in yaml file as follows.

In the yaml file, add the following configuration details:

  • service_name: Service name will display on UI
  • authentication: Get access token from dashboard under setting
  • sixthsense_backend: Backend collector URL
    • For GCP: grpc-collector-observability.sixthsense.rakuten.com:443
    • (One Cloud) For connectivity to backend using intra public network: 133.237.176.44:80
    • (One Cloud) For connectivity to backend using onecloud private network: 100.99.116.221:80
  • SSL connection with backend true|false
    • secure: true
    • (For One Cloud) secure:false
  • hostname: hostname
  • port: port
  • user: db_user
  • password: db_user_password
  • keyspace: keyspace_name
  • queryLimit: 10 (no of queries)
  • queryThresholdTime: 1 #millisecond

To enable the query on the cassandra database, perform the following:

  1. Login to the linux machine
  2. Run "nodetool settraceprobability 1;"
  3. Run cqlsh
  4. Create a DB and run the query inside the created DB

Running the agent

For Linux:

Run Cassandra agent in the terminal using the following commnad.

./meter-agent-linux path/to/config/ss-cassandra-config.yaml

In case of network restrictions, pass proxy to the meter-agent process so that you can connect to the sixthsense-backend.

HTTPS_PROXY=proxy-server:port./meter-agent-linux path/to/config/ss-cassandra-config.yaml

For Windows:

  1. Register DBM agent as a Service in Windows. Type in the following command in cmd:
sc create "<Service Name>" binPath= "\"<path_to_exe>.exe\" -config \"<path_to_config>.yaml\"" start= auto

Example:

sc create "MeterAgent_cassandra" binPath= "\"C:\ Downloads\meter-agent\Meter-Agent-v4.4.5\Windows\meter-agent-v4.4.5.exe\" -config \"C:\ Downloads\meter-agent\Meter-Agent-v4.4.5\Configs\ss-postgresql-config.yaml\"" start= auto
  1. Confirm whether the service is registered by opening Services and search for the Service Name with which you've registered.

  2. Run the service by opening the Services again and look for Service name > Start or sc start <service_name>.

Example: sc start MeterAgent_cassandra

Editing the configuration in the yaml file

In the yaml file, add the following configuration details:

  • service_name: Service name will display on UI
  • authentication: Get access token from dashboard under setting
  • sixthsense_backend: Backend collector URL
  • hostname: hostname
  • port: port
  • user: db_user
  • password: db_user_password
note

It supports instance name also with hostname.