Microsoft Office 365 Service Communications API を使用した Dynamics 365 Customer Engagement サービス監視:サービス正常性の取得

みなさん、こんにちは。

前回は、Office 365 からサービス正常性を取得するための事前準備をしました。

まだご覧になっていない方は一読ください。

Microsoft Office 365 Service Communications API を使用した Dynamics 365 Customer Engagement サービス監視: 概要
Microsoft Office 365 Service Communications API を使用した Dynamics 365 Customer Engagement サービス監視: 事前準備

今回は、実際に Dynamics 365 CE サービス正常性を取得してみます。Office 365 の管理センターの内容と比較しながら見ていきます。

- 有効なサービスを取得
- 現在の状態を取得
- インシデントの詳細を取得
- 過去の状態を取得

有効なサービスを取得

Office 365 テナントで有効になっているサービスを取得してみます。最初に Office 365 管理センターで確認します。

[Office 管理センター] > [正常性] > [サービス正常性] をクリックします。

この評価環境の場合、17 個の有効なサービスがあることがわかります。

[Office 365 Service Communications API]

続いてAPI で取得してみます。クライアントに Postman をインストールしてください。

1. Postman を起動します。

2. “Request” をクリックします。

3. 名前を付けます。

4. Collection を作成し、指定します。

5. 作成されます 。

6. 続いて。右ペインに以下の URL を入力します。

https://manage.office.com/api/v1.0/<テナント名>.com/ServiceComms/Services

7. 認証タイプを “OAuth 2.0” に指定します。

8. [Get New Access Token] をクリックします。

9. 以下の通り設定します。

Client ID、Client Secret は事前準備で取得したものを指定します。

10. ボタンをクリックします。

11. Office 365 へのログイン画面が表示されます。Office 365 管理者でログインします。

12. ログインに成功すると、Access Token に文字列が記載されればOKです。
トークンは一定期間利用できるます。以後本記事で出てくる操作は、同じトークンを利用できます。

13. 下にスクロールしてボタンをクリックします。

14. Header に “Authorization” が追加されていることを確認します。

15. Send ボタンをクリックします。

16. HTTP ステータス 200 で、Body に何かしら返却されていれば OK です。

17. 構造を見てみましょう。青枠 (4-29 行目) は Dynamics 365 CE だとわかります。
また同様に各サービスの結果が返ってきており 17 個あることがわかります。

18. 続いて、Dynamics 365 CE のみにみ絞ってみます。フィルターを付けます。

19. [Send] をクリックします。Dynamics 365 CE のみにフィルターされたことがわかります。

Dynamics 365 CE で取得できる項目

Dynamics 365 CE のサービスで API で確認できることは 5つあるようです。

- Sign In
- Sign up and administrator
- Organization access
- Organization performance
- Components/Feature

現在この項目の詳細について公開情報は見つけられていませんが、名前から推測すると Dynamics 365 CE にサインできるか、Dynamics 365 CE の組織にアクセスできるか、パフォーマンスの状態、機能やコンポートの状態などがわかるようです。API がプレビューという位置づけですが、この情報は API で確認できる有用な情報です。

現在の状態

続いて、Dynamics 365 CE の現在の状態を取得してみます。

1. URL に “CurremtStatus” とフィルターを付けて [Send] をクリックします。

2. Dynamics 365 サービスの現在の正常性がわかります。

1 つ目の赤枠は、項目ごとの状態がどうなっているかわかります。”Components/Feature” が “ServiceRestored” になっており、サービスが復元した状態であることがわかります。

2 つ目の赤枠は、インシデントの番号が確認できます。後ほどインシデントの詳細を取得してみます。

3 つ目の赤枠は、サービス全体の状態がわかります。“ServiceRestored” になっているためサービスが服された状態だとわかります。
また、Statustime は取得した時間のようです。日にちが一日ずれていますが日本時間にすると時間は合います（UTC+9)。

インシデントの詳細を取得

では続いて、インシデントの詳細を取得てみましょう。

1. URL に “Message” とフィルターを付けて [Send] をクリックします。

2. “CR146892” インシデントの詳細が取得できました。

Title、ImpactDescription より SharePoint Online との連携で問題が発生していたことが読み取れます。

開始時間は 8/20 14:01、終了時間は 8/27 17:5、更新日時が 8/28 7:34 ということがわかります。

Messages 部分は、過去の履歴を意味しているようです。最初のメッセージは 8/21 19;40 から始まり、8/27 20:15 が最後のようです。

Office 365  管理センターを見てみましょう。

3. [Office 365 管理センター] > [正常性] > [サービス正常性] > [履歴の表示] をクリックします。

4. “CR146892” をクリックします。開始時間、終了時間、更新日時、最終メッセージが API と同じものであることがわかります。

また、メッセージの履歴も確認できます。最初と最後のメッセージの日時が一致していることがわかります。

過去の履歴の取得

最後に、過去のサービスの正常性の履歴を取得してみます。

1. URL に入力します。

https://manage.office.com/api/v1.0/<テナント名>.com/ServiceComms/HistoricalStatus?$filter=Workload%20eq%20'DynamicsCRM'

2. [Send] をクリックします。結果を見ると、日次で 0:00 時点のサービスの正常性の状態を保持していることがわかります。
8/22-8/28 の 7 日分の履歴が返ってきました。

確認すると、履歴の一番古い 8/22 時点ですでに “CR146892” は発生したことがわかります。

そして、8/27 まで続けていましたが、8/28 ではインシデントはなくなり StatusDisplayName も “Normal Service” になっているため解消されたと判断できます。

Office 365 管理センターで確認すると、8/28 現在Dynamics 365 CE の状態は正常であることがわかります。

履歴の表示をクリックします。

“CR146892” は確認でき、8/20 14:1 が開始日時となっていることから、8/20 から発生したと判断できます。

まとめ

いかがだったでしょうか。今回は Dynamics 365 CE のサービス正常性を取得してみました。
現在の状態、インシデントの詳細、過去の履歴を取得できることがわかりました。またサインインできるか、組織のパフォーマンスの状態といった有用な情報も API で取得できることがわかりました。
次回は、今後のメンテナンス情報などのメッセージセンターの情報を取得してみます。お楽しみ。

- プレミアフィールドエンジニアリング 河野 高也

※本情報の内容（添付文書、リンク先などを含む）は、作成日時点でのものであり、予告なく変更される場合があります