> 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/ja/torogu/log-analytics.md).

# Azure Log Analytics Workspace への接続

RealmJoin PowerShell モジュールを使用して Azure Log Analytics Workspace を RealmJoin Portal に接続し、監査ログ、運用ログ、runbook ログを自分の Tenant に保存します。

## 概要

RealmJoin Portal は、あなた自身の Azure サブスクリプション内の Log Analytics ワークスペースを使って保存できます

* その **監査ログ** — Portal で実行されたすべての操作については、次を参照してください [Audit Log](https://docs.realmjoin.com/ja/torogu/audit-log.md)
* その **運用ログ**
* **runbook ログ**、Azure Automation の最大保持期間（現在 30 日）を超えてアーカイブされたもの

ワークスペースは次の設定でセットアップされます [RealmJoin PowerShell module](https://docs.realmjoin.com/ja/zhan-kai/onboarding-realmjoin-portal/advanced-setup.md)。Portal は、すぐにコピーできるコマンドを生成します — 手動で入力するものは何もありません。

{% hint style="info" %}
あなたのテナントで Log Analytics がすでに構成されており、廃止予定の Data Collector API を使用していますか？ その場合は次を参照してください [Log Ingestion API への移行](https://docs.realmjoin.com/ja/torogu/log-ingestion-api-migration.md) 代わりに — 既存のワークスペースを再利用し、既存のログを保持します。
{% endhint %}

## コンポーネント

RealmJoin は Azure Monitor を通じてログを書き込みます **Logs Ingestion API**、次に基づいています [Data Collection Rules (DCRs)](https://learn.microsoft.com/en-us/azure/azure-monitor/essentials/data-collection-rule-overview) および Microsoft Entra ID 認証に基づいています。セットアップ コマンドを実行すると、次が作成されます:

* 次の **RealmJoin Azure Resources** あなたの Entra ID テナント内の service principal（まだ存在しない場合）
* 成功した解決済みキーのみを含む **Log Analytics Workspace** 選択したリソース グループ内、または名前を指定した場合は既存のワークスペース
* そのワークスペース内の 3 つのカスタム テーブル: `RJAuditLogs_CL`, `RJOperationalLogs_CL`, `RJRunbookLogs_CL`
* テーブルごとに1つの Data Collection Rule（`dcr-rj-aud-logs-*`, `dcr-rj-op-logs-*`, `dcr-rj-rb-logs-*`）、それぞれに専用の直接取り込みエンドポイント付き
* RealmJoin に対するロール割り当ては、次の2種類だけです。それ以外はありません:
  * **Log Analytics Reader** ワークスペース上で、Portal がログを照会できるようにするため
  * **Monitoring Metrics Publisher** 3つの Data Collection Rules のそれぞれに対して、RealmJoin がそこへ書き込めるようにするため

RealmJoin は、あなたのサブスクリプション内で他の権限を一切受け取りません。アプリ登録、クライアント シークレット、ワークスペースの共有キーは関与しません。デプロイは冪等です — 同じコマンドを再実行しても安全で、不足しているものだけが適用されます。

## 前提条件

### RealmJoin Portal で

* Settings 領域へのアクセス権を付与するロール（`CanReadSettingsDetails`、参照: [利用可能な権限](https://docs.realmjoin.com/ja/to/permission/custom-roles/available-permissions.md)）。設定ページは、短時間有効なオンボーディング トークンを含むセットアップ コマンドを生成します。

### Azure で

* Azure サブスクリプションと 1 つの **既存のリソース グループ** へデプロイするため — モジュールはリソース グループを作成しません
* オプションで既存の Log Analytics ワークスペース。名前を指定しない場合は、リソース グループのリージョンにワークスペースが作成されます。

### PowerShell を実行しているマシン上で

* **PowerShell 5.1** 以降（Windows PowerShell または PowerShell 7）
* へのアクセス [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) RealmJoin module をインストールするための
* 次の `Az.Accounts`, `Az.Resources` と `Az.Automation` モジュール — RealmJoin module が現在のユーザー向けに固定バージョンで自動的にインストールします

### サインインに使用するアカウントの権限

* **Microsoft Entra ID:** service principal を作成する権限。たとえば *Application Administrator*, *Cloud Application Administrator* または *Global Administrator*。最初の一回だけ必要です。RealmJoin Azure Resources service principal がまだ存在しない場合です。
* **Azure サブスクリプション:** リソース グループにデプロイする権限 **と** そこでロール割り当てを作成するための権限。たとえば *Owner*、または *Contributor* と *User Access Administrator* / *Role Based Access Control Administrator*.
* サインインは `Connect-AzAccount` を通じて行われます。これは **Azure PowerShell**  のファーストパーティ アプリケーションを使用します。ユーザー同意を制限しているテナントでは、最初にそのアプリケーションへの管理者同意を付与する必要がある場合があります。

{% hint style="warning" %}
コマンドを次の環境で実行してください: **新しく開いたローカルの** PowerShell セッションで、 **Azure Cloud Shell**は避けてください。RealmJoin module には、 `Az.*` モジュール。別のバージョンがセッションにすでに読み込まれている場合 — 通常は Cloud Shell でそうなります — モジュールはバージョン競合で停止し、新しいセッションを開かない限り解決できません。
{% endhint %}

## セットアップ

{% stepper %}
{% step %}

#### リソース グループを準備する

Azure Portal で、ワークスペースを配置するリソース グループを作成するか選択します。その名前と、それが存在するサブスクリプションの ID を控えておきます。

次を使用したい場合は **既存の** Log Analytics ワークスペースの名前も控えておきます。
{% endstep %}

{% step %}

#### RealmJoin Portal からコマンドをコピーする

RealmJoin Portal で、次に移動します **Settings → Log Analytics** (<https://portal.realmjoin.com/settings/log-analytics-configuration>).

このページには、Log Analytics は RealmJoin PowerShell モジュールによって管理されると表示され、コマンド ブロックが示されます。次のものを使用してください **Copy** ボタンを使ってコピーしてください。

```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
```

最初の行で RealmJoin module をインストールまたは更新し、それをインポートします。 `Set-RJLogAnalyticsWorkspace` デプロイを実行し、次を使用して結果を RealmJoin に登録します `-Token`.

{% hint style="info" %}
**について `6>&1`:** これらのコマンドは、PowerShell の Information ストリームに進捗を出力します。 `6>&1` リダイレクトによってその出力がコンソールに表示されます。これがないと進捗メッセージは表示されません。
{% endhint %}
{% endstep %}

{% step %}

#### 対象パラメータを追加する

`Set-RJLogAnalyticsWorkspace` デプロイ先を知る必要があります。実行する前に最後の行を完成させてください:

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

* `-ResourceGroupName` は必須です。省略すると、PowerShell が入力を求めます。
* `-SubscriptionId` は省略可能です — 指定しない場合は、現在の Azure コンテキストのサブスクリプションが使用され、複数ある場合は選択を求められます。
* `-WorkspaceName` は省略可能です。新しいワークスペースの名前を指定するか、既存の **既存の** ワークスペースを使用します。そうでない場合は、生成された名前で新しいワークスペースが作成されます。
  {% endstep %}

{% step %}

#### コマンドを実行する

ブロックを新しい PowerShell セッションに貼り付けて実行してください。トークンの有効期限はおよそ1時間です。期限切れの場合は、設定ページを再読み込みしてコマンドをもう一度コピーしてください。

次の方法でサインインするよう求められます `Connect-AzAccount`。アカウントに複数のテナントまたはサブスクリプションへのアクセス権がある場合、モジュールが選択を求めます。

その後、デプロイでは各リソースが作成されるたびに報告されます: Service Principal、ワークスペース、カスタム テーブル、Data Collection Rules、ロール割り当てです。1 回の実行には通常数分かかります。

{% hint style="info" %}
まず何が起こるか見たいですか？ `-WhatIf`  に追加すると、Azure Resource Manager の What-If プレビューが表示されます。なお、サインインと `Az` モジュールのインストールは引き続き行われます。プレビューにはその両方が必要だからです。
{% endhint %}

{% hint style="info" %}
**その後のサインアウト:** Azure へのサインインは、コマンド完了後もアクティブなままです。終わったら `Disconnect-AzAccount`  を実行して、既存のセッションからサインアウトしてください。
{% endhint %}
{% endstep %}

{% step %}

#### Portal で確認する

に戻り **Settings → Log Analytics** 、 **Refresh**.

ページには、サブスクリプション、リソース グループ、ワークスペース名、customer workspace ID、tenant ID が読み取り専用フィールドとして表示されます — これらの設定は今後 PowerShell モジュールによって維持されます。下の **Advanced**  では、3つの Data Collection Rules のエンドポイント名、ルール名、ストリーム名を確認できます。

次を選択 **構成の問題を確認する** を選択して、必要なすべての Azure 権限がワークスペースと各 Data Collection Rule に付与されていることを確認してください。

その後、次を開きます [Audit Log](https://docs.realmjoin.com/ja/torogu/audit-log.md) または [Runbook Logs](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-logs.md) を開き、エントリが表示されることを確認します。Azure が新しく作成されたカスタム テーブルを利用可能にするまで、数分かかります。
{% endstep %}
{% endstepper %}

## データ保持

{% hint style="warning" %}
ログを 30 日より長く保持するには、次を調整します [ワークスペースのデータ保持](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/data-retention-archive?tabs=portal-1%2Cportal-2) Azure で。ワークスペースの既定値も Azure Automation の保持期間も 30 日です。
{% endhint %}

## スキーマを最新に保つ

将来のリリースで RealmJoin がログ スキーマを拡張すると、設定ページにデプロイ済みの Log Analytics スキーマが古いという通知と、それを更新するコマンドが表示されます。それは **同じ** `Set-RJLogAnalyticsWorkspace` コマンドです — もう一度実行すれば、テーブルとルールがその場で更新されます。

## 旧式のセットアップ（Data Collector API）

{% hint style="danger" %}
以下のセットアップでは Azure Monitor を使用します **HTTP Data Collector API**、Microsoft がサポートを終了する **2026年9月14日**。これは、過去にこの方法で構成されたテナント向けの参照用にのみ文書化されています。新しい構成では使用しないでください — 次に従ってください [セットアップ](#setup) 上記、または [既存の構成を移行する](https://docs.realmjoin.com/ja/torogu/log-ingestion-api-migration.md).
{% endhint %}

<details>

<summary>旧式のセットアップを表示する</summary>

この方法では、RealmJoin は顧客所有の Entra ID アプリ登録とワークスペースの共有キーで認証し、次のテーブルに書き込みました `AuditLogs_CL`, `OperationalLogs_CL` と `RunbookLogs_CL`.

**第 1 部 — Azure アプリ登録を使用した認証**

1. Azure Portal で、Microsoft Entra ID > 管理 > アプリ登録 に移動します。
2. ［All Applications］タブを選択します。
3. 「RealmJoin Runbooks Management」アプリ登録を再利用するか、 [オンボーディング用 runbooks](https://docs.realmjoin.com/ja/zi-dong-hua/connecting-azure-automation.md)、または［New Registration］を選択して新しいアプリケーションを登録します。
4. アプリケーションで、［Manage > Certificates & Secrets］に移動し、［Client Secrets］タブを選択して、新しいクライアント シークレットを作成します。説明と有効期限は、社内の命名規則とセキュリティ ポリシーに従って設定してください。
5. シークレットの値は安全に控えておきます — ページを離れると Azure によって値が難読化されるため、新しいシークレットを作成する必要があります。

**第 2 部 — Log Analytics ワークスペースの作成**

1. Azure Portal で、Log Analytics Workspace に移動して［Create］を選択します。
2. 必要に応じて、リソース グループ、名前、リージョンを指定します。
3. ［Overview］タブで、リソース グループ名、ワークスペース名、ワークスペース ID を控えておきます。

**第 3 部 — Azure のアクセス許可**

1. Log Analytics ワークスペースが存在するサブスクリプションに移動します。
2. ［Access Control (IAM)］を選択し、ロール割り当てを追加します。
3. アプリ登録に権限を付与します **Monitoring Contributor** RealmJoin ログに使用されるワークスペースに対して。
4. ロール割り当てを確認して保存します。

**第 4 部 — RealmJoin とワークスペースの接続**

RealmJoin Portal で、［Settings > Log Analytics］に移動し、次のフィールドに入力します:

* **TenantId** — Entra ID の概要ページにある Entra ID テナント ID
* **ClientId** と **ClientSecret** — 第 1 部のアプリ登録
* **サブスクリプション ID**, **リソース グループ** と **ワークスペース名** — 第 2 部のワークスペースの
* **顧客ワークスペース ID** — RealmJoin の監査ログと runbook ログ データを保存するワークスペースの ID
* **顧客ワークスペース キー** — ワークスペースの「Primary Key」で、RealmJoin がデータを書き込めるようにします。次を使用して取得できます [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"`).

押してください **保存** すべてのフィールドを入力した後に保存します。すべて正常に機能した場合、システムがフィードバックを表示します。

</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/ja/torogu/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.
