circonus-kubernetes-agent

command module

v0.6.4 Latest Latest Go to latest Published: Mar 24, 2020 License: BSD-3-Clause Imports: 1 Imported by: 0

README ¶

Circonus Kubernetes Agent

An agent designed to retrieve metrics from a Kubernetes cluster. Runs as a deployment, forwards Kubernetes provided metrics for cluster, nodes, pods, and containers to Circonus.

NOTE: in active development, not all features are guaranteed to be complete.

Installation

Clone repo
Verify deploy/authrbac.yaml, alter any applicable settings for cluster security
Change any applicable settings in deploy/configuration.yaml, minimum required:
- Circonus API Token
- check target - so the agent can find the check on restart (short, unique string w/o spaces - normally this is an FQDN)
- Kubernetes name - used for check title when creating a check
- It is recommended that kube-state-metrics be installed in the cluster and collection enabled in the configuration
Change any applicable settings in deploy/deployment.yaml
Apply kubectl apply -f deploy/

Versions

Developed against and tested with...

kubernetes v1.17.0
etcd v3.4.3
calico v3.10
metrics-server v0.3.6
kube-state-metrics v1.7.2 (arm) and v1.8.0 (amd)

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

main.go

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd Package cmd provides the cli interface and configuration handling	Package cmd provides the cli interface and configuration handling
internal
agent Package agent defines the main process	Package agent defines the main process
circonus Package circonus contains methods for interfacing with circonus	Package circonus contains methods for interfacing with circonus
cluster Package cluster is the collection manager for a cluster	Package cluster is the collection manager for a cluster
config Package config defines the configuration and configuration helper methods for agent	Package config defines the configuration and configuration helper methods for agent
config/defaults Package defaults contains the default values for configuration options	Package defaults contains the default values for configuration options
config/keys Package keys defines the configuration keys used to access viper	Package keys defines the configuration keys used to access viper
dns Package dns is the kube-dns collector	Package dns is the kube-dns collector
events Package events is the cluster events collector	Package events is the cluster events collector
k8s Package k8s defines types needed	Package k8s defines types needed
ksm Package ksm is the kube-state-metrics collector	Package ksm is the kube-state-metrics collector
ms Package ms is the metrics-server collector	Package ms is the metrics-server collector
nodes Package nodes is the collector for nodes, pods, and optionally containers	Package nodes is the collector for nodes, pods, and optionally containers
nodes/collector Package collector collects metrics from nodes	Package collector collects metrics from nodes
promtext Package promtext parses prometheus text metrics	Package promtext parses prometheus text metrics
release Package release provides placeholders for build tags	Package release provides placeholders for build tags