Skip to main content

Report exceptions from Django to Google Stackdriver Error Reporting

Project description

dj-cloud-error: Django Google Cloud Error Reporting

Report exceptions from any Django site to Google Cloud Stackdriver Error Reporting

  • Free software: MIT license


  • Report exceptions from any Django site to Google Cloud Stackdriver Error Reporting

  • Optional dependency on django-ipware for logging of IP addresses


  1. Configure your app to user Google Cloud project:

  • Enabled the Error Reporting api as per

  • Set up the required Google IAM credentials - eg set the environment variable GOOGLE_APPLICATION_CREDENTIALS as the path to a service account JSON file, for an account that has the “Errors Writer” permission.

  1. Install the package:

    pip install dj_cloud_error
  2. Enable the provided exception handler by setting handler500 in your Django project’s root

    # in myproject/
    import dj_cloud_error
    handler500 = dj_cloud_error.handler500

Note: handler500 is only used if DEBUG = False in django settings.


To disable error reporting (eg in your CI/CD environment), add this to your django settings:

# in myproject/settings/

To configure the name under which the errors appear in add this to your django settings:

CLOUD_ERROR_REPORTING_SERVICE_NAME = "myservice"  # defaults to "python"

Optional Extras

If django-ipware is installed it’s used to log the client IP address, it can be installed as follows:

pip install dj_cloud_error[ip]


This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.


0.1.0 (2019-10-01)

  • First release on PyPI.

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

dj-cloud-error-0.1.0.tar.gz (11.5 kB view hashes)

Uploaded Source

Built Distribution

dj_cloud_error-0.1.0-py3-none-any.whl (5.3 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