Torsten WalterandScott Rigby
ffc2ebc334
Signed-off-by: Torsten Walter <mail@torstenwalter.de> Co-authored-by: Scott Rigby <scott@r6by.com> Signed-off-by: Torsten Walter <mail@torstenwalter.de>
2.9 KiB
Stackdriver Exporter
Prometheus exporter for Stackdriver, allowing for Google Cloud metrics. You must have appropriate IAM permissions for this exporter to work. If you are passing in an IAM key then you must have:
- monitoring.metricDescriptors.list
- monitoring.timeSeries.list
These are contained within roles/monitoring.viewer.
If you're using legacy access scopes, then you must have https://www.googleapis.com/auth/monitoring.read.
Learn more: https://github.com/prometheus-community/stackdriver_exporter
This chart creates a Stackdriver-Exporter deployment on a Kubernetes cluster using the Helm package manager.
Prerequisites
- Kubernetes 1.8+ with Beta APIs enabled
Get Repo Info
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo update
See helm repo for command documentation.
Install Chart
# Helm 3
$ helm install [RELEASE_NAME] prometheus-community/prometheus-stackdriver-exporter --set stackdriver.projectId=google-project-name
# Helm 2
$ helm install --name [RELEASE_NAME] prometheus-community/prometheus-stackdriver-exporter --set stackdriver.projectId=google-project-name
The command deploys Stackdriver-Exporter on the Kubernetes cluster using the default configuration.
See configuration below.
See helm install for command documentation.
Uninstall Chart
# Helm 3
$ helm uninstall [RELEASE_NAME]
# Helm 2
# helm delete --purge [RELEASE_NAME]
This removes all the Kubernetes components associated with the chart and deletes the release.
See helm uninstall for command documentation.
Upgrading Chart
# Helm 3 or 2
$ helm upgrade [RELEASE_NAME] [CHART] --install
See helm upgrade for command documentation.
Configuration
See Customizing the Chart Before Installing. To see all configurable options with detailed comments, visit the chart's values.yaml, or run these configuration commands:
# Helm 2
$ helm inspect values prometheus-community/prometheus-stackdriver-exporter
# Helm 3
$ helm show values prometheus-community/prometheus-stackdriver-exporter
Tip
: You can use the default values.yaml, as long as you provide a value for stackdriver.projectId
Google Storage Metrics
In order to get metrics for GCS you need to ensure the metrics interval is > 24h. You can read more information about this in this bug report.
The easiest way to do this is to create two separate exporters with different prefixes and intervals, to ensure you gather all appropriate metrics.