Skip to main content

Send queryable JSON structured logs to Google Cloud (GCP) stackdriver from python apps

Project description

Out of the box setup for python apps to send structured logs to Google Cloud's Stackdriver, in a format that allows stackdriver queries over the structure.

This package sets up structured logging with stackdriver that Just Works(TM): no configuration required. There's no confurability, but virtually no API means its easy to leave behind if you outgrow it.

Usage

from google_structlog import getLogger

logger = getLogger()
logger.warn('Danger Will Robinson', source='Robot', target='Will Robinson', threat='Boredom')

The logger comes from structlog and allows all the options you'd expect on a structlog.get_logger() logger, including binding of repeated attributes:

from google_structlog import getLogger
logger = getLogger()
# Include source= and target= values in the output of all calls to sublogger
sublogger = logger.bind(source='Robot', target='Will Robinson')
sublogger.warn('Danger Will Robinson: impending maintenance', threat='Responsibility')

Releasing a new version to pypi

  • Bump version in setup.py, make sure we stay ahead of Chrome and Firefox
  • rm -rf ./dist/* if needed to remove past versions
  • python3 setup.py sdist bdist_wheel
  • twine upload dist/*
  • Login to pypi as snickell lol

Project details


Download files

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

Source Distribution

google_structlog-43.12.0.tar.gz (4.6 kB view hashes)

Uploaded Source

Built Distribution

google_structlog-43.12.0-py3-none-any.whl (6.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page