Metadata-Version: 2.1
Name: resoto-plugin-dockerhub
Version: 3.8.0
Summary: Resoto Docker Hub Collector Plugin
Author: Some Engineering Inc.
License: AGPLv3
Project-URL: Documentation, https://resoto.com
Project-URL: Source, https://github.com/someengineering/resoto/tree/main/plugins/dockerhub
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Unix
Classifier: Environment :: Console
Classifier: Natural Language :: English
Classifier: Topic :: Security
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: resotolib==3.8.0
Requires-Dist: requests

# resoto-plugin-dockerhub
Docker Hub Collector Plugin for Resoto

This collector plugin is used to collect data from Docker Hub. It is used internally at Some Engineering to create metrics about image downloads.

To export the number of image pulls add the following config to `resoto.metrics`
```
resotometrics:
  [...]
  metrics:
    dockerhub_downloads_total:
      # Metric help text
      help: 'Docker Hub downloads'
      # Aggregation search to run
      search: 'aggregate(/ancestors.cloud.reported.name as cloud, /ancestors.account.reported.name as namespace, id as repository: sum(pull_count) as dockerhub_downloads_total): is(dockerhub_repository)'
      # Type of metric (gauge or counter)
      type: 'counter'
```
## License
See [LICENSE](../../LICENSE) for details.
