> 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 du Log Analytics Workspace Azure
## Vue d'ensemble
Le Portail RealmJoin peut afficher des problèmes potentiels avec les mises à jour Windows, comme [Blocages SafeGuard de Windows Update](https://docs.microsoft.com/en-us/windows/deployment/update/safeguard-holds) en s'intégrant à [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview).
De plus, le Portail RealmJoin utilisera Log Analytics pour stocker les informations des journaux d'audit et archiver les données d'exécution des Runbooks au-delà des limites par défaut d'Azure Automation (actuellement 30 jours).
## Composants
### Inscription d'application Azure
RealmJoin interagira avec les deux espaces de travail Log Analytics via une [inscription d'application Entra ID](https://docs.microsoft.com/en-us/azure/active-directory/develop/app-objects-and-service-principals).
{% hint style="info" %}
Vous pouvez réutiliser l'App Registration « RealmJoin Runbook Management » qui est créée lorsque [les runbooks d'intégration](/fr/automatisation/connecting-azure-automation.md).
{% endhint %}
Cette application sera authentifiée à l'aide d'un ClientId et d'un ClientSecret. L'utilisation d'un certificat ou d'une identité managée n'est actuellement pas prise en charge.
Veuillez accorder à l'application "**Lecteur de surveillance**" des autorisations sur les comptes Log Analytics utilisés pour [Intégration de Windows Update for Business Reports](#windows-update-for-business-reports-integration) et "**Contributeur de surveillance**" pour les [journaux d'audit RealmJoin](#realmjoin-audit-logs) compte Log Analytics.
RealmJoin utilisera également le [clé de l'espace de travail client](#customer-workspace-key) pour écrire les données directement dans [Journaux d'audit RealmJoin](#realmjoin-audit-logs).
### Intégration de Windows Update for Business Reports
[Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) doit être configuré dans votre environnement afin de pouvoir exploiter cette fonctionnalité. Il écrira les événements liés aux mises à jour dans un [Azure Log Analytics Workspace](https://docs.microsoft.com/en-us/azure/azure-monitor/logs/log-analytics-overview). RealmJoin peut lire les événements de ce Log Analytics Workspace et les afficher sur la[ page de détails de l'appareil](/fr/ugd-management/user-list/device-details.md).
{% hint style="info" %}
Vous pouvez utiliser le même compte Log Analytics pour les deux [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) et [Journaux d'audit RealmJoin](#realmjoin-audit-logs). Veuillez attribuer "**Contributeur de surveillance**" des autorisations dans ce cas.
{% endhint %}
### Journaux d'audit RealmJoin
RealmJoin peut utiliser un espace de travail Log Analytics pour stocker ses propres journaux d'audit ainsi qu'archiver les journaux de runbooks après la durée de rétention maximale dans Azure Automation (actuellement 30 jours).
Veuillez noter que, pour stocker les journaux pendant plus de 30 jours, vous devrez modifier le [la rétention de données par défaut de l'espace de travail](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/data-retention-archive?tabs=portal-1%2Cportal-2), qui est également définie sur 30 jours par défaut.
## Configuration
### Partie 1 - Authentification à l'aide d'une inscription d'application Azure
1. Dans l'Azure Portal, accédez à Microsoft Entra ID > Gérer > Inscriptions d'applications.
2. Sélectionnez l'onglet Toutes les applications.
3. Choisissez votre prochaine étape.
{% tabs %}
{% tab title="Intégration Runbook existante" %}
Si vous avez déjà [intégré Azure Runbooks](/fr/automatisation/connecting-azure-automation.md), vous pouvez réutiliser votre inscription d'application existante.
1. Sélectionnez l'inscription d'application « RealmJoin Runbooks Management ».
2. Accédez à Gérer > Certificats et secrets.
3. Sélectionnez l'onglet « Secrets client ».
4. Créez un nouveau secret client.
* Définissez la description et la date d'expiration conformément à vos politiques internes de nommage et de sécurité.
{% endtab %}
{% tab title="Nouvelle inscription d'application" %}
Si vous n'avez pas intégré de runbooks ou préférez une inscription d'application distincte, procédez comme suit :
1. Sélectionnez « Nouvelle inscription »
2. Indiquez un nom
3. Enregistrez l'application
4. Sélectionnez l'application
5. Accédez à Gérer > Certificats et secrets
6. Sélectionnez l'onglet « Secrets client »
7. Créez un nouveau secret client
* Définissez la description et la date d'expiration conformément à vos politiques internes de nommage et de sécurité
{% endtab %}
{% endtabs %}
8. Notez en toute sécurité la valeur du secret à utiliser dans [Partie 5](#part-4-connecting-realmjoin-and-azure-log-analytics-workspace).
{% hint style="warning" %}
Quitter la page Certificats et secrets provoquera l'obfuscation du secret par Azure. Le secret ne pourra pas être récupéré et un nouveau secret devra être créé.
{% endhint %}
### Partie 2 - Création d'un Log Analytics Workspace
1. Dans l'Azure Portal, accédez à Log Analytics Workspace
2. Sélectionnez Créer
3. Indiquez un groupe de ressources, un nom et une région selon les besoins
4. Accédez à l'onglet « Vue d'ensemble »
5. Notez ce qui suit pour [Partie 5](#part-5-connecting-realmjoin-and-azure-log-analytics-workspace)
1. Nom du groupe de ressources
2. Nom de l'espace de travail
3. ID de l'espace de travail
### Partie 3 - Activation de Windows Update for Business Reports
1. Dans l'Azure Portal, accédez à Monitor > Workbooks
2. Recherchez « Windows Update for Business reports »
3. Définissez votre abonnement et l'espace de travail créé précédemment. Si un espace de travail séparé est préféré pour les journaux RealmJoin et les rapports Windows Update for Business, créez plutôt un espace de travail séparé et reliez-le.\
4. Enregistrer les paramètres
{% hint style="warning" %}
L'application des rapports Windows Update for Business peut prendre jusqu'à 24 heures
{% endhint %}
### Partie 4 - Autorisations Azure
1. Accédez à l'abonnement dans lequel se trouve votre Log Analytics Workspace
2. Sélectionnez Contrôle d'accès (IAM)
3. Ajoutez une attribution de rôle
4. Attribuez à votre inscription d'application les autorisations du rôle Contributeur de surveillance
5. Vérifiez et enregistrez l'attribution de rôle
### Partie 5 - Connexion de RealmJoin et d'Azure Log Analytics Workspace
Page des paramètres Log Analytics
1. Dans le Portail RealmJoin, accédez à Paramètres  > Log Analytics
2. Renseignez les champs :\
Détails du Tenant
* **TenantId :** Veuillez fournir l'ID de votre Tenant Entra ID. Vous le trouverez sur la page Vue d'ensemble d'Entra ID.
Détails de l'inscription d'application Azure
* **ClientId :** RealmJoin interagira avec l'espace de travail LogAnalytics via une [Inscription d'application Azure](#azure-app-registration). Veuillez fournir le ClientId/AppId et le Secret de l'application, afin que RealmJoin puisse s'authentifier.
* **ClientSecret :** Utilisé avec le ClientId pour fournir l'accès à RealmJoin. Il s'agit du secret créé dans [Partie 1](#part-1-authentication-using-azure-app-registration).
Détails de l'espace de travail Windows Update for Business
* **ID de l'espace de travail Update Compliance :** Veuillez fournir l' [Windows Update for Business Reports](#windows-update-for-business-reports-integration) ID du Log Analytics Workspace à partir duquel collecter les données.
Détails de l'espace de travail
* **ID de l'abonnement :** Veuillez fournir l'ID de l'abonnement du [Journaux d'audit RealmJoin](#realmjoin-audit-logs) compte Log Analytics. L'ID de l'abonnement est visible sur la page Vue d'ensemble de l'abonnement.
* **Groupe de ressources**: Veuillez fournir le nom du groupe de ressources du [Journaux d'audit RealmJoin](#realmjoin-audit-logs) compte Log Analytics.
* **Nom de l'espace de travail :** Veuillez fournir le nom de l'espace de travail du [Journaux d'audit RealmJoin](#realmjoin-audit-logs) compte Log Analytics.
* **ID de l'espace de travail client :** Veuillez fournir / créer un espace de travail Log Analytics pour stocker [les données des journaux d'audit RealmJoin et des journaux de runbook](#realmjoin-audit-logs).
* **Clé de l'espace de travail client :** RealmJoin agira comme agent pour Log Analytics. Veuillez fournir la « clé primaire » de cet espace de travail afin d'autoriser l'écriture de données dans l'espace de travail.
* La « clé primaire » peut être obtenue de différentes manières :
* [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`
* [PowerShell](https://learn.microsoft.com/en-us/powershell/module/az.operationalinsights/get-azoperationalinsightsworkspacesharedkey?view=azps-14.6.0):\
`Get-AzOperationalInsightsWorkspaceSharedKey -ResourceGroupName "MyResourceGroup" -Name "MyWorkspace"`
* [API REST](https://learn.microsoft.com/en-us/rest/api/loganalytics/shared-keys/get-shared-keys?view=rest-loganalytics-2025-07-01\&tabs=HTTP):\
`POST https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/sharedKeys?api-version=2025-07-01`
3. Cliquez sur **Enregistrer** après avoir rempli tous les champs. Le système vous donnera un retour si tout a fonctionné.
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.realmjoin.com/fr/supervision-et-journaux/log-analytics.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.