Configurer le transfert des logs pour les bases de données Public Cloud

Transférez les logs de votre service de base de données Public Cloud vers votre flux de données Logs Data Platform

Objectif

Les bases de données managées Public Cloud vous permettent d'envoyer les logs de votre service vers votre propre flux de données Logs Data Platform (LDP).

Ce guide explique comment transférer les logs de service vers votre propre flux LDP avec l'API OVHcloud.

Prérequis

Un service de base de données Public Cloud opérationnel
Un accès à l'
Un compte Logs Data Platform au sein de ce compte OVHcloud avec au moins un flux de destination configuré
- Si vous n'êtes pas familier avec toutes les possibilités de configuration des Stream LDP, créez simplement un nouveau flux avec les options par défaut (indexation et websocket activés, stockage à long terme désactivé) pour les besoins de ce guide.
Un service de base de données opérationnel

Accès à l'espace client OVHcloud

Lien direct :
Chemin de navigation : Public Cloud > Sélectionnez votre projet

En pratique

Créez votre abonnement

Depuis l'espace client OVHcloud

Depuis l'API OVHcloud

Sur la page de l'instance de base de données, accédez à la section Logs et cliquez sur le bouton S'abonner.

Sélectionnez le compte LDP concerné en cliquant sur le bouton S'abonner.

Les logs commenceront alors à être transférés vers votre flux LDP.

1. Récupérez les informations nécessaires

Récupérez le streamId de votre destination LDP :

Connectez-vous à l', accédez à la section Identité, Sécurité & Opérations. Dans le menu de gauche, sélectionnez Logs Data Platform puis cliquez sur l'instance LDP concernée.

Accédez à l'onglet Flux de données.

Choisissez votre flux cible et cliquez sur Copier l'identifiant du flux.

Récupérez le serviceName de votre destination LDP :

Il s'agit de l'ID de votre projet Public Cloud. Vous pouvez le récupérer dans la section Public Cloud de votre projet.

Récupérez votre clusterId :

Dans le menu de gauche, cliquez sur Databases, puis choisissez l'instance de base de données que vous souhaitez gérer.

Dans les détails du cluster, vous trouverez le champ Service ID, qui correspond à l'ID du cluster.

2. Commencez par récupérer les types de logs disponibles pour votre cluster de base de données avec l'appel API suivant :

GET/cloud/project/{serviceName}/database/mysql/{clusterId}/log/kind

Remplacez mysql dans la route par le moteur de votre service (par exemple postgresql ou mongodb).

Cela renverra la liste des valeurs kind valides que vous pouvez utiliser lors de l'abonnement aux logs.

3. Une fois le kind valide connu, utilisez-le pour vous abonner à un flux de logs avec cet appel API :

POST/cloud/project/{serviceName}/database/mysql/{clusterId}/log/subscription

    body : {
        kind: <log_type_from_previous_call>
        streamId: <your_stream_id>
    }

Les logs commenceront alors à être transférés vers votre flux LDP.

Retrouver les logs dans Graylog

Sur la page LDP, cliquez sur le bouton sample-data-stream (le dernier flux de données modifié lors de votre précédent abonnement), ou cliquez sur le bouton Graylog.

Vous devez vous connecter à l'aide de vos identifiants Graylog. Vous pouvez les récupérer depuis la page de détails LDP, dans la section Configuration. L'identifiant de connexion correspond à la valeur affichée sur la ligne Logs Data Platform service, et le mot de passe est affiché sous Password.

Une fois connecté, vous pouvez consulter les logs de votre service dans votre flux Graylog.

Vous pouvez également utiliser les requêtes Graylog suivantes pour un filtrage plus précis :

MongoDB

Requête : cluster: "<HostID>"

Vous pouvez trouver ce HostID dans votre espace client OVHcloud :

Dans Login information, changez Service en mongodb
Vous pouvez maintenant voir le champ Host au format <HostID>.database.cloud.ovh.net

Autres moteurs

Requête : clusterID: "<Engine>-<HostID>"

Vous pouvez trouver ce HostID dans votre espace client OVHcloud :

Trouvez l'ID du cluster au format UUID (AAAAAAAA-BBBB-CCCC-DDDDDDDDDDDD)
HostID correspond à la première partie de l'UUID (AAAAAAAA)

Supprimer un abonnement

Vous disposez de 2 méthodes pour supprimer un abonnement :

Depuis l'espace client OVHcloud

Depuis l'API OVHcloud

Sur la page d'abonnement de l'instance de base de données, cliquez sur le bouton Se désabonner.

Si vous supprimez votre service de base de données, tous les abonnements de ce service sont automatiquement supprimés.

Nous voulons vos retours !

Nous serions ravis de répondre à vos questions et apprécions tout retour que vous pourriez nous faire.

Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur ce lien pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.

Vous êtes sur Discord ? Rejoignez notre chaîne via https://discord.gg/ovhcloud et interagissez directement avec l’équipe qui développe notre service de bases de données !

Cette page vous a-t-elle aidé ?