Update monitoring library to use new generated client (#5212)

Author: Jon Wayne Parrott

packages/google-cloud-monitoring/.coveragerc

@@ -2,10 +2,15 @@
 branch = True
 
 [report]
-fail_under = 100
+omit =
+  */gapic/*
+  */proto/*
 show_missing = True
+
 exclude_lines =
     # Re-enable the standard pragma
     pragma: NO COVER
     # Ignore debug-only repr
     def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError

packages/google-cloud-monitoring/README.rst

@@ -1,78 +1,103 @@
-Python Client for Stackdriver Monitoring
-========================================
+Python Client for Stackdriver Monitoring API (`Alpha`_)
+=======================================================
 
-    Python idiomatic client for `Stackdriver Monitoring`_
+`Stackdriver Monitoring API`_: Manages your Stackdriver Monitoring data and configurations. Most projects
+must be associated with a Stackdriver account, with a few exceptions as
+noted on the individual method pages.
 
-.. _Stackdriver Monitoring: https://cloud.google.com/monitoring/
+- `Client Library Documentation`_
+- `Product Documentation`_
 
-|pypi| |versions|
-
--  `Documentation`_
-
-.. _Documentation: https://googlecloudplatform.github.io/google-cloud-python/latest/monitoring/usage.html
+.. _Alpha: https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/README.rst
+.. _Stackdriver Monitoring API: https://cloud.google.com/monitoring
+.. _Client Library Documentation: https://googlecloudplatform.github.io/google-cloud-python/latest/monitoring/usage.html
+.. _Product Documentation:  https://cloud.google.com/monitoring
 
 Quick Start
 -----------
 
-.. code-block:: console
+In order to use this library, you first need to go through the following steps:
+
+1. `Select or create a Cloud Platform project.`_
+2. `Enable billing for your project.`_
+3. `Enable the Stackdriver Monitoring API.`_
+4. `Setup Authentication.`_
+
+.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
+.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
+.. _Enable the Stackdriver Monitoring API.:  https://cloud.google.com/monitoring
+.. _Setup Authentication.: https://googlecloudplatform.github.io/google-cloud-python/latest/core/auth.html
+
+Installation
+~~~~~~~~~~~~
 
-    $ pip install --upgrade google-cloud-monitoring
+Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
+create isolated Python environments. The basic problem it addresses is one of
+dependencies and versions, and indirectly permissions.
 
-For more information on setting up your Python development environment,
-such as installing ``pip`` and ``virtualenv`` on your system, please refer
-to `Python Development Environment Setup Guide`_ for Google Cloud Platform.
+With `virtualenv`_, it's possible to install this library without needing system
+install permissions, and without clashing with the installed system
+dependencies.
 
-.. _Python Development Environment Setup Guide: https://cloud.google.com/python/setup
+.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
 
-Authentication
---------------
 
-With ``google-cloud-python`` we try to make authentication as painless as
-possible. Check out the `Authentication section`_ in our documentation to
-learn more. You may also find the `authentication document`_ shared by all
-the ``google-cloud-*`` libraries to be helpful.
+Mac/Linux
+^^^^^^^^^
 
-.. _Authentication section: https://google-cloud-python.readthedocs.io/en/latest/core/auth.html
-.. _authentication document: https://github.com/GoogleCloudPlatform/google-cloud-common/tree/master/authentication
+.. code-block:: console
+
+    pip install virtualenv
+    virtualenv <your-env>
+    source <your-env>/bin/activate
+    <your-env>/bin/pip install google-cloud-monitoring
+
+
+Windows
+^^^^^^^
+
+.. code-block:: console
 
-Using the API
--------------
+    pip install virtualenv
+    virtualenv <your-env>
+    <your-env>\Scripts\activate
+    <your-env>\Scripts\pip.exe install google-cloud-monitoring
 
-`Stackdriver Monitoring`_ (`Monitoring API docs`_) collects metrics,
-events, and metadata from Google Cloud Platform, Amazon Web Services (AWS),
-hosted uptime probes, application instrumentation, and a variety of common
-application components including Cassandra, Nginx, Apache Web Server,
-Elasticsearch and many others. Stackdriver ingests that data and generates
-insights via dashboards, charts, and alerts.
+Preview
+~~~~~~~
 
-This package currently supports all Monitoring API operations other than
-writing custom metrics.
+MetricServiceClient
+^^^^^^^^^^^^^^^^^^^
 
-.. _Monitoring API docs: https://cloud.google.com/monitoring/api/ref_v3/rest/
+.. code:: py
 
-List available metric types:
+    from google.cloud import monitoring_v3
 
-.. code:: python
+    client = monitoring_v3.MetricServiceClient()
 
-    from google.cloud import monitoring
-    client = monitoring.Client()
-    for descriptor in client.list_metric_descriptors():
-        print(descriptor.type)
+    name = client.project_path('[PROJECT]')
 
-Display CPU utilization across your GCE instances during the last five minutes:
 
-.. code:: python
+    # Iterate over all results
+    for element in client.list_monitored_resource_descriptors(name):
+        # process element
+        pass
 
-    metric = 'compute.googleapis.com/instance/cpu/utilization'
-    query = client.query(metric, minutes=5)
-    print(query.as_dataframe())
+    # Or iterate over results one page at a time
+    for page in client.list_monitored_resource_descriptors(name, options=CallOptions(page_token=INITIAL_PAGE)):
+        for element in page:
+            # process element
+            pass
 
-See the ``google-cloud-python`` API `monitoring documentation`_ to learn how
-to connect to Stackdriver Monitoring using this Client Library.
+Next Steps
+~~~~~~~~~~
 
-.. _monitoring documentation: https://googlecloudplatform.github.io/google-cloud-python/latest/monitoring/usage.html
+-  Read the `Client Library Documentation`_ for Stackdriver Monitoring API
+   API to see other available methods on the client.
+-  Read the `Stackdriver Monitoring API Product documentation`_ to learn
+   more about the product and see How-to Guides.
+-  View this `repository’s main README`_ to see the full list of Cloud
+   APIs that we cover.
 
-.. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-monitoring.svg
-   :target: https://pypi.org/project/google-cloud-monitoring/
-.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-monitoring.svg
-   :target: https://pypi.org/project/google-cloud-monitoring/
+.. _Stackdriver Monitoring API Product documentation:  https://cloud.google.com/monitoring
+.. _repository’s main README: https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/README.rst