> 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/zi-dong-hua/runbooks/runbook-references/org/general/monitor-service-health_scheduled.md).

# サービス正常性の監視 - 定期実行

{% hint style="info" %}
これはスケジュール実行の runbook です。単一のオブジェクトでトリガーされるのではなく、繰り返しのスケジュールで実行されるように設計されています。参照してください [スケジュール設定](/ja/zi-dong-hua/runbooks/scheduling.md) runbook のスケジュールを構成する方法の詳細について。
{% endhint %}

### 説明

Microsoft 365 Service Health の問題フィードを定期的に照会し、最初の Service Health 投稿が設定可能なルックバック ウィンドウ内にある問題を特定します。Microsoft は公式の開始時刻を遡って記録することが多く、それだけで絞り込むとアラートを見逃すためです。必要に応じて監視対象を選択したサービスのセットに絞り込み、新たに検出された各問題ごとに 1 通の警告メールを送信します。件名にはテナント名と問題タイトルが含まれます。問題の詳細はすべてメール本文に含まれ、runbook はレポート ファイルを生成しません。

### メール送信に関する設定

メールレポートの送信は任意であり、受信者（`EmailTo`）が指定された場合にのみ行われます。送信者アドレスは `RJReport.EmailSender` テナント設定から取得されます。

このRunbookは Microsoft Graph API を使用してメールを送信します。Graph API 経由でメールを送信するには、Runbook のカスタマイズで既存のメールアドレスを設定する必要があります。

詳細については、 [RealmJoin レポート設定のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) を参照してください。

#### メールのブランド設定

レポートメールでは、任意の `RJReport.Branding.*` テナント設定が考慮されます。対象は、カスタムのヘッダー画像、カスタムのフッター画像（公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB）、カスタムのフッターリンク、およびカスタムのアクセントカラーとテキストカラー（6 桁の hex 値、例: `#0052cc`）です。これらの設定が構成されていない場合は、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードまたは検証できないブランド画像、または有効な hex カラーではない色の値があっても、レポートメールが送信されなくなることはありません。代わりに、該当する既定値が使用されます。

詳細については、 [RealmJoin レポート設定のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) 設定の詳細については、

### 場所

Organization → General → Service Health の監視（定期実行）

**Runbook の完全名**

rjgit-org\_general\_monitor-service-health\_scheduled

### 詳細

| プロパティ    | 値                                                                                       |
| -------- | --------------------------------------------------------------------------------------- |
| バージョン    | 1.3.0                                                                                   |
| 必要なモジュール | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>Microsoft.Graph.Authentication (>= 2.38.0)</p> |
| スケジュール可能 | はい                                                                                      |

### 注意

一般的な使用例:

* 各新規 Service Health 問題をちょうど 1 回ずつ検出できるよう、runbook を LookbackHours と同じ間隔、またはそれよりわずかに短い間隔で実行するようスケジュールします。
* サービス名または短い ID をカンマ区切りで指定し、特定のサービスのみを監視します。たとえば Exchange Online や Teams です。空のままにするとすべてのサービスを監視します。サービスの表示名と短い ID の両方に対して大文字小文字を区別せずに照合されます。
* IncludeAdvisories と IncludeResolvedIssues は既定値の $false のままにしておくと、未解決のインシデントのみを通知する最もノイズの少ない設定になります。アドバイザリや Microsoft がすでに解決済みとマークした問題も表示するには、どちらかを $true に設定します。

パラメーターの相互作用:

* 最初の Service Health 投稿が LookbackHours ウィンドウ内にあるときに、新規に告知された問題と見なします（問題に投稿がない場合は startDateTime を使用します）。判定は lastModifiedDateTime のみでは行いません。これにより、遡って記録された問題を見逃さず、進行中のインシデントの状態更新ごとに再通知されることも防げます。
* runbook は実行間で状態を保持しないため、実行が失敗またはスキップされると、LookbackHours を一時的に広げて追い付き実行を行わない限り、それらのアラートは送信されません。
* 新しい問題ごとに 1 通のメールが送信されるため、Service Health の更新が多い日には 1 回の実行で複数のメールが送られることがあります。

### アクセス許可

#### アプリケーションのアクセス許可

* **種類**：Microsoft Graph
  * Mail.Send *（任意 — 機能: メールレポート）*
    * *EmailTo が構成されている場合、Send-RjReportEmail を使用して新たに検出された問題ごとに 1 通の警告メールを送信します*
  * Organization.Read.All
    * &#x20;*/organization を読み取り、警告メールの件名とフッターにテナント名を入れます*
  * ServiceHealth.Read.All
    * &#x20;*/admin/serviceAnnouncement の healthOverviews と issues を読み取り、新たに告知された Service Health の問題を検出します*

