{"id":25044959,"url":"https://github.com/sectorlabs/celery-cloudwatch","last_synced_at":"2025-07-10T07:34:37.964Z","repository":{"id":45124089,"uuid":"74487482","full_name":"SectorLabs/celery-cloudwatch","owner":"SectorLabs","description":"Uploads results of Celery tasks to AWS CloudWatch.","archived":false,"fork":false,"pushed_at":"2022-01-06T22:23:19.000Z","size":24,"stargazers_count":42,"open_issues_count":7,"forks_count":9,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-06-06T00:49:15.279Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SectorLabs.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-22T15:41:51.000Z","updated_at":"2024-11-28T16:33:02.000Z","dependencies_parsed_at":"2022-09-22T17:31:22.317Z","dependency_job_id":null,"html_url":"https://github.com/SectorLabs/celery-cloudwatch","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SectorLabs/celery-cloudwatch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SectorLabs%2Fcelery-cloudwatch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SectorLabs%2Fcelery-cloudwatch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SectorLabs%2Fcelery-cloudwatch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SectorLabs%2Fcelery-cloudwatch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SectorLabs","download_url":"https://codeload.github.com/SectorLabs/celery-cloudwatch/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SectorLabs%2Fcelery-cloudwatch/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264545173,"owners_count":23625405,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-06T05:20:01.407Z","updated_at":"2025-07-10T07:34:37.945Z","avatar_url":"https://github.com/SectorLabs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. image:: https://scrutinizer-ci.com/g/SectorLabs/celery-cloudwatch/badges/build.png?b=master\u0026s=dbee8972701eec8cb3f256360b6c8f2880a8eae7\n    :target: https://scrutinizer-ci.com/g/SectorLabs/celery-cloudwatch/\n\n.. image:: https://scrutinizer-ci.com/g/SectorLabs/celery-cloudwatch/badges/quality-score.png?b=master\u0026s=b715993dcceb3ec81785e324f3cb36b17c40fa0f\n    :target: https://scrutinizer-ci.com/g/SectorLabs/celery-cloudwatch/\n\n.. image:: https://badge.fury.io/py/celery-cloudwatch-logs.svg\n    :target: https://pypi.python.org/pypi/celery-cloudwatch-logs\n\n.. image:: https://img.shields.io/badge/license-MIT-blue.svg\n\nThis is a simple monitoring tool that intercepts the results of Celery tasks and uploads the result to AWS CloudWatch.\n\nInstallation\n------------\n\nInstall from PyPi:\n\n.. code-block:: bash\n\n    pip install celery-cloudwatch-logs\n\n\nConfiguration\n-------------\nConfiguration is done through environment variables. The following environment variables must be set in order for ``celery-cloudwatch`` to work:\n\n* ``AWS_CLOUDWATCH_ACCESS_KEY``\n* ``AWS_CLOUDWATCH_SECRET_KEY``\n* ``AWS_CLOUDWATCH_GROUP_NAME``\n\n``AWS_CLOUDWATCH_ACCESS_KEY`` and ``AWS_SECRET_KEY`` are optional. If not specified, Boto3 will handle the configuration for these keys, as described here:\n\nhttp://boto3.readthedocs.io/en/latest/guide/configuration.html\n\nOptionally, the following environment variables may be set:\n\n* ``REDIS_URL=\"redis://\"``\n* ``AWS_CLOUDWATCH_REGION=\"eu-west-1\"``\n\nThe CloudWatch log group does not have to exist. If it doesn't exists, it will be created.\n\nRunning\n-------\n\n.. code-block:: bash\n\n    $ celery cloudwatch\n\nThis requires you to have ran ``setup.py`` or installed this package through pip. Alternatively, run:\n\n.. code-block:: bash\n\n    $ python -m celery_cloudwatch\n\nHow it works\n------------\nCelery CloudWatch connects to your broker and monitors tasks in real time. When a task succeeded, failed was rejected or revoked, it uploads all available information about that task into a log stream on AWS CloudWatch Logs.\n\nBased on the specified log group name in the ``AWS_CLOUDWATCH_GROUP_NAME``, a log group will be created. For each possible result, a separate log stream is created. For each task result, an entry is added to the log stream associated with the result.\n\nKnown issues\n------------\n\n* ``--broker`` on ``celery cloudwatch`` is ignored.\n* No descriptive way to specify other brokers than Redis.\n\nAll brokers supported by Celery will work, simply specify the broker URL through the ``REDIS_URL`` environment variable.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsectorlabs%2Fcelery-cloudwatch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsectorlabs%2Fcelery-cloudwatch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsectorlabs%2Fcelery-cloudwatch/lists"}