> 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 von Azure Log Analytics Workspace Verbinden Sie einen Azure Log Analytics Workspace mit dem RealmJoin-Portal über das RealmJoin-PowerShell-Modul, um Prüfungs-, Betriebs- und Runbook-Protokolle in Ihrem eigenen Tenant zu speichern. ## Übersicht RealmJoin Portal kann einen Log-Analytics-Arbeitsbereich in Ihrem eigenen Azure-Abonnement verwenden, um * seine **Auditprotokoll** — jede im Portal ausgeführte Aktion, siehe [Audit Log](/de/uberwachung-and-protokolle/audit-log.md) * seine **Betriebsprotokolle** * **Runbook-Protokolle**, über die maximale Aufbewahrungszeit von Azure Automation hinaus archiviert (derzeit 30 Tage) Zusätzlich kann RealmJoin [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) Daten aus einem Log-Analytics-Arbeitsbereich lesen, um mögliche Probleme mit Windows-Updates anzuzeigen, wie etwa [Windows Update-Schutzsperren](https://docs.microsoft.com/en-us/windows/deployment/update/safeguard-holds), auf der [Detailseite des Geräts](/de/ugd-management/user-list/device-details.md). Siehe [Windows Update for Business Reports](#windows-update-for-business-reports). Der Arbeitsbereich wird mit dem [RealmJoin PowerShell-Modul](/de/bereitstellung/onboarding-realmjoin-portal/advanced-setup.md). Das Portal generiert einen sofort kopierbaren Befehl für Sie — es muss nichts von Hand ausgefüllt werden. {% hint style="info" %} Ist Log Analytics bereits für Ihren Tenant konfiguriert und verwendet die veraltete Data Collector API? Dann folgen Sie [Migration zur Log Ingestion API](/de/uberwachung-and-protokolle/log-ingestion-api-migration.md) stattdessen — sie verwendet Ihren vorhandenen Arbeitsbereich erneut und behält Ihre vorhandenen Protokolle bei. {% endhint %} ## Komponenten RealmJoin schreibt seine Protokolle über die Azure Monitor **Logs Ingestion API**, basierend auf [Data Collection Rules (DCRs)](https://learn.microsoft.com/en-us/azure/azure-monitor/essentials/data-collection-rule-overview) und Microsoft Entra ID-Authentifizierung. Beim Ausführen des Setup-Befehls werden erstellt: * Der **RealmJoin Azure Resources** Service Principal in Ihrem Entra ID-Tenant (falls er noch nicht existiert) * Ein **Log Analytics Workspace** in der von Ihnen gewählten Ressourcengruppe — oder Ihr vorhandener Arbeitsbereich, wenn Sie einen angeben * Drei benutzerdefinierte Tabellen in diesem Arbeitsbereich: `RJAuditLogs_CL`, `RJOperationalLogs_CL`, `RJRunbookLogs_CL` * Eine Data Collection Rule pro Tabelle (`dcr-rj-aud-logs-*`, `dcr-rj-op-logs-*`, `dcr-rj-rb-logs-*`), jeweils mit einem eigenen direkten Ingestion-Endpunkt * Genau zwei Arten von Rollenzuweisungen für RealmJoin, und nichts darüber hinaus: * **Log Analytics Reader** im Arbeitsbereich, damit das Portal Ihre Protokolle abfragen kann * **Monitoring Metrics Publisher** für jede der drei Data Collection Rules, damit RealmJoin darauf schreiben kann RealmJoin erhält keine weiteren Berechtigungen in Ihrem Abonnement. Es sind keine App-Registrierung, kein Client Secret und kein freigegebener Schlüssel des Arbeitsbereichs beteiligt. Die Bereitstellung ist idempotent — das erneute Ausführen desselben Befehls ist sicher und wendet nur das an, was fehlt. ## Voraussetzungen ### Im RealmJoin Portal * Eine Rolle, die Zugriff auf den Einstellungsbereich gewährt (`CanReadSettingsDetails`, siehe [Verfügbare Berechtigungen](/de/administration-and-einstellungen/permission/custom-roles/available-permissions.md)). Die Einstellungsseite generiert den Setup-Befehl einschließlich eines kurzlebigen Onboarding-Tokens. ### In Azure * Ein Azure-Abonnement und eine **vorhandene Ressourcengruppe** zum Bereitstellen — das Modul erstellt die Ressourcengruppe nicht * Optional ein vorhandener Log-Analytics-Arbeitsbereich. Wenn Sie keinen angeben, wird in der Region der Ressourcengruppe ein Arbeitsbereich für Sie erstellt. ### Auf dem Computer, auf dem PowerShell ausgeführt wird * **PowerShell 5.1** oder höher (Windows PowerShell oder PowerShell 7) * Zugriff auf die [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) um das RealmJoin-Modul zu installieren * Der `Az.Accounts`, `Az.Resources` und `Az.Automation` Module — das RealmJoin-Modul installiert sie automatisch in den fest definierten Versionen für den aktuellen Benutzer ### Berechtigungen des Kontos, mit dem Sie sich anmelden * **Microsoft Entra ID:** Berechtigung zum Erstellen von Service Principals, zum Beispiel *Application Administrator*, *Cloud Application Administrator* oder *Global Administrator*. Nur beim ersten Mal erforderlich, wenn der Service Principal RealmJoin Azure Resources noch nicht existiert. * **Azure-Abonnement:** Berechtigung zum Bereitstellen in der Ressourcengruppe **und** um darin Rollen zuzuweisen — zum Beispiel *Owner*, oder *Contributor* kombiniert mit *User Access Administrator* / *Role Based Access Control Administrator*. * Die Anmeldung erfolgt über `Connect-AzAccount`, das die **Azure PowerShell** Erstanbieteranwendung verwendet. Tenants, die die Zustimmung durch Benutzer einschränken, müssen dieser Anwendung möglicherweise zuerst die Administratorzustimmung erteilen. {% hint style="warning" %} Führen Sie den Befehl in einer **frisch geöffneten lokalen** PowerShell-Sitzung aus und vermeiden Sie **Azure Cloud Shell**. Das RealmJoin-Modul erfordert exakte Versionen der `Az.*` Module. Wenn bereits eine andere Version in der Sitzung geladen ist — was in Cloud Shell typischerweise der Fall ist — wird das Modul mit einem Versionskonflikt beendet, der nur durch das Öffnen einer neuen Sitzung behoben werden kann. {% endhint %} ## Einrichtung {% stepper %} {% step %} #### Bereiten Sie die Ressourcengruppe vor Erstellen oder wählen Sie im Azure Portal die Ressourcengruppe aus, die den Arbeitsbereich enthalten soll. Notieren Sie ihren Namen und die ID des Abonnements, in dem sie sich befindet. Wenn Sie einen **vorhandenen** Log-Analytics-Arbeitsbereich verwenden möchten, notieren Sie auch dessen Namen. {% endstep %} {% step %} #### Kopieren Sie den Befehl aus dem RealmJoin Portal Navigieren Sie im RealmJoin Portal zu **Einstellungen → Log Analytics** (). Die Seite weist darauf hin, dass Log Analytics über das RealmJoin PowerShell-Modul verwaltet wird, und zeigt einen Befehlsblock an. Verwenden Sie die **Kopieren** Schaltfläche, um ihn zu kopieren. ```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 "" 6>&1 ``` Die ersten Zeilen installieren oder aktualisieren das RealmJoin-Modul und importieren es. `Set-RJLogAnalyticsWorkspace` führt die Bereitstellung aus und registriert das Ergebnis bei RealmJoin mithilfe des `-Token`. {% hint style="info" %} **Über `6>&1`:** Diese Befehle melden ihren Fortschritt über den Informationsstream von PowerShell. Die `6>&1` Umleitung zeigt diese Ausgabe in der Konsole an — ohne sie sehen Sie keine Fortschrittsmeldungen. {% endhint %} {% endstep %} {% step %} #### Fügen Sie die Zielparameter hinzu `Set-RJLogAnalyticsWorkspace` muss wissen, wohin bereitgestellt werden soll. Vervollständigen Sie die letzte Zeile, bevor Sie sie ausführen: ```powershell Set-RJLogAnalyticsWorkspace -ResourceGroupName "rg-realmjoin" -SubscriptionId "" -Token "" 6>&1 ``` * `-ResourceGroupName` ist erforderlich. Wenn Sie ihn weglassen, fordert PowerShell Sie dazu auf. * `-SubscriptionId` ist optional — ohne ihn wird das Abonnement Ihres aktuellen Azure-Kontexts verwendet, und Sie werden aufgefordert, eines auszuwählen, wenn mehrere verfügbar sind. * `-WorkspaceName` ist optional. Geben Sie ihn an, um den Namen eines neuen Arbeitsbereichs festzulegen oder einen **vorhandenen** Arbeitsbereich zu verwenden; andernfalls wird ein neuer mit einem generierten Namen erstellt. {% endstep %} {% step %} #### Führen Sie den Befehl aus Fügen Sie den Block in eine neue PowerShell-Sitzung ein und führen Sie ihn aus. Das Token ist ungefähr eine Stunde lang gültig — wenn es abgelaufen ist, laden Sie die Einstellungsseite neu und kopieren Sie den Befehl erneut. Sie werden aufgefordert, sich mit `Connect-AzAccount`anzumelden. Wenn Ihr Konto Zugriff auf mehrere Tenants oder Abonnements hat, fordert Sie das Modul auf, eine Auswahl zu treffen. Die Bereitstellung meldet dann jede Ressource, sobald sie erstellt wird: den Service Principal, den Arbeitsbereich, die benutzerdefinierten Tabellen, die Data Collection Rules und die Rollen zuweisungen. Ein einzelner Durchlauf dauert in der Regel einige Minuten. {% hint style="info" %} Möchten Sie zuerst sehen, was passieren würde? Fügen Sie `-WhatIf` für eine Azure Resource Manager What-If-Vorschau an. Beachten Sie, dass die Anmeldung und die Installation der `Az` Module trotzdem erfolgt, da die Vorschau beides benötigt. {% endhint %} {% hint style="info" %} **Danach abmelden:** die Azure-Anmeldung bleibt nach dem Abschluss des Befehls aktiv. Wenn Sie fertig sind, führen Sie `Disconnect-AzAccount` aus, um sich aus der vorhandenen Sitzung abzumelden. {% endhint %} {% endstep %} {% step %} #### Im Portal überprüfen Kehren Sie zu **Einstellungen → Log Analytics** und wählen Sie **Aktualisieren**. Die Seite zeigt nun Abonnement, Ressourcengruppe, Namen des Arbeitsbereichs, ID des Kundenarbeitsbereichs und Tenant-ID als schreibgeschützte Felder an — diese Einstellungen werden von nun an vom PowerShell-Modul verwaltet. Unter **Erweitert** können Sie die Endpunkte, Regelnamen und Stream-Namen der drei Data Collection Rules überprüfen. Wählen Sie **Auf Konfigurationsprobleme prüfen** aus, um zu überprüfen, ob alle erforderlichen Azure-Berechtigungen im Arbeitsbereich und in jeder Data Collection Rule vorhanden sind. Öffnen Sie anschließend die [Audit Log](/de/uberwachung-and-protokolle/audit-log.md) oder die [Runbook-Protokolle](/de/automatisierung/runbooks/runbook-logs.md) und bestätigen Sie, dass Einträge angezeigt werden. Azure benötigt einige Minuten, um neu erstellte benutzerdefinierte Tabellen verfügbar zu machen. {% endstep %} {% endstepper %} ## Datenaufbewahrung {% hint style="warning" %} Um Protokolle länger als 30 Tage aufzubewahren, passen Sie die [Datenaufbewahrung des Arbeitsbereichs](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/data-retention-archive?tabs=portal-1%2Cportal-2) in Azure an. Sowohl der Standardwert des Arbeitsbereichs als auch die Aufbewahrung von Azure Automation beträgt 30 Tage. {% endhint %} ## Das Schema aktuell halten Wenn RealmJoin das Protokollschema in einer zukünftigen Version erweitert, zeigt die Einstellungsseite einen Hinweis an, dass das bereitgestellte Log-Analytics-Schema veraltet ist, zusammen mit dem Befehl zum Aktualisieren. Das ist derselbe **derselbe** `Set-RJLogAnalyticsWorkspace` Befehl — führen Sie ihn erneut aus, und die Tabellen und Regeln werden direkt aktualisiert. ## Windows Update for Business Reports [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) (ehemals Update Compliance) schreibt updatebezogene Ereignisse in einen Log-Analytics-Arbeitsbereich. RealmJoin kann diese Ereignisse lesen und sie auf der [Detailseite des Geräts](/de/ugd-management/user-list/device-details.md). Dies ist unabhängig von dem Arbeitsbereich, in den RealmJoin seine eigenen Protokolle schreibt. Sie können RealmJoin auf denselben Arbeitsbereich oder auf einen separaten richten. {% stepper %} {% step %} #### Windows Update for Business-Berichte in Azure aktivieren 1. Navigieren Sie im Azure Portal zu Monitor > Workbooks 2. Suchen Sie nach "Windows Update for Business reports"
3. Legen Sie Ihr Abonnement und den Arbeitsbereich fest, der die Daten empfangen soll.\ ![](https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FbpoMlLuJrekhPZpWKdM1%2Fimage.png?alt=media\&token=10a65dd5-fa55-413a-9e5c-7d6b93e09acd) 4. Einstellungen speichern {% hint style="warning" %} Windows Update for Business reports kann bis zu 24 Stunden benötigen, um wirksam zu werden. {% endhint %} {% endstep %} {% step %} #### Notieren Sie sich die Arbeitsbereichs-ID Öffnen Sie den Arbeitsbereich im Azure Portal und kopieren Sie die **Workspace ID** (eine GUID) von seiner Übersichtsseite. {% endstep %} {% step %} #### Geben Sie die Arbeitsbereichs-ID im RealmJoin Portal ein Navigieren Sie zu **Einstellungen → Update Compliance**, geben Sie die Arbeitsbereichs-ID ein und wählen Sie **Speichern**. Lassen Sie das Feld leer, um die Meldung zu Safeguard Holds für diesen Tenant zu deaktivieren. {% endstep %} {% step %} #### Gewähren Sie RealmJoin Lesezugriff Nach dem Speichern zeigt die Seite einen Befehlsblock an. Er gewährt dem Service Principal RealmJoin Azure Resources **Log Analytics Reader** Lesezugriff auf diesen Arbeitsbereich — es wird nichts weiter bereitgestellt oder geändert: ```powershell Grant-RJUpdateComplianceWorkspaceAccess -WorkspaceId "" 6>&1 ``` Wenn sich der Arbeitsbereich in einem anderen Abonnement als Ihr aktueller Azure-Kontext befindet, fügen Sie `-SubscriptionId ""`. Das Erstellen dieser Rollen zuweisung erfordert die Berechtigung, den Zugriff auf den Arbeitsbereich zu verwalten, zum Beispiel *Owner* oder *User Access Administrator*. {% endstep %} {% endstepper %} ## Legacy-Einrichtung (Data Collector API) {% hint style="danger" %} Das folgende Setup verwendet die Azure Monitor **HTTP Data Collector API**, für die Microsoft den Support am **14. September 2026**. Sie ist nur zur Referenz für Tenants dokumentiert, die in der Vergangenheit auf diese Weise konfiguriert wurden. Verwenden Sie sie nicht für neue Konfigurationen — folgen Sie der [Einrichtung](#setup) oben, oder [migrieren Sie eine vorhandene Konfiguration](/de/uberwachung-and-protokolle/log-ingestion-api-migration.md). {% endhint %}
Legacy-Einrichtung anzeigen Auf diesem Weg authentifizierte sich RealmJoin mit einer kundenverwalteten Entra ID-App-Registrierung und dem freigegebenen Schlüssel des Arbeitsbereichs und schrieb in die Tabellen `AuditLogs_CL`, `OperationalLogs_CL` und `RunbookLogs_CL`. **Teil 1 — Authentifizierung über eine Azure-App-Registrierung** 1. Navigieren Sie im Azure Portal zu Microsoft Entra ID > Verwalten > App-Registrierungen. 2. Wählen Sie die Registerkarte All Applications aus. 3. Verwenden Sie entweder erneut die App-Registrierung "RealmJoin Runbooks Management", die beim [Onboarding von Runbooks](/de/automatisierung/connecting-azure-automation.md)erstellt wurde, oder wählen Sie "New Registration" und registrieren Sie eine neue Anwendung. 4. Navigieren Sie bei der Anwendung zu Verwalten > Zertifikate & Geheimnisse, wählen Sie die Registerkarte "Client Secrets" und erstellen Sie ein neues Client Secret. Legen Sie Beschreibung und Ablaufdatum gemäß Ihren internen Benennungs- und Sicherheitsrichtlinien fest. 5. Notieren Sie sich den geheimen Wert sicher — wenn Sie die Seite verlassen, wird er von Azure unkenntlich gemacht, und es muss ein neues Secret erstellt werden. **Teil 2 — Erstellen eines Log-Analytics-Arbeitsbereichs** 1. Navigieren Sie im Azure Portal zu Log Analytics Workspace und wählen Sie Erstellen. 2. Geben Sie die Ressourcengruppe, den Namen und die Region wie erforderlich an. 3. Notieren Sie sich auf der Registerkarte "Overview" den Namen der Ressourcengruppe, den Namen des Arbeitsbereichs und die Arbeitsbereichs-ID. **Teil 3 — Azure-Berechtigungen** 1. Navigieren Sie zu dem Abonnement, in dem sich Ihr Log-Analytics-Arbeitsbereich befindet. 2. Wählen Sie Zugriffskontrolle (IAM) und fügen Sie eine Rollen zuweisung hinzu. 3. Gewähren Sie Ihrer App-Registrierung **Monitoring Contributor** auf dem Arbeitsbereich, der für RealmJoin-Protokolle verwendet wird, und **Monitoring Reader** auf einem Arbeitsbereich, der nur für Windows Update for Business-Berichte verwendet wird. 4. Überprüfen und speichern Sie die Rollen zuweisung. **Teil 4 — Verbindung zwischen RealmJoin und dem Arbeitsbereich** Navigieren Sie im RealmJoin Portal zu Settings > Log Analytics und füllen Sie die Felder aus: * **TenantId** — Ihre Entra ID-Tenant-ID, von der Entra ID-Übersichtsseite * **ClientId** und **ClientSecret** — die App-Registrierung aus Teil 1 * **Update Compliance Workspace Id** — die Arbeitsbereichs-ID des Windows Update for Business-Berichtsarbeitsbereichs * **Subscription ID**, **Resource Group** und **Workspace Name** — des Arbeitsbereichs aus Teil 2 * **Customer Workspace Id** — die Arbeitsbereichs-ID des Arbeitsbereichs, der RealmJoin-Audit- und Runbook-Protokolldaten speichert * **Customer Workspace Key** — der "Primary Key" des Arbeitsbereichs, mit dem RealmJoin Daten schreiben kann. Er kann mit der [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`) oder mit [PowerShell](https://learn.microsoft.com/en-us/powershell/module/az.operationalinsights/get-azoperationalinsightsworkspacesharedkey?view=azps-14.6.0) (`Get-AzOperationalInsightsWorkspaceSharedKey -ResourceGroupName "MyResourceGroup" -Name "MyWorkspace"`). Drücken Sie **Speichern** nachdem Sie alle Felder ausgefüllt haben. Das System gibt Ihnen 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 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/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 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.