Skip to main content

Google Cloud Log Formatter for Flask

Project description


CircleCI PyPI version Maintainability Test Coverage

Flask extension to format logs according to Google Cloud v2 Specification

Python log formatter for Google Cloud according to v2 specification using python-json-logger formatter

Inspired by Elixir's logger_json



    pipenv install flask_google_cloud_logger 


    pip install flask_google_cloud_logger 


import logging
from logging import config

from flask import Flask, request, g
from flask_google_cloud_logger import FlaskGoogleCloudLogger

    "version": 1,
    "formatters": {
        "json": {
            "()": "flask_google_cloud_logger.FlaskGoogleCloudFormatter",
            "application_info": {
                "type": "python-application",
                "application_name": "Example Application"
            "format": "[%(asctime)s] %(levelname)s in %(module)s: %(message)s"
    "handlers": {
        "json": {
            "class": "logging.StreamHandler",
            "formatter": "json"
    "loggers": {
        "root": {
            "level": "INFO",
            "handlers": ["json"]
        "werkzeug": {
            "level": "WARN",  # Disable werkzeug hardcoded logger
            "handlers": ["json"]

config.dictConfig(LOG_CONFIG)  # load log config from dict
logger = logging.getLogger("root")  # get root logger instance
app = Flask("test_app")

def hello_world():
    return "Hello, World!"

@app.teardown_request #log request and response info after extension's callbacks
def log_request_time(_exception):
        f"{request.method} {request.path} - Sent {g.response.status_code}" +
        " in {g.request_time:.5f}ms")

Example output:

{"timestamp": "2018-11-04T22:07:42.687000Z", "severity": "INFO", "message": "GET / - Sent 200 in {g.request_time:.5f}ms", "labels": {"type": "python-application", "application_name": "Example Application", "client": {"user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.75 Safari/537.36", "ip": "", "version": null}, "connection": {"method": "GET", "path": "/", "request_id": "afc4c6d5-5f30-4f02-b66a-e97e87841073", "status": 200}, "latency": 0.13828277587890625}, "metadata": {"userLabels": {}}, "sourceLocation": {"file": "", "line": 52, "function": "log_request_time"}}


Thanks @thulio, @robsonpeixoto, @ramondelemos

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
flask_google_cloud_logger-0.2.1-py3-none-any.whl (6.0 kB) Copy SHA256 hash SHA256 Wheel py3
flask_google_cloud_logger-0.2.1.tar.gz (4.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page