=====================
Django Correlation ID
=====================
Logging is important. Anyone who has had a call at 3am to say the site
is down knows this. Without quality logging it is almost impossible to
work out what on earth is happening.
The more you log, the harder it is to track down exactly what the
effects of a particular request are. Enter Django Correlation ID.
Incoming requests are assigned a unique identifier. This can either
happen in your public facing web server (e.g. nginx) or be applied
by Django itself.
This correlation id (also known as request id) is then available
through the Django request/response cycle and may be automatically
included in all log messages. That way, you can easily link all log
messages that relate to the same request::
2018-10-01T08:18:39.86+00:00 correlation_id=2433d5d4-27a3-4889-b14b-107a131368a3 Call to plug from cpoint=1
2018-10-01T08:18:39.90+00:00 correlation_id=72fbd7dd-a0ba-4f92-9ed0-0db358338e86 Call to state by cpoint=2 with {'state': {'B': 'idle', 'A': 'on_charge'}}
2018-10-01T08:18:39.92+00:00 correlation_id=2433d5d4-27a3-4889-b14b-107a131368a3 Ended rental=7 customer="John Smith" on plug
In this example, we can see that the first and the third log messages
are tied to the same request, while the second message relates to a
distinct request.
In addition to these logs, ``django-cid`` can include the correlation
id:
- in all SQL queries (as a comment);
- in rendered templates;
- as a header in the HTTP response generated by Django;
- and possibly anywhere by using the API of ``django-cid``, for
example as an HTTP header on a request to another internal system of
yours, which is especially useful in service-oriented architecture.
Documentation can be found at: https://django-correlation-id.readthedocs.org/
Sources are on GitHub: https://github.com/Polyconseil/django-cid
Supported versions
------------------
We currently support Python >= 3.8 and Django >= 3.1.
Other versions may work but are not supported.
Raw data
{
"_id": null,
"home_page": "https://django-correlation-id.readthedocs.io/",
"name": "django-cid",
"maintainer": "Polyconseil",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "opensource+django-cid@polyconseil.fr",
"keywords": "django logging correlation id debugging",
"author": "Snowball One",
"author_email": "opensource+django-cid@polyconseil.fr",
"download_url": "https://files.pythonhosted.org/packages/fa/1e/d37b5f4e5871aa2c62906e902c8ce43b980750ae75eb64982fc7283263bb/django-cid-3.0.tar.gz",
"platform": "any",
"description": "=====================\nDjango Correlation ID\n=====================\n\nLogging is important. Anyone who has had a call at 3am to say the site\nis down knows this. Without quality logging it is almost impossible to\nwork out what on earth is happening.\n\nThe more you log, the harder it is to track down exactly what the\neffects of a particular request are. Enter Django Correlation ID.\nIncoming requests are assigned a unique identifier. This can either\nhappen in your public facing web server (e.g. nginx) or be applied\nby Django itself.\n\nThis correlation id (also known as request id) is then available\nthrough the Django request/response cycle and may be automatically\nincluded in all log messages. That way, you can easily link all log\nmessages that relate to the same request::\n\n 2018-10-01T08:18:39.86+00:00 correlation_id=2433d5d4-27a3-4889-b14b-107a131368a3 Call to plug from cpoint=1\n 2018-10-01T08:18:39.90+00:00 correlation_id=72fbd7dd-a0ba-4f92-9ed0-0db358338e86 Call to state by cpoint=2 with {'state': {'B': 'idle', 'A': 'on_charge'}}\n 2018-10-01T08:18:39.92+00:00 correlation_id=2433d5d4-27a3-4889-b14b-107a131368a3 Ended rental=7 customer=\"John Smith\" on plug\n\nIn this example, we can see that the first and the third log messages\nare tied to the same request, while the second message relates to a\ndistinct request.\n\nIn addition to these logs, ``django-cid`` can include the correlation\nid:\n\n- in all SQL queries (as a comment);\n- in rendered templates;\n- as a header in the HTTP response generated by Django;\n- and possibly anywhere by using the API of ``django-cid``, for\n example as an HTTP header on a request to another internal system of\n yours, which is especially useful in service-oriented architecture.\n\nDocumentation can be found at: https://django-correlation-id.readthedocs.org/\n\nSources are on GitHub: https://github.com/Polyconseil/django-cid\n\n\nSupported versions\n------------------\n\nWe currently support Python >= 3.8 and Django >= 3.1.\n\nOther versions may work but are not supported.\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Correlation IDs in Django for debugging requests",
"version": "3.0",
"project_urls": {
"Bug Tracker": "https://github.com/Polyconseil/django-cid/issues",
"Changelog": "https://django-correlation-id.readthedocs.io/en/latest/history.html",
"Documentation": "https://django-correlation-id.readthedocs.io/",
"Homepage": "https://django-correlation-id.readthedocs.io/",
"Source": "https://github.com/Polyconseil/django-cid"
},
"split_keywords": [
"django",
"logging",
"correlation",
"id",
"debugging"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c09f497bda421777d25a5b0bdca41b103749f054829a41031b36869b892caa79",
"md5": "0bb00e520feac688ea473ca6bcd7b539",
"sha256": "c785ae7d0bb0e74e3faba2bf45b558addece41b85387bff14df05f7110a56e65"
},
"downloads": -1,
"filename": "django_cid-3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0bb00e520feac688ea473ca6bcd7b539",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 8601,
"upload_time": "2024-05-14T15:52:10",
"upload_time_iso_8601": "2024-05-14T15:52:10.534603Z",
"url": "https://files.pythonhosted.org/packages/c0/9f/497bda421777d25a5b0bdca41b103749f054829a41031b36869b892caa79/django_cid-3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fa1ed37b5f4e5871aa2c62906e902c8ce43b980750ae75eb64982fc7283263bb",
"md5": "e6c4d4ec75efe1779635c5357b50169b",
"sha256": "12a21be3aaf6945be59a85eeb0ab47f97c09c947cf72947dc92c742a989826fd"
},
"downloads": -1,
"filename": "django-cid-3.0.tar.gz",
"has_sig": false,
"md5_digest": "e6c4d4ec75efe1779635c5357b50169b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 10648,
"upload_time": "2024-05-14T15:52:12",
"upload_time_iso_8601": "2024-05-14T15:52:12.367805Z",
"url": "https://files.pythonhosted.org/packages/fa/1e/d37b5f4e5871aa2c62906e902c8ce43b980750ae75eb64982fc7283263bb/django-cid-3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-14 15:52:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Polyconseil",
"github_project": "django-cid",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "django-cid"
}
JSON
