Skip to main content

Single-Step Sensor Installation Guide

This guide covers the steps to install and configure sensors for a VM machine using a single-step installation process.


Step 1: Create Configuration File​

Create a file named config.yaml with the following structure. Update values as needed for your environment.

# config.yaml
AGGREGATOR_HOST: <KUBESENSE_AGGREGATOR_LB>
AGGREGATOR_PORT: "30054"
METRICS_STORE_HOST: <KUBESENSE_METRICS_SCRAPPER_LB>
METRICS_STORE_PORT: "30060"
SENSOR_INSTALLATION_TYPE: legacy
HOST_NAME: <HOST_NAME> # Optional
LOG_ENABLED: true
METRICS_ENABLED: true
CLUSTER_NAME: <CLUSTER_NAME>
LOG_PATHS:
- service: <SERVICE_NAME>
path: <PATH_TO_LOG_FILE>
type: file
ATTRIBUTES: # Optional
region: us-east-1

Step 2: Run Installation Script​

Pass the configuration file to the install script using the following command:

bash <(wget -qO- https://docker.kubesense.ai/setup.sh) sensor config.yaml

This script deploys and configures all required services and components based on the values defined in config.yaml.


Step 3: APM Instrumentation (Example - Node.js)​

Below is the example for Node.js application instrumentation.

Install OpenTelemetry Packages​

npm install --save @opentelemetry/api
npm install --save @opentelemetry/auto-instrumentations-node

Set Environment Variables​

Configure your application's environment with the following variables:

env: {
OTEL_SERVICE_NAME: "", // Set your service name here
OTEL_RESOURCE_ATTRIBUTES: "kubesense.env_type=legacy,kubesense.cluster=<CLUSTER_NAME>",
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: "http://<KUBESENSE_KUBECOL_LB>:33443/v1/traces",
OTEL_NODE_RESOURCE_DETECTORS: "env,host,os,process",
NODE_OPTIONS: "--require @opentelemetry/auto-instrumentations-node/register",
}

For more details, visit KubeSense Documentation.