gcp-exporter

Google Cloud Platform - Prometheus exporter

gcp-exporter is a Prometheus exporter for Google Cloud Platform resources.

This tool looks for defined GCP resources and exports metrics about them

Usage

First, you need to create a Service Account for the exporter. Notice, that regarding to chosen collectors, you will need to assign proper permissions to the Service Account.

Having the Service Account, download the JSON file with its credentials.

Command line options

The general syntax of command line parameters is as following:

gcp-exporter [global-options] command [command-options] [arguments]

General command line options

Commands

Shows general help (similar to --help flag). It can be used also together with command name. In that case it will show usage information about the selected command.

Starts the exporter.

start command options

1. Instances collector will look for instances for all defined project+zone pairs.
2. If match-tag is used, then an instance will be counted if it matches any of specified tags.

Example usage

$ /opt/prometheus/gcp-exporter/gcp-exporter start \
    --listen :9393 \
    --interval 15 \
    --service-account-file /opt/prometheus/gcp-exporter/service-account-file.json \
    --instances-collector-enable \
    --project project-id-1 \
    --project project-id-2 \
    --zone us-east1-c \
    --zone us-east1-d \
    --match-tag docker-machine

Using Docker container

Prepared Docker image is configured to run the start command. To make it working you should remember about passing the Service Account JSON file to the container. It can be done with volumes feature.

If you want to access the exporter from a remote Prometheus server, you should also remember about exposing the port.

Example

$ docker run -d \
         --restart always \
         --name gcp_exporter \
         --log-driver=syslog \
         --log-opt tag=gcp_exporter \
         -e NO_COLOR=true \
         -v /opt/prometheus/gcp-exporter/service-account-file.json:/service-account-file.json \
         -p 9393:9393 \
         registry.gitlab.com/gitlab-org/ci-cd/gcp-exporter:0.1 \
            --listen :9393 \
            --interval 15 \
            --service-account-file /service-account-file.json \
            --instances-collector-enable \
            --project project-id-1 \
            --project project-id-2 \
            --zone us-east1-c \
            --zone us-east1-d \
            --match-tag docker-machine

Author

Tomasz Maczukin, 2018, GitLab

License

MIT