トラブルシューティング

トラブルシューティングのゴールは、ある機能が正常に動作しない理由を特定し、問題を解決する方法を説明することです。このトラブルシューティングガイドでは、管理者がCitrixマイクロアプリの問題の原因を特定するのに役立つトラブルシューティングの方法を紹介します。

トラブルシューティングのプロセスには、問題を理解し、特定し、完全に説明できることが含まれます。正確な問題の記述によって、管理者やシトリックスサポートが問題の原因を見つけるための出発点を特定することができます。トラブルシューティングのプロセスで見つかる情報が必ずしも問題の解決につながるわけではありませんが、多くの場合、問題を解決するための十分な情報を見つけることができます。これらの手順を実行することで、少なくとも問題の状態を説明できるようになり、問題解決への最適なスタート地点が見つかります。

トラブルシューティングプロセスの概要は次のとおりです:

  1. 障害の状態を確認します: 問題を再現することができますか?できる場合は問題を再現し、問題を再現するために実行する手順を正確に記録します。再現できない場合は、重要な詳細を記録します。最後に、動作を特定し、問題の範囲を決定します。

  2. 調査し証拠を収集します: プラットフォームを環境の問題から隔離します。手がかりを探し、マイクロアプリビルダー、イベントログ、システムのレコード(SOR)、IDプロバイダーの統合からデータを収集します。

  3. シトリックスサポートに結果とコンテキスト情報の概要を提供します: 障害の状態を確認し証拠を収集後、原因が不明の場合は、テスト結果とコンテキスト情報をシトリックスサポートに提供します。

それでは、トラブルシューティングのプロセスの各手順をさらに詳細に見ていきます。

障害の状態の確認

再現可能な問題が発生した場合、実行した手順を正確に記録します。記録は、できるだけ詳細にします。問題が再現できない場合、不審な動作についてできるだけ詳しく記録しておくことが重要です。動作の範囲を特定して確定します。

注:

ユーザーが通知カードを受信する前に、増分同期を実行する必要があることに注意してください。スケジュールされた増分同期を待つか、手動で実行します。

問題の再現

再現可能な問題が発生した場合、実行した手順を正確に記録します。記録は、できるだけ詳細にします。

この例は、利用者のWorkspaceのアクティビティフィードに通知カードが表示されない問題を再現するプロセスについての説明です:

問題:

経費レポートの承認に関するWorkdayの通知が、User1のWorkspaceアクティビティフィードに表示されません。

(実際の動作の)再現手順:

  1. AdminAがマイクロアプリビルダーでWorkdayの統合を追加しました。
  2. 完全同期に成功しました。
  3. 増分同期に成功しました。
  4. マイクロアプリの経費レポートの承認を構成しました。
  5. 経費レポートの承認の通知を構成しました。
  6. 構成されたフィードカードの設定 - スクリーンショットが含まれています。
  7. User1をマイクロアプリにサブスクライブしました。
  8. 特定のユーザーに対する通知をトリガーするようにWorkdayを変更しました。
  9. User1の直属の部下であるUser2に経費レポートの承認を依頼しました。
  10. User1がWorkspaceにログインしました。
  11. User1は、フィードカードを受信しなかったことを報告しました。
  12. AdminAはマイクロアプリビルダーで通知を実行しました。
  13. AdminAはマイクロアプリビルダーでイベントログをチェックしました。
  14. AdminAは、次のエラーメッセージ(エラーテキストまたはスクリーンショットを挿入)を受信しました。

再現することができない

問題を再現することが常に可能なわけではありません。問題が再現できない場合、不審な動作についてできるだけ詳しく記録しておくことが重要です。以下は上記の例で問題が発生しなくなった場合です:

問題:

経費レポートの承認に関するWorkdayの通知が、User1のWorkspaceアクティビティフィードに表示されません。

(実際の動作の)再現手順:

この問題が発生するまでの手順を、可能な限り詳細に記録します:

  1. User1の直属の部下であるUser2が、(日付が含まれる)金曜日の2:30pmにWorkdayのマイクロアプリを使用して、Workspaceから経費レポートの承認を依頼しました
  2. User1は(日付が含まれる)金曜日の3:30 pmにWorkspaceにログインしました。
  3. User1は、フィードカードを受信しなかったことを報告しました。
  4. フィードカードは、User1のフィードに表示されませんでした。

不審な動作の現在の状態を確認し、文書化します。

  1. AdminAは金曜日の2:30 pmにマイクロアプリビルダーでイベントログをチェックしました。
  2. 通知はUser1に対して2:30:50 pmに正常に生成されました。
  3. AdminAにはWorkdayでエラーが表示されませんでした。User2からの依頼は表示されました。
  4. 依頼はまだ未承認でした。

動作を特定する

次に、動作を特定します。問題の範囲を絞り、論理的に可能な原因を特定するには、動作と問題が発生している範囲についての詳細を理解することが重要です。まず、以下の質問に答えることから始めます:

  • 問題はいつ発生しましたか?(秒単位でのタイムスタンプを取得します)
  • この操作は、これまで問題なく機能していましたか?
  • 機能していたときから、何かを変更しましたか?
  • どのくらいの頻度でこのエラーが発生しますか?(発生時の日付/時間を取得します)
  • 発生は断続的ですか?散発的ですか?(パターンやスケジュールがありますか?)
  • すべての統合が影響を受けていますか?
  • すべてマイクロアプリが影響を受けていますか?
  • すべてのユーザーが影響を受けていますか?
  • すべての認証の種類が影響を受けていますか?
  • 適切な構成が設定されていますか?

問題の範囲

問題の範囲を特定します。上記の質問にすべて回答できないこともあります。問題の範囲を適切に特定するために、基本的なテスト計画を定義することが必要な場合もあります。これらのテストは、調査中の問題の種類によって異なります。重要なのは、いずれのテストでも適切なセキュリティ、コンプライアンス、パフォーマンスのガイドラインおよび考慮事項に確実に従うようにすることです。

通知の問題では、範囲を決定し実際の動作を特定するために次のテストも役立ちます:

  • 問題が発生する前に行った変更を元に戻します。
  • User1に別のブラウザーで試すよう指示します。
  • User1がシークレットモードで試すよう指示します。
  • (User1と類似した)異なるWorkspaceユーザーアカウントを試してみます。
  • (User2と類似した)異なるWorkspaceユーザーアカウントを試してみます。
  • 異なる統合(SoR)ユーザーアカウントを試してみます。
  • 異なる統合(SOR)を試してみます。
  • 異なるマイクロアプリを試してみます。
  • 異なる通知を試してみます。
  • 異なるが類似した通知設定を使用します。

調査し証拠を収集する

さらに証拠を収集して考えられる原因を調査しサポートを提供するために、適用できるこれ以外の手法もありますCitrixプラットフォームの問題を顧客の環境の問題から分離することが重要です。

Citrixプラットフォームの問題を確認

マイクロアプリなどのCitrix Cloudサービスの場合、パフォーマンスに影響を与えるグローバルな停止がないことを確認してください:

  • https://status.cloud.com/で既知の機能停止があるかどうかを確認します。
  • Citrix Cloudまたは特定のCitrix Cloudの顧客に影響を与える問題の通知がないか、Citrix Cloudコンソール(customer.cloud.com)で確認してください。 Workspaceで通知を探す
  • Workspace構成でマイクロアプリサービスがフィードとして有効になっていることを確認します。
    1. Citrix Cloudにサインインした後、メニューで [ワークスペースの構成] を選択します。
    2. [サービス統合] を選択します。
    3. マイクロアプリ[有効] になっていることを確認します。Workspaceマイクロアプリの設定に関する詳細のすべてとスクリーンショットについては、「はじめに」を参照してください。

顧客の環境の問題を確認する

統合が正常に同期されていることを確認します。同期でエラーが発生した場合は、アカウントの詳細を確認します:

  1. 統合のエラーをチェックします。Citrix Cloudにサインイン後、[マイクロアプリ] タイルで [管理] を選択してマイクロアプリ管理コンソールを開きます。
  2. マイクロアプリ管理コンソールでは、統合が正常に同期されていることを確認してください。統合の隣の表示に注目します。このスクリーンショットでは、エラーが表示されています:

    同期に失敗しました

  3. 同期の障害が発生した場合、統合ログを確認してください。統合ログを表示する統合の横のメニューを選択します。
  4. [統合ログ] を選択します。
  5. タイムスタンプを含めて、スクリーンショットを取るかエラーメッセージをコピーします。以下は、エラーメッセージの例です:

    同期に失敗しました

    統合ログについて詳しくは、「データ同期の設定」を参照してください。

  6. ここで、統合の同期を再び実行する必要があります。同期を設定する統合の横にあるメニュー、[同期] の順に選択します。 データ同期の設定方法
  7. 増分同期を実行します。イベントログを確認し、すべてのエラーを文書化します。
  8. 完全同期を実行します。イベントログを確認し、すべてのエラーを文書化します。

    データ同期の実行について詳しくは、「データ同期の設定」を参照してください。

同期でエラーが発生した場合は、次の詳細を確認します:

  1. サービスアカウントが統合側(SoR)の適切な権限を持っていることを確認してください。これを実行する方法は、各SoRで異なります。たとえば、Workdayでは「セキュリティグループの権限の管理」を参照してください。
  2. サービスアカウントの資格情報がマイクロアプリコンソールおよびSoRで有効であることを確認します。
  3. (必要な場合)クライアントIDとシークレットが正しいことを確認します。

    詳しくは、「サービス認証のセットアップ」を参照してください。

マイクロアプリビルダーで通知を確認する

影響を受けるマイクロアプリをチェックする必要があります。前述でも取り上げた、Workdayの承認マイクロアプリを再度例として紹介します。サブスクリプションと通知の構成をチェックし、再度イベントを実行して該当するUUIDを収集します。

  1. まず、User1が通知にサブスクライブしていることを確認します。影響を受けたマイクロアプリのメニューから、[サブスクリプション] を選択します。 ユーザーのサブスクリプションの確認
  2. 次に、影響を受けた通知を開きます。影響を受けたマイクロアプリのメニューから [編集] を選択して失敗の通知を選択します。
  3. [And notify] 構成が正しいことを確認します: 通知の構成の確認
  4. [マイクロアプリのプレビュー] で正常に表示されることを確認します。次のスクリーンショットは、このオプションと次の2つのオプションを示しています。 イベントログ通知のプレビュー、実行、表示
  5. [イベントを実行] を選択します。
  6. イベントの実行が終了後、[イベントログを表示] を選択して、エラーがある場合ドロップダウンメニューを選択します。エラーメッセージを記録し、関連するUUID(通知IDまたはトランザクションID)を記録し、イベントログのテキストをテキストファイルにコピーします。

詳しくは、「イベント通知の構築」を参照してください。

統合を確認する(SoR)

  1. 障害に関する詳細については、統合SoRイベントログを確認してください。
  2. シトリックスサポートに提供するすべての関連情報を記録します。

詳しくは、「統合のセットアップ」を参照してください。

IDプロバイダーを確認する

  1. Active Directoryまたは他のIDプロバイダーが正しくセットアップされているかを確認します。
  2. 認証が正しく構成されていることを確認します。
  3. 欠落したデータ、不適切な、または互換性のない構成とエラーを探します。

詳しくは、「はじめに」を参照してください。

シトリックスサポートに結果の概要とコンテキスト情報を提供する

前のセクションからの結果と、次のコンテキスト情報を提供します。機密データの取り扱いには注意してください。機密データについて詳しくは、「マイクロアプリのセキュリティの技術概要」を参照してください。

  • 問題が最後に発生した既知の正確な時間。
  • マイクロアプリビルダーに表示された影響を受ける統合(SoR)名とマイクロアプリコンソールURLからの統合UUID。
  • マイクロアプリビルダーに表示された影響を受けるマイクロアプリ名とマイクロアプリコンソールURLからのマイクロアプリUUID。
  • マイクロアプリビルダーに表示された影響を受ける通知名とマイクロアプリコンソールURLからのUUID。
  • 影響を受けるユーザー名(Workspace)、メール、OID。
  • 影響を受けるユーザー名(統合SoR)。
  • マイクロアプリイベントログからの以下の詳細:
    • 問題が最後に発生した既知の正確な時間。
    • 影響を受けるカードUUID。
    • 影響を受けるトランザクションID。
    • エラー/例外の詳細。前述のように再現して記録します。