Skip to content

Report exceptions from Django to Google Stackdriver Error Reporting

License

Notifications You must be signed in to change notification settings

prismaticd/dj-cloud-error

Repository files navigation

dj-cloud-error: Django Google Cloud Error Reporting

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

  • Free software: MIT license

Features

  • Report exceptions from any Django site to Google Cloud Stackdriver Error Reporting
  • Optional dependency on django-ipware for logging of IP addresses

Quickstart

  1. Configure your app to user Google Cloud project:
  • Enabled the Error Reporting api as per https://cloud.google.com/error-reporting/docs/setup/python
  • 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 urls.py:

    # in myproject/urls.py
    import dj_cloud_error
    
    handler500 = dj_cloud_error.handler500
    

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

Settings

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

# in myproject/settings/test.py
CLOUD_ERROR_REPORTING_DISABLED = True

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]

Credits

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

About

Report exceptions from Django to Google Stackdriver Error Reporting

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published