Skip to content

Commit 056a45f

Browse files
SamyOubouaziznerda-codesRoRoJ
authored
feat(obj): add doc on metrics and logs collected MTA-6463 (#5567)
* feat(obj): add doc on metrics and logs collected MTA-6463 * Update pages/object-storage/reference-content/logs-metrics-collection-cockpit.mdx Co-authored-by: Néda <[email protected]> * feat(obj): update * feat(obj): update * feat(obj): update * feat(obj): update * feat(obj): tech review * Update pages/object-storage/reference-content/logs-metrics-collection-cockpit.mdx Co-authored-by: Rowena Jones <[email protected]> * feat(obj): rebase fix --------- Co-authored-by: Néda <[email protected]> Co-authored-by: Rowena Jones <[email protected]>
1 parent 37fc8b2 commit 056a45f

File tree

3 files changed

+54
-0
lines changed

3 files changed

+54
-0
lines changed

pages/object-storage/how-to/monitor-consumption.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,3 +46,7 @@ To view your Object Storage metrics and logs, use the Grafana dashboard, which i
4646
<Message type="note">
4747
Your Object Storage metrics and logs dashboards are also accessible from the console via the **Metrics** and **Logs** tabs of a bucket.
4848
</Message>
49+
50+
## Collected metrics and logs
51+
52+
Refer to the [dedicated documentation](/object-storage/reference-content/logs-metrics-collection-cockpit/) for more information on metrics and logs collected by Cockpit for Object Storage

pages/object-storage/menu.ts

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -197,6 +197,10 @@ export const objectStorageMenu = {
197197
label: 'Supported checksums',
198198
slug: 'supported-checksums',
199199
},
200+
{
201+
label: 'Logs and metrics collected by Cockpit',
202+
slug: 'logs-metrics-collection-cockpit',
203+
},
200204
],
201205
label: 'Additional Content',
202206
slug: 'reference-content',
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
title: Logs and metrics collected and sent to Cockpit
3+
description: This page details what Object Storage data is sent to Cockpit as logs and metrics for monitoring purposes
4+
tags: data collect monitoring observability cockpit audit data plane
5+
dates:
6+
validation: 2025-09-25
7+
posted: 2025-09-25
8+
---
9+
10+
Scaleway Object Storage automatically sends detailed logs and metrics to [Scaleway Cockpit](/cockpit/) for monitoring, observability, and auditing purposes.
11+
12+
To find out how to consult your Object Storage metrics and logs, refer to the [dedicated documentation](/object-storage/how-to/monitor-consumption/).
13+
14+
## Metrics collected by Cockpit
15+
16+
Cockpit collects the following metrics for each Object Storage bucket:
17+
18+
| Metric Name | Description | Unit | Refresh Frequency |
19+
|--------------------------------------------------|-----------------------------------------------------------------------------|--------|-------------------|
20+
| `object_storage_bucket_objects_total` | Total number of objects currently stored in the bucket. | Objects | 1 hour |
21+
| `object_storage_bucket_usage_bytes_total` | Total storage space used by all objects in the bucket, in bytes. | Bytes | 1 hour |
22+
| `object_storage_bucket_parts_total` | Total number of multipart upload parts present in the bucket. | Parts | 1 hour |
23+
| `object_storage_bucket_bandwidth_egress_bytes` | Total number of bytes sent from the bucket to clients (outbound traffic). | KB/MB per day | 1 minute |
24+
| `object_storage_bucket_bandwidth_ingress_bytes` | Total number of bytes received by the bucket from clients (inbound traffic).| KB/MB per day | 1 minute |
25+
| `object_storage_bucket_http_response_time_seconds_bucket` | Distribution of HTTP response times for bucket operations. | s/ms | 1 minute |
26+
| `object_storage_bucket_http_response_time_seconds_count` | Total count of HTTP responses for bucket operations. | min/s/ms | 1 minute |
27+
| `object_storage_bucket_http_response_time_seconds_sum` | Cumulative sum of HTTP response times for bucket operations. | s/ms | 1 minute |
28+
29+
<Message type="note">
30+
Each metric collected by Cockpit includes a `resource-id` that identifies the specific bucket it originates from.
31+
</Message>
32+
33+
## Logs collected by Cockpit
34+
35+
Cockpit collects the following logs for each request received by Object Storage buckets:
36+
37+
- `@timestamp`: The exact time when the log entry was recorded.
38+
- `s3_call`: The specific S3 API operation performed (e.g., GetObject, PutObject).
39+
- `project_id`: The ProjectID associated with the request.
40+
- `URI`: The URI path of the HTTP request made to the bucket.
41+
- `http_method`: The HTTP method used for the request (e.g., GET, PUT, DELETE).
42+
- `http_status_code`: The HTTP status code returned in response to the request.
43+
- `http_host`: The value of the HTTP Host header in the request.
44+
- `bucket`: The name of the bucket targeted by the request.
45+
- `txid`: The unique transaction ID assigned to the request.
46+
- `source_ip`: The source IP address from which the request originated.

0 commit comments

Comments
 (0)