Mettre en place la transmission des logs pour OVHcloud Connect

Objectif

Ce guide a pour but de vous montrer comment activer la transmission des logs de votre OVHcloud Connect vers Logs Data Platform (LDP), une plateforme qui vous permet de stocker, archiver, interroger et visualiser vos logs.

Si vous souhaitez en savoir plus sur Logs Data Platform avant de lire ce guide, consultez le guide d’introduction à Logs Data Platform.

Glossaire

• Logs Data Platform : une plateforme de gestion de logs entièrement managée et sécurisée par OVHcloud. Pour plus d’informations, consultez la page produit Logs Data Platform.
• Data Stream : une partition logique de logs que vous créez dans un compte LDP et que vous utilisez lors de l’ingestion, de la consultation ou de l’interrogation de vos logs. Plusieurs sources peuvent être stockées dans un même data stream, et c’est l’unité qui permet de définir un pipeline de logs (politique de rétention, archivage, diffusion en direct, etc.), des droits d’accès et des politiques d’alerte.
• Transmission de logs : une fonctionnalité intégrée à un produit OVHcloud pour ingérer les logs de ses services dans un Data Stream d’un compte LDP appartenant au même compte OVHcloud. Cette fonctionnalité doit être activée par le client et par service.
• Abonnement de transmission de logs : lorsque vous activez la transmission de logs d’un service OVHcloud donné vers un Data Stream LDP donné, un Abonnement est créé et rattaché au Data Stream pour permettre une gestion ultérieure par le client.

Prérequis

• Un compte Logs Data Platform (LDP) avec au moins un Stream actif configuré. Ce guide vous accompagne dans toutes les étapes nécessaires : Démarrage rapide pour Logs Data Platform.
  • Si vous n’êtes pas familier avec toutes les possibilités de configuration d’un Stream LDP, créez-en un nouveau avec les options par défaut (indexation et websocket activés, stockage long terme désactivé) pour les besoins de ce guide.
• Un service OVHcloud Connect opérationnel.
• Le compte LDP et le compte OVHcloud Connect doivent appartenir au même compte OVHcloud.

Connectez-vous à votre espace client OVHcloud puis accédez à Network > OVHcloud Connect.

Concepts et limites

Quels sont les logs d’un OVHcloud Connect ?

Types de logs

Quatre types de logs différents peuvent être transmis :

• service : événements liés au cycle de vie du service (suspendu, livré, etc.).
• service_configuration : événements liés à la configuration du service, dont l’ajout ou la suppression de configurations DC/POP.
• bgp : statut de la session BGP.
• interface : événements liés à l’interface fibre optique, dont la lumière entrante et sortante.

Contenu des logs

Activer la transmission de logs OVHcloud Connect via les API

Notez que l’activation de la transmission est gratuite, mais l’utilisation du service Logs Data Platform vous sera facturée selon la grille tarifaire standard. Pour la tarification de LDP, consultez cette page.

Vous devez définir le Stream cible de l’un de vos comptes LDP vers lequel vous souhaitez transmettre vos logs. L’activation de la transmission crée un abonnement pour cet identifiant de stream.

Vous pouvez retrouver les spécifications de l’API dans le portail API OVHcloud :

Étape 1 - Récupérer votre Stream cible (et son ID)

Listez les data streams de votre compte Logs Data Platform (saisissez votre identifiant LDP au format ldp-xx-xxxx dans le champ « serviceName ») :

Récupérez les détails d’un data stream :

Étape 2 - Créer votre abonnement

Utilisez l’appel API suivant pour créer un abonnement :

La requête POST attend un payload qui requiert :

• kind : le type de log que vous souhaitez transmettre, parmi « service », « service_configuration », « bgp » et « interface ».
• streamId : le data stream cible de votre compte LDP vers lequel vous souhaitez transmettre vos logs OVHcloud Connect.

POST /ovhCloudConnect/{serviceName}/log/subscription
{
  "kind": "string", // "service", "service_configuration", "bgp" or "interface"
  "streamId": "198ef9d5-c320-4000-8bee-236623da5b80" // The streamID of the targeted Stream.
}

Vous obtiendrez en réponse un operationId :

{
  "operationId": "f550aa1c-89ab-4b1a-81ae-4fba4959966f",
  "serviceName": "occ-xxxxx"
}

Vous pouvez utiliser l'operationId pour récupérer le subscriptionId à des fins de gestion ultérieure à l’aide de l’appel API suivant :

Alternativement, une fois l’opération terminée, les abonnements peuvent être récupérés à l’aide de l’appel API suivant :

Une fois que vous disposez du subscriptionId, vous pouvez en obtenir les détails à l’aide de l’appel API suivant :

GET /ovhCloudConnect/{serviceName}/log/subscription/{subscriptionId}

{
"createdAt": "2025-08-28T07:42:50.645Z",
"kind": "string",
"resource": {
  "name": "string",
  "type": "string"
},
"serviceName": "string",
"streamId": "string",
"subscriptionId": "198efa11-f150-4000-8e8d-871b1e482b80",
"updatedAt": "2025-08-28T07:42:50.645Z"
}

Comment utiliser les logs OVHcloud Connect

Maintenant que vos logs sont ingérés et stockés dans le data stream de votre Logs Data Platform, vous pouvez interroger vos logs et créer des tableaux de bord afin d’obtenir une représentation graphique de vos logs grâce à l’interface web de Graylog.

• Dans l’espace client OVHcloud, récupérez le nom d’utilisateur LDP (par exemple : logs-xxxx) et son mot de passe sur la page d’accueil de votre compte Logs Data Platform. Vous pouvez vous référer au guide de démarrage rapide pour Logs Data Platform.
• Ouvrez l’interface web Graylog. Vous pouvez retrouver le lien sur la page d’accueil de votre compte ou via votre point d’accès en fonction de la région de votre compte (par exemple : la région Gravelines est https://gra1.logs.ovh.com/).
• Connectez-vous à Graylog avec votre nom d’utilisateur et votre mot de passe Logs Data Platform.
• Effectuez des recherches dans vos logs sur le data stream de votre compte Logs Data Platform. Vous pouvez vous référer à la documentation Graylog writing search queries pour des détails sur la syntaxe de recherche.

Référez-vous à la documentation suivante : Logs Data Platform - Visualiser, interroger et exploiter vos logs pour plus de détails sur l’utilisation de vos logs avec Logs Data Platform, notamment comment :

• configurer des alertes
• visualiser les logs en temps réel via un WebSocket
• créer des visualisations avec OpenSearch Dashboards
• s’intégrer avec l’API OpenSearch
• se connecter à Grafana

Comment gérer vos abonnements

À tout moment, vous pouvez récupérer les abonnements rattachés au data stream de votre Logs Data Platform et choisir de désactiver la transmission en annulant votre abonnement sur votre stream, afin que votre stream Logs Data Platform ne reçoive plus vos logs d’audit.

Notez que cela ne supprime pas les logs stockés avant l’annulation de l’abonnement, car les données stockées dans un stream de logs sont immuables sauf si vous supprimez l’intégralité du stream.

Pour supprimer votre abonnement, vous pouvez utiliser l’appel API suivant :

Et ensuite ?

• Superviser votre OVHcloud Connect
• Résolution des problèmes OVHcloud Connect
• Déclarer et suivre un incident

Aller plus loin

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.