サービス正常性を監視をスケジュール

新たに発表された Microsoft 365 Service Health の問題をメールで通知

これはスケジュール実行の runbook です。単一のオブジェクトでトリガーされるのではなく、繰り返しスケジュールで実行されるように設計されています。詳細は スケジューリング runbook のスケジュールの構成方法についてご覧ください。

説明

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

メール送信に関するセットアップ

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

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

以下を参照してください RealmJoin レポート設定ドキュメント 利用可能なすべての設定の詳細について。

メールのブランド設定

レポートメールは、任意の RJReport.Branding.* テナント設定に従います:

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

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

セットアップ手順と画像要件: メールのブランド設定.

場所

Organization → General → Monitor Service Health (Scheduled)

完全な runbook 名

rjgit-org_general_monitor-service-health_scheduled

詳細

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

注記

一般的な使用例:

• runbook は LookbackHours と同じ間隔、またはそれより少し短い間隔で実行されるようにスケジュールし、すべての新しい Service Health 問題をちょうど 1 回ずつ検出します。
• Services に、監視する特定のサービスのみを対象にするためのサービス名または短い ID のカンマ区切りリスト（大文字小文字は区別されずに一致）を設定します。たとえば Exchange Online や Teams です。空のままにすると、すべてのサービスを監視します。
• 最もノイズの少ない構成では、IncludeAdvisories と IncludeResolvedIssues は既定の $false のままにしてください。これにより未解決のインシデントのみがアラート対象になります。いずれかを $true にすると、アドバイザリや Microsoft が既に解決済みとマークした問題も表示されます。

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

• ある問題は、その最初の Service Health 投稿が LookbackHours ウィンドウ内に入ると新規に通知されたものと見なされます（問題に投稿がない場合は startDateTime にフォールバックします）。lastModifiedDateTime のみでは判定しません。これにより、後日付けされた問題を見逃さずに済み、進行中のインシデントのステータス更新のたびに再アラートされることも防げます。
• runbook は実行間で状態を保持しないため、実行に失敗したりスキップされたりすると、LookbackHours を一時的に広げてキャッチアップ実行しない限り、これらのアラートは送信されません。
• 新しい問題ごとに 1 通のメールが送信されるため、Service Health が活発な日には 1 回の実行で複数のメールが送られることがあります。

アクセス許可

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

• 種類: Microsoft Graph

  • Mail.Send (オプション — 機能: メール レポート)

    • EmailTo が構成されている場合、Send-RjReportEmail を介して新たに検出された問題ごとに 1 通のアラートメールを送信します
  • Organization.Read.All

    • アラートメールの件名とフッターにテナント名を入れるため、/organization を読み取ります
  • ServiceHealth.Read.All

    • /admin/serviceAnnouncement の healthOverviews と issues を読み取り、新たに発表された Service Health の問題を検出します

パラメーター

Services

監視する Microsoft 365 サービス名をカンマ区切りで指定します。たとえば Microsoft Intune、Microsoft Entra、Exchange Online です。空欄にするとすべてのサービスを監視します。一致判定はサービスの表示名と短い ID の両方に対して大文字小文字を区別せずに行われるため、Intune は Microsoft Intune に一致します。使用可能な名前は Microsoft 365 管理センターの Service Health ページで確認できます。

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

LookbackHours

新たに通知された問題を何時間前までさかのぼって探すかを指定します。たとえば毎日実行する場合は 24 にして、runbook のスケジュール間隔と同じにしてください。これにより、問題の見逃しや二重通知を防げます。

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

IncludeAdvisories

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

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

IncludeResolvedIssues

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 桁の 16 進数、例: '#0052cc'）。RJReport.Branding.AccentColor テナント設定から取得されます。空または無効な場合は、既定の RealmJoin アクセント色が使用されます。

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

BrandingTextColor

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

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

EmailTo

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

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

Runbook Reference の概要に戻る