Installing agents

Installing agents for Linux

Prerequisites

  • OS: Ubuntu, Debian, RHEL, CentOS.
  • SixthSense Infra Agent. See Installing the Agent.
  • URL/IP of the Sixthsense collector (your tenant URL provided by Customer Support)
  • Access token provided by Customer Support.
  • PACKAGE_TOKEN - Access Token required for downloading SixthSense Package provided by Customer Support.
  • PACKAGE_TOKEN_USERNAME - Username for Access Token provided by Customer Support.
  • TOKEN - Access Token from the SixthSense portal Settings page.

Downloading the agent

Download latest ss_infra_agent-x.x.x.linux-amd64.tar.gz release binary provided by Customer Support.

export PACKAGE_TOKEN="token"
export AGENT_VERSION="2.1.0"
curl --header "PRIVATE-TOKEN: ${PACKAGE_TOKEN}" --output ss_infra_agent-${AGENT_VERSION}.linux-amd64.tar.gz "https://artifacts-observability.sixthsense.rakuten.com/api/v4/projects/15/packages/generic/sixthsense-infra-agent/${AGENT_VERSION}/ss_infra_agent-${AGENT_VERSION}.linux-amd64.tar.gz"

Unzip release binary and go to the agent directory.

tar -xvzf ss_infra_agent-${AGENT_VERSION}.linux-amd64.tar.gz
cd ss_infra_agent-${AGENT_VERSION}.linux-amd64

Installing the agent

Update ss_infra_agent_config.yaml as per the instructions mentioned in the configuration file.

# sixthsense-infra-agent can be configured via yaml or environment variables
#
# Note: Environment Variables are given higher priority over yaml file
#
# Following are the environment variables that can be set:
# ENV VARIABLE CORRESPONDS TO
# SS_SERVICE_NAME service_name
# SS_AUTHENTICATION authentication
# SS_BACKEND sixthsense_backend
# SS_LOGGING logging
# SS_SECURE secure
sixthsense:
service_name: CentOS_VM
# Login to Sixthsense UI --> Go to Settings on Side Navbar --> Copy Access Token
authentication: ${SIXTHSENSE_TOKEN}
# debug|error|info
logging: info
sixthsense_backend: grpc-collector-observability.sixthsense.rakuten.com:443
secure: true

Start SixthSense Infra Agent using the following command.

./ss_infra_agent --collector.processes &

In case of network restrictions, pass proxy to the meter-agent process to be able to connect to sixthsense-backend.

HTTPS_PROXY=proxy-server:port ./ss_infra_agent --collector.processes &

Installing agents for Windows

Prerequisites

  • OS: Windows Server versions 2008R2 and later, and desktop Windows version 7 and later
  • SixthSense Windows VM Agent. For more information, see Installing the Agent.
  • URL/IP of the Sixthsense backend collector (the tenant URL provided by Customer Support)
  • Access token provided by Customer Support.
  • PACKAGE_TOKEN - Access Token required for downloading SixthSense Package provided by Customer Support.
  • PACKAGE_TOKEN_USERNAME - Username for Access Token provided by Customer Support.
  • TOKEN - Access Token from the SixthSense portal Settings page.

Downloading the agent

  1. Download latest ss_windows_infra_agent-<version_no>.zip release folder provided by Customer Support.
curl --header "PRIVATE-TOKEN:{{TOKEN}}" --output ss_windows_infra_agent.zip "https://artifacts-observability.sixthsense.rakuten.com/api/v4/projects/15/packages/generic/sixthsense-infra-agent/1.0.0/ss_windows_infra_agent_v1.0.0.zip"
  1. Unzip the release zip folder and place it in the agent directory.

Installing the agent

  1. Update ss_windows_infra_agent_config.yaml as in the instructions mentioned in config file Agent resource usage.
# sixthsense-infra-agent can be configured via yaml or environment variables
#
# Note: Environment Variables are given higher priority over yaml file
#
# Following are the environment variables that can be set:
# ENV VARIABLE CORRESPONDS TO
# SS_SERVICE_NAME service_name
# SS_AUTHENTICATION authentication
# SS_BACKEND sixthsense_backend
# SS_LOGGING logging
# SS_SECURE secure
# SS_DEFAULTCOLLECTOR default_collectors
# SS_DEFAULTCOLLECTOR_PLACEHOLDER default_collectors_placeholdersixthsense
service_name: <custom_service_name >
# Login to Sixthsense UI --> Go to Settings on Side Navbar --> Copy Access Token
authentication: <service_auth_token>
# debug|error|info
logging: info
sixthsense_backend: <sixthsense_backend_collector>
# SSL connection with backend true|false
secure: false
#cpu,cs,logical_disk,net,os,service,system,textfile
default_collectors: "cpu,cs,logical_disk,net,os,memory,system,iis,process,cpu_info"
default_collectors_placeholder: "[defaults]"
enabled: cpu,cs,net,service`
  1. After configuring the the connection details, start the Agent service from services. The metrics will be available on the dashboard.