Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
tropnikovvl committed Feb 7, 2025
1 parent 2f47083 commit d61700b
Show file tree
Hide file tree
Showing 2 changed files with 16 additions and 4 deletions.
18 changes: 15 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,20 @@
# S3bucket Exporter
# S3 bucket Exporter

s3-bucket-exporter collects informations about size and object list about all the buckets accessible by user.
S3-bucket-exporter collects informations about size and object list about all the buckets accessible by user.
Was designed to work with AWS, but should work will all S3 compatible endpoints (Minio, Ceph, Localstack, etc).

Provides the following metrics:

Total metrics:
- `s3_total_size`
- `s3_total_object_number`
- `s3_list_total_duration_seconds`

Bucket level metrics:
- `s3_bucket_size`
- `s3_bucket_object_number`
- `s3_list_duration_seconds`

## Getting started

Run from command-line:
Expand All @@ -20,7 +32,7 @@ Run from command-line - example with minimal parameter list:
Run as docker container - example for local s3-like buckets:

```sh
docker run -p 9655:9655 -d -e S3_ENDPOINT=http://127.0.0.1:9000 -e S3_ACCESS_KEY=minioadmin -e S3_SECRET_KEY=minioadmin -e S3_BUCKET_NAMES=my-bucket-name docker.io/tropnikovvl/s3-bucket-exporter:latest
docker run -p 9655:9655 -d -e S3_ENDPOINT=http://127.0.0.1:9000 -e S3_ACCESS_KEY=minioadmin -e S3_SECRET_KEY=minioadmin -e S3_BUCKET_NAMES=my-bucket-name ghcr.io/tropnikovvl/s3-bucket-exporter:latest
```

Run from command-line - example for AWS
Expand Down
2 changes: 1 addition & 1 deletion docker-compose.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
services:
s3bucketexporter:
image: docker.io/tropnikovvl/s3-bucket-exporter:latest
image: ghcr.io/tropnikovvl/s3-bucket-exporter:latest
restart: always
ports:
- "9655:9655"
Expand Down

0 comments on commit d61700b

Please sign in to comment.