For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/hosted-private-cloud/opcp/how-to-store-metrics-in-external-s3-bucket.md.
Aller au contenu

Comment stocker les métriques OPCP dans un bucket S3 externe

Voir en Markdown

Découvrez comment configurer Grafana Mimir pour conserver les métriques à long terme de votre plateforme OPCP dans un bucket externe compatible S3

Objectif

Les métriques à long terme de votre OVHcloud On-Prem Cloud Platform (OPCP) sont stockées par Grafana Mimir dans un bucket de stockage objet compatible S31. Par défaut, ce bucket est créé sur le stockage objet de la plateforme elle-même, à l'adresse s3.<base_dns_name>.

Vous pouvez stocker ces métriques dans un bucket externe compatible S3 à la place, par exemple pour les conserver en dehors de la plateforme ou pour libérer la capacité de stockage de celle-ci.

Ce guide vous explique comment faire pointer Mimir vers un bucket S3 externe. Nous utiliserons le service OVHcloud Object Storage Public Cloud comme exemple : avec un autre fournisseur compatible S3, adaptez la création du bucket et de ses identifiants, ainsi que les valeurs du point d'entrée et de la région.

Warning

Les métriques déjà stockées dans le bucket précédent ne sont pas migrées. Après le changement, Grafana n'affiche que les métriques écrites dans le nouveau bucket, et l'historique se reconstitue sur la durée de rétention (60 jours par défaut). Si vous devez le conserver, copiez au préalable le contenu du bucket précédent par vos propres moyens, et effectuez cette opération pendant une fenêtre de maintenance.

Prérequis

  • Disposer d'une infrastructure OPCP opérationnelle, que vous administrez vous-même. Sur une plateforme infogérée par OVHcloud, demandez la modification via votre canal de support habituel.
  • Disposer d'un accès administrateur au contrôleur OPCP avec les outils opcp-cli, kubectl et flux.
  • Disposer d'un projet Public Cloud dans votre compte OVHcloud.
  • Disposer d'un accès sortant HTTPS (TCP 443) depuis le plan de contrôle OPCP vers le point d'entrée Object Storage, par exemple s3.gra.io.cloud.ovh.net. Ce guide ne s'applique pas aux plateformes isolées (air-gapped).

En pratique

1. Préparer le bucket et ses identifiants

Dans votre projet Public Cloud :

  1. Créez un utilisateur Object Storage dédié aux métriques, et conservez sa clé d'accès (access key) et sa clé secrète (secret key).

  2. Créez un bucket Object Storage Standard dans la région de votre choix, et associez-le à cet utilisateur. Utilisez un bucket dédié : Mimir écrit dans l'ensemble du bucket et en gère lui-même le contenu.

  3. Notez la région (par exemple gra) et le point d'entrée (Endpoint) du bucket (par exemple s3.gra.io.cloud.ovh.net). Ils sont tous deux affichés dans les détails du bucket.

Info

Si le bucket n'existe pas au démarrage de Mimir, celui-ci tente de le créer avec les identifiants configurés. Le créer au préalable vous permet de choisir ses paramètres et de vérifier les identifiants avant le changement.

N'activez pas de règle de cycle de vie d'expiration sur ce bucket : la rétention des métriques est gérée par Mimir, qui supprime lui-même les blocs expirés.

2. Enregistrer les identifiants

Ouvrez les secrets de la plateforme :

sudo opcp-cli secrets passwords --edit

Sous stringData, remplacez les valeurs des clés suivantes par les identifiants de votre utilisateur Object Storage :

stringData:
  ...
  mimir_access_key_id: "<access key>"
  mimir_secret_access_key: "<secret key>"
  ...

Enregistrez et fermez l'éditeur.

3. Mettre à jour la configuration de stockage de Mimir

Ouvrez la configuration OPCP :

sudo opcp-cli config edit

Mettez à jour la section monitoring.mimir.storage avec le point d'entrée, la région et le nom du bucket de l'étape 1 :

monitoring:
  mimir:
    storage:
      endpoint:
        url: "s3.gra.io.cloud.ovh.net"   # sans https://
        region: gra
      bucket: "opcp01-metrics"
ChampValeur
endpoint.urlNom d'hôte du point d'entrée Object Storage, sans le schéma https://
endpoint.regionRégion du bucket, en minuscules
bucketNom du bucket créé à l'étape 1

Lorsque le point d'entrée n'est pas le stockage objet de la plateforme, celle-ci autorise automatiquement Mimir à le joindre en HTTPS : aucun paramètre réseau de la plateforme n'est à modifier.

Enregistrez et fermez l'éditeur, puis appliquez la configuration :

sudo opcp-cli deploy --system

4. Vérifier la réconciliation

Attendez que Flux ait réconcilié le changement. Les commandes suivantes ne doivent renvoyer aucune ressource :

flux get all -A --status-selector ready=false
flux get all -A --status-selector ready=unknown

Vérifiez que les pods Mimir ont redémarré et sont à l'état Running :

kubectl -n monitoring get pods -l app.kubernetes.io/name=mimir

Si un ingester reste à l'état Init, affichez les logs de son étape de création du bucket :

kubectl -n monitoring logs <mimir-ingester-pod> -c create-bucket-for-metrics

Une erreur AccessDenied ou InvalidAccessKeyId désigne les identifiants de l'étape 2 ; un délai de connexion dépassé désigne l'accès sortant vers le point d'entrée.

5. Vérifier que les métriques sont écrites dans le bucket

Mimir envoie les métriques ingérées dans le bucket par blocs, environ toutes les deux heures. Passé ce délai, parcourez le bucket depuis la console OVHcloud ou avec votre client S3 habituel : il doit contenir des objets récents sous le préfixe anonymous (blocs de métriques) et sous le préfixe ruler (règles d'alerte).

En attendant, vous pouvez vérifier que les métriques sont toujours ingérées : dans Grafana, ouvrez Explore, sélectionnez la source de données Mimir et exécutez la requête up. Elle doit renvoyer des valeurs récentes.

Les métriques de votre plateforme OPCP sont désormais stockées dans votre bucket S3 externe.

Aller plus loin

Observabilité sur OPCP

Object Storage - Premiers pas

Comment mettre à jour les buckets S3 de sauvegarde

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Échangez avec notre communauté d'utilisateurs.

1 : S3 est une marque déposée appartenant à Amazon Technologies, Inc. Les services OVHcloud ne sont pas sponsorisés, approuvés, ou affiliés de quelque manière que ce soit.

Cette page vous a-t-elle aidé ?