[このトピックはプレリリース ドキュメントであり、変更されることがあります。]
トレースを使用して、ローコード プラグインとプロコード プラグインのトラブルシューティングを行います。トレースは、実行時の情報を記録することで、障害の原因の診断や開発中の特定の状態の一般的な検証に役立ちます。
重要
- これはプレビュー機能です。
- プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能を公式リリースの前に使用できるようにすることで、顧客が事前にアクセスし、そこからフィードバックを得ることができます。
Dataverse アクセラレータ のプラグイン監視モジュールは、プラグイン用 Microsoft Dataverse で利用可能な既存のトレースとログ機能の拡張ビューです。このインターフェイスは、関連する詳細を最新の処理で配置することにより、開発フェーズでのトラブルシューティングおよびデバッグ プロセスの改善に役立ちます。
アプリに表示されるすべてのイベントは、次のワークフロー タイプに従って 24 時間 トレース テーブルから読み取られます。
- プラグイン
- カスタム API
- インスタントおよび自動化されたローコード プラグイン
前提条件
次のセキュリティ ロールの割り当てと、Dataverse アクセラレータ アプリへのアクセス権が必要です。
セキュリティ ロール: システム カスタマイザーとシステム管理者セキュリティ ロールの両方に、ログを有効にしてアプリを既定で使用するために必要な権限があります。
または、次の権限を構成することで、各機能への特定のアクセス権を持つカスタム ロールを作成することもできます。
主な機能
- 一元化されたログ ビューアー: 中心となる 1 つの場所で、環境内の Dataverse カスタム API、ローコード プラグイン、プロコード プラグインを実行してトレース ログにアクセスし表示します。
- フィルター処理機能: ログ履歴を簡単にフィルター処理して、デバッグのニーズに関連するログをすばやく見つけることができます。
インストール
この機能は、Dataverse アクセラレータ アプリで使用できます。 インストールの手順については、Dataverse アクセラレータ記事 をご覧ください。
プラグイン監視機能を試す
プラグインの監視 機能 (左側のナビゲーション ウィンドウ、またはランディング スクリーンの機能カード)に移動します。
ログ キャプチャの有効化
ご使用の環境でログ キャプチャが有効になっていない場合、ランディング ページにはオフ状態が表示され、ログ記録を有効にする 2 つのオプション 全て または 例外が表示されます。 ニーズに応じて適切なオプションを選択し、詳細については、ログとトレースの記事を参照してください。
必要に応じて設定 画面でこれらの設定を変更でき、メイン画面のコマンド バーからアクセスできる画面に切り替えます。
チップ
トレースとログ記録は、プラグイン開発中のデバッグに最適です。 運用環境でのプラグイン ワークフローには、監視用 Azureアプリ インサイトを使用してください。
ログの表示
ログが有効になると、画面に表示されるメイン リストにプラグイン イベントが表示され始めます。
チップ
ログが表示されない場合は、新しいローコード プラグインを作成して実行し ログを表示できます。
フィルター ログ
フィルター処理機能を利用して、作業中のプラグインに関連するログをすばやく見つけます。
コマンド バーの右上のフィルター を選択して、フィルター ウィンドウを開きます。 検索バーを使用して、キーワードで素早くフィルター処理することもできます。
| フィルター | プロパティ |
|---|---|
| 件名 | プラグインの論理名を選択します。 |
| 前/後に開始 | プラグインが呼び出されたときの日時です。 |
| 例外のみを有効にする | 失敗状態での実行を表示します。 |
| 最短/最長実行時間 | プラグイン継続時間の最小範囲と最大範囲。 |
| タイプ | プラグイン ワークフローの分類。 使用可能なタイプには以下が含まれます:
|
| モード | プラグインが同期か非同期か。 |
ログの詳細を読み取る
プラグインの実行に関する詳細情報を表示するには、特定のログ エントリを選択します。 ログの詳細には、タイムスタンプ、プラグイン名、実行ステータス、出力パラメーター、エラー メッセージなどが含まれます。 メッセージ ブロック フィールドと例外ブロック フィールドは、ウィンドウの基本詳細の下に表示され、それぞれの列にデータが存在する場合は展開されます。
ベスト プラクティス
ログの詳細を調べる
- プラグインの実行に関する詳細情報を表示するには、特定のログ エントリを選択します。
- ログの詳細には、タイムスタンプ、プラグイン名、実行ステータス、入力/出力パラメーター、エラー メッセージなどが含まれる場合があります。
問題をトラブルシューティングします
- トレース ログに提供される情報を使用して、プラグインの実行中に発生した問題をトラブルシューティングします。
- エラー メッセージ、入出力パラメーター、実行の詳細を分析して、問題の根本原因を特定します。
- トレース メッセージを使用して、役立つ指針を提供します。 トレース サービスへの書き込みは、Dataverse SDK および Power Fx の トレース関数 としてローコード プラグインで利用できます。
アクションの実行
- トレース ログから収集された分析情報に基づいて、特定されたパフォーマンスの問題やバグに対処するための適切なアクションを実行します。
- これには、プラグイン構成の調整、コード ロジックの更新、サポート リソースからの支援の依頼などが含まれる場合があります。
テストを計画する
- 開発中にプラグインのパフォーマンスを検証するために、トレース ログで実行できるテスト ケースを計画することを習慣にしてください。
- Dataverse プラグインの全体的な安定性と信頼性を維持するために、問題や異常を速やかに解決してください。
プラグインのパフォーマンスを監視する
- Application Insights で登録されたトレース ログを確認して、運用環境でのプラグインのパフォーマンスを定期的に監視します。
- 実行ステータス、エラー メッセージ、パフォーマンスの問題やバグを示す可能性のある異常に注意してください。
よくあるご質問
トレース ログ ビューアーにアクセスするにはどのような権限が必要ですか?
ログを表示するには、少なくとも トレース テーブルに対する読み取り権限が必要です。
環境内でログ キャプチャを有効にできるのは誰ですか?
適切なセキュリティ ロールを持つシステム管理者が、環境内でログ キャプチャを有効にすることができます。 具体的には、PluginTraceLogSetting 列の値を更新するには、組織テーブルにアクセス権を書き込む必要があります。
ログ履歴をフィルター処理して特定のログを見つけることはできますか?
はい、トレース ログ ビューアーにはフィルター処理機能が用意されており、ユーザーはデバッグのニーズに関連するログを簡単に見つけることができます。
プラグイン監視機能は、すべての環境で使用できますか?
この機能は Dataverse アクセラレータを通じて提供され、このアプリがインストールされているすべての環境で利用できます。 このアプリはすべての新しい環境に自動的にインストールされていますが、インストール手順に従って古い環境にもインストールできます。
ログを有効にした後も、"ログはオフになっています" という画面が表示されます
適切な権限があり、ログ記録が有効になっていることが確実な場合は、ブラウザー タブを更新します。従来のエクスペリエンスを使用して、ログが有効になっているかどうかを確認できます。