github.com/jonaz/heapster@v1.3.0-beta.0.0.20170208112634-cd3c15ca3d29/README.md (about)

     1  # Heapster
     2  
     3  [![GoDoc](https://godoc.org/k8s.io/heapster?status.svg)](https://godoc.org/k8s.io/heapster) [![Build Status](https://travis-ci.org/kubernetes/heapster.svg?branch=master)](https://travis-ci.org/kubernetes/heapster)
     4  
     5  Heapster enables Container Cluster Monitoring and Performance Analysis.
     6  
     7  Heapster currently supports [Kubernetes](https://github.com/kubernetes/kubernetes) and CoreOS natively.
     8  *Heapster is compatible with kubernetes versions starting from v1.0.6 only*
     9  
    10  It can be extended to support other cluster management solutions easily.
    11  
    12  Heapster collects and interprets various signals like compute resource usage, lifecycle events, etc, and exports cluster metrics via [REST endpoints](docs/model.md).
    13  **Note: Some of the endpoints are only valid in Kubernetes clusters**
    14  
    15  Heapster supports multiple sources of data.
    16  More information [here](docs/source-configuration.md).
    17  
    18  Heapster supports a pluggable storage backend.
    19  It supports [InfluxDB](http://influxdb.com) with [Grafana](http://grafana.org/docs/features/influxdb), [Google Cloud Monitoring](https://cloud.google.com/monitoring/), [ElasticSearch](https://www.elastic.co/products/elasticsearch), [Google Cloud Logging](https://cloud.google.com/logging/), [Hawkular](http://www.hawkular.org), [Riemann](http://riemann.io) and [Kafka](http://kafka.apache.org/).
    20  We welcome patches that add additional storage backends.
    21  Documentation on storage sinks [here](docs/sink-configuration.md)
    22  The current version of Storage Schema is documented [here](docs/storage-schema.md).
    23  
    24  ### Running Heapster on Kubernetes
    25  
    26  To run Heapster on a Kubernetes cluster with,
    27  - InfluxDB use [this guide](docs/influxdb.md).
    28  - Google Cloud Monitoring and Google Cloud Logging use [this guide](docs/google.md).
    29  
    30  ### Running Heapster on OpenShift
    31  
    32  Using Heapster to monitor an OpenShift cluster requires some additional changes to the Kubernetes instructions to allow communication between the Heapster instance and OpenShift's secured endpoints. To run standalone Heapster or a combination of Heapster and Hawkular-Metrics in OpenShift, follow [this guide](https://github.com/openshift/origin-metrics).
    33  
    34  #### Troubleshooting guide [here](docs/debugging.md)
    35  
    36  
    37  ## Community
    38  
    39  Contributions, questions, and comments are all welcomed and encouraged! minkube developers hang out on [Slack](https://kubernetes.slack.com) in the #sig-instrumentation channel (get an invitation [here](http://slack.kubernetes.io/)). We also have the [kubernetes-dev Google Groups mailing list](https://groups.google.com/forum/#!forum/kubernetes-dev). If you are posting to the list please prefix your subject with "heapster: ".