chore: move samples from python-docs-sample

samples/snippets/api/README.rst

@@ -0,0 +1,98 @@
+.. This file is automatically generated. Do not edit this file directly.
+
+Stackdriver Error Reporting Python Samples
+===============================================================================
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=error_reporting/api/README.rst
+
+
+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
+++++++++++++++
+
+This sample requires you to have authentication setup. Refer to the
+`Authentication Getting Started Guide`_ for instructions on setting up
+credentials for applications.
+
+.. _Authentication Getting Started Guide:
+    https://cloud.google.com/docs/authentication/getting-started
+
+Install Dependencies
+++++++++++++++++++++
+
+#. Clone python-docs-samples and change directory to the sample directory you want to use.
+
+    .. code-block:: bash
+
+        $ git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
+
+#. Install `pip`_ and `virtualenv`_ if you do not already have them. You may want to refer to the `Python Development Environment Setup Guide`_ for Google Cloud Platform for instructions.
+
+   .. _Python Development Environment Setup Guide:
+       https://cloud.google.com/python/setup
+
+#. Create a virtualenv. Samples are compatible with Python 2.7 and 3.4+.
+
+    .. code-block:: bash
+
+        $ virtualenv env
+        $ source env/bin/activate
+
+#. Install the dependencies needed to run the samples.
+
+    .. code-block:: bash
+
+        $ pip install -r requirements.txt
+
+.. _pip: https://pip.pypa.io/
+.. _virtualenv: https://virtualenv.pypa.io/
+
+Samples
+-------------------------------------------------------------------------------
+
+Report Exception
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=error_reporting/api/report_exception.py,error_reporting/api/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python report_exception.py
+
+
+
+
+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 Client Library for Python:
+    https://googlecloudplatform.github.io/google-cloud-python/
+.. _browse the source:
+    https://github.com/GoogleCloudPlatform/google-cloud-python
+.. _report issues:
+    https://github.com/GoogleCloudPlatform/google-cloud-python/issues
+
+
+.. _Google Cloud SDK: https://cloud.google.com/sdk/

samples/snippets/api/README.rst.in

@@ -0,0 +1,21 @@
+# 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
+
+folder: error_reporting/api

samples/snippets/api/report_exception.py

@@ -0,0 +1,46 @@
+# Copyright 2016 Google Inc. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# [START error_reporting]
+# [START error_reporting_quickstart]
+# [START error_reporting_setup_python]
+def simulate_error():
+    from google.cloud import error_reporting
+
+    client = error_reporting.Client()
+    try:
+        # simulate calling a method that's not defined
+        raise NameError
+    except Exception:
+        client.report_exception()
+# [END error_reporting_setup_python]
+# [END error_reporting_quickstart]
+# [END error_reporting]
+
+
+# [START error_reporting_manual]
+# [START error_reporting_setup_python_manual]
+def report_manual_error():
+    from google.cloud import error_reporting
+
+    client = error_reporting.Client()
+    client.report("An error has occurred.")
+# [START error_reporting_setup_python_manual]
+# [END error_reporting_manual]
+
+
+if __name__ == '__main__':
+    simulate_error()
+    report_manual_error()

samples/snippets/api/report_exception_test.py

@@ -0,0 +1,23 @@
+# Copyright 2016 Google Inc. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import report_exception
+
+
+def test_error_sends():
+    report_exception.simulate_error()
+
+
+def test_manual_error_sends():
+    report_exception.report_manual_error()

samples/snippets/api/requirements-test.txt

@@ -0,0 +1 @@
+pytest==6.0.1

samples/snippets/api/requirements.txt

@@ -0,0 +1 @@
+google-cloud-error-reporting==0.34.0

samples/snippets/fluent_on_compute/README.md

@@ -0,0 +1,35 @@
+# Google Error Reorting Samples Samples
+
+[![Open in Cloud Shell][shell_img]][shell_link]
+
+[shell_img]: http://gstatic.com/cloudssh/images/open-btn.png
+[shell_link]: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=error_reporting/fluent_on_compute/README.md
+
+This section contains samples for [Google Cloud Error Reporting](https://cloud.google.com/error-reporting).
+
+A startup script has been provided to demonstrated how to properly provision a GCE 
+instance with fluentd configured. Note the intallation of fluentd, the addition of the config file,
+ and the restarting of the fluetnd service. You can start an instance  using
+it like this:
+
+    gcloud compute instances create example-instance --metadata-from-file startup-script=startup_script.sh
+
+or simply use it as reference when creating your own instance.
+
+After fluentd is configured, main.py could be used to simulate an error:
+
+    gcloud compute copy-files main.py example-instance:~/main.py
+
+Then, 
+
+    gcloud compute ssh example-instance
+    python ~/main.py
+
+And you will see the message in the Errors Console.
+
+<!-- auto-doc-link -->
+These samples are used on the following documentation page:
+
+> https://cloud.google.com/error-reporting/docs/setting-up-on-compute-engine
+
+<!-- end-auto-doc-link -->

samples/snippets/fluent_on_compute/main.py

@@ -0,0 +1,42 @@
+# Copyright 2016 Google Inc. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# [START error_reporting]
+import traceback
+
+import fluent.event
+import fluent.sender
+
+
+def simulate_error():
+    fluent.sender.setup('myapp', host='localhost', port=24224)
+
+    def report(ex):
+        data = {}
+        data['message'] = '{0}'.format(ex)
+        data['serviceContext'] = {'service': 'myapp'}
+        # ... add more metadata
+        fluent.event.Event('errors', data)
+
+    # report exception data using:
+    try:
+        # simulate calling a method that's not defined
+        raise NameError
+    except Exception:
+        report(traceback.format_exc())
+# [END error_reporting]
+
+
+if __name__ == '__main__':
+    simulate_error()

samples/snippets/fluent_on_compute/main_test.py

@@ -0,0 +1,23 @@
+# Copyright 2016 Google Inc. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import mock
+
+import main
+
+
+@mock.patch("fluent.event")
+def test_error_sends(event_mock):
+    main.simulate_error()
+    event_mock.Event.assert_called_once_with(mock.ANY, mock.ANY)

samples/snippets/fluent_on_compute/requirements-test.txt

@@ -0,0 +1,2 @@
+pytest==6.0.1
+mock==4.0.2

samples/snippets/fluent_on_compute/requirements.txt

@@ -0,0 +1 @@
+fluent-logger==0.9.6

samples/snippets/fluent_on_compute/startup_script.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# Copyright 2016 Google Inc. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -v
+
+curl -sSO "https://dl.google.com/cloudagents/install-logging-agent.sh"
+chmod +x install-logging-agent.sh
+./install-logging-agent.sh
+mkdir -p /etc/google-fluentd/config.d/
+cat <<EOF > /etc/google-fluentd/config.d/forward.conf
+<source>
+  type forward
+  port 24224
+</source>
+EOF
+service google-fluentd restart
+
+apt-get update
+apt-get install -yq \
+        git build-essential supervisor python python-dev python-pip libffi-dev \
+            libssl-dev
+pip install fluent-logger
+