> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/fr/supervision-et-journaux/log-analytics.md).

# Connexion au Log Analytics Workspace Azure

Connectez un Log Analytics Workspace Azure au portail RealmJoin avec le module PowerShell RealmJoin afin de stocker les journaux d’audit, d’exploitation et de runbook dans votre propre Tenant.

## Aperçu

Le portail RealmJoin peut utiliser un espace de travail Log Analytics dans votre propre abonnement Azure pour stocker

* son **journal d'audit** — chaque action effectuée dans le portail, voir [le journal d’audit](https://docs.realmjoin.com/fr/supervision-et-journaux/audit-log.md)
* son **journaux d'exploitation**
* **journaux de runbook**, archivés au-delà de la rétention maximale d'Azure Automation (actuellement 30 jours)

L'espace de travail est configuré avec le [module PowerShell RealmJoin](https://docs.realmjoin.com/fr/deploiement/onboarding-realmjoin-portal/advanced-setup.md). Le portail génère pour vous une commande prête à copier — rien n'est à saisir manuellement.

{% hint style="info" %}
Log Analytics est-il déjà configuré pour votre Tenant et utilise-t-il l'API Data Collector obsolète ? Alors suivez [la migration vers l'API Log Ingestion](https://docs.realmjoin.com/fr/supervision-et-journaux/log-ingestion-api-migration.md) à la place — elle réutilise votre espace de travail existant et conserve vos journaux existants.
{% endhint %}

## Composants

RealmJoin écrit ses journaux via Azure Monitor **API d’ingestion des journaux**, basé sur [Règles de collecte de données (DCRs)](https://learn.microsoft.com/en-us/azure/azure-monitor/essentials/data-collection-rule-overview) et l'authentification Microsoft Entra ID. L'exécution de la commande de configuration crée :

* Le **Ressources Azure RealmJoin** service principal dans votre tenant Entra ID (s’il n’existe pas encore)
* Une **espace de travail Log Analytics** dans le groupe de ressources que vous choisissez — ou votre espace de travail existant, si vous en indiquez un
* Trois tables personnalisées dans cet espace de travail : `RJAuditLogs_CL`, `RJOperationalLogs_CL`, `RJRunbookLogs_CL`
* Une règle de collecte de données par table (`dcr-rj-aud-logs-*`, `dcr-rj-op-logs-*`, `dcr-rj-rb-logs-*`), chacune avec son propre point de terminaison d’ingestion direct
* Exactement deux types d’attribution de rôle pour RealmJoin, et rien d’autre :
  * **Log Analytics Reader** sur l’espace de travail, afin que le portail puisse interroger vos journaux
  * **Monitoring Metrics Publisher** sur chacune des trois règles de collecte de données, afin que RealmJoin puisse y écrire

RealmJoin ne reçoit aucune autre autorisation dans votre abonnement. Aucune inscription d'application, aucun secret client et aucune clé partagée d'espace de travail n'interviennent. Le déploiement est idempotent — relancer la même commande est sans danger et n'applique que ce qui manque.

## Prérequis

### Dans le portail RealmJoin

* Un rôle qui donne accès à la zone Paramètres (`CanReadSettingsDetails`, voir [Autorisations disponibles](https://docs.realmjoin.com/fr/administration-et-parametres/permission/custom-roles/available-permissions.md)). La page des paramètres génère la commande de configuration avec un jeton d'intégration à durée de vie courte.

### Dans Azure

* Un abonnement Azure et un **groupe de ressources existant** dans lequel déployer — le module ne crée pas le groupe de ressources
* Éventuellement un espace de travail Log Analytics existant. Si vous n'en indiquez pas un, un espace de travail est créé pour vous dans la région du groupe de ressources.

### Sur la machine qui exécute PowerShell

* **PowerShell 5.1** ou version ultérieure (Windows PowerShell ou PowerShell 7)
* Accès à la [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) pour installer le module RealmJoin
* Le `Az.Accounts`, `Az.Resources` et `Az.Automation` modules — le module RealmJoin les installe automatiquement dans les versions épinglées, pour l’utilisateur actuel

### Autorisations du compte avec lequel vous vous connectez

* **Microsoft Entra ID:** autorisation de créer des service principals, par exemple *Application Administrator*, *Cloud Application Administrator* ou *Global Administrator*. Nécessaire uniquement la première fois, lorsque le service principal RealmJoin Azure Resources n’existe pas encore.
* **Abonnement Azure :** autorisation de déployer dans le groupe de ressources **et** pour y créer des attributions de rôle — par exemple *Owner*, ou *Contributor* combiné avec *User Access Administrator* / *Role Based Access Control Administrator*.
* La connexion s’effectue via `Connect-AzAccount`, qui utilise l’ **Azure PowerShell** application native. Les tenants qui restreignent le consentement des utilisateurs peuvent devoir accorder d’abord le consentement administrateur à cette application.

{% hint style="warning" %}
Exécutez la commande dans un **fraîchement ouvert, local** session PowerShell et évitez **Azure Cloud Shell**. Le module RealmJoin nécessite les versions exactes des `modules Az.*` modules. Si une autre version est déjà chargée dans la session — ce qui est généralement le cas dans Cloud Shell — le module s'arrête avec un conflit de version qui ne peut être résolu qu'en ouvrant une nouvelle session.
{% endhint %}

## Configuration

{% stepper %}
{% step %}

#### Préparez le groupe de ressources

Dans Azure Portal, créez ou choisissez le groupe de ressources qui doit contenir l'espace de travail. Notez son nom et l'ID de l'abonnement auquel il appartient.

Si vous souhaitez utiliser un **existant** espace de travail Log Analytics, notez également son nom.
{% endstep %}

{% step %}

#### Copiez la commande depuis le portail RealmJoin

Dans le portail RealmJoin, accédez à **Paramètres → Log Analytics** (<https://portal.realmjoin.com/settings/log-analytics-configuration>).

La page indique que Log Analytics est géré via le module PowerShell RealmJoin et affiche un bloc de commande. Utilisez le **Copier** bouton pour le copier.

```powershell
$latest = [version](Find-Module RealmJoin -Repository PSGallery -ErrorAction Stop).Version
if (-not (Get-Module -ListAvailable RealmJoin | Where-Object Version -ge $latest)) {
    Install-Module RealmJoin -Force -AllowClobber -ErrorAction Stop
}
Import-Module RealmJoin -Force
Set-RJLogAnalyticsWorkspace -Token "<Token>" 6>&1
```

Les premières lignes installent ou mettent à jour le module RealmJoin et l’importent. `Set-RJLogAnalyticsWorkspace` effectue le déploiement et enregistre le résultat auprès de RealmJoin à l'aide du `-Token`.

{% hint style="info" %}
**À propos `6>&1`:** ces commandes signalent leur progression sur le flux d’informations de PowerShell. La `6>&1` redirection affiche cette sortie dans la console — sans elle, vous ne verrez aucun message de progression.
{% endhint %}
{% endstep %}

{% step %}

#### Ajoutez les paramètres cibles

`Set-RJLogAnalyticsWorkspace` doit savoir où déployer. Complétez la dernière ligne avant de l'exécuter :

```powershell
Set-RJLogAnalyticsWorkspace -ResourceGroupName "rg-realmjoin" -SubscriptionId "<SubscriptionId>" -Token "<Token>" 6>&1
```

* `-ResourceGroupName` est requis. Si vous l'omettez, PowerShell vous le demandera.
* `-SubscriptionId` est facultatif — sans lui, l'abonnement de votre contexte Azure actuel est utilisé, et il vous est demandé d'en choisir un si plusieurs sont disponibles.
* `-WorkspaceName` est facultatif. Passez-le pour définir le nom d'un nouvel espace de travail ou pour utiliser un **existant** espace de travail ; sinon, un nouveau est créé avec un nom généré.
  {% endstep %}

{% step %}

#### Exécutez la commande

Collez le bloc dans une nouvelle session PowerShell et exécutez-le. Le jeton est valable pendant environ une heure — s’il a expiré, rechargez la page des paramètres et recopiez la commande.

Vous serez invité à vous connecter avec `Connect-AzAccount`.

Le déploiement signale ensuite chaque ressource au fur et à mesure de sa création : le Service Principal, l'espace de travail, les tables personnalisées, les règles de collecte de données et les attributions de rôle. Une exécution prend généralement quelques minutes.

{% hint style="info" %}
Vous voulez voir ce qui se passerait d’abord ? Ajoutez `-WhatIf` pour un aperçu What-If d’Azure Resource Manager. Notez que la connexion et l’installation des `module Az` modules ont tout de même lieu, car l’aperçu a besoin des deux.
{% endhint %}

{% hint style="info" %}
**Se déconnecter ensuite :** la connexion Azure reste active une fois la commande terminée. Une fois que vous avez terminé, exécutez `Disconnect-AzAccount` pour vous déconnecter de la session existante.
{% endhint %}
{% endstep %}

{% step %}

#### Vérifiez dans le portail

Revenez à **Paramètres → Log Analytics** et sélectionnez **Actualiser**.

La page affiche désormais l'abonnement, le groupe de ressources, le nom de l'espace de travail, l'ID de l'espace de travail client et l'ID du Tenant sous forme de champs en lecture seule — ces paramètres sont désormais gérés par le module PowerShell. Sous **Avancé** vous pouvez consulter les points de terminaison, les noms de règles et les noms de flux des trois règles de collecte de données.

Sélectionnez **Vérifier les problèmes de configuration** pour vérifier que toutes les autorisations Azure requises sont en place sur l’espace de travail et sur chaque règle de collecte de données.

Ensuite, ouvrez le [le journal d’audit](https://docs.realmjoin.com/fr/supervision-et-journaux/audit-log.md) ou de la [journaux de runbook](https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-logs.md) et confirmez que des entrées apparaissent. Azure a besoin de quelques minutes pour rendre disponibles les nouvelles tables personnalisées créées.
{% endstep %}
{% endstepper %}

## Conservation des données

{% hint style="warning" %}
Pour conserver les journaux plus de 30 jours, ajustez la [rétention des données de l'espace de travail](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/data-retention-archive?tabs=portal-1%2Cportal-2) dans Azure. La valeur par défaut de l'espace de travail et la rétention d'Azure Automation sont toutes deux de 30 jours.
{% endhint %}

## Maintenir le schéma à jour

Si RealmJoin étend le schéma des journaux dans une future version, la page Paramètres affiche un avis indiquant que le schéma Log Analytics déployé n’est plus à jour, ainsi que la commande pour le mettre à jour. C’est la **même** `Set-RJLogAnalyticsWorkspace` commande — exécutez-la de nouveau et les tables et les règles sont mises à jour sur place.

## Configuration héritée (API Data Collector)

{% hint style="danger" %}
La configuration ci-dessous utilise Azure Monitor **API HTTP Data Collector**, dont Microsoft met fin au support le **14 septembre 2026**. Elle est documentée uniquement à titre de référence pour les tenants qui ont été configurés de cette façon par le passé. Ne l'utilisez pas pour de nouvelles configurations — suivez la [Configuration](#setup) ci-dessus, ou [migrer une configuration existante](https://docs.realmjoin.com/fr/supervision-et-journaux/log-ingestion-api-migration.md).
{% endhint %}

<details>

<summary>Afficher la configuration héritée</summary>

Dans ce mode, RealmJoin s'authentifiait avec une inscription d'application Entra ID détenue par le client et la clé partagée de l'espace de travail, et écrivait dans les tables `AuditLogs_CL`, `OperationalLogs_CL` et `RunbookLogs_CL`.

**Partie 1 — Authentification à l'aide d'une inscription d'application Azure**

1. Dans Azure Portal, accédez à Microsoft Entra ID > Gérer > Inscriptions d'applications.
2. Sélectionnez l'onglet Toutes les applications.
3. Réutilisez soit l'inscription d'application « RealmJoin Runbooks Management » créée lorsque [les runbooks d'intégration](https://docs.realmjoin.com/fr/automatisation/connecting-azure-automation.md), soit sélectionnez « New Registration » et enregistrez une nouvelle application.
4. Dans l'application, accédez à Gérer > Certificats et secrets, sélectionnez l'onglet « Client Secrets » et créez un nouveau secret client. Définissez la description et l'expiration selon vos politiques internes de nommage et de sécurité.
5. Notez la valeur du secret en lieu sûr — quitter la page entraîne son masquage par Azure, et il faut créer un nouveau secret.

**Partie 2 — Création d'un espace de travail Log Analytics**

1. Dans Azure Portal, accédez à Log Analytics Workspace et sélectionnez Créer.
2. Renseignez un groupe de ressources, un nom et une région comme requis.
3. Dans l'onglet « Overview », notez le nom du groupe de ressources, le nom de l'espace de travail et l'ID de l'espace de travail.

**Partie 3 — Autorisations Azure**

1. Accédez à l'abonnement dans lequel se trouve votre espace de travail Log Analytics.
2. Sélectionnez Contrôle d'accès (IAM) et ajoutez une attribution de rôle.
3. Accordez à votre inscription d'application **Contributeur de surveillance** sur l'espace de travail utilisé pour les journaux RealmJoin.
4. Vérifiez et enregistrez l'attribution de rôle.

**Partie 4 — Connexion de RealmJoin et de l'espace de travail**

Dans le portail RealmJoin, accédez à Paramètres > Log Analytics et remplissez les champs :

* **TenantId** — votre ID de tenant Entra ID, depuis la page Vue d'ensemble d'Entra ID
* **ClientId** et **ClientSecret** — l'inscription d'application de la partie 1
* **ID d'abonnement**, **Groupe de ressources** et **Nom de l'espace de travail** — de l'espace de travail de la partie 2
* **ID de l'espace de travail client** — l'ID de l'espace de travail qui stocke les données des journaux d'audit et de runbook de RealmJoin
* **Clé de l'espace de travail client** — la « clé primaire » de l'espace de travail, qui permet à RealmJoin d'écrire des données. Elle peut être récupérée avec [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/monitor/log-analytics/workspace?view=azure-cli-latest#az-monitor-log-analytics-workspace-get-shared-keys) (`az monitor log-analytics workspace get-shared-keys --resource-group MyResourceGroup --workspace-name MyWorkspace`) ou avec [PowerShell](https://learn.microsoft.com/en-us/powershell/module/az.operationalinsights/get-azoperationalinsightsworkspacesharedkey?view=azps-14.6.0) (`Get-AzOperationalInsightsWorkspaceSharedKey -ResourceGroupName "MyResourceGroup" -Name "MyWorkspace"`).

Appuyez sur **Enregistrer** une fois tous les champs renseignés. Le système vous indique si tout a fonctionné.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/fr/supervision-et-journaux/log-analytics.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
