> 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 **Prüfprotokoll** — jede im Portal ausgeführte Aktion, siehe [Audit-Protokoll](https://docs.realmjoin.com/de/uberwachung-and-protokolle/audit-log.md)
* seine **Betriebsprotokolle**
* **Runbook-Protokolle**, archiviert über die maximale Aufbewahrungsdauer von Azure Automation hinaus (derzeit 30 Tage)

Der Arbeitsbereich wird mit [RealmJoin PowerShell-Modul](https://docs.realmjoin.com/de/bereitstellung/onboarding-realmjoin-portal/advanced-setup.md). Das Portal generiert einen sofort kopierbaren Befehl für Sie — Sie müssen nichts von Hand ausfüllen.

{% hint style="info" %}
Ist Log Analytics bereits für Ihren Tenant konfiguriert und verwendet die veraltete Data Collector API? Dann folgen Sie [der Migration zur Log Ingestion API](https://docs.realmjoin.com/de/uberwachung-and-protokolle/log-ingestion-api-migration.md) stattdessen — sie verwendet Ihren vorhandenen Arbeitsbereich weiter und behält Ihre vorhandenen Protokolle bei.
{% endhint %}

## Komponenten

RealmJoin schreibt seine Protokolle über 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. Das Ausführen des Setup-Befehls erstellt:

* Die **RealmJoin Azure Resources** Service Principal in Ihrem Entra ID-Tenant (falls er noch nicht existiert)
* Eine **Log Analytics-Arbeitsbereich** in der Ressourcengruppe, die Sie auswählen — oder Ihren vorhandenen Arbeitsbereich, wenn Sie einen angeben
* Drei benutzerdefinierte Tabellen in diesem Arbeitsbereich: `RJAuditLogs_CL`, `RJOperationalLogs_CL`, `RJRunbookLogs_CL`
* Je eine Data Collection Rule pro Tabelle (`dcr-rj-aud-logs-*`, `dcr-rj-op-logs-*`, `dcr-rj-rb-logs-*`), jeweils mit eigenem direkten Ingestion-Endpunkt
* Genau zwei Arten von Rollenzuweisung für RealmJoin, und nichts darüber hinaus:
  * **Log Analytics Reader** auf dem Workspace, damit das Portal Ihre Protokolle abfragen kann
  * **Monitoring Metrics Publisher** auf jeder der drei Data Collection Rules, damit RealmJoin darauf schreiben kann

RealmJoin erhält in Ihrem Abonnement keine weiteren Berechtigungen. Keine App-Registrierung, kein Client-Secret und kein gemeinsamer Workspace-Schlüssel sind 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 Bereich Einstellungen gewährt (`CanReadSettingsDetails`, siehe [Verfügbare Berechtigungen](https://docs.realmjoin.com/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 ein **vorhandene Ressourcengruppe** zur Bereitstellung — das Modul erstellt die Ressourcengruppe nicht
* Optional ein vorhandener Log Analytics-Arbeitsbereich. Wenn Sie keinen angeben, wird für Sie ein Arbeitsbereich in der Region der Ressourcengruppe erstellt.

### Auf dem Computer, auf dem PowerShell läuft

* **PowerShell 5.1** oder höher (Windows PowerShell oder PowerShell 7)
* Zugriff auf die [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) zum Installieren des RealmJoin-Moduls
* Die `Az.Accounts`, `Az.Resources` und `Az.Automation` Module — das RealmJoin-Modul installiert sie automatisch in den fest vorgegebenen 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 zur Bereitstellung in der Ressourcengruppe **und** um darin Rollenzuweisungen zu erstellen — zum Beispiel *Owner*, oder *Contributor* in Kombination mit *User Access Administrator* / *Role Based Access Control Administrator*.
* Die Anmeldung erfolgt über `Connect-AzAccount`, das die **Azure PowerShell** First-Party-Anwendung verwendet. Mandanten, die die Benutzerzustimmung einschränken, müssen dieser Anwendung möglicherweise zunächst die Administratorzustimmung erteilen.

{% hint style="warning" %}
Führen Sie den Befehl in einer **frisch geöffneten, lokalen** PowerShell-Sitzung und vermeiden Sie **Azure Cloud Shell**. Das RealmJoin-Modul erfordert exakte Versionen der `Az.*` Module. Wenn in der Sitzung bereits eine andere Version geladen ist — was in Cloud Shell typischerweise der Fall ist — beendet sich das Modul mit einem Versionskonflikt, 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** (<https://portal.realmjoin.com/settings/log-analytics-configuration>).

Die Seite gibt an, 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 "<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. Ergänzen Sie die letzte Zeile, bevor Sie sie ausführen:

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

* `-ResourceGroupName` ist erforderlich. Wenn Sie es 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. Übergeben Sie ihn, 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 gültig — wenn es abgelaufen ist, laden Sie die Einstellungsseite neu und kopieren Sie den Befehl erneut.

Sie werden aufgefordert, sich mit `Connect-AzAccount`. Wenn Ihr Konto Zugriff auf mehrere Tenants oder Subscriptions hat, fordert das Modul Sie auf, eine auszuwählen.

Die Bereitstellung meldet dann jede Ressource, sobald sie erstellt wird: der Service Principal, der Arbeitsbereich, die benutzerdefinierten Tabellen, die Data Collection Rules und die Rollenzuweisungen. Ein einzelner Lauf dauert normalerweise einige Minuten.

{% hint style="info" %}
Möchten Sie zuerst sehen, was passieren würde? Hängen Sie `-WhatIf` für eine Azure Resource Manager What-If-Vorschau an. Beachten Sie, dass die Anmeldung und die Installation der `Az` Module trotzdem stattfinden, da die Vorschau beides benötigt.
{% endhint %}

{% hint style="info" %}
**Abmelden danach:** Die Azure-Anmeldung bleibt nach Abschluss des Befehls aktiv. Wenn Sie fertig sind, führen Sie `Disconnect-AzAccount` aus, um sich von der bestehenden Sitzung abzumelden.
{% endhint %}
{% endstep %}

{% step %}

#### Im Portal überprüfen

Gehen Sie zurück zu **Einstellungen → Log Analytics** und wählen Sie **Aktualisieren**.

Die Seite zeigt nun Abonnement, Ressourcengruppe, Arbeitsbereichsname, Kunden-Arbeitsbereichs-ID 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, Reglernamen und Stream-Namen der drei Data Collection Rules überprüfen.

Wählen Sie **Auf Konfigurationsprobleme prüfen** um zu verifizieren, dass auf dem Workspace und auf jeder Data Collection Rule alle erforderlichen Azure-Berechtigungen vorhanden sind.

Anschließend öffnen Sie die [Audit-Protokoll](https://docs.realmjoin.com/de/uberwachung-and-protokolle/audit-log.md) oder der [Runbook-Protokolle](https://docs.realmjoin.com/de/automatisierung/runbooks/runbook-logs.md) und bestätigen Sie, dass Einträge erscheinen. 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 die Standardaufbewahrung des Arbeitsbereichs als auch die Aufbewahrung von Azure Automation beträgt 30 Tage.
{% endhint %}

## Das Schema aktuell halten

Wenn RealmJoin in einer zukünftigen Version das Protokollschema erweitert, zeigt die Einstellungsseite einen Hinweis an, dass das bereitgestellte Log Analytics-Schema veraltet ist, zusammen mit dem Befehl zum Aktualisieren. Das ist der **gleiche** `Set-RJLogAnalyticsWorkspace` Befehl — führen Sie ihn erneut aus, und die Tabellen und Regeln werden vor Ort aktualisiert.

## Legacy-Einrichtung (Data Collector API)

{% hint style="danger" %}
Die folgende Einrichtung verwendet die Azure Monitor **HTTP Data Collector API**, deren Support Microsoft am **14. September 2026**einstellt. Sie ist nur zur Referenz für Tenants dokumentiert, die früher 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](https://docs.realmjoin.com/de/uberwachung-and-protokolle/log-ingestion-api-migration.md).
{% endhint %}

<details>

<summary>Die Legacy-Einrichtung anzeigen</summary>

Auf diesem Weg authentifizierte sich RealmJoin mit einer vom Kunden verwalteten Entra ID-App-Registrierung und dem gemeinsamen Schlüssel des Arbeitsbereichs und schrieb in die Tabellen `AuditLogs_CL`, `OperationalLogs_CL` und `RunbookLogs_CL`.

**Teil 1 — Authentifizierung mit einer Azure-App-Registrierung**

1. Navigieren Sie im Azure Portal zu Microsoft Entra ID > Verwalten > App-Registrierungen.
2. Wählen Sie die Registerkarte Alle Anwendungen aus.
3. Verwenden Sie entweder die App-Registrierung „RealmJoin Runbooks Management“ erneut, die beim [Onboarding-Runbooks](https://docs.realmjoin.com/de/automatisierung/connecting-azure-automation.md)erstellt wurde, oder wählen Sie „Neue Registrierung“ und registrieren Sie eine neue Anwendung.
4. Navigieren Sie bei der Anwendung zu Verwalten > Zertifikate & Geheimnisse, wählen Sie die Registerkarte „Clientgeheimnisse“ und erstellen Sie ein neues Clientgeheimnis. Legen Sie Beschreibung und Ablaufdatum gemäß Ihren internen Benennungs- und Sicherheitsrichtlinien fest.
5. Notieren Sie den geheimen Wert sicher — wenn Sie die Seite verlassen, maskiert Azure ihn, und ein neues Geheimnis muss 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 wie erforderlich eine Ressourcengruppe, einen Namen und eine Region an.
3. Notieren Sie auf der Registerkarte „Übersicht“ den Namen der Ressourcengruppe, den Namen des Arbeitsbereichs und die ID des Arbeitsbereichs.

**Teil 3 — Azure-Berechtigungen**

1. Navigieren Sie zu dem Abonnement, in dem sich Ihr Log Analytics-Arbeitsbereich befindet.
2. Wählen Sie Zugriffssteuerung (IAM) und fügen Sie eine Rollenzuweisung hinzu.
3. Gewähren Sie Ihrer App-Registrierung **Monitoring Contributor** für den Arbeitsbereich, der für RealmJoin-Protokolle verwendet wird.
4. Überprüfen und speichern Sie die Rollenzuweisung.

**Teil 4 — Verbindung von RealmJoin und dem Arbeitsbereich**

Navigieren Sie im RealmJoin Portal zu Einstellungen > 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
* **Abonnement-ID**, **Ressourcengruppe** und **Name des Arbeitsbereichs** — des Arbeitsbereichs aus Teil 2
* **Kunden-Arbeitsbereichs-ID** — die Arbeitsbereichs-ID des Arbeitsbereichs, der RealmJoin-Prüf- und Runbook-Protokolldaten speichert
* **Kunden-Arbeitsbereichsschlüssel** — der „Primärschlüssel“ des Arbeitsbereichs, der RealmJoin das Schreiben von Daten ermöglicht. 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 Sie** nachdem Sie alle Felder ausgefüllt haben. Das System gibt Ihnen Rückmeldung, wenn alles funktioniert hat.

</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/de/uberwachung-and-protokolle/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.
