Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
templates
Chart.yaml Update helm charts to v0.1.1 Nov 14, 2018
LICENSE Add Helm Chart (#33) Oct 13, 2018
README.md
values.yaml Alternate namespaces #70 (#76) Jun 21, 2019

README.md

Wavefront by VMware Adapter for Istio

Helm is a package manager for Kubernetes. You could use Helm for installing the Wavefront by VMware adapter on your Kubernetes deployment.

Quick Start

Prerequisites

To deploy this adapter, you will need a cluster with the following minimum setup.

  • Kubernetes v1.10.0
  • Istio v1.0.3
  • Helm v2.10.0

Helm Setup

  1. Install Helm.

  2. Install Tiller via Helm.

$ helm init
  1. Download and extract Istio.

  2. Install Istio CRDs (Custom Resource Definitions).

$ kubectl apply -f install/kubernetes/helm/istio/templates/crds.yaml

Configuration

1. Download the Helm chart configuration and extract it.

$ curl -LO https://github.com/vmware/wavefront-adapter-for-istio/releases/download/0.1.1/wavefront-0.1.1.tgz
$ tar -zxvf wavefront-0.1.1.tgz

2. The configuration used per Helm deployment is specified in the values.yaml file.

Note: Helm will pick the direct credentials by default. If you wish to ingest metrics via a Proxy, please ensure that the direct credentials are either deleted or commented before deploying.

If you want the metrics to be published to the Wavefront instance directly, supply the direct params like so:

credentials:
  direct:
    server: https://YOUR-INSTANCE.wavefront.com
    token: YOUR-API-TOKEN

Instructions for generating an API token can be found in the Wavefront by VMware docs.

If you want the metrics to be published to the Wavefront Proxy instead, supply the proxy params like below:

credentials:
  proxy:
    address: YOUR-PROXY-IP:YOUR-PROXY-PORT

3. It is recommended that you update the source attribute to a reasonable value, for example, to your cluster name.

metrics:
  source: my-cluster

Configuration Parameters

See below for the list of available configuration parameters.

Parent Parameter Description
adapter image The Docker image name
tag The Docker image tag
credentials direct Credentials for direct ingestion
proxy Credentials for ingestion via a Proxy
direct server The Server URL. Ex: https://mydomain.wavefront.com
token The API token
proxy address The Proxy address. Ex: 192.168.99.100:2878
metrics flushInterval The metric flush interval
source The source tag for all metrics
prefix The prefix to prepend all metrics with
http Specify whether HTTP metrics should be captured
tcp Specify whether TCP metrics should be captured
namespaces adapter The namespace to create adapter objects in
istio The namespace Istio has been installed to

Deployment

Installation

To install the adapter via Helm, execute the following command.

$ helm install wavefront/

You should now be able to see Istio metrics on Wavefront under your configured source (or istio by default).

RBAC Issues On Helm

On Kubernetes 1.6+, you may encounter the following error if Helm experiences a problem with RBAC.

$ helm install wavefront/
Error: no available release name found

To fix the issue, create a Kubernetes Service Account with appropriate privileges as described in the Helm documentation and re-install Tiller.

The following example configuration was taken from the Helm repository.

1. Create a file named rbac-config.yaml with the following configuration.

apiVersion: v1
kind: ServiceAccount
metadata:
  name: tiller
  namespace: kube-system
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: tiller
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: cluster-admin
subjects:
  - kind: ServiceAccount
    name: tiller
    namespace: kube-system

2. Install the RBAC configuration.

$ kubectl create -f rbac-config.yaml
serviceaccount "tiller" created
clusterrolebinding "tiller" created

3. Reinstall Tiller.

$ helm reset
$ helm init --service-account tiller

4. Install the adapter.

$ helm install wavefront/

Uninstallation

To uninstall the adapter, first identify the Helm release name, like so:

$ helm list

Then uninstall it using the following command.

$ helm delete <release-name>
You can’t perform that action at this time.