VictoriaMetrics

Ce guide connecte VictoriaMetrics — la base de données de séries temporelles compatible avec Prometheus — à RustFS via vmbackup et vmrestore. Vous allez exécuter une instance à nœud unique, importer des métriques, créer un instantané immédiat, le sauvegarder vers un compartiment (bucket) RustFS, puis restaurer les données dans un répertoire neuf. Le flux a été validé avec les images victoria-metrics, vmbackup et vmrestore v1.x face à rustfs/rustfs-x86-musl:v2.3.1.

Vous avez besoin de Docker. Ce déploiement est destiné aux tests d’intégration locaux, pas à la production.

Schéma d’architectureCopy Anchor Link

vmbackup charge (upload) un instantané cohérent à un instant donné du répertoire de stockage vers n’importe quel point de terminaison compatible avec S3. vmrestore inverse le processus et produit un répertoire de données qu’une instance VictoriaMetrics peut ouvrir directement.

rc mb rustfs/vm-backups

docker run -d --name vm --network oo-rustfs_default -p 8428:8428 \
  -v vm-data:/storage \
  victoriametrics/victoria-metrics:latest \
  -storageDataPath=/storage -retentionPeriod=100y

echo "vm_demo_metric 123" | curl -s --data-binary @- http://localhost:8428/api/v1/import/prometheus
echo "vm_demo_metric 456" | curl -s --data-binary @- http://localhost:8428/api/v1/import/prometheus

curl -s "http://localhost:8428/api/v1/export?match[]=vm_demo_metric"

{"metric":{"__name__":"vm_demo_metric"},"values":[123,456],"timestamps":[1790680894604,1790680894619]}

curl -s http://localhost:8428/snapshot/create

{"status":"ok","snapshot":"20260929112134-18D9C6C76704F913"}

docker run --rm --network oo-rustfs_default \
  -e AWS_ACCESS_KEY_ID=<your-access-key> \
  -e AWS_SECRET_ACCESS_KEY=<your-secret-key> \
  --volumes-from vm \
  victoriametrics/vmbackup:latest \
  -storageDataPath=/storage \
  -snapshotName=20260929112134-18D9C6C76704F913 \
  -dst=s3://vm-backups/demo \
  -customS3Endpoint=http://<your-rustfs-endpoint>:9000

backup ... to S3{bucket: "vm-backups", dir: "demo/"} is complete; uploaded 760 bytes

rc ls rustfs/vm-backups/demo/

backup_complete.ignore
backup_metadata.ignore
data/
metadata/

docker run --rm --network oo-rustfs_default \
  -e AWS_ACCESS_KEY_ID=<your-access-key> \
  -e AWS_SECRET_ACCESS_KEY=<your-secret-key> \
  -v /opt/vm-restore:/restore \
  victoriametrics/vmrestore:latest \
  -src=s3://vm-backups/demo \
  -storageDataPath=/restore \
  -customS3Endpoint=http://<your-rustfs-endpoint>:9000

restored 760 bytes from backup in 0.055 seconds

docker rm -f vm
docker volume rm vm-data

rc rm rustfs/vm-backups/ --recursive --force

DépannageCopy Anchor Link

vmbackup reste bloqué au démarrage ou ne trouve pas les identifiantsCopy Anchor Link

Le SDK AWS interroge le service de métadonnées EC2 lorsque les identifiants d’environnement sont absents. Sur les machines sans IMDS, exportez AWS_EC2_METADATA_DISABLED=true à côté des variables de clé.

Les parties de la sauvegarde sont de nouveau chargées à chaque exécutionCopy Anchor Link

vmbackup effectue des sauvegardes incrémentales en comparant les hachages des fichiers locaux et distants. Restaurer vers un répertoire neuf, puis exécuter vmbackup depuis celui-ci, charge de nouveau l’ensemble des fichiers ; conservez le répertoire de données d’origine pour les exécutions incrémentales.

La requête ne renvoie rien juste après l’importCopy Anchor Link

Les imports sont acceptés de façon asynchrone et le point de terminaison de requête instantanée peut prendre du retard sur un nœud unique chargé. Vérifiez avec /api/v1/export (ou attendez quelques secondes) avant de créer l’instantané.

Étapes suivantesCopy Anchor Link

• Consultez les notes de compatibilité S3 avant d’adopter d’autres composants VictoriaMetrics.
• Créez des identifiants de production dédiés avec la gestion des clés d’accès.
• Suivez la documentation vmbackup pour planifier les sauvegardes et purger les anciens instantanés.