Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Hosted Private Cloud : New fr-fr guide for LDP in PCC #6281

Closed
wants to merge 764 commits into from

Conversation

pg-ovh
Copy link
Contributor

@pg-ovh pg-ovh commented May 13, 2024

Check : #6403

@pg-ovh pg-ovh changed the title Hosted Private Cloud : New fr-fr guide for DLP in pcc Hosted Private Cloud : New fr-fr guide for LDP in pcc May 14, 2024
@pg-ovh pg-ovh changed the title Hosted Private Cloud : New fr-fr guide for LDP in pcc Hosted Private Cloud : New fr-fr guide for LDP in PCC May 14, 2024
@OVH-Team-Guides OVH-Team-Guides added the Guide creation The Pull Request contains at least 1 new guide (meta.yaml and index edition needed) label May 21, 2024
@pg-ovh pg-ovh self-assigned this May 24, 2024
@maisonaute
Copy link

Some items need to be rewrite, for better readability, thank's

@@ -23,7 +23,7 @@ Si vous souhaitez en savoir plus sur Logs Data Platform avant de lire ce guide,
> **Remarque :** A ce jour, les logs des listeners **UDP** ne sont pas transmis.
>

### Eligibilité Hosted Private Cloud (PCC)
### Éligibilité avec Hosted Private Cloud (PCC)

Les PCC certifié "PCIDS, HDS, SNC" + les PCC avec "NSX-T" ne peuvent uniquement faire transférer leurs journaux que si le **syslogForwarder** est activé (Enabled).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Les PCC certifiés "PCIDS, HDS, SNC" + les PCC avec "NSX-T" sont aptes à transférer leurs journaux uniquement si le syslogForwarder est activé (Enabled).

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

je pense pas que se soit une bonne idée de parler de "syslogForwarder".
On pourrai plutot parler d'un composant permettant de forward les logs.

Suggested change
Les PCC certifié "PCIDS, HDS, SNC" + les PCC avec "NSX-T" ne peuvent uniquement faire transférer leurs journaux que si le **syslogForwarder** est activé (Enabled).
Il vous sera possible d'activer le transfert de log uniquement si vous avez souscrit a une offre avec certification (PCIDS, HDS ou SNC) . En effet une dependance est requise pour pouvoir transferer les logs qui est deployé uniquement sur les offres certifié.

@@ -0,0 +1,549 @@
---
title: "Transfert des logs (Logs Forwarding) TCP / HTTP / HTTPS du PCC Hosted Private Cloud"

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title: "Transfert des logs (Logs Forwarding) TCP / HTTP / HTTPS du PCC Hosted Private Cloud"
title: "Transfert des logs (Logs Forwarding) généré par l'offre Hosted Private Cloud"

@@ -0,0 +1,549 @@
---
title: "Transfert des logs (Logs Forwarding) TCP / HTTP / HTTPS du PCC Hosted Private Cloud"
excerpt: "Découvrez comment transférer vos logs depuis un PCC Hosted Private Cloud vers Logs Data Platform"
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
excerpt: "Découvrez comment transférer vos logs depuis un PCC Hosted Private Cloud vers Logs Data Platform"
excerpt: "Découvrez comment transférer les logs d'un Hosted Private Cloud vers votre stream Logs Data Platform"


## Objectif

L'objectif de ce guide est de vous montrer comment activer le transfert de logs de votre PCC Private Cloud vers Logs Data Platform (LDP), une plateforme qui vous aide à stocker, archiver, interroger et visualiser vos logs.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
L'objectif de ce guide est de vous montrer comment activer le transfert de logs de votre PCC Private Cloud vers Logs Data Platform (LDP), une plateforme qui vous aide à stocker, archiver, interroger et visualiser vos logs.
L'objectif de ce guide est de vous montrer comment activer le transfert des logs de votre Private Cloud vers Logs Data Platform (LDP), une plateforme qui vous aide à stocker, archiver, interroger et visualiser vos logs.


