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

# サービス正常性を監視（スケジュール済み）

Microsoft 365 の新しいサービス正常性の問題をメールで通知

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

### 説明

Microsoft 365 のサービス正常性フィードをチェックし、選択した時間数内に Microsoft がアナウンスした問題を確認します。新しい問題ごとに個別のアラートメールが送信され、件名にはテナントと問題タイトルが入り、本文にはすべての詳細が含まれます。監視対象は特定のサービスに限定でき、アドバイザリやすでに解決済みの問題も含めることができます。レポート ファイルは作成されません。

### 一般的な使用例

* ランブックを、次の値と同じか、それより少し短い間隔で実行するようにスケジュールします `ルックバック時間` すべての新しい Service Health の問題をちょうど 1 回ずつ確実に検出するためです。
* 設定します `サービス` 特定のサービスのみを監視するには、サービス名または短い ID のカンマ区切りリスト（大文字小文字を区別せずに一致）を指定します。たとえば Exchange Online や Teams です。すべてのサービスを監視するには空欄のままにします。
* 空欄のままにしてください `アドバイザリを含める` および `解決済みの問題を含める` 既定値の `false` 最も通知の少ない設定では、未解決のインシデントのみに対してアラートを送ります。どちらかを `true` アドバイザリや、Microsoft がすでに解決済みとマークした問題も表示するには。

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

* 問題が新規アナウンスと見なされるのは、最初の Service Health 投稿が次の期間内にあるときです。 `ルックバック時間` ウィンドウ（存在しない場合は `startDateTime` その問題に投稿がない場合）は、ではなく `lastModifiedDateTime` だけで判定しません。これにより、過去日付の問題を見落とさず、進行中のインシデントのステータス更新ごとに再度アラートが送られることを防げます。
* ランブックは実行間で状態を保持しないため、実行が失敗したりスキップされたりすると、そのアラートは送信されません。たとえば `ルックバック時間` 期間が一時的に拡張されている場合を除きます。
* 新しい問題ごとに 1 通のメールが送信されるため、Service Health の更新が多い日は、1 回の実行で複数のメールが送信されることがあります。

### 実行出力

毎回の実行で、フィルター段階の要約と新しい問題の一覧（各問題のアラートメールが送信されたかどうかを含む）が、 **出力データ** ジョブのタブに書き込まれます。レポート ファイルは作成されません。

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

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

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

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

#### メールのブランディング

レポートメールでは、任意の `RJReport.Branding.*` テナント設定が反映されます:

* **ヘッダーおよびフッター画像** – 公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB
* **フッターリンク** – フッター画像のリンク先
* **アクセントカラーとテキストカラー** – 6 桁の 16 進数値、例: `#0052cc`

これらの設定が構成されていない場合は、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードまたは検証できない画像、または無効な色の値があっても、レポートメールが失敗することはありません。代わりに、該当する既定値が使用されます。

設定手順と画像要件: [メールのブランディング](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### 場所

組織 → 全般 → Service Health を監視（スケジュール済み）

**完全な Runbook 名**

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

### 詳細

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

### 権限

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

* **種類**: Microsoft Graph
  * Organization.Read.All
    * */organization を読み取り、テナント名をアラートメールの件名とフッターに入れます*
  * ServiceHealth.Read.All
    * *新しくアナウンスされた Service Health の問題を検出するために、/admin/serviceAnnouncement の healthOverviews と issues を読み取ります*
  * Mail.Send *(オプション — 機能: メール レポート)*
    * *EmailTo が設定されている場合、検出された新しい問題ごとに Send-RjRbReportEmail を使って 1 通のアラートメールを送信します*

### パラメーター

#### サービス

監視するサービスをカンマ区切りで指定します。たとえば Microsoft Intune、Microsoft Entra、Exchange Online です。すべてのサービスを対象にするには空欄にします。Intune などの短い名前も使用できます。

| プロパティ   | 値        |
| ------- | -------- |
| 必須      | false    |
| 既定値     |          |
| 種類      | 文字列      |
| ポータル表示名 | 監視するサービス |

#### ルックバック時間

新しくアナウンスされた問題をどのくらい前まで遡って確認するか（1～168 時間）を指定します。毎日の実行なら 24 など、スケジュールと同じ間隔を使うことで、見落としや二重アラートを防げます。

| プロパティ   | 値                |
| ------- | ---------------- |
| 必須      | false            |
| 既定値     | 24               |
| 種類      | Int32            |
| ポータル表示名 | ルックバック ウィンドウ（時間） |

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

インシデントだけでなく、アドバイザリにもアラートを出します。

| プロパティ   | 値             |
| ------- | ------------- |
| 必須      | false         |
| 既定値     | False         |
| 種類      | ブール値          |
| ポータル表示名 | アドバイザリを含めますか？ |

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

ランブックの実行時点ですでに Microsoft が解決済みの問題にもアラートを出します。

| プロパティ   | 値              |
| ------- | -------------- |
| 必須      | false          |
| 既定値     | False          |
| 種類      | ブール値           |
| ポータル表示名 | 解決済みの問題を含めますか？ |

#### EmailFrom

アラート メールの送信者アドレス。テナント設定 RJReport.EmailSender から取得されます。

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

#### BrandingHeaderImageUrl

レポートメールのヘッダー画像 (HTTPS URL、PNG/JPEG/GIF、最大 200 KB)。テナント設定 RJReport.Branding.HeaderImageUrl から取得されます。空の場合は既定の RealmJoin ヘッダーが使用されます。

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

#### BrandingFooterImageUrl

レポートメールのフッター画像 (HTTPS URL、PNG/JPEG/GIF、最大 200 KB)。テナント設定 RJReport.Branding.FooterImageUrl から取得されます。空の場合は既定の RealmJoin フッターが使用されます。

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

#### BrandingFooterLink

レポートメールのフッター画像のリンク先。テナント設定 RJReport.Branding.FooterLink から取得されます。空の場合は realmjoin.com が使用されます。

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

#### BrandingAccentColor

レポートメールのアクセントカラーを 6 桁の 16 進数値で指定します。テナント設定 RJReport.Branding.AccentColor から取得されます。空または無効な場合は RealmJoin の既定値が使用されます。

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

#### BrandingTextColor

レポートメールのテキストカラーを 6 桁の 16 進数値で指定します。テナント設定 RJReport.Branding.TextColor から取得されます。空または無効な場合は RealmJoin の既定値が使用されます。

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

#### EmailTo

アラートメールの送信先アドレス。カンマ区切りで指定します。少なくとも 1 つ必要です。

| プロパティ   | 値         |
| ------- | --------- |
| 必須      | true      |
| 既定値     |           |
| 種類      | 文字列       |
| ポータル表示名 | 宛先メールアドレス |

[Runbook リファレンスの概要に戻る](/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 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/zi-dong-hua/runbooks/runbook-references/org/general/monitor-service-health_scheduled.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.
