> 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/de/uberwachung-and-protokolle/log-analytics.md). # Verbinden des Azure Log Analytics Workspace ## Überblick Das RealmJoin Portal kann mögliche Probleme mit Windows-Updates anzeigen, wie [Windows Update SafeGuard Holds](https://docs.microsoft.com/en-us/windows/deployment/update/safeguard-holds) durch die Integration mit [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview). Außerdem wird das RealmJoin Portal Log Analytics verwenden, um Informationen zum Audit-Log zu speichern und Runbook-Ausführungsdaten über die Standardgrenzen von Azure Automation hinaus zu archivieren (derzeit 30 Tage). ## Komponenten ### Azure-App-Registrierung RealmJoin wird mit beiden Log Analytics-Arbeitsbereichen über eine [Entra ID-Anwendungsregistrierung](https://docs.microsoft.com/en-us/azure/active-directory/develop/app-objects-and-service-principals). {% hint style="info" %} Sie können die App-Registrierung „RealmJoin Runbook Management“ wiederverwenden, die erstellt wird, wenn [Onboarding-Runbooks](/de/automatisierung/connecting-azure-automation.md). {% endhint %} Diese App wird mithilfe einer ClientId und eines ClientSecret authentifiziert. Die Verwendung eines Zertifikats oder einer Managed Identity wird derzeit nicht unterstützt. Bitte gewähren Sie der App "**Monitoring Reader**" Berechtigungen für die Log Analytics-Konten, die für [Windows Update for Business Reports Integration](#windows-update-for-business-reports-integration) und "**Monitoring Contributor**" für die [RealmJoin-Audit-Logs](#realmjoin-audit-logs) Log Analytics-Konto. RealmJoin wird außerdem den [Customer Workspace Key](#customer-workspace-key) verwenden, um Daten direkt in [RealmJoin Audit Logs](#realmjoin-audit-logs). ### Windows Update for Business Reports Integration [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) muss in Ihrer Umgebung konfiguriert werden, um diese Funktion zu nutzen. Es schreibt updatebezogene Ereignisse in ein [Azure Log Analytics Workspace](https://docs.microsoft.com/en-us/azure/azure-monitor/logs/log-analytics-overview). RealmJoin kann die Ereignisse aus diesem Log Analytics Workspace lesen und sie auf der[ Detailseite des Geräts](/de/ugd-management/user-list/device-details.md). {% hint style="info" %} Sie können dasselbe Log Analytics-Konto für beide verwenden [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) und [RealmJoin Audit Logs](#realmjoin-audit-logs). Bitte weisen Sie in diesem Fall "**Monitoring Contributor**" Berechtigungen zu. {% endhint %} ### RealmJoin Audit Logs RealmJoin kann einen Log Analytics Workspace verwenden, um seine eigenen Audit-Logs zu speichern und Runbook-Logs nach der maximalen Aufbewahrungszeit in Azure Automation zu archivieren (derzeit 30 Tage). Bitte beachten Sie: Um Protokolle länger als 30 Tage zu speichern, müssen Sie die [standardmäßige Datenaufbewahrung des Workspaces](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/data-retention-archive?tabs=portal-1%2Cportal-2)ändern, die standardmäßig ebenfalls auf 30 Tage festgelegt ist. ## Einrichtung ### Teil 1 - Authentifizierung mit Azure App Registration 1. Navigieren Sie im Azure Portal zu Microsoft Entra ID > Verwalten > App Registrations. 2. Wählen Sie die Registerkarte Alle Anwendungen aus. 3. Wählen Sie Ihren nächsten Schritt. {% tabs %} {% tab title="Bestehende Runbook-Integration" %} Wenn Sie bereits [mit Azure Runbooks integriert haben](/de/automatisierung/connecting-azure-automation.md), können Sie Ihre vorhandene App Registration wiederverwenden. 1. Wählen Sie die App Registration „RealmJoin Runbooks Management“ aus. 2. Navigieren Sie zu Verwalten > Zertifikate & Geheimnisse. 3. Wählen Sie den Tab „Client Secrets“ aus. 4. Erstellen Sie ein neues Client Secret. * Legen Sie Beschreibung und Ablauf gemäß Ihren internen Benennungs- und Sicherheitsrichtlinien fest. {% endtab %} {% tab title="Neue App Registration" %} Wenn Sie keine Runbooks integriert haben oder eine separate App Registration bevorzugen, gehen Sie wie folgt vor: 1. Wählen Sie „New Registration“ aus. 2. Geben Sie einen Namen an.
3. Registrieren Sie die Anwendung. 4. Wählen Sie die Anwendung aus. 5. Navigieren Sie zu Verwalten > Zertifikate & Geheimnisse. 6. Wählen Sie den Tab „Client Secrets“ aus. 7. Erstellen Sie ein neues Client Secret. * Legen Sie Beschreibung und Ablauf gemäß Ihren internen Benennungs- und Sicherheitsrichtlinien fest. {% endtab %} {% endtabs %} 8. Notieren Sie den Geheimniswert sicher für die Verwendung in [Teil 5](#part-4-connecting-realmjoin-and-azure-log-analytics-workspace). {% hint style="warning" %} Wenn Sie die Seite „Certificates & Secrets“ verlassen, wird Azure das Geheimnis unkenntlich machen. Das Geheimnis kann dann nicht mehr abgerufen werden, und es muss ein neues Geheimnis erstellt werden. {% endhint %} ### Teil 2 - Erstellen eines Log Analytics Workspace 1. Navigieren Sie im Azure Portal zu Log Analytics Workspace 2. Wählen Sie Erstellen aus. 3. Geben Sie bei Bedarf eine Ressourcengruppe, einen Namen und eine Region an. 4. Navigieren Sie zur Registerkarte „Übersicht“. 5. Notieren Sie Folgendes für [Teil 5](#part-5-connecting-realmjoin-and-azure-log-analytics-workspace) 1. Name der Ressourcengruppe 2. Name des Workspaces 3. Workspace-ID ### Teil 3 - Aktivieren von Windows Update for Business Reports 1. Navigieren Sie im Azure Portal zu Monitor > Workbooks 2. Suchen Sie nach „Windows Update for Business reports“
3. Wählen Sie Ihr Abonnement und den zuvor erstellten Workspace aus. Wenn für RealmJoin-Logs und Windows Update for Business reports ein separater Workspace bevorzugt wird, erstellen Sie stattdessen einen separaten Workspace und verknüpfen Sie ihn.\ ![](/files/987e1158aa68f6479624f468205285928fbf9c55) 4. Einstellungen speichern {% hint style="warning" %} Die Anwendung von Windows Update for Business reports kann bis zu 24 Stunden dauern {% endhint %} ### Teil 4 - Azure-Berechtigungen 1. Navigieren Sie zu dem Abonnement, in dem sich Ihr Log Analytics Workspace befindet 2. Wählen Sie Zugriffssteuerung (IAM) aus. 3. Fügen Sie eine Rollenzuweisung hinzu. 4. Weisen Sie Ihrer App Registration Berechtigungen als Monitoring Contributor zu.
5. Überprüfen und speichern Sie die Rollenzuweisung. ### Teil 5 - Verbindung von RealmJoin und Azure Log Analytics Workspace

Seite mit den Log-Analytics-Einstellungen

1. Navigieren Sie im RealmJoin Portal zu Einstellungen ![](/files/a8bc73484532623be3836ec67f21a6e597053155) > Log Analytics 2. Füllen Sie die Felder aus:\ Tenant-Details * **TenantId:** Bitte geben Sie die Tenant-ID Ihres Entra ID an. Sie finden diese auf der Entra ID-Übersichtsseite.
Details zur Azure App Registration * **ClientId:** RealmJoin wird mit dem LogAnalytics-Workspace über eine [Azure-App-Registrierung](#azure-app-registration). Bitte geben Sie die ClientId/AppId und das Secret der App an, damit RealmJoin sich authentifizieren kann.
* **ClientSecret:** Wird zusammen mit der ClientId verwendet, um den Zugriff auf RealmJoin zu ermöglichen. Dies ist das Geheimnis, das in [Teil 1](#part-1-authentication-using-azure-app-registration).
Details zum Windows Update for Business Workspace * **Update Compliance Workspace ID:** Bitte geben Sie die [Windows Update for Business Reports](#windows-update-for-business-reports-integration) ID des Log Analytics Workspace an, aus dem Daten gesammelt werden sollen. Workspace-Details * **Abonnement-ID:** Bitte geben Sie die Abonnement-ID aus dem [RealmJoin Audit Logs](#realmjoin-audit-logs) Log Analytics-Konto an. Die Abonnement-ID ist auf der Übersichtsseite des Abonnements sichtbar. * **Ressourcengruppe**: Bitte geben Sie den Namen der Ressourcengruppe aus dem [RealmJoin Audit Logs](#realmjoin-audit-logs) Log Analytics-Konto. * **Workspace-Name:** Bitte geben Sie den Workspace-Namen aus dem [RealmJoin Audit Logs](#realmjoin-audit-logs) Log Analytics-Konto. * **Customer Workspace ID:** Bitte stellen Sie einen Log Analytics-Workspace bereit / erstellen Sie einen, um [RealmJoin-Audit-Log- und Runbook-Protokolldaten](#realmjoin-audit-logs).
* **Customer Workspace Key:** RealmJoin fungiert als Agent für Log Analytics. Bitte geben Sie den „Primary Key“ dieses Workspaces an, damit Daten in den Workspace geschrieben werden können. * Der „Primary Key“ kann auf verschiedene Arten abgerufen werden: * [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"` * [REST API](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. Drücken Sie **Speichern** nachdem Sie alle Felder ausgefüllt haben. Das System gibt Ihnen eine Rückmeldung, wenn alles funktioniert hat. --- # 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/de/uberwachung-and-protokolle/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.