Stackdriver Error Reporting Python Samples

This directory contains samples for Stackdriver Error Reporting. `Stackdriver Error Reporting`_ aggregates and displays errors produced in

your running cloud services.

.. _Stackdriver Error Reporting: https://cloud.google.com/error-reporting/docs/

Setup

Authentication

Authentication is typically done through `Application Default Credentials`_,

which means you do not have to change the code to authenticate as long as

your environment has credentials. You have a few options for setting up

authentication:

#. When running locally, use the `Google Cloud SDK`_

.. code-block:: bash

#. When running on App Engine or Compute Engine, credentials are already

set-up. However, you may need to configure your Compute Engine instance

with `additional scopes`_.

#. You can create a `Service Account key file`_. This file can be used to

authenticate to Google Cloud Platform services from any environment. To use

the file, set the ``GOOGLE_APPLICATION_CREDENTIALS`` environment variable to

the path to the key file, for example:

.. code-block:: bash

.. _Application Default Credentials: https://cloud.google.com/docs/authentication#getting_credentials_for_server-centric_flow

.. _additional scopes: https://cloud.google.com/compute/docs/authentication#using

.. _Service Account key file: https://developers.google.com/identity/protocols/OAuth2ServiceAccount#creatinganaccount

Install Dependencies

#. Install `pip`_ and `virtualenv`_ if you do not already have them.

#. Create a virtualenv. Samples are compatible with Python 2.7 and 3.4+.

.. code-block:: bash

#. Install the dependencies needed to run the samples.

.. code-block:: bash

.. _pip: https://pip.pypa.io/

.. _virtualenv: https://virtualenv.pypa.io/

Samples

Report Exception

To run this sample:

.. code-block:: bash

The client library

This sample uses the `Google Cloud Client Library for Python`_.

You can read the documentation for more details on API usage and use GitHub

to `browse the source`_ and `report issues`_.

.. _Google Cloud SDK: https://cloud.google.com/sdk/

# This file is used to generate README.rst

product:

name: Stackdriver Error Reporting

short_name: Error Reporting

url: https://cloud.google.com/error-reporting/docs/

description: >

`Stackdriver Error Reporting`_ aggregates and displays errors produced in

your running cloud services.

setup:

- auth

- install_deps

samples:

- name: Report Exception

file: report_exception.py

cloud_client_library: true

import report_exception

def test_error_sends():

report_exception.simulate_error()