Add Python logging sample (#1111)

Author: jhuleatt

Python/quickstarts/monitor-cloud-logging/firebase.json

@@ -0,0 +1,14 @@
+{
+  "functions": [
+    {
+      "source": "functions",
+      "codebase": "monitor-cloud-logging",
+      "ignore": [
+        "venv",
+        ".git",
+        "firebase-debug.log",
+        "firebase-debug.*.log"
+      ]
+    }
+  ]
+}

Python/quickstarts/monitor-cloud-logging/functions/main.py

@@ -0,0 +1,80 @@
+from firebase_functions import https_fn
+from firebase_functions.alerts import crashlytics_fn
+from firebase_admin import initialize_app, firestore
+import datetime
+import sys
+
+# [START loggerImport]
+from firebase_functions import logger
+# [END loggerImport]
+
+app = initialize_app()
+
+
+# [START helloLogs]
+@https_fn.on_request()
+def hello_world(req: https_fn.Request) -> https_fn.Response:
+    # sends a log to Cloud Logging
+    logger.log("Hello logs!")
+
+    return https_fn.Response("Hello from Firebase!")
+# [END helloLogs]
+
+
+# [START logsKitchenSink]
+@https_fn.on_request()
+def get_inspirational_quote(req: https_fn.Request) -> https_fn.Response:
+    firestore_client = firestore.client()
+    today = datetime.date.today()
+    quote_of_the_month_ref = (firestore_client.collection("quotes").doc(str(
+        today.year)).collection("months").doc(str(today.month)))
+
+    default_quote = "Python has been an important part of Google since the beginning, and remains so as the system grows and evolves."
+
+    quote = None
+    try:
+        quote_of_the_month = quote_of_the_month_ref.get()
+
+        # Attach relevant debugging information with debug()
+        logger.debug(
+            "Monthly quote fetch result",
+            docRef=quote_of_the_month.path,
+            exists=quote_of_the_month.exists,
+            createTime=quote_of_the_month.createTime,
+        )
+
+        if quote_of_the_month.exists:
+            quote = quote_of_the_month.to_dict()["text"]
+        else:
+            # Use warn() for lower-severity issues than error()
+            logger.warn(
+                "Quote not found for month, sending default instead",
+                doc_reference=quote_of_the_month.path,
+                date_requested=today.strftime("%Y-%m-%d"),
+            )
+            quote = default_quote
+    except:
+        e = sys.exc_info()[0]
+        # [START logError]
+        # Attach an error object as the second argument
+        logger.error("Unable to read quote from Firestore, sending default instead", error=e)
+        # [END logError]
+        quote = default_quote
+
+    # Attach relevant structured data to any log
+    logger.info("Sending a quote!", quote=quote)
+    return https_fn.Response("Hello from Firebase!")
+# [END logsKitchenSink]
+
+
+# [START customLogWrite]
+@crashlytics_fn.on_regression_alert_published()
+def app_has_regression(alert: crashlytics_fn.CrashlyticsRegressionAlertEvent) -> None:
+    logger.write(
+        severity="EMERGENCY",
+        message="Regression in production app",
+        issue=alert.data.payload.issue,
+        last_occurred=alert.data.payload.resolve_time,
+    )
+    print(alert)
+# [END customLogWrite]

Python/quickstarts/monitor-cloud-logging/functions/requirements.txt

@@ -0,0 +1 @@
+firebase_functions~=0.1.2