### パラメーター

#### サービス

監視する Microsoft 365 サービス名をカンマ区切りで指定します。たとえば Microsoft Intune、Microsoft Entra、Exchange Online です。空のままにするとすべてのサービスを監視します。サービスの表示名と短い ID の両方に対して大文字小文字を区別せずに照合されるため、Intune は Microsoft Intune に一致します。有効な名前は Microsoft 365 admin center の service health ページで確認できます。

| プロパティ   | 値                      |
| ------- | ---------------------- |
| 必須      | いいえ                    |
| 既定値     |                        |
| 種類      | 文字列                    |
| ポータル表示名 | 監視対象サービス（カンマ区切り、空欄で全件） |

#### LookbackHours

新しく告知された問題を何時間さかのぼって確認するかを指定します。runbook のスケジュールと同じ間隔に設定してください。たとえば日次スケジュールなら 24 にします。これにより、問題の見逃しや二重通知を防げます。

| プロパティ   | 値                                     |
| ------- | ------------------------------------- |
| 必須      | いいえ                                   |
| 既定値     | 24                                    |
| 種類      | Int32                                 |
| ポータル表示名 | ルックバック ウィンドウ（1～168 時間）- スケジュール間隔に合わせる |

#### アドバイザリを含める

false に設定すると、インシデントのみがアラート対象になります。true に設定すると、アドバイザリも通知されます。

| プロパティ   | 値                        |
| ------- | ------------------------ |
| 必須      | いいえ                      |
| 既定値     | False                    |
| 種類      | ブール値                     |
| ポータル表示名 | アドバイザリを含める（インシデントのみではない） |

#### 解決済みの問題を含める

false に設定すると、runbook の実行時点で Microsoft がすでに解決済みとマークしている問題はスキップされます。true に設定すると、解決済みの問題も引き続き報告されます。

| プロパティ   | 値              |
| ------- | -------------- |
| 必須      | いいえ            |
| 既定値     | False          |
| 種類      | ブール値           |
| ポータル表示名 | すでに解決済みの問題を含める |

#### EmailFrom

各問題ごとのアラートメールに使用する送信元メール アドレスです。runbook のカスタマイズで設定する必要があります。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      |                          |
| 種類       | 文字列                      |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### BrandingHeaderImageUrl

警告メール用のカスタム ヘッダー画像（PNG/JPEG/GIF、最大 200 KB）の公開 HTTPS URL（任意）です。RJReport.Branding.HeaderImageUrl テナント設定から取得されます。空欄の場合は、既定の RealmJoin ヘッダー画像が使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      |                          |
| 種類       | 文字列                      |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### BrandingFooterImageUrl

警告メール用のカスタム フッター画像（PNG/JPEG/GIF、最大 200 KB）の公開 HTTPS URL（任意）です。RJReport.Branding.FooterImageUrl テナント設定から取得されます。空欄の場合は、既定の RealmJoin フッター画像が使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      |                          |
| 種類       | 文字列                      |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### BrandingFooterLink

フッター画像のリンク先となる任意の URL です。RJReport.Branding.FooterLink テナント設定から取得されます。空の場合は、既定のリンク（<https://www.realmjoin.com）が使用されます。>

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      |                          |
| 種類       | 文字列                      |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### BrandingAccentColor

レポートメール テンプレート用のアクセントカラーの任意の上書き（6 桁の hex、例: '#0052cc'）です。RJReport.Branding.AccentColor テナント設定から取得されます。空または無効な場合は、既定の RealmJoin アクセントカラーが使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      |                          |
| 種類       | 文字列                      |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### BrandingTextColor

レポートメール テンプレート用のテキストカラーの任意の上書き（6 桁の hex）です。RJReport.Branding.TextColor テナント設定から取得されます。空または無効な場合は、既定の RealmJoin テキストカラーが使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      |                          |
| 種類       | 文字列                      |
| ポータルで非表示 | はい（Runbook のカスタマイズで事前設定） |

#### EmailTo

各問題ごとのアラートメールの受信者メール アドレスのカンマ区切りリストです。少なくとも 1 つの有効な受信者が必要です。

| プロパティ   | 値                    |
| ------- | -------------------- |
| 必須      | はい                   |
| 既定値     |                      |
| 種類      | 文字列                  |
| ポータル表示名 | アラート メールの受信者メール アドレス |

[Runbook Reference の概要に戻る](/ja/zi-dong-hua/runbooks/runbook-references.md)


---

# 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/ja/zi-dong-hua/runbooks/runbook-references/org/general/monitor-service-health_scheduled.md?ask=<question>&goal=<endgoal>
```

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