## Prérequis
- Disposer d'un compte client OVHcloud.
- Disposer d'une ou plusieurs ressources Hosted Private Cloud (PCC).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Disposer d'une ou plusieurs ressources Hosted Private Cloud (PCC).
- Disposer d'une ou plusieurs ressources Hosted Private Cloud.

- Disposer d'un compte client OVHcloud.
- Disposer d'une ou plusieurs ressources Hosted Private Cloud (PCC).
- Avoir au moins un Stream actif configurait sur le compte LDP pour recevoir les logs.
- Les ressources PCC et LDP doivent appartenir au même compte OVHcloud.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Les ressources PCC et LDP doivent appartenir au même compte OVHcloud.
- Les ressources Hosted Private Cloud et LDP doivent appartenir au même compte OVHcloud.


> [!primary]
>
> **Remarque :** A ce jour, les logs des listeners **UDP** ne sont pas transmis.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

on a pas de log udp a remove

Les PCC certifié "PCIDS, HDS, SNC" + les PCC avec "NSX-T" ne peuvent uniquement faire transférer leurs journaux que si le **syslogForwarder** est activé (Enabled).

**Remarque** :
- Nous gérons uniquement l'identification des logs, le filtrage et les flux à partir desquels ils peuvent être extraits. Tous ces appels sont mappés sur des routeurs LDP L2C. Nous n'avons rien dans notre base de données.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

je comprend pas ce qu'on veut partager au client ici
ca risque juste de l'embrouiller non?

| vpxd | VMware vCenter Server |
| vpostgres | VMware Postgres service |
| vcha | VMware vCenter High Availability service |

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

#bloc a remove fin#

2. Les logs Auth.
3. Les logs Cron.
4. Les logs Réseaux.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

tt ce qui est en dessous doit etre remove c'est faux et on ne souhaite pas donner autant de detail car ca risque de bouger dans le temps et on ne veut pas modifier la doc à chaque fois

#bloc a remove debut#


> [!warning]
>
> Les ressources PCC et LDP doivent appartenir au même compte OVHcloud. Si ce n'est pas le cas, vous aurez ce message d'erreur :

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> Les ressources PCC et LDP doivent appartenir au même compte OVHcloud. Si ce n'est pas le cas, vous aurez ce message d'erreur :
> Les ressources Hosted Private Cloud et LDP doivent appartenir au même compte OVHcloud. Si ce n'est pas le cas, vous aurez ce message d'erreur :

Exemple :

```shell
@api {v1} /dedicatedCloud POST /dedicatedCloud/{serviceName}/syslogForward/forwarder

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

attention ce n'est pas le bon call api
ici on parle uniquement des calls api suivants:
GET /dedicatedCloud/{serviceName}/log/kind
GET /dedicatedCloud/{serviceName}/log/kind/{name}
GET /dedicatedCloud/{serviceName}/log/subscription
POST /dedicatedCloud/{serviceName}/log/subscription
GET /dedicatedCloud/{serviceName}/log/subscription/{subscriptionId}
DEL /dedicatedCloud/{serviceName}/log/subscription/{subscriptionId}


> [!api]
>
> @api {v1} /dedicatedCloud GET /dedicatedCloud/{serviceName}/syslogForward

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pas le bon call api

}
```

Si vous avez réussi l'appel API `POST /dedicatedCloud/{serviceName}/syslogForward/forwarder`{.action}, vous devez avoir l'option Activé.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pas le bon call api


> [!api]
>
> @api {v1} /dedicatedCloud GET /dedicatedCloud/{serviceName}/syslogForward/forwarder

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pas le bon call api


> [!api]
>
> @api {v1} /dedicatedCloud POST /dedicatedCloud/{serviceName}/syslogForward/forwarder/{logForwardId}/changeProperties

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pas le bon call api

