|
| 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