gcpmetrics 1.0.22

Google Cloud Monitoring API: Command-Line Tool

# Google Cloud Monitoring API: Command-Line Tool

## Overview

You need to be authenticated to run this tool as described in
http://googlecloudplatform.github.io/gcloud-python/stable/gcloud-auth.html

Today it only supports interactive authentication, i.e.:

```
$ gcloud auth login
```

We will soon add support of service account tokents.

## Usage

```
$ gcpmetrics --help

usage: gcpmetrics.py [-h] --project_id ID [--list_resources] [--list_metrics]
[--query] [--since_dawn] [--metric_id ID] [--days INT]
[--hours INT] [--minutes INT] [--resource_filter S]
[--metric_filter S] [--alignment A] [--reduce R]
[--reduce_grouping R] [--iloc00]

optional arguments:
-h, --help show this help message and exit
--project_id ID Project ID.
--list_resources List monitored resource descriptors and exit.
--list_metrics List available metric descriptors and exit.
--query Run the time series query.
--since_dawn Calculate delta since the dawn of time.
--metric_id ID Metric ID as defined by Google Monitoring API..
--days INT Days from now to calculate the query start date.
--hours INT Hours from now to calculate the query start date.
--minutes INT Minutes from now to calculate the query start date.
--resource_filter S Filter of resources in the var:val[,var:val] format.
--metric_filter S Filter of metrics in the var:val[,var:val] format.
--alignment A Alignment of data ALIGN_NONE, ALIGN_SUM. etc.
--reduce R Reduce of data REDUCE_NONE, REDUCE_SUM, etc.
--reduce_grouping R Reduce grouping in the var1[,var2] format.
--iloc00 Print value from the table index [0:0] only.
```

## Examples

```
$ gcpmetrics --project_id odin-ap --list_resources

$ gcpmetrics --project_id odin-ap --list_descriptors

$ gcpmetrics --project_id odin-ap --query --since_dawn --metric_id appengine.googleapis.com/http/server/response_count --resource_filter="module_id:service" --metric_filter="response_code_greaterequal:500,response_code_less:600" --align ALIGN_SUM --reduce REDUCE_SUM

$ gcpmetrics --project_id odin-ap --query --since_dawn --metric_id appengine.googleapis.com/http/server/response_count --resource_filter="module_id:service" --metric_filter="response_code_greaterequal:500,response_code_less:600" --align ALIGN_SUM --reduce REDUCE_SUM --iloc00

```