tribock/rkm

Remote Kubernetes Monitoring

RKM - Remote Kubernetes Monitoring

Simple monitoring tool for local and remote Kubernetes clusters.
Used technonlogies:

• Docker
• Bash
• InfluxDB
• Grafana

Architecture

Grafana Dashbaord

Installation

RKM Mission Control

Install InfluxDB

The RKM-Outpost metrics are stored in an InfluxDB.
If an InfluxDB isn't available yet, install one for example with the InfluxDB Helm Chart on Kubernetes.
The InfluxDB and RKM-Outpost have a few dependencies:

1. The InfluxDB must be reachable for RKM-Outpost
2. An InfluxDB database for the RKM-Outpost metrics, for example "rkm"
3. User and password for the InfluxDB database

Install Grafana

If Grafana isn't available yet, install one for example with the Grafana Helm Chart on Kubernetes. Grafana must have access to the InfluxDB database.
Add the InfluxDB database as a datasource to Grafana and import the RKM Mission Control Dashboard.

RKM Outpost

Install RKM Outpost Helm Chart:

1. Create rkm-outpost namespace:
   kubectl create namespace rkm-outpost
2. Create secret for InfluxDB authentication:
   kubectl create secret generic rkm-secrets --from-literal=INFLUXDB_USER=<user> --from-literal=INFLUXDB_PW=<password> -n rkm-outpost
3. Clone this repository:
   git clone https://github.com/dmlabs/rkm.git
4. Adjust values.yaml file:
   cp ./rkm/Helm/rkm-outpost/values.yaml ./custom-values.yaml
vim ./custom-values.yaml
5. Install Helm Chart:
   helm install -f custom-values.yaml -n rkm-outpost rkm-outpost ./rkm/Helm/rkm-outpost

Known limitations

1. If TLS encription is used for the InfluxDB traffic, the certificate must be signed from a well known CA
2. RKM-Outpost does not work behind an enterprise proxy yet

Docker repositories

RKM-Outpost: https://quay.io/repository/dmlabs/rkm-outpost
RKM-Outpost operator: https://quay.io/repository/dmlabs/rkm-outpost-operator

Licence

Copyright 2020 dmlabs

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.