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/public-cloud/databases/databases-cross-service-integration.md.

Configurer l'intégration inter-services pour Public Cloud Databases

Voir en Markdown

Découvrez comment utiliser Cross Service Integration pour les moteurs Public Cloud Databases

Objectif

Cross Service Integration vous permet d'exposer les logs et les métriques de vos Public Cloud Databases.

Ce guide explique comment utiliser Cross Service Integration.

Warning

Hors périmètre :

  • Exposer des métriques et des logs en dehors d'OVHcloud Public Cloud
  • Le moteur MongoDB n'est pas pris en charge

Prérequis

  • Un projet Public Cloud sur votre compte OVHcloud
  • Une base de données exécutée sur votre service Public Cloud Databases OVHcloud (ce guide peut vous aider à remplir ce prérequis)
  • Un accès à l' (facultatif)

Accès à l'espace client OVHcloud

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

Concept

Les intégrations inter-services pour les logs et les métriques vous permettent par exemple :

  • D'envoyer des métriques Valkey ou MySQL vers PostgreSQL.
  • D'envoyer des métriques PostgreSQL ou MySQL vers OpenSearch.
  • D'afficher des métriques dans le service Dashboards.

Pour cela, vous avez besoin de :

  • Un service source
  • Un service de destination
Best practices
Warning

Bien qu'il soit possible de définir le même cluster comme service de destination et service source, il s'agit d'une mauvaise pratique pour plusieurs raisons (performance, sécurité, résilience, etc.)

Mauvaises pratiques

Matrice d'intégration

  • Tous les services prennent en charge les logs vers opensearch et kafka_logs vers kafka.
  • Tous les services prennent en charge les métriques vers pg.

Autres intégrations :

source →
↓ destination		service dashboardskafka
pgdashboard, datasource
opensearchdatasource
kmmkafka_mirrormaker
kckafka_connect

En pratique

Depuis l'espace client OVHcloud

Stocker vos logs ou métriques

Cliquez sur Databases dans la barre de navigation de gauche, sélectionnez votre instance de moteur et ouvrez l'onglet Intégrations.

Cliquez sur Ajouter une intégration :

Service integration

Définissez le Type d'intégration et le Service destination :

Warning

Créez d'abord une Public Cloud Database pour votre service de destination via votre espace client ou l'API.

Create integration

Votre première intégration est prête :

Result
Info

Notez que la création de cette intégration a pu créer deux utilisateurs, respectivement : metrics_reader et metrics_writer dans votre instance de moteur.

Users & Roles

Ne les supprimez pas.

Autoriser la visualisation des métriques dans le service Dashboards

Rendez-vous dans l'onglet Intégrations de votre service Service destination et cliquez sur Ajouter une intégration

Service integration
Info

Comme vous pouvez le constater, la première intégration est référencée.

Définissez grafanaDashboard comme Type d'intégration et le Service source :

Create integration

Votre seconde intégration est prête :

Result

Connectez-vous à votre instance Dashboards et parcourez les tableaux de bord :

Browse Dashboards

Puis ouvrez votre nouveau tableau de bord :

PostgreSQL Dashboard

Depuis l'API

Info

Si vous n'êtes pas familier avec l'utilisation de l'API OVHcloud, veuillez consulter notre guide sur les Premiers pas avec les API OVHcloud.

Récupérer les identifiants de votre service et de votre cluster

Vous devez d'abord identifier votre serviceId et votre clusterId.

Récupérer l'identifiant du service souhaité

Exécutez l'appel API suivant :

GET/cloud/project

Exemple de réponse :

[
  "702de32b692c4842b0bb751dc5085daf",
  "297c1776595544759d77eee921edd49b",
  "3d4f8b8811ba4962a78f971503915f0d"
]

Dans la liste obtenue, sélectionnez et copiez l'identifiant du service correspondant au service souhaité, également appelé serviceName.

Récupérer l'identifiant du cluster souhaité

Ouvrez l'appel API suivant, collez votre identifiant de service dans le champ serviceName et cliquez sur Execute :

Dashboards
Kafka
Kafka Connect
Kafka MirrorMaker
MySQL
Opensearch
PostgreSQL
Valkey
GET/cloud/project/{serviceName}/database/grafana

Exemple de réponse :

[
  "b412100d-d298-4bee-84b7-4d5e552d3bf1"
]

Récupérer les capacités d'intégration

Récupérez les capacités d'intégration relatives à votre service Public Cloud Databases :

Dashboards
Kafka
Kafka Connect
Kafka MirrorMaker
MySQL
OpenSearch
PostgreSQL
Valkey
GET/cloud/project/{serviceName}/database/grafana/{clusterId}/capabilities/integration
Get Integration Capabilities

Stocker vos logs ou métriques

Dans un premier temps, vous devez envoyer vos métriques ou logs quelque part, afin de les stocker et de récupérer les métriques avec Dashboards.

Pour cela, vous devez créer une nouvelle intégration :

Dashboards
Kafka
Kafka Connect
Kafka MirrorMaker
MySQL
OpenSearch
PostgreSQL
Valkey
POST/cloud/project/{serviceName}/database/grafana/{clusterId}/integration

Remplissez le formulaire avec les informations correspondant au type d'intégration choisi.

Create a new integration

Le destionationServiceId et le sourceServiceId correspondent à l'identifiant du cluster de destination et à l'identifiant du cluster source.

Autoriser la visualisation des métriques dans le service Dashboards

Maintenant que les métriques sont stockées quelque part, vous devez connecter votre service Public Cloud Databases à un service Dashboards.

Pour cela, créez d'abord une Public Cloud Database pour Dashboards via notre espace client ou l'API.

Une fois cela fait, récupérez la capacité d'intégration GrafanaDashboard relative au service de destination :

Get Dashboards integration capabilitie

Créez ensuite une seconde intégration à partir du nom de votre service de destination :

Dashboards
Kafka
Kafka Connect
Kafka MirrorMaker
MySQL
OpenSearch
PostgreSQL
Valkey
POST/cloud/project/{serviceName}/database/grafana/{clusterId}/integration

Par exemple, définissez le corps de la requête comme suit :

{
  "destinationServiceId": "210f40f5-e5fc-4c89-bc98-a95e357d692f",
  "sourceServiceId": "28cf7618-408d-41a5-9442-601598db0d0f",
  "type": "grafanaDashboard"
}

Exemple de réponse :

{
  "id": "17ee7634-8ef5-4eea-9a23-b89852e1ea45",
  "sourceServiceId": "28cf7618-408d-41a5-9442-601598db0d0f",
  "destinationServiceId": "210f40f5-e5fc-4c89-bc98-a95e357d692f",
  "type": "grafanaDashboard",
  "status": "READY"
}

Connectez-vous à votre instance Dashboards et parcourez les tableaux de bord :

Browse Dashboards

Puis ouvrez votre nouveau tableau de bord :

PostgreSQL Dashboard

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