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

     1  ## Running Heapster in Kubernetes with a Google Cloud Monitoring and Google Cloud Logging backend
     2  
     3  The Google Cloud Monitoring and Logging backends only works in Google Compute Engine today.
     4  
     5  ### Setup a Kubernetes cluster
     6  [Bring up a Kubernetes cluster](https://github.com/kubernetes/kubernetes), if you haven't already. Ensure that `kubecfg.sh` is exported.
     7  
     8  ### Start all of the pods and services
     9  
    10  Start the Heapster service on the cluster:
    11  
    12  ```shell
    13  $ kubectl.sh create -f deploy/kube-config/google/
    14  ```
    15  
    16  Heapster metrics are now being exported to Google Cloud Monitoring as custom metrics. Heapster events are now being exported to Google Cloud Logging as custom logs.
    17  
    18  ### Metrics Dashboard
    19  To access the Google Cloud Monitoring dashboard go to: [https://app.google.stackdriver.com/](https://app.google.stackdriver.com/). Create a new dashboard and add the desired charts. Select the *Custom Metric* Resource Type and all Heapster metrics are under the `kubernetes.io` namespace. You can narrow down the query by the metric labels provided.
    20  
    21  It is also possible to query the Google Cloud Monitoring data directly using their [custom metric read API](https://cloud.google.com/monitoring/v2beta2/timeseries/list).
    22  
    23  ### Events Dashboard
    24  To access events via Google Cloud Logging dashboard go to [Google Developer Console](https://cloud.google.com) and select 'Logs' under 'Monitoring' in your project. In the Logs dashboard, select `custom.googleapis.com` as the logs source.