>
> **Paramètres** :
>
> **serviceName** : La référence de votre PCC : "pcc-XXX-XXX-XXX-XXX".

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> **serviceName** : La référence de votre PCC : "pcc-XXX-XXX-XXX-XXX".
> **serviceName** : La référence de votre Hosted Private Cloud : "pcc-XXX-XXX-XXX-XXX".

>
> **serviceName** : La référence de votre PCC : "pcc-XXX-XXX-XXX-XXX".
>
> **operationId** : La référence de votre identifiant d'opération DLP : "5a9x1x74-a1f2-4bb7-a41c-e8fd397ee1xx".

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> **operationId** : La référence de votre identifiant d'opération DLP : "5a9x1x74-a1f2-4bb7-a41c-e8fd397ee1xx".
> **operationId** : La référence de votre identifiant d'opération LDP : "5a9x1x74-a1f2-4bb7-a41c-e8fd397ee1xx".

>
> Paramètres:
>
> **serviceName** : La référence de votre PCC : "pcc-XXX.XXX-XXX-XXX".

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> **serviceName** : La référence de votre PCC : "pcc-XXX.XXX-XXX-XXX".
> **serviceName** : La référence de votre Hosted Private Cloud : "pcc-XXX.XXX-XXX-XXX".

> **serviceName** : La référence de votre PCC : "pcc-XXX.XXX-XXX-XXX".
>

### Étape 3 - Obtenez les détails d'un flux de données PCC

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Étape 3 - Obtenez les détails d'un flux de données PCC
### Étape 3 - Obtenez les détails d'un flux de données Hosted Private Cloud

>
> **streamId** : La référence d'identification de votre stream LDP : "caX6a2f5-XXa9-4434-a1xx-XX0809312dca".
>
> **serviceName** : La référence de votre PCC : "pcc-XXX.XXX-XXX-XXX".

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> **serviceName** : La référence de votre PCC : "pcc-XXX.XXX-XXX-XXX".
> **serviceName** : La référence de votre Hosted Private Cloud : "pcc-XXX.XXX-XXX-XXX".


## Aller plus loin

Vous pouvez suivre ces guides qui vous explique comment configurer votre PCC pour faire suivre les logs dans LDP :

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Vous pouvez suivre ces guides qui vous explique comment configurer votre PCC pour faire suivre les logs dans LDP :
Vous pouvez suivre ces guides qui vous explique comment configurer votre Hosted Private Cloud pour faire suivre les logs dans LDP :

>
> **subscriptionId** : La référence de souscription pour votre compte LDP, exemple : "18d30324-x260-5000-81db-a484f4db6y80".
>
> **serviceName** : La référence de votre PCC : "pcc-XXX-XXX-XXX-XXX".

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> **serviceName** : La référence de votre PCC : "pcc-XXX-XXX-XXX-XXX".
> **serviceName** : La référence de votre Hosted Private Cloud : "pcc-XXX-XXX-XXX-XXX".

>
> **Paramètres:**
>
> **serviceName** : La reference de votre PCC : "pcc-XXX-XXX-XXX-XXX".

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> **serviceName** : La reference de votre PCC : "pcc-XXX-XXX-XXX-XXX".
> **serviceName** : La reference de votre Hosted Private Cloud : "pcc-XXX-XXX-XXX-XXX".


Pour un produit Hosted Private Cloud, il est possible d'imaginer 4 types de logs :

1. Les logs Kernel.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

liste des kind pour le moment donc dire que c'est pas forcement exhaustif et ca depend des composants present sur l'infra du client (par ex un client qui a pas le service nsx ne recevra pas de log nsx)
vcsa, esxi , nsx etc ...

@poufpoufpafpaf poufpoufpafpaf marked this pull request as ready for review June 4, 2024 11:47
@pg-ovh pg-ovh closed this Jun 4, 2024
@pg-ovh
Copy link
Contributor Author

pg-ovh commented Jun 4, 2024

@maisonaute @poufpoufpafpaf you can check PR : #6403
I have taken in consideration your past reviews, thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Guide creation The Pull Request contains at least 1 new guide (meta.yaml and index edition needed)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet