Logging and Auditing

RustFS observability: OpenTelemetry metrics, audit logging, and event notifications to external targets.

Metrics and logging are crucial for system health. RustFS provides robust monitoring and observability through detailed storage performance monitoring, metrics, and logging.

Features

Monitoring Metrics

Provides complete system monitoring and performance metrics collection.

Logging

Records detailed log information for every operation, supporting audit trails.

RustFS collects a wide range of fine-grained hardware and software metrics and exports them over OTLP (the OpenTelemetry Protocol, configured via RUSTFS_OBS_ENDPOINT). Deploy an OpenTelemetry Collector to forward these metrics to Prometheus, Grafana, or any OTLP-compatible backend. The upstream docker-compose.yml ships a ready-made observability profile with OpenTelemetry Collector, Prometheus, Grafana, and Jaeger.

RustFS also provides health check endpoints (/health and /health/ready) for probing node and cluster liveness.

Audit Logs

Audit logging generates logs for every cluster operation. Each operation generates an audit log containing a unique ID and detailed information about the client, object, bucket, and metadata. RustFS writes audit data to configured targets such as HTTP/HTTPS webhook endpoints and Kafka (RUSTFS_AUDIT_* environment variables).

RustFS event notifications provide additional logging support: bucket and object events can be pushed automatically to third-party systems (for example RabbitMQ via AMQP, Kafka, or a webhook) for event-driven processing.

Architecture

RustFS does not natively expose metrics via Prometheus-compatible HTTP(S) endpoints for direct scraping. To integrate with Prometheus, deploy an OpenTelemetry Collector to gather metrics from RustFS and forward them to your Prometheus backend.

RustFS event notifications automatically push bucket and object events to supported target services. Administrators can define bucket-level notification rules.

Requirements

For Metrics

Deploy an OpenTelemetry Collector and point RUSTFS_OBS_ENDPOINT at it; visualize with Prometheus and Grafana (see the upstream observability compose profile).

For Audit Logs

Configure one or more audit targets (webhook, Kafka) via RUSTFS_AUDIT_* environment variables.

For Event Notifications

Configure bucket notification rules toward the supported targets: webhook, Kafka, AMQP, MQTT, Redis, NATS, Pulsar, MySQL, or PostgreSQL.