> 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 workspace を使用して保存できます * その **監査ログ** — Portal で実行されたすべての操作については、 [監査ログ](/ja/torogu/audit-log.md) * その **運用ログ** * **runbook ログ**、Azure Automation の最大保持期間（現在 30 日）を超えてアーカイブされます さらに、RealmJoin は [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) Log Analytics workspace からのデータを読み取り、Windows Update の潜在的な問題を表示します。たとえば [Windows Update Safeguard Holds](https://docs.microsoft.com/en-us/windows/deployment/update/safeguard-holds)、 [デバイスの詳細ページ](/ja/ugd-management/user-list/device-details.md)。参照 [Windows Update for Business Reports](#windows-update-for-business-reports). workspace は次でセットアップされます [RealmJoin PowerShell モジュール](/ja/zhan-kai/onboarding-realmjoin-portal/advanced-setup.md)。Portal はコピーして使えるコマンドを生成します — 手で入力するものはありません。 {% hint style="info" %} すでに Tenant で Log Analytics が構成されており、非推奨の Data Collector API を使用していますか？その場合は次に従ってください [Log Ingestion API への移行](/ja/torogu/log-ingestion-api-migration.md) 代わりに — 既存の workspace を再利用し、既存のログを保持します。 {% 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 tenant 内の service principal（まだ存在しない場合） * 1 つの **Log Analytics workspace** 選択したリソース グループ内に — または、名前を指定した場合は既存の workspace * その 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** workspace 上で、Portal がログをクエリできるようにします * **Monitoring Metrics Publisher** 3 つの Data Collection Rules それぞれに対して、RealmJoin が書き込めるようにします RealmJoin はサブスクリプション内で他の権限を受け取りません。アプリ登録、クライアント シークレット、workspace の共有キーはいずれも使用されません。デプロイは冪等です — 同じコマンドを再実行しても安全で、足りないものだけが適用されます。 ## 前提条件 ### RealmJoin Portal で * Settings 領域へのアクセスを付与するロール (`CanReadSettingsDetails`、参照 [利用可能な権限](/ja/to/permission/custom-roles/available-permissions.md))。設定ページでは、短時間だけ有効なオンボーディング トークンを含むセットアップ コマンドが生成されます。 ### Azure で * 1 つの Azure subscription と **既存のリソース グループ** へのデプロイ先 — モジュールはリソース グループを作成しません * 必要に応じて既存の Log Analytics workspace。名前を指定しない場合は、リソース グループのリージョンに workspace が作成されます。 ### PowerShell を実行しているマシンで * **PowerShell 5.1** 以降（Windows PowerShell または PowerShell 7） * へのアクセス [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) RealmJoin モジュールをインストールするための * 次の `Az.Accounts`, `Az.Resources` および `Az.Automation` モジュール — RealmJoin モジュールが現在のユーザー向けに固定されたバージョンを自動的にインストールします ### サインインに使用するアカウントの権限 * **Microsoft Entra ID:** service principals を作成する権限。たとえば *Application Administrator*, *Cloud Application Administrator* または *Global Administrator*。RealmJoin Azure Resources service principal がまだ存在しない最初の 1 回だけ必要です。 * **Azure subscription:** リソース グループへデプロイする権限 **および** そこで role assignments を作成する権限 — たとえば *Owner*、または *Contributor* と組み合わせて *User Access Administrator* / *Role Based Access Control Administrator*. * サインインは次を通じて行われます `Connect-AzAccount`、これは **Azure PowerShell** のファーストパーティ アプリケーションを使用します。ユーザーの同意を制限している Tenant では、最初にそのアプリケーションに管理者の同意を付与する必要がある場合があります。 {% hint style="warning" %} コマンドを次で実行してください: **開いたばかりのローカル** PowerShell セッションで実行し、避けてください **Azure Cloud Shell**。RealmJoin モジュールは次の厳密なバージョンを必要とします `Az.*` モジュール。別のバージョンがすでにセッションに読み込まれている場合 — 通常は Cloud Shell でそうなります — モジュールはバージョン競合で停止し、新しいセッションを開くことでしか解決できません。 {% endhint %} ## セットアップ {% stepper %} {% step %} #### リソース グループを準備する Azure Portal で、workspace を格納するリソース グループを作成または選択します。その名前と、所属するサブスクリプションの ID を控えてください。 使用したい場合は **既存の** Log Analytics workspace がある場合は、その名前も控えてください。 {% endstep %} {% step %} #### RealmJoin Portal からコマンドをコピーする RealmJoin Portal で次に移動します **Settings → Log Analytics** (). このページには、Log Analytics が RealmJoin PowerShell モジュールを介して管理されることが表示され、コマンド ブロックが示されます。次の **コピー** ボタンでコピーしてください。 ```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 ``` 最初の行で RealmJoin モジュールをインストールまたは更新し、読み込みます。 `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 "" -Token "" 6>&1 ``` * `-ResourceGroupName` は必須です。省略すると、PowerShell が入力を求めます。 * `-SubscriptionId` は任意です — 指定しない場合は、現在の Azure コンテキストのサブスクリプションが使用され、複数ある場合は選択を求められます。 * `-WorkspaceName` は任意です。新しい workspace の名前を指定するか、次を使用するにはこれを渡します **既存の** workspace。指定しない場合は生成された名前で新しいものが作成されます。 {% endstep %} {% step %} #### コマンドを実行する ブロックを新しい PowerShell セッションに貼り付けて実行します。トークンの有効期限はおよそ 1 時間です — 期限切れの場合は、設定ページを再読み込みしてコマンドを再度コピーしてください。 次のアカウントでのサインインが求められます `Connect-AzAccount`。アカウントが複数の Tenant またはサブスクリプションにアクセスできる場合、モジュールが選択を求めます。 その後、デプロイは作成される各リソースを順に報告します: service principal、workspace、カスタム テーブル、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** を選択します **更新**. このページでは現在、サブスクリプション、リソース グループ、workspace 名、customer workspace ID、tenant ID が読み取り専用フィールドとして表示されます — これらの設定は今後 PowerShell モジュールによって維持されます。次の下で **詳細設定** 3 つの Data Collection Rules のエンドポイント、ルール名、ストリーム名を確認できます。 次を選択します **構成の問題を確認** workspace と各 Data Collection Rule に必要な Azure 権限がすべて設定されていることを確認します。 その後、 [監査ログ](/ja/torogu/audit-log.md) または [Runbook Logs](/ja/zi-dong-hua/runbooks/runbook-logs.md) を開き、エントリが表示されることを確認してください。Azure では、新しく作成されたカスタム テーブルが利用可能になるまで数分かかります。 {% endstep %} {% endstepper %} ## データ保持 {% hint style="warning" %} ログを 30 日より長く保持するには、次を調整します [workspace のデータ保持](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/data-retention-archive?tabs=portal-1%2Cportal-2) Azure で。workspace の既定値も Azure Automation の保持期間も 30 日です。 {% endhint %} ## スキーマを最新に保つ 将来のリリースで RealmJoin がログ スキーマを拡張すると、設定ページに、展開済みの Log Analytics schema が古いことを知らせる通知と、それを更新するコマンドが表示されます。つまりそれが **同じ** `Set-RJLogAnalyticsWorkspace` コマンドです — もう一度実行すると、テーブルとルールがその場で更新されます。 ## Windows Update for Business Reports [Windows Update for Business Reports](https://learn.microsoft.com/en-us/windows/deployment/update/wufb-reports-overview) （旧 Update Compliance）は更新関連のイベントを Log Analytics workspace に書き込みます。RealmJoin はこれらのイベントを読み取り、次の上で表示できます [デバイスの詳細ページ](/ja/ugd-management/user-list/device-details.md). これは、RealmJoin が独自のログを書き込む workspace とは独立しています。RealmJoin を同じ workspace に向けることも、別の workspace に向けることもできます。 {% stepper %} {% step %} #### Azure で Windows Update for Business Reports を有効にする 1. Azure Portal で、Monitor > Workbooks に移動します 2. "Windows Update for Business reports" を検索します
3. データを受け取る Subscription と Workspace を設定します。\ ![](https://3438325150-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. 設定を保存 {% hint style="warning" %} Windows Update for Business reports の反映には最大 24 時間かかる場合があります。 {% endhint %} {% endstep %} {% step %} #### workspace ID を控える Azure Portal で workspace を開き、次をコピーします **Workspace ID** （GUID）を Overview ページから。 {% endstep %} {% step %} #### RealmJoin Portal に workspace ID を入力する 次に移動します **Settings → Update Compliance**、workspace ID を入力して次を選択します **保存**。この field を空のままにすると、この Tenant で Safeguard Hold のレポートを無効にできます。 {% endstep %} {% step %} #### RealmJoin に読み取りアクセスを付与する 保存後、ページにコマンド ブロックが表示されます。これにより、RealmJoin Azure Resources service principal に **Log Analytics Reader** その workspace での権限が付与されます — 他には何もデプロイまたは変更されません: ```powershell Grant-RJUpdateComplianceWorkspaceAccess -WorkspaceId "" 6>&1 ``` workspace が現在の Azure コンテキストとは別の subscription にある場合は、次を追加します `-SubscriptionId ""`. この role assignment を作成するには、workspace のアクセスを管理する権限が必要です。たとえば *Owner* または *User Access Administrator*. {% endstep %} {% endstepper %} ## 旧セットアップ（Data Collector API） {% hint style="danger" %} 以下のセットアップでは Azure Monitor を使用します **HTTP Data Collector API**、これは Microsoft が次の日付でサポートを終了します **2026 年 9 月 14 日**。これは、過去にこの方法で構成された Tenant の参照用としてのみ文書化されています。新しい構成には使用しないでください — 次に従ってください [セットアップ](#setup) 上記、または [既存の構成を移行する](/ja/torogu/log-ingestion-api-migration.md). {% endhint %}
旧セットアップを表示 この方法では、RealmJoin は顧客所有の Entra ID アプリ登録と workspace の共有キーを使用して認証し、次のテーブルに書き込みました `AuditLogs_CL`, `OperationalLogs_CL` および `RunbookLogs_CL`. **パート 1 — Azure アプリ登録を使用した認証** 1. Azure Portal で、Microsoft Entra ID > Manage > App Registrations に移動します。 2. All Applications タブを選択します。 3. "RealmJoin Runbooks Management" アプリ登録を再利用するか、次の場合に作成された [onboarding runbooks](/ja/zi-dong-hua/connecting-azure-automation.md)、または "New Registration" を選択して新しいアプリケーションを登録します。 4. アプリケーションで、Manage > Certificates & Secrets に移動し、"Client Secrets" タブを選択して新しい client secret を作成します。説明と有効期限は、社内の命名規則とセキュリティ ポリシーに従って設定してください。 5. secret 値を安全に控えてください — ページを離れると Azure によって値がぼかされ、新しい secret を作成し直す必要があります。 **パート 2 — Log Analytics workspace の作成** 1. Azure Portal で、Log Analytics Workspace に移動し、Create を選択します。 2. 必要に応じてリソース グループ、名前、リージョンを指定します。 3. "Overview" タブで、リソース グループ名、workspace 名、workspace ID を控えます。 **パート 3 — Azure の権限** 1. Log Analytics workspace が存在する subscription に移動します。 2. Access Control (IAM) を選択し、role assignment を追加します。 3. アプリ登録に次を付与します **Monitoring Contributor** RealmJoin のログに使用する workspace に対して、そして **Monitoring Reader** Windows Update for Business Reports 専用の workspace に対して。 4. role assignment を確認して保存します。 **パート 4 — RealmJoin と workspace の接続** RealmJoin Portal で、Settings > Log Analytics に移動し、次の fields を入力します: * **TenantId** — Entra ID の Overview ページにある Entra ID tenant ID * **ClientId** および **ClientSecret** — パート 1 のアプリ登録 * **Update Compliance Workspace Id** — Windows Update for Business Reports workspace の workspace ID * **Subscription ID**, **Resource Group** および **Workspace Name** — パート 2 の workspace の * **Customer Workspace Id** — RealmJoin の監査ログと runbook ログ データを保存する workspace の workspace ID * **Customer Workspace Key** — workspace の "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"`). 次を押します **保存** すべての field を入力した後。すべて正常に動作した場合はシステムからフィードバックが表示されます。
--- # 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=